ImagingDataCommons / IDC-WebApp

Web Application front end for IDC (CORE REPO)
Apache License 2.0
6 stars 2 forks source link

Issues with Correlation Between Search Results Graph with what is selected in Search Configuration Box #506

Closed G-White-ISB closed 3 years ago

G-White-ISB commented 3 years ago

An external reviewer noted issues with the correlation between the search results graph and the search configuration box. For instance when just the Abdomen BodyPartExamined value is selected, four different values, Abdomen, Headneck, Chest, and None appear in the Body Part Examined pie chart. This behavior is known and expected. The attribute are faceted by CaseIDs, and the same CaseID may match several different values of the same attribute. Hovering over the two information icons in the panels yields some explanatory text. We realize the users could easily miss these icons or not understand they are actionable. We are exploring better ways to explain these issues to the user.

G-White-ISB commented 3 years ago

unnamed-3

fedorov commented 3 years ago

@G-White-ISB if I recall correctly our today's discussion, we planned to add a text right below the piecharts with the pointer to the documentation, no (cc @wlongabaugh )?

One idea for the text: "This documentation section explains why the charts include items other than the attributes selected in the left panel".

wlongabaugh commented 3 years ago

My suggestion is something more conversational, with a glyph that catches the eye, e.g.:

PieGuidance
G-White-ISB commented 3 years ago

Clicking away for an explanation is annoying. I think we should attempt an explanation in the text so that most people either understand or think they understand without following the link.

"As some attributes have non mutually exclusive values the charts may contain non zero counts for these values even when they are not selected in the left hand panel. See here for a detailed explanation."

wlongabaugh commented 3 years ago

OK, how about a mouse over with more text then, plus the link? I am trying to capture attention here with something short and pithy. In my experience, verbose text gets ignored...the "fine print"

G-White-ISB commented 3 years ago

True text is usually ignored, but our use case here is someone who is confused by the chart results and is looking for an explanation. If we had text that reveals more text in a mouseover, well it would have to be crystal clear that you could mouseover the initial text.

I'm not crazy about the conversational style but that might just be me. Somehow it reminds me of clippy. I'll make a couple of prototypes for a web app meeting in the new year and we can spend 15 minutes reviewing them.

wlongabaugh commented 3 years ago

At least I'm not suggesting eyeballs on a wiggly paperclip 8^D. Might run ideas past the original reviewer? Note I'm not trying to explain the situation in the visible text (too complex), but provide a more noticeable and compelling "hook" to provide the explanation besides a tiny (i) glyph. Thanks.

G-White-ISB commented 3 years ago

Proposed solution is a glyph at the bottom of the pie charts that looks like this: Screen Shot 2021-02-01 at 11 47 02 AM On hover a tootip pops up:

Screen Shot 2021-02-01 at 11 48 42 AM @fedorov and @ulrikew comments welcome

madelyngreyes commented 3 years ago

Issue 4.4 in Tin's test report addressed in this ticket.

madelyngreyes commented 3 years ago

Also, issue 4.5

madelyngreyes commented 3 years ago

New clarification section for filters returned example, Screen Shot 2021-02-25 at 12 53 05 PM @ulrikew @fedorov

wlongabaugh commented 3 years ago

@G-White-ISB I'm wondering if the pie chart shown in the glyph (corresponding to nothing selected) should correspond the the attributes selection (Abdomen selected). I found that somewhat perplexing when trying to understand what was being conveyed.

s-paquette commented 3 years ago

@wlongabaugh @fedorov Is this considered testing passed? (That glyph is simply a fixed image, it's not a realtime drawing.)

wlongabaugh commented 3 years ago

@s-paquette My preference would be to swap in this image instead and then consider it testing passed: results_glyp2

G-White-ISB commented 3 years ago

Concur with change proposed in image. Actually I had meant the filter selection to correspond with the pie chart.

s-paquette commented 3 years ago

@G-White-ISB Are we going to get to this adjustment this Sprint, or should I push this into Sprint 19?

wlongabaugh commented 3 years ago

@G-White-ISB Should be able to take the above image and drop it in place. Original file just edited to produce above file.

G-White-ISB commented 3 years ago

I can put this in now. George

On Fri, Feb 26, 2021 at 12:33 PM wlongabaugh notifications@github.com wrote:

@G-White-ISB https://github.com/G-White-ISB Should be able to take the above image and drop it in place. Original file just edited.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/ImagingDataCommons/IDC-WebApp/issues/506#issuecomment-786879446, or unsubscribe https://github.com/notifications/unsubscribe-auth/AN54OR3DBZZK6VPCWDVZVGLTBAASTANCNFSM4VE43EXQ .

G-White-ISB commented 3 years ago

In a PR. Nothing else is changed.

On Fri, Feb 26, 2021 at 12:51 PM George White george.white@isbscience.org wrote:

I can put this in now. George

On Fri, Feb 26, 2021 at 12:33 PM wlongabaugh notifications@github.com wrote:

@G-White-ISB https://github.com/G-White-ISB Should be able to take the above image and drop it in place. Original file just edited.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/ImagingDataCommons/IDC-WebApp/issues/506#issuecomment-786879446, or unsubscribe https://github.com/notifications/unsubscribe-auth/AN54OR3DBZZK6VPCWDVZVGLTBAASTANCNFSM4VE43EXQ .

fedorov commented 3 years ago

I am not a 508 compliance expert, but dark blue on dark grey for the link color does not strike me as good contrast.

s-paquette commented 3 years ago

@fedorov We can I think make a separate ticket for addressing 508 items such as contrast, so as to minimize scope creep. The new proposed image is now live on idc-testing; does it address the ticket's original concerns?

fedorov commented 3 years ago

I thought this belongs to this ticket, since we are introducing a new feature, and my comment was specifically about testing of that new feature. Again, I am not in a position to comment on 508. All I am saying is that the choice of colors in the tooltip for this specific feature implemented in this ticket is suboptimal.

s-paquette commented 3 years ago

@fedorov We generally try to keep 508 compliance in its own ticket or tickets, because those changes are often small tweaks which are best done en masse rather than issue by issue. (Also because we run the test as a separate pass.)