mi2b2 Client for RPDR

Using the Image Library

The last tab of the new mi2b2 workbench is the Image Viewer. Here the user can finally view and perform actions on the material that was downloaded to the previously specified local folder.

This tab has a layout that is quite different from the previous tabs, as it is made up from three smaller panels. The first panel (24) in the lower left hand corner holds the Image Library, where the user can view and manage all studies that are still being transferred or otherwise housed in the Library directory.

The panel above it (25) is the Image Browser, which manages studies users wish to see first by patient, then by study, and finally by series. Images are viewed in the Image Viewer (26) on the right, and can be manipulated by using the tools provided below it (27).

Download Progress

Before they are able to be visualized in the Viewer, the images need to be successfully downloaded. They start downloading to the specified location immediately after the user clicks the Download Studies to My Computer button in the previous tab. The Library provides an overview of the download procedure by marking the studies that are ready to be visualized as Ready or by showing the download progress bar for the ones that are loading (28).


The Image Library (29) has a combo box listing the library’s current location. The user can select a different directory from the combo box drop-down menu, or use the Browse button (30) right next to it so to choose a different directory. In case there are studies undergoing download, the user can click on the Refresh button (31) in order to scan the current Library Directory and update the list of studies displayed. After being pressed, the refresh button turns into a red Stop button, and the user then has the option to cancel scanning. The Cancel-all button (32) cancels all ongoing downloads. Currently downloading or queued studies can be canceled and requeued with a downloaded study and click on "Open Containg Folder" to open the folder that contains the study.

The Library has a table listing all studies in the Library directory, including all studies in its subdirectories. There are seven columns:

  • The study’s checkbox which displays a red X if the material is not yet ready.
  • The MRN of the patient.
  • The study’s Accession Number
  • The date and time the study was downloaded by the user to the specified Library location.
  • The status of the download process
  • The size of the file.
  • The path to the study folder.
The Library persists over different sessions of mi2b2, and previously used Library locations are remembered. When you start mi2b2, the last known Library location is automatically loaded.


Selecting a study’s checkbox loads that study in the Browser (33). Unchecking the box unloads the study. Loaded studies are organized by patient (34), study (35), and then series (36). Selecting any element opens/closes the tree. Users can unload from the Viewer a patient/study/series by selecting the corresponding close button (37). The open file button (38) next to it will reveal the images of a series in their directory so users can easily use other software to view, annotate, or process the images.

Image Viewer

When the user selects a series from the browser, the Image Viewer automatically displays the corresponding images, starting with the first DICOM file contained in the folder. The Viewer consists of a viewing area (39), and a control panel below the viewing area (40). Users can use the appropriate scroll bars to iterate over frames of an open image or images of a series (41).


The control panels offer the user the possibility of performing some basic editing actions on the displayed images. The left part of the control panel shows a graph of image data statistics and controls to adjust maximum/minimum/contrast/brightness of the image (42). The Auto Adjust button cycles through some predefined settings (implemented by the ImageJ package that is used to display the images) - eventually users will cycle back to the original setting. The Reset button erases the adjustments the user might have made and recovers the original settings. On the right, there is a thumbnail of the displayed image (43) and the Zoom Controls (44).

Example workflow

The last series of screen shots demonstrate the use of the Image Viewer tab. The user previously loaded a selection of DICOM images corresponding to a cohort of patients.


The DICOM series of interest have now been successfully downloaded to the local space and are ready to be accessed and viewed


The user checks the studies belonging to the MRN cohort of interest in the Image Library. Their respective DICOM files show up in the Image Browser right above.


The user selects one of the series that he or she wants to visualize in the Viewer area. The toolbox offers the possibility to scroll through the different slices.


D, E, F. The zoom in/out and the Contrast/Brightness controls allow the user to manipulate the view of each slice displayed in the Viewer panel.