ICTatRTI / coconut-analytics

Browserified & backboned version of coconut-reports
Other
2 stars 3 forks source link

Dashboard: Determine key indicators to display at top #149

Closed gmcressman closed 8 years ago

gmcressman commented 8 years ago

image

@mikeymckay should advise which indicators we should display at the top of the Dashboard. He will also probably need to write the necessary queries. @cjenkins-rti should review and revise the design. She may also implement design changes. @scloo is familiar with this code.

Suggested candidate indicators:

  1. Number of epidemic threshold Alerts in selected time period. Link to Epidemic Thresholds report.
  2. Number of epidemic threshold Alarms in selected time period. Link to Epidemic Thresholds report. Perhaps #1 and #2 should be combined into a single number.
  3. Number of errors detected by system. Link to Errors Detected by System report. (Why don't we shorten this report name to System Errors?)
  4. Number of cases. Link to ??
  5. Cases without completed facility record 24 hours after facility notification. Link to Users Report - How Fast Are Followups Occuring (Occurring has two "r"s. Correct spelling). (Can we shorten the name of this report too? It's much easier to read and understand shorter text on the screen. How about "Followup by User"?
  6. Cases without complete household record 48 hours after facility notification. Same report link as #5?
  7. Median time from SMS sent to Case Notification on tablet Same report link as #5?.
  8. Median time from Case Notification to Complete Facility. Same report link as #5? 9 Median time from Complete Facility to Complete Household. Same report link as #5?
  9. Other? Trend in number of cases compared to previous time period?
gmcressman commented 8 years ago

We need input on which indicators should be displayed. I will ask Jeremiah.

gmcressman commented 8 years ago

Question sent to Jeremiah.

gmcressman commented 8 years ago

Jeremiah has not responded. And we need to move this forward now. We can always make changes later based on user feedback.

Limit the number of indicators at the top of the dashboard to 6. Each indicator tile will be linked to one existing report.

The indicators will be as follows:

  1. Number of epidemic threshold Alerts in selected time period. Link to Epidemic Thresholds report.
  2. Number of epidemic threshold Alarms in selected time period. Link to Epidemic Thresholds report. Perhaps #1 and #2 should be combined into a single number.
  3. Number of cases. Link to Analysis report.
  4. Cases without completed facility record 24 hours after facility notification. Link to Users Report - How Fast Are Followups Occurring.
  5. Cases without complete household record 48 hours after facility notification. Same report link as #5?
  6. Number of errors detected by system. Link to Errors Detected by System report. (Why don't we shorten this report name to System Errors? I'll add a separate issue about shortening report titles.)
mikeymckay commented 8 years ago

Here is the wishlist. 8 indicators. I think we will probably set the default date range to be from the beginning of the year to the present - but I am not totally certain about this.

ALERTS

ALARMS

NOTIFIED CASES

CASES NOT FOLLOWED UP

HSAT (ADDITIONAL POSITIVE CASES FROM HOUSEHOLD)

TEST RATE FROM HOUSEHOLDS (# people tested / # people in household - 1)

FSAT (ADDITIONAL POSITIVE CASES FROM FOCAL TESTING - (ACD))

PERCENT CASES SUSPECTED TO BE IMPORTED

gmcressman commented 8 years ago

IMPORTANT CORRECTIONS:

HSAT = Household Screening and Treatment (members of the index case household) FSAT = Focal Screening and Treatment (persons within a designated focal area , such as surrounding households within within 150 meters of an index case household) MSAT = Mass Screening and Treatment (e.g. all persons within a Shehia)

It is NOT clear to me how we apply HSAT. @mikeymckay - could it be that ZAMEP and Jeremiah are using other definitions of these terms? How are they defining them WRT Coconut Surveillance?

The first time I saw these terms was in Shannon Kincaide Godbout's Masters thesis on Coconut Surveillance (Duke Univ.). These terms don't seem to be widely used yet, but they make sense, are useful, and will probably catch on.

Incidentally, I've seen reactive case detection abbreviated as RACD and RCD. UCSF uses RACD, so that's what I'm using.

gmcressman commented 8 years ago

We'll need to shorted the text on the tiles.

# ALERTS
# ALARMS
# NOTIFIED
# NOT FOLLOWED UP
# HSAT
% HSAT TESTED
# FSA
% IMPORTED

We could use hover-over or some kind of help to provide more information about what these mean. We also need to link each of these to a report for more details.

Oh, and my question about MSAT above is irrelevant, since we're not dealing with that, at least not yet.

mikeymckay commented 8 years ago

From what I understand, focal screening could also apply when you setup a desk in a village and you invite people to come for testing. Mass screening really focuses on screening everyone - but I could be wrong about that. HSAT simply means that we want the number of positive cases (we also had a useful discussion about 'positive' vs 'suspected' - Jeremiah believes strongly in using positive) found at the household. Within Coconut Surveillance, on the Household Question Set the first question asks the reason for visiting the household: Index Case Household, Neighbor Household, Mass Screen. I added Mass Screen in an attempt to capture ACD (Active Case Detection) scenarios - but ideally it would probably be better to distinguish between Focal and Mass. So far Coconut Surveillance hasn't been used for any ACD/Focal/Mass screening, but if they can get enough tablets, it probably will be used in the coming months.

mikeymckay commented 8 years ago

@scloo - leave it to me to build the queries for you. Description for what is needed is below.

ALERTS - need a new view

ALARMS - need a new view

NOTIFIED - new combo view with reduce

NOT FOLLOWED UP - new comboe view with reduce

HSAT - new combo view with reduce

% HSAT TESTED - new combo view with reduce (need to add in household members to get baseline)

FSA - new combo view with reduce (need to add new field that reports "mass screen" for reason for visiting household)

% IMPORTED - new combo with with reduce (need to add new field to extract "imported)

gmcressman commented 8 years ago

Done.

mikeymckay commented 8 years ago

Pasting in from slack:

HSAT is in caseCounter: "Number Household Members Tested Positive" Let's ignore FSAT, since it's been 0 thus far @stephen ^^^^^ that should give you alert and alarm counts. Turn reduce on. (alertAlarmCounter)