Discovery Control Panel User Guide
Introduction
Discovery is built on open source XNAT. It allows you to:
- configure connections between PACS or VNA
- index the DICOM metadata
- manage data requests that come from Discovery Dashboard
- create data requests from a list of imaging study identifiers
Data requests can then be pulled as full imaging studies from your clinical imaging system and staged for further processing and analysis.
This document provides instructions to index a PACS or VNA and create data requests, as well as monitor both indexing and requests.
Instruction Steps
Indexing the PACS into Discovery
In order to get a cohort-centric view of DICOM metadata in Discovery Dashboard, PACS must be indexed. This is the first step in populating the data that will be used in your visualizations.
Once the Discovery plugin has been configured and the appropriate PACS and Service Class Provider (SCP) receivers are in place, Discovery indexing can be executed. (Note: more than one indexing job can run simultaneously, which will often increase throughput)
Executing an Indexing Job
Indexing jobs are handled on a per-date basis that correspond to the DICOM StudyDate tag. Execute for all days desired to visualize and build imaging cohorts from your PACS.
To execute an index job:
- Navigate to Site Administration in the top navigation menu and select Discovery Control Panel.
- Select the Indexing tab, and then select New Index Job.
- Choose the date range to index, select the Update Existing Records checkbox to update existing metadata.
- Select Begin Index. The time required for indexing will vary depending on the PACS system, network connectivity, and the number of studies that require indexing.
Viewing and Canceling Indexing Jobs
Indexing jobs can be monitored including job status and how many days are complete out of days requested.
To view, cancel, or restart indexing jobs:
- Navigate to Site Administration in the top navigation menu and select Discovery Control Panel.
- Select the Indexing tab.
- Depending on the job state, the indexing job can be canceled or restarted.
Viewing Indexing Status
Indexing progress can also be viewed based on DICOM Study Date. This can provide a general idea of what has been indexed and what is missing.
- Navigate to Site Administration in the top navigation menu and select Discovery Control Panel
- Select the Indexing tab
- At the bottom, a histogram displays a daily count of DICOM study dates that have been indexed. As indexing occurs, this histogram will be populated.
- The histogram can be viewed based on a preselected or custom date range, which can be selected from the View date range dropdown or by clicking and dragging on the histogram.
Data Requests
A data request is a collection of Study Instances or Accession Numbers that identifies a cohort of interest. Once a request is fulfilled, further analysis can be performed.
There are currently two methods to submit a data request to Discovery Control Panel:
- a Comma-Separated Values (CSV) upload
- a submission from the Discovery Dashboard.
To manage Data Requests, please follow the below steps:
- Navigate to Site Administration in the top navigation menu and select Discovery Control Panel.
- Select the Data Requests tab.
- Select a row in the Data Requests table to see more information about that request, including the requesting user, associated IRB number, number of studies requested, Discovery query details and the requested study identifiers.
Discovery Dashboard
- From the Discovery Dashboard, once you have filtered to the desired cohort, select the Request Cohort button. This will send the list of filtered studies to the Discovery Control Panel data request service.
- The request will remain in PENDING state until a site admin selects the Approve on the data request. More detailed information on dashboard filtering is available in the Discovery Dashboard Documentation.
Upload a CSV File
- To submit a Data Request, upload a CSV file containing either Accession Numbers or Study Instance UIDs with the appropriate header, see supported formats below.
- Choose New Request from the Data Requests screen
- Once the request has been submitted, it will appear in the Data Requests table in the Control Panel.
The CSV upload supports the following formats:
Approving a Data Request
A data request will be in PENDING state until an admin approves the request.
Prior to approving a data request, create a new project for the cohort project if it does not already exist. To create a project, go to New -> Project in the top navigation menu.
- Select the desired data request from the table.
- Select Approve Request which gives the option to link to a cohort project.
- Select a project to link to or Download Only and select Approve Request again to begin downloading.
Studies are only downloaded once from the source PACS and saved in an archive project. If a Link Request project is selected, the images will be available in this project upon completion.
Monitoring a Data Request
Select a data request from the table to get more details.
- PRE_PROCESSING - Study identifiers are being resolved on PACS
- PENDING - Request has been saved to the database and awaiting approval
- DENIED - Data request has been canceled
- PROCESSING - Request has been approved, queued for downloading
- DOWNLOADING - Imaging data downloading from PACS
- COMPLETE - All studies downloaded successfully
- COMPLETE_WITH_ERRORS - Finished processing, some studies in error state
- ERROR - Unexpected issue, admin is notified and request can be retried
- FAILED - Admin is notified and the request cannot be retried
Request Study Statuses
Each study has its own status with more details.
- REQUESTED: study has been requested as part of the data request
- QUEUED: study has been queued for retrieval from PACS
- DOWNLOADING: at least one instance from the study has been received from PACS
- DOWNLOADED: all instances from the study have been received from PACS
- AVAILABLE: study is available for use in the data request project
- ERROR: there was an issue during any step in the process. See the status message for details.
Data Request Linked Cohort Project
This project provides a view into the cohort requested by the researcher. Data can be analyzed and processed further in this project, or it can be sent to Flywheel Core using the Flywheel Integration container.
Resources
Discovery Dashboard Quick Start