Skip to end of metadata
Go to start of metadata

Overview

Search for Studies

Users can search for patients via Medical Record Numbers (MRNs), and search for studies via these patients or, alternatively, Accession Numbers (ANs). Both of these search tasks follow the same communication diagram to the left.

In mi2b2 client's Tab 1, users can enter a list of MRNs and search on the PACS to find the list of corresponding patients. Once the list of patients is found, users can use these patients to find a set of DICOM studies corresponding to these patients. Alternatively, if the users already have a list of ANs, they can enter them in Tab 2 and search on the PACS for these studies. Finally, after a list of studies is obtained, users can select the desired ones and request the studies to be copied to the remote repository (cache).

Request Studies

mi2b2 client sends requests to the mi2b2 server, which, in turn, asks the PACS to copy these studies into mi2b2 server's repository (cache). The copying of studies is done via the DICOM C-Move 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). As such, the time it takes to fulfill each request is highly dependent upon the mi2b2 server's configuration, PACS access policy, load, and availability. Once the studies are available in the mi2b2 cache, users can later download them onto their own local machine.

View Requests

As the transferring of studies from PACS to mi2b2 server is asynchronous, users can check the request status by asking the mi2b2 server. This is executed whenever user visits the Request Log tab or click on its "refresh" button.

Videos

Requires Flash Player

A detailed look at Search for Patients and Search for Studies tabs. Learn how to

  1. Search patients by MRNs.
  2. Import a text file of MRNs.
  3. Interpret the search status report.
  4. Use append and overwrite modes in search.
  5. Export table data.
  1. Search patients by accession numbers (ANs).
  2. Request studies to be retrieved from PACS to the mi2b2 server repository.
  3. Check request status.
  4. Prioritize requests so some requests are delivered before others.
  5. Cancel ongoing requests.
  6. Delete old request entries.

Please note that the video is based on mi2b2 1.2.00. Interface differences (including tab ordering) exist in 1.3.0 and up, but should not impact functionality or workflow shown here.

Search by Medical Record Numbers (MRNs)

If you have a list of MRNs, you can search for studies of the patients with these MRNs.

Initialization

This is a screenshot of the mi2b2 client's Tab 1 at the start.

1. (Select an Institution) Users must first select an institution and an institution against whose PACS the search will be performed.
2. (Select a Department) Once an Institution is selected, the department dropdown box becomes active. The default value is "All Departments".
3. (Clear MRNs in the Text Area) Users can clear the values in the current text box by clicking on this button
4. (Import MRNs from a File) Users can import MRNs stored in a text file (.txt). The MRNs must be comma- or newline- separated.
5. (Scout for Patients with the MRNs in the Text Area) Click this button to execute the search. This button is only activated when there are MRNs in the text area, and an institution and a department have been appropriately selected.
6. (Append or Overwrite the Result Table) Users can designate whether the results of the next "Scout for Patients" action will append to the current result table, or overwrite it.
7. (MRN Text Area) This is the text area where users can enter MRNs directly.

After Scouting for Patients

After scouting has been performed, the results are shown in a table. If "Append" has been selected, the results would be added to the existing table. If "Overwrite" has been selected, the results would overwrite the existing table. Additional buttons are also activated.

1. (Scout Statistics) mi2b2 client reports how many patients are in the current table. The number of newly patients found in the last scout is listed in parentheses. Statistics of the MRNs submitted in the last search is also reported. Links are provided to view MRNs that are duplicates or not found. Users can use the links to examine these MRNs and export them.
2. (Selection Controls) Users may use "Select All" and "Flip Selection" to select patients listed in the table. By default, all results are selected.
3. (Toggle Filters) Users can toggle show/hide filter controls. Filter controls allow users to refine the results shown in the table. All filtering actions are performed on the client side exclusively.
4. (Result Table) Results of the scout is shown in this table. Each row contains a patient. If more than one patient share the same MRN, then these patients show up as a single entry with an expandable button (see the patient with MRN = 4). Users can see all patients by clicking on the expand button. Users can sort by MRNs (cycling through ascending/descending/original order) by clicking on the MRN column header. However, this is the only column users can sort by.
5. (Export Table Content) Users can export the entire content of the table or the selected rows by using these buttons. The content is exported to a text file (.txt).
6. (Find Studies for Selected Patients) After selecting patients of the right gender and age, users can click on this button to ask mi2b2 to retrieve a list of studies associate with these patients. This button will transition users to Tab 2 (see below).

Search by Accession Numbers (ANs)

Users are transitioned to Tab 2 after selecting "Find Studies for Selected Patients" from Tab 1. Alternatively, users can directly enter Tab 2 and enter a list of ANs to search for studies.

Initialization

This is a screenshot of the mi2b2 client's Tab 2 at initialization. The layout and functionality are similar to that of Tab 1. The only difference is that in Tab 1, the user inputs are MRNs, and here the user inputs are ANs.

1. (Select an Institution) Users must first select an institution and an institution against whose PACS the search will be performed.
2. (Select a Department) Once an Institution is selected, the department dropdown box becomes active. The default value is "All Departments".
3. (Clear ANs in the Text Area) Users can clear the values in the current text box by clicking on this button
4. (Import ANs from a File) Users can import MRNs stored in a text file (.txt). The ANs must be comma- or newline- separated.
5. (Find Studies with the ANs in the Text Area) Click this button to execute the search. This button is only activated when there are ANs in the text area and an institution and a department have been appropriately selected.
6. (Append or Overwrite the Result Table) Users can designate whether the results of the next "Find Studies" action will append to the current result table, or overwrite it.
7. (AN Text Area) This is the text area where users can enter ANs directly.

After Searching for Studies

Users can get to this point either from "Find Studies for Selected Patients" in Tab 1 or by Find "Studies with the ANs in the Text Area" in Tab 2.

After searching for studies has been performed, the results are shown in a table. If "Append" has been selected, the results would be added to the existing table. If "Overwrite" has been selected, the results would overwrite the existing table. Additional buttons are also activated.

1. (Search Statistics) mi2b2 client reports how many studies are in the current table. The number of newly added studies found in the last search is listed in parentheses. Statistics of the MRNs or ANs submitted in the last search is also reported. Links are provided to view MRNs or ANs that are duplicates or are not found. Users can use the links to examine these MRNs and export them.
2. (Select a Department) Once an Institution is selected, the department dropdown box becomes active. The default value is "All Departments".
3. (Clear ANs in the Text Area) Users can clear the values in the current text box by clicking on this button
4. (Import ANs from a File) Users can import ANs stored in a text file (.txt). The ANs must be comma- or newline- separated.
5. (Find Studies with the ANs in the Text Area) Click this button to execute the search. This button is only activated when there are ANs in the text area and an institution and a department have been appropriately selected.
6. (Append or Overwrite the Result Table) Users can designate whether the results of the next "Find Studies" action will append to the current result table, or overwrite it.
7. (AN Text Area) This is the text area where users can enter ANs directly.

View Request Status

After submitting studies to be transferred from PACS to mi2b2 repository in Search for Studies tab, a notification pops up to invite users to go to the Request Log tab. 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.

Below is a screenshot of the mi2b2 client's Tab 5. The table shows all requests that have been submitted to the mi2b2 server and their statuses. Users can see what requests have been completed and ready for download, and which ones are still being processed.

Each request has a status (column 2). A request's status typically transitions from Scheduled to Processing to Completed. When an error occurs, the status will be Error. Sometimes not all images in a study are retrievable from the PACS. When this occurs, the status is Incomplete (incomplete retrieval). Although these studies are missing some images, users can still download them. Finally, after a request is canceled, the status is Canceled.

Users can cancel any ongoing request (Scheduled or Processing). Users can delete requests of any status.

When a request is Scheduled, users can adjust the priority (column 6) of ongoing requests. mi2b2 server will fulfill requests with higher priority first, and lower priority last. However, this priority has no effect on PACS availability, nor how soon PACS can deliver the studies to the mi2b2 server.

Request Log UI Layout

1. (Managing Requests) Users can cancel any ongoing requests using the "Cancel Selected" button. Canceled requests have the status Canceled. Users can also delete any requests using the "Delete Selected" button. By selecting a priority and click on "Apply", users can change the priority of requests to High/Normal/Low. Normal is the default priority.
2. (Managing Table Contents) Users can use the "Refresh" button to get the latest version of this table. Users can toggle the filter UI by using the "Show Filters" button.
3. (Request Table) This table shows all the requests that have been submitted to the mi2b2 server.

Completing a study request means the requested studies are retrieved from PACS and stored in the mi2b2 server repository. If this task is successful, the status for related studies will show Complete. At this point, users can go to the Image Repository tab to download them onto the users' local machines. See Download Studies for more information.


  • No labels