TimeAlign: Exploratory Visual Analysis Plugin for Temporal Events  

Contributed by the Human-Computer Interaction Lab at the University of Maryland, College Park

Description

The TimeAlign plugin for i2b2 is a visual analysis tool for temporal categorical data from for multiple patient records. It visualizes multiple patients' medical history. Each history contains a set of relevant categorical events (ex. diagnosis, prescription, intervention, room change, admission, discharge, etc). TimeAlign displays the records and their events in a linear, zoomable timeline that allows investigators to quickly grasp the temporal relationships of important events.

Features

TimeAlign lets investigators explore the data via its simple but powerful interaction mechanisms. At the heart of it is the Align-Rank-Filter (ARF) framework. Investigators can align all patients by some an important first occurrence of an event and discover how other events are related to it. For example, by aligning patients by their first heparin injectionexposure, investigators can examine if the event of low-platelet reading occur more frequently as a potential signal for heparin-induced thrombocytopenia. Ranking, for example, can reorder order patients by the number of low-platelet reading events from highest to lowest. Finally, filtering lets investigators to narrow down patient population by event characteristics: show only patients with at least three exposures of heparin (filter by event count), or show patients who have never had a surgical procedure followed by heparin exposure followed by low-platelet count (filter by an event orderingsequence).

In addition, distribution of events over time can be shown. Groups of patients can be created via filtering. Distribution of groups can be compared. All these features let investigators visualize and interact with the data, explore potentially interesting temporal relationships, formulate hypotheses, and hopefully discover new findings.

History and Lifelines2

i2b2's TimeAlign plugin originates from the Lifelines2 project from in the Human-computer Interaction Lab in the University of Maryland at College Park. Lifelines2 was a PhD dissertation project from part of the doctoral dissertation by Taowei David Wang, under the supervision of Ben Shneiderman and Catherine Plaisant. Taowei has since graduated and is now part of the broader i2b2 team, creating different other plugins for the i2b2 platform.

Download and Setup

Quick Start

This is the home of the Related Project – TimeAlign space.

To help you on your way, we've inserted some of our favourite macros on this home page. As you start creating pages, blogging and commenting you'll see the macros below fill up with all the activity in your space.

...

...

...

Selected Publications for Lifelines2

...

• Taowei David Wang, Amol Deshpande, and Ben Shneiderman, A Temporal Pattern Search Algorithm for Personal History Event Visualization, IEEE Transactions on Knowledge and Data Engineering, 24(5), 799-812, 2012.
• Taowei David Wang, Krist Wongsuphasawat, Catherine Plaisant and Ben Shneiderman. Extracting Insights from Electronic Health Records: Case Studies, a Visual Analytics Process Model, and Design Recommendations. Journal of Medical Systems, Volume 35, Number 5 (2011), 1135-1152, DOI: 10.1007/s10916-011-9718-x
• Taowei David Wang, Catherine Plaisant, Ben Shneiderman, Neil Spring, David Roseman, Greg Marchand, Vikramjit Mukherjee, and Mark Smith. Temporal Summaries: Supporting Temporal Categorical Searching, Aggregation and Comparison, IEEE Transactions on Visualization and Computer Graphics, 15(6), 1049-1056, November/December, 2009.
• Taowei David Wang, Catherine Plaisant, Alex Quinn, Roman Stanchak, Ben Shneiderman, and Shawn Murphy. Aligning Temporal Data by Sentinel Events: Discovering Patterns in Electronic Health Records, Proceedings of the Twenty-sixth Annual SIGCHI Conference on Human Factors in Computing Systems (CHI '08), 457-466, 2008.

Visit Lifelines2 for more papers and other related projects.

Download and Setup

Prerequisite: i2b2 Workbench 1.5 or above.

1. Download the TimeAlign plugin (.jar).
2. Place the downloaded .jar file in your i2b2 workbench's workbench/plugins directory (picture).
3. Launch your i2b2 Workbench and log in. Select from menu: Window -> Show View -> Other... -> Align-in-time Category -> Align-in-time View to launch TimeAlign. If you do not see Align-in-time Category, please read on.
4. Make sure your i2b2workbench.properties file contains the following line. (Picture) (Where to find i2b2workbench.properties?)

   Panel
   writeTimelineFile=yes

5. Make sure your configuration file workbench/configuration/config.ini contains only the following. You can safely replace the content of your file with the following.

   Panel
   #Product Runtime Configuration File osgi.splashPath=platform:/base/plugins/edu.harvard.i2b2.eclipse eclipse.product=edu.harvard.i2b2.eclipse.product osgi.bundles=org.eclipse.equinox.common@2:start,org.eclipse.update.configurator@3:start,org.eclipse.core.runtime@start osgi.bundles.defaultStartLevel=4 i2b2.homebase=https://www.i2b2.org/updateSite

Video Demonstration