mi2b2 Client for RPDR

IRB-protected access to patient information

Under the Patients tab of the new workbench, the user has access to the list of patients associated with the specific IRB-approved RPDR project.

Main panel

The main window of this tab contains five columns:

  • The patient’s EMPI number (one of the two unique identifiers)
  • The patient’s name
  • The patient’s gender
  • The date of birth
  • The patient’s MRN (the second unique identifier)
By clicking the selection boxes in front the of EMPIs the user can select or unselect the patients of interest. Alternatively, the Select All or Flip Selections buttons can be used.

The name of the RPDR project is displayed on the top left corner (1). The interface provides the user with supplementary information, like the name of the user (here masked for reasons of data sharing) and its status (2), indicated by a colored circle at the top right corner of the panel (green indicating an active status, red indicating that some core i2b2 services on the backend are not working). As every project is allocated an amount of storage space, there is a bar indicating the proportion of space taken up by data that has been successfully requested and received from the PACS.

Filtering menu

In all the tabs of the workbench interface - with the exception of the Image Viewer - the user has access to a panel of filtering widgets, always located on the right side of the tab. The user can show or hide this panel by clicking on the Toggle Filter(s) button. The mechanics behind filtering are simple and identical between the different tabs. There is a set of widgets corresponding to each column of the main table holding the information about the patients (in this case) or the studies (in other tabs). By appropriately selecting only the values users want to see in that column, the filter will automatically hide the rest.

There are three types of filter widgets in the new mi2b2 workbench.

  • The last type of filter is a text box (4), where the user can enter values which should be delimited by a space, a comma, or a carriage return. By using those boxes, the user has the option to enter the EMPIs or MRNs of specific patients and thus explicitly view information that belongs to this subset of people.
  • The second is a range slider (6). It is a scroll bar with two end points that users can move independently. The values between (and including) the two endpoints are the values that the users select, and the rest are filtered out. This type of filter is useful for values that can be meaningfully ordered, such as dates, or names. By default, a range slider selects all values in the table (nothing is filtered). The lower end point (minimum) and the upper end point (maximum) values are always displayed. The filter action takes place when users release the dragging action of the end point controls. Once a range is set, users can also drag the range thumb to move both the upper and lower end point controls simultaneously. Double clicking on the yellow portion of the range slider resets it.
  • The first type of filter widgets is a group of checkboxes (5). mi2b2 will filter out any checkbox that is not selected. By default, all checkboxes are selected (nothing is filtered).
  • The filter widgets can of course be used in combination with each other. For example, if the user wants to view only the female patients of MGH that were born later than 12/13/1962, he/she should select only the “Female” box under the Gender widget, move the Date of Birth slider till the desired date shows up on the left, and uncheck the BWH option from the Institution widget, as can be seen on the figure on the right.
  • A text message underneath the main viewing panel informs the user of how many patients correspond to the current filter settings. For example, after filtering according to the above criteria, the resulting patient set includes 28 patients, out of the initial 369.

Request studies

When the user has performed the desired filtering procedures on the available patient information, the next step is to request the Radiology information related to this cohort using the DICOM CFIND directive in order to establish a connection with the PACS. The user simply clicks on the Get Image Study Information for Selected Patients button, located at the bottom of the main panel (3). Then, the workbench automatically switches to the next tab: Studies.

Example workflow

The last section of each page of this online guide provides the reader with an exemplary workflow he or she would follow when using the particular Tab of the mi2b2 client for RPDR. The first of those case studies, dedicated to the Patients tab, walks the reader from the beginning of the procedure (logging-in to the client) to the point of selecting studies and requesting detailed data for them.


The log-in window, from where the user logs in using their MGB credentials.


The welcome screen of the new mi2b2 Workbench. The user inputs the passphrase associated with the IRB protocol of the particular project in order to access the next windows.


The main window of the Patients tab displaying the patient list specific to this project


The user selects the patients of interest in the main panel.


An exemplary use of the Selection filter (see above for full details of their functionalities).


The user can enter a list of MRNs specific to a patient cohort in order to access information from only those studies.


Filtering by gender is also an option.


Finally the user requests study information for the selected patients by clicking on the Get Image Study Information button.