Import CDS data

📘

For information on currently available CDS data on the CGC, the details and history of CDS data updates.

📘

If you are working with the PHS002011 dataset, download the PHS002011 manifest file.

About the CDS

The Cancer Data Service (CDS) is a data repository under the NCI's Cancer Research Data Commons (CRDC) infrastructure for storing cancer research data generated by NCI funded programs. Its data is stored in the Database for Genotypes and Phenotypes (dbGaP) database provided by National Center for Biotechnology Information (NCBI). CDS hosts datasets that contain controlled access data, with access permissions being controlled by dbGaP.

CDS data can be imported to the CGC in the following ways:

🚧

If you are trying to import data classified as controlled from CDS to the CGC, you need to be logged in to the CGC using an eRA Commons account with access to controlled data.

Please note that the Seven Bridges team strives to keep the data available for import on the CGC aligned with CDS data updates. However, CDS updates are not instantly available for import on the CGC. Find out the currently available releases of CDS data on the CGC.

Import CDS data using the Cancer Data Service Explorer 

📘

Please note

The CDS Explorer will be deprecated on July 1st 2024 and all the datasets will be available on the CDS Portal.

Cancer Data Service Explorer is an integrated dataset file explorer on the CGC that allows you to filter and select the exact data that you want to analyze further, and then perform a seamless import into a project on the CGC using the steps described below:

  1. While on the CGC's main dashboard, on the main menu bar click Data > Cancer Data Service Explorer.
  2. Click Explore files. File explorer opens.
  3. Use the search boxes and filters in the left pane to select the data that you want to analyze further.

  1. Once you have selected your set of data, click Copy to project in the top-right corner. Copy dialog opens.
  2. In the Select project dropdown select a project that you want to export the files to. If you want to import data to a new project, click Create new project. If the import contains controlled data, such data can only be imported in a controlled project.
  3. (Optional) Once you have selected a project, enter file tags in the Add tags field.
  4. In the Resolve naming conflicts dropdown select the action to be taken if a file with the same name already exists in the target project.
  5. Click Copy. Your files will be exported to the selected project.

Import CDS data using a manifest file 

The process of importing CDS data to the Cancer Genomics Cloud (CGC) using a manifest file generated through SRA Run Selector consists of the following two stages:

  • Searching for data and downloading a manifest file from SRA Run Selector.
  • Importing files to the CGC based on the downloaded manifest file.

Download CDS manifest files from SRA

Manifest files contain information about the data you want to import in the second stage of this process.

To download a manifest file:

  1. Open the SRA Run Selector.
  2. In the Accession field enter the accession of your choice and click Search. The list of search results opens.
  3. (Optional) In the Filters List section on the left, select the criteria to narrow down the result list.

Now you can proceed to do the following:

  • Download the manifest file for the entire set of data returned for the accession:
  1. In the Select section, click Metadata in the Total table row. This downloads the manifest file for all data for the accession.

  • Select specific items from the list and download manifest file for the selected items only:
  1. Scroll down to see the list of items that match the search and filtering criteria.
  2. Check the boxes next to items you want to select.
  3. In the Select section, click Metadata in the Selected table row. This downloads the manifest file for the selected data only.

Import CDS data to the CGC

When you have downloaded a manifest file from SRA, follow the steps below to import the data to the CGC:

  1. Navigate to a project on the CGC or create one. If the manifest file includes references to controlled data, such data can only be imported in a controlled project.
  2. Once in the project, click the Files tab.
  3. Click Add files > Import from a manifest file.
  4. In the Import files from dropdown, select Cancer Data Service (CDS).
  5. Click Browse files and select the manifest file from your local machine, or drag and drop the file onto the marked area. Alternatively, if you have already uploaded your generated manifest file to a project, click Select manifest from project and select the file.
  6. (Optional) In the Add tags field add the keywords (tags) that describe the imported items.
  7. Resolve naming conflicts - Select the action to be taken if a naming conflict occurs. Available actions are Skip (default option) and Auto Rename. Read more about naming conflicts resolution.
  8. Click Import. The file import process starts and you are taken to the Files tab.