...

This i2b2 web client plugins enables a user to visualize the demographics of a subset of a patient set, as well as those subsets that are  associated (observed) with certain concepts any various counts of observations of a selected concept (ontology termsterm).

This plugin provides the following main functions:

• Generates demographic histograms on the subsets of patients associated (observed) with any selected concepts various counts of observations of a selected concept (ontology termsterm).
• Allows the use usage of smaller queries of patient subgroups (from a large patient set) iteratively, in place of one single large query of that huge patient set, to reduce risk of overwhelming the server (i2b2 hive).
• Allows selection of subset of patients from a large patient set, to further reduce risk of overwhelming the server.
• Allows selection of the appropriate grouping of observation tallies against which to generate the resulting histograms.
• Provides feedbacks on current progress, elapsed time, and estimated remaining run time.
• Provides notification & suggestion in cases of paging (query-subgrouping) by the server.
• Provides termination indication & suggestion (for recovery) when the server failed.
• Provides detailed 'HELP' and 'HINT' dialogs in response to corresponding hotlinks strategically placed next to input fields that may need explanations or suggestion.

...

1. Navigate to the "Specify Data" tab. Drag and drop a Patient Set and one or more concepts a concept (ontology termsterm) onto the appropriate input boxes:## 
   • Enter appropriate values in the 'Starting Patient' and 'Number of Patients' fields that are then presented, to specify the subset of the patient set to use. Also specify at the 'Query Subgroup Size'
    field
   • field the size of smaller queries of subgroups of patients to be used iteratively, to facilitate reducing the risks of overwhelming the server (i2b2 hive).
   ## 
   • Click on the corresponding 'HELP' hotlinks next to the 'Starting Patient' and 'Number of Patients'
    fields
   • fields, and
   the
   • the 'HELP' hotlink next to the 'Query Subgroup Size' field, for detailed information; and enter corresponding appropriate values.
   ## 
   • Click on the corresponding 'HINT' hotlink below the 'Concepts' field for hint or suggestion for selecting concepts.
2. Next, select the appropriate grouping of observation tallies against which to generate the resulting histograms at the "Output Options" tab Image Added
3. Finally, select the "View Results" tab to wait for and view the generated demographic histograms.

Result Example 1

Grouping observation tallies in sequence of '1, 2, 3, 4, 5, 6, 7, 8, 9, over 9':

Image Added

Result Example

...

2

Grouping observation tallies in sequence of '1-2, 3-4, 5-6, 7-8, over 8': Image Added
 Image Removed

Caveats

1. Since it is possible for the server (i2b2 hive) to take a long time to provide all the data requested, this plugin provides occasional updates of 'Elapsed time' and 'estimated remaining run time', etc. displays while the data are being fetched. These displayed values are at best rough estimates based on occasional data coming back from the server. In the case of zero 'Query Subgroup Size' selected (i.e. no query-subgrouping), then there would be no data coming back from the server until either of the following situations:
   1. The whole, single, query is done.
   2. The server itself started paging (i.e. query-subgrouping), and the result of the 1^st of such paged subqueries just arrived.
   3. The server got overwhelmed by all the excessive data and failed, returning an 'error'.
2. In any of these cases above, the updates of 'Elapsed time' and 'estimated remaining run time' will be quite infrequent, as updates from the server (i2b2 hive) will most likely take a long time, and far and few in-between, if any.
3. This plugin also tries to provide updates on the current subgroup the server (i2b2 hive) is fetching. However, in the cases when the server (i2b2 hive) itself started paging (i.e. query-subgrouping), then the current subgroup # being fetched may exceed the original stated total number of subgroups.

...

The latest version of this web client plugins can be downloaded from its Codeplex download page.