Familial, Associational, & Incidental Relationships (FAIR) Initiative.
Space shortcuts
Space Tools

Versions Compared


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

About the FAIR-conceptTracer Web Client Plugin


This plugin is part of the FAIR (Familial, Associational, & Incidental Relationships) Tool Set developed as a result of feedback and suggestions from the i2b2 users community in the University of Massachusetts Medical School. As its name implies, the purpose of this tool set is to facilitate a researcher in the pursuit of studies which may involve members of a patient's relationships of any defined types.
This plugin provides the following main functions:

  1. Tabulates all available FAIR members of each patient for a set of selected Patients.
  2. Allows selection of certain patients and their FAIR members for tracing concepts in them in tabulation.
  3. Optionally exports aforementioned tabulated data into an Excel spreadsheet file and / or a CSV file conveniently.


  1. Navigate to the "Specify Data" tab; then, drag and drop a desired Patient Set and one or more Concepts onto the input boxes provided.
  2. Click the "Select Subjects" tab to view the patients and their FAIR members.
  3. Select appropriate subjects for tracing the selected Concepts ("concept_cd") in the "related" individuals.
  4. Click the "View Results" tab to view the tabulated results.
  5. Optionally click the appropriate button to export the tabulated data into an Excel spreadsheet file and / or a CSV file conveniently.
  6. Optionally repeat steps 3-4 (or 3-5) to select different subjects and FAIRs for additional / different Concept tracing.



Browser Compatibilities

  • This plugin works on the following browsers: Firefox (v.4.0.1), Chrome (v.19.0), Safari (v.5.0.5), and Internet Explorer (v.8.0 & v.9.0.1).
  • The i2b2 Web client itself does not work on the following browser: Opera (v.11.50).

i2b2 Version Compatibilities

This version (v.1.0) of this plugin is developed on i2b2 v.

Version History


Inital release, for i2b2 v1.6.0.2.

(Q4 2012)





This plugin is free to the rest of the i2b2 community. It can be downloaded from the University of Massachusetts Medical School website for i2b2 related downloads, as well as the Google Code project download page set up for it.  

Terms of Use

This plugin is published under the GNU GPL v3 license

This software is distributed as a plugin to the i2b2 v1.6 webclient framework, and may be used free of charge. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

About Us

This plugin was created by S. Wayne Chan, Tom English, Rajani Sadasivam, Thomas Houston, & the Bio-Medical Informatics (BMI) Core Team, University of Massachusetts Medical School, Worcester, MA.

Copyright 2012 University of Massachusetts Medical School. 


This plugin leveraged off the following:

  • the general construct / format /style / template used in the i2b2 web client plugin examples by N. Benik & G. Weber.
  • the XLS export feature of the ExportXLS plugin by M. Bucalo, Universita' di Pavia.