User Visualization Requirements
v 0.01 23-May-2014
Authors: M. Price
The purpose of this document is to capture requirements for visualization so that we can explore the use of D3 as a visualization component and to, then, drive future validation of requirements.
- Show enough information to be accurate.
- Do not show to much information.
- Consistent conventions over customization.
- Provide easy entry into the data through standardized reports and dashboards with meaningful labels and descriptions.
- Users will not be able to, in release 1 of the visualization hub, create or run their own queries. This will be done by the question manager or automatically at fixed intervals.
- Detailed narrative reports will be completed outside of the Hub. (e.g. for research publications, specific reports for divisions, Physicians Data Collaborative).
- We will us D3 layouts and adjust requirements to match where needed, avoiding complex D3 development at the start.
- For specific custom graphs, we will assume that the question manager will develop with the questioner and that a reasonable set of standard graphs (with some level of customization) will meet most common needs.
- Users will access the Hub through their desktop / laptop
- We can define the browser requirements and do not have to support all browsers.
- Users will not use the system on a daily basis and will not become experts. The majority of users will remain novice users.
- The small number of expert users will work with the Network Question Manager to meet their more detailed requirements.
These are currently not in a specific order. Numbering will come later.
We should split these features into separate files at some time.
Feature: xx-xx Visualize simple network query result.
In order to visualize a simple network query with a single aggregated numerator and denominator.
A validated result user should be able to
See the network query result in a clear bar graph format with axes marked and with appropriate labels showing the overall result for the whole network.
Example: Percent of active patients in a practice who have one or more allergies or no-known allergy documented.
Feature: xx-xx Visualize network query result with multiple numerators
In order to visualize a network query with multiple aggregated numerators and single denominator.
A validated result user should be able to
See the network query result in a clear stacked bar graph format with axes marked and with appropriate labels showing the overall result for the whole network.
Feature: xx-xx Show detail of graph element
In order to see the specifics of a graph element such as a bar in a bar graph
A validated result user should be able to
Select the graph element and see additional information (e.g. the numbers)
Feature: xx-xx Select visualization for a specific query
In order to ensure consistency of display of the information display
The Questioner through the Network Question Manager should be able to
Pre-define the results display for a query such that when validated users view results they will be seen in a consistent, meaningful manner.
Feature: xx-xx Compare groups of patients across the network at a point in time
In order to make meaningful comparisons between groups of patients
The Questioner should be able to
Select a results display that allows for multiple paired numerators and denominators to be shown on an ordinal histogram in a particular order.
Scenario:
Given the need to understand the average number of current medications in the network
And there is a need to understand if there is a gender difference in medication rates
Then the questioner should be able to design a query and display such that the results can be shown as male and female.
Scenario:
Given the need to understand the average number of current medications in the network
And there is a need to understand if there is a difference in medication rates based on age of patients
Then the questioner should be able to design a query and display such that the results can be shown in age brackets (e.g. 0-9, 10-19, 20-29...).
Feature: xx-xx View sub-groups of practices / practitioners at a point in time.
In order to compare pre-defined subgroups of practitioners / practices in the network
The Questioner should be able to
Pre-define the need and visualize subgroups of practices / practitioners in a histogram or stacked histogram format.
Example: STOPP study will need to compare intervention and control groups of physicians.
Feature: xx-xx Compare groups of practices / practitioners at a point in time.
In order to make comparisons between groups of practitioners / practices in the network
**WHO** should be able to
Adjust the results of a simple single bar graph or single stacked bar graph to show sub-populations of practices across the network in a histogram that will still ensure privacy of the existing practices in the network.
** NEED TO DECIDE WHO DOES THIS -- QUESTIONER OR VALIDATED USER **
Feature: xx-xx View a query set as a dashboard
In order to see a collection of related results
Validated User should be able to
View an pre-defined set of visualizations on a single view, showing enough information that the data makes sense.
Feature: xx-xx Create Dashboard
In order to provide validated users a consistent and meaningful experience
Network Question Manager should be able to
Create pre-defined dashboards that can be shared with validated users in the Hub.
Feature: xx-xx PITO ODD
In order to assess if users qualify for PITO funding
Validated User should be able to
Display a specific dashboard that shows all the ODD requirements clearly showing if the user meets the currently defined thresholds for each.
Feature: xx-xx Export aggregate results
In order to
Network Question Manager should be able to
DOTHIS
Feature: xx-xx Export visualized report / dashboard
In order to share their work with others
Validated End User should be able to
create a printable PDF of a dashboard with appropriate name and time stamps.
Feature: xx-xx Print PITO ODD
In order to qualify for PITO funding
Validated User should be able to
Create a PDF from the ODD dashboard that shows all the ODD requirements in a manner that would meet PITO conformance.
(Need to work into features)
There will be sets of pre-defined queries that users will want to review as a batch. for example the objective data dashboard.
Users will want to customize their own dashboards / result sets.
Users will trend data for longitudinally relevant questions and looking at changes over time.
Graph Types
- Bar
- Stacked Bar
- Line
- Scatter Plots
- Box plots
We will want to look at
- results across patient sub groups
- results across practice sub groups
- results over time (pre / post and time series)
Do we want to explore time series data within the Hub?
- This would be important for several questions and for QI activities over time. HOWEVER, it will require some level of data persistance. For studies, this can be handled outside of the network (e.g. the STOPP study will need to store the agregate results outside of SCOOP for at least 5 years).
SCOOP is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
