TimeAlign
Space shortcuts
Space Tools

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

TimeAlign: Exploratory Visual Analysis Plugin for Temporal Events  

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

      Authors: Taowei David Wang, Ben Shneiderman, Catherine Plaisant
      Related Project: Lifelines2

Image Added

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.

...

Column
width75%
Recently Updated

...

width5%
Column
width35%
Navigate space
Page Tree Search
Page Tree

...

Selected Publications for Lifelines2

...

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

 

TimeAlign Getting Started video

 

Older LifeLines2 videos from HCIL

 

Video

Image Added



Image Added

Image Added

Format

.mp4 (download size: 81.4MB)

 

.swf (view in browser, where Flash Player is required)

.sfw

Run Time

5.28

 

4:58

8:11

Description

Demonstrates how to
1. launch TimeAlign
2. create data via i2b2's query services
3. navigate around timeAlign's basic features

 

Scenario 1: Identifying potential patients with contrast-related nephropathy.

Scenario 2: Investigating heparin-induced thrombocytopenia.