mi2b2 Client for RPDR

Finding the studies that correspond to the patient population of interest

The second tab of the new mi2b2 workbench is the Studies tab. The user has just requested Imaging Data information for the group of patients he specified in the previous tab. Here, he can view the information and perform filtering actions, before the final request of the Radiology material stored in PACS. The layout of the tab is very similar to the previous one: The main viewing panel allows the user to view the information related to the studies that correspond to the subgroup of patients he previously selected. The mi2b2 filter menu can be found on the right of the viewing panel. Above the viewing panel there is a line reporting the search statistics, and informs the user of the number of studies that are in the current viewing panel.

Main panel

The main window of this tab contains eight columns:

  • The study’s Accession Number (AN).
  • The Radiology Report (when available).
  • The Institution in which the study was performed.
  • The MRN of the patient.
  • The date and time the study was performed.
  • The modality of the particular study. For example, Computed Tomography, X-Ray Angiography etc.
  • The study description: An entry that contains - often as acronyms - information that characterizes the image acquisition.
  • The Department in which the study was performed (Radiology in this case).
As a search is initiated in the previous tab (Patients) the user has the opportunity to cancel it by clicking on the red box next to the Search status bar (7). The MRNs that were cancelled are marked as failed and can be resubmitted by clicking on the resubmit failed ones button (8). In case of repeated failures, consider contacting the RPDR Help team.

A very important feature of this new release of the workbench is the ability of the user to perform a Radiology report text search of a specific study, when the report is available. With a simple click on the View button in the second column, the user opens the Radiology report (9).

Radiology report text search

The user can perform one other very important action: peruse the Radiology reports in search of desired keywords. The search bar (10) above the main viewing panel serves this purpose. For example, if the word “pain” is entered then only the studies that have Radiology reports containing this word show up in the viewing panel, as is shown in the following figure. When the report is opened, the keyword is highlighted in yellow.

Filtering menu

Just like the previous tab, the filtering menu contains one filter widget for every column of the main viewing panel. Again, there are three types of widgets, just like it was previously described: Checkboxes, range sliders and text boxes.

The user can filter the information by entering the Accession Numbers corresponding to studies of interest (11), or the MRNs (13) corresponding to a list of patients. The Report widget allows the user to view which studies come with a Radiology report (12).

Likewise, the user can use the sliders to define the study time period of interest. Also, the displaying information can be organized in terms of the modalities, by selecting/unselecting the corresponding checkboxes under the Modalities widget.

Search statistics

The mi2b2 workbench reports how many studies are in the current table (14). The number of newly added studies found in the last search is listed in parentheses. Statistics of the MRNs or Accession Numbers submitted in the last search is also reported. Links are provided to view MRNs or Accession Numbers that are duplicates or are not found. Users can use the links to examine these MRNs and export them by creating an output text file.

The output file can be imported into Excel (adjacent figure) and contains three columns: The EMPI number of the patient, the Institution name, and one last entry containing the MRN followed by the name of the patient.

Once the user has selected the studies that wishes to obtain Radiology Data from (by clicking on the checkbox in front of the Accession Number column) the final step is to submit the request so that the studies can be transferred from PACS to mi2b2 repository. This is done by simply clicking on the Move to Image Repository button underneath the main viewing panel (15).

The user then is automatically redirected to the next tab: Transfer Log. This tab allows users to view the progress of all submitted requests. Since this tab does not periodically check with the mi2b2 server for the latest statuses, users are encourage to visit this tab often or click on the "Refresh" button to get the most recent statuses.

The mi2b2 workbench then sends requests to the mi2b2 server, which, in turn, asks the PACS to copy these studies into mi2b2 server's repository (cache). The transfer of studies from the PACS to the mi2b2 remote image repository is done via the DICOM CMOVE directive, and it is executed asynchronously by mi2b2 server. Because accessing clinically utilized PACS may impact their performance, mi2b2 is typically configured to only access these PACS during downtime (when volume of clinical use is low).

Example workflow

The following captions demonstrate what the user can do after requesting detailed information for a patient cohort of interest.


Out of the six MRNs submitted in the previous tab, there are only three that offer detailed study information. In total, there are four studies found.


All of the studies found in this case come with an associated Radiology report. The user can click on the View button and access the report.


The user checks if the word “edema” shows up in any of the available reports. After typing it in the search box, only the studies with reports in which this word is included show up. When the report(s) is opened, the keyword is highlighted in yellow.


The user accesses the list of the MRNs and EMPIs that were not found by clicking on the corresponding link.


Finally the studies to be transferred from the PACS to the project-specific mi2b2 repository are selected and the request is submitted by clicking on the Move to Image Repository button