mi2b2
Space shortcuts
Space Tools
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 62 Next »

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 cache (below).

Request Studies

The mi2b2 client sends requests to the mi2b2 server, which, in turn, asks the PACS to copy these studies into mi2b2 server's own cache. The copying of studies is done via the DICOM C-Move directive, and is executed asynchronously by the 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 Tab 3 or click on Tab 3's "refresh" button.

Videos

Requires Flash Player


(video length: 3:08).

A detailed look at Tab 1, Search Patients by MRNs. 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.


(video length: 3:25).

A detailed look at Tab 2 and Tab3, Search Studies by Accession Numbers and Request Studies. Learn how to

  1. Search patients by accession numbers (ANs).
  2. Request studies to be retrieved from PACS to the mi2b2 server cache.
  3. Prioritize requests so some requests are delivered before others.
  4. Cancel unwanted requests.
  5. Configure download settings to apply encryption with a previously generated key file.

The video demo continues in this follow-up video.

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

Users are transitioned to Tab 3 after selecting "Request Selected Studies" from Tab 2 or by clicking on the tab directly. 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 3. The table shows all requests that have been submitted to the mi2b2 server and shows their statuses. Users can see what requests have been fulfilled 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 In Process 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). Finally, after a request is canceled, the status is Canceled.

Users can cancel any ongoing request (Scheduled or In Process). 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.

Finally, availability (column 5) shows if the study associated with a request is available for download. That is, the request has completed, and the study is already in the mi2b2 server cache.

Request Management 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.
4. (Download Location) Users can select where to store the downloaded studies using the dropdown box and the button to browse for a new location.
5. (Encryption) Users can select whether to encrypt downloaded studies. The default value is to use encryption, however, if the download location conforms to the data safety and confidentiality policies outlined in each individual user's approved IRB, users may choose to not encrypt the downloaded studies. For encryption options and on how encryption is used, please see Encryption.
6. (Encryption Indicator) This indicator shows whether a download action can be performed. When it is red, the download button is disabled. When it is green, the download button is enabled. The indicator will show green only if (1) Encryption is selected, and an encryption key is supplied, or (2) User oped to use no encryption.
7. (Download Selected Studies) Users can select this button to download the selected studies to the download location using any encryption settings that has been specified.

Completing a study request means the requested studies are retrieved from PACS and stored in the mi2b2 server cache. If this task is successful, the status for related studies on Tab 3 will show Complete, and the availability will be affirmative. At this point, users can select these studies and click on "Download Selected Studies" to download them onto a location the user chooses. See Download Studies for more information.


  • No labels