NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In reviewing imaging search results, it is important to understand the hierarchy of submissions in NBIA. For more information, see #Relationship of Patient to Study to Series to Images.

If you run a search before configuring column and sort display parameters, only the Subject Identifiers for the patients/images that meet the criteria and a column containing one check box per row display by default. An example displays in the following figure.
"With imaging criteria only and no column definition

...

You can set display parameters for the results on the Columns and Sorting tabs. For more information, see on page 60 #Results Type Tab.
See also #caIntegrator and NBIA, [#Retrieving DICOM Images and #Example of Retrieving Images.

...

Images can be accessed in NBIA if you see buttons on the Search Results page. See the Imaging Note in on page 60 #Results Type Tab. You can click links on the Search Results tab to view or download image data.

  • View in NBIA – This link corresponds to each Image Series listed in the results table. If you click the link, NBIA opens to the login page. After you log in, NBIA brings up the first image in the corresponding image series; an example is shown in the following figure. You must log into NBIA to see the data. On the NBIA page that opens, you can opt to view the entire series containing this image, or you can display the image as a large JPEG-formatted image. You can also add the image to the NBIA basket. For more information, see the NBIA online help or user's guide accessible from NBIA.
    An example of displaying the first image in image series
  • Forward to NBIAsearch results:forwarding imaging results to NBIA;NBIA:forwarding imaging results toThis This button is linked to results you have selected by row. Click the button to open NBIA, where the image series you select are loaded in the NBIA image basket. In the event that the caIntegrator study was NOT configured with image annotation for an image series, caIntegrator sends NBIA a list of Study Instance UIDs, for which NBIA will add all corresponding image series to the basket. In the event that the caIntegrator study was configured with annotations for an image series, the system sends NBIA a list of Image Series IDs, for which NBIA adds all corresponding image series to the basket.

Retrieving DICOM Images

On the Imaging imaging data Search Results page, you can click the Retrieve DICOM Images button which is linked to results you have selected by row. caIntegrator retrieves the corresponding image(s) from NBIA through the grid. NBIA organizes the download file by patient ID, StudyInstance UID, and ImageSeries UID, and compresses it into a zip file. When caIntegrator notifies you that the file is retrieved, the DICOM Retrieval page indicates whether the retrieved files are Study Instance UIDs or Image Series UIDs, shown in the following figure. For more information, see the note below.
DICOM Retrieval result

Click the Download DICOM link to download and save the file. caIntegrator unzips the file and displays the list of images in the file. To open the DICOM images, you must have a DICOM image viewer application installed on your computer. For more information, see http://dicom.online.fr/fr/download.htm.

In the search results, not all of the patients subjects in the data subset may be mapped to image series IDs. If you select a mixture of patients that subjects, some of whom have image annotations as indicated by an image series ID and patients that some of whom do not have image annotations (no image series ID), when you click the Retrieve DICOM Images button, NBIA retrieves the images for the entire NBIA study instance UID that includes the image seriesIDs you checked.

If on the Search Results tab you select only patients subjects that have image annotations as indicated by an image series ID, when you click the Retrieve DICOM Images button, NBIA retrieves images for the NBIA image series that were matched in the search. If the results are a mixture, but you select one specific row with a valid image annotation, caIntegrator aggregates to the image series. If results are a mixture and you select multiple rows, caIntegrator aggregates to the NBIA study in which multiple image series you have selected in the search results are found.

...

To best understand this, it is important to review the hierarchy of submissions in NBIA. For more information, see #Relationship of Patient to Study to Series to Images. See also

Example of Retrieving Images

...

  1. Open a study that has imaging data associated with it that points to the production NBIA server.
  2. Make a query that will have image series or patients who are associated to Image Studies and select a few of those patients in the check box.
  3. Click the Retrieve Dicom Images button. Note that it aggregates to the image study.
  4. Now go back to Results Type tab, select all image annotations and run the query again.
  5. Select an image series type column and click the Retrieve Dicom Images button. caIntegrator now aggregates to the Image Series that were selected and not the Image Study.
  6. Select a row that doesn't have image series data, and a row that does, and push the button. This should aggregate to the study for the rows selected.
  7. Click Forward to NBIA. You should see the same types of aggregation for these tests.

When the image Study is in the checked boxes (regardless of image series being there or not), the system aggregates up to the Image Study level.

Include Page
caIntegrator:Relationship of Patient to Study to Series to Images
caIntegrator:Relationship of Patient to Study to Series to Images

Exporting Data

search results:exporting data;exporting:dataYou You can choose to download tabular search results as a CSV file. Click the Export .csv link at the bottom of the page. You may need to scroll the page to see it. The file contains the annotations, columns and data sort configurations you specified in the search query.

...