NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Revised the wiki page title.

...

Only users who have registered for and logged in to the CSSI DCC Portal can upload investigation data. During registration, you must also select the I would like to upload Investigation data checkbox and be approved. For more information, refer to Registering to Use the CSSI DCC Portal. If you need an administrator to delete an investigation version from a project, click the Contact Us link at the bottom of the screen.

Uploading ISA-Tab Files

Before uploading a file to the CSSI DCC portal, consult the ISA-Tab specification

Multiexcerpt include
MultiExcerptNameExitDisclaimer
nopaneltrue
PageWithExcerptwikicontent:Exit Disclaimer to Include
. This specification describes how to structure your investigation data to create an Investigation-Study-Assay tab-delimited (ISA-Tab) archive file. This may involve configuring it using open-source software
Multiexcerpt include
MultiExcerptNameExitDisclaimer
nopaneltrue
PageWithExcerptwikicontent:Exit Disclaimer to Include
made for this purpose.

...

  1. Log in to the CSSI DCC Portal.
  2. Select Investigations > Upload.
    The Upload ISA TAB Files page appears.
    Upload ISA Tab Files page
  3. Click New Project.
    The Project Properties page appears.

    Info

    A project is simply a container for the ISA-Tab file. It allows you to track multiple versions of ISA-Tab file uploads to this project.

    It is a best practice for each investigation to have its own project.


    Project properties page

  4. Enter a unique title for your new project. Note that this title and that of the ISA-Tab file that the project contains can be different.
  5. Click Save Project.
    The new project is listed under Investigation Projects.

    Info

    If the File Upload section of the page is not visible, click Open next to the project name to show it.


    Upload ISA TAB Files page with an unpublished project 

  6. Select the file you want to upload to this project in one of the following ways:

    • Drag and drop the ISA-Tab archive file from your computer to the Drop your files here box surrounded by the dashed lines:
      Drop your files here or click to browse

    • Click the Drop your files here box image and browse to where the file is stored.
      The file is listed in the File Upload area and the status is listed as Ready.

  7. If the file is 100 GB or smaller, click Upload selected files. If the file is larger than 100 GB, use Globus instead. 

    The file begins processing and the status moves through the following stages:

    • Uploading
    • Processing Queued    
    • Queued
    • Preparing uploaded files
    • Parsing ISA TAB Metadata    
    • Preparing Data Files    
    • Validating assay files and file sizes    
    • File processed successfully    
    • Success: file processed successfully  

    Once an administrator approves the upload request, the uploaded file appears as a new project version in the Investigation Projects section of the page. It is not yet published, so you must now publish it to use it in CSSI DCC. For instructions on previewing and publishing it, refer to Publishing ISA-Tab Files to the CSSI DCC Portal.
    Project with uploaded file processed successfully

    If needed now or later, click Edit to change the project name. 

    Show If
    groupGP-CFW_DES_DEV
    Info
    iconfalse
    titleNote Visible to GP-CFW_DES_DEV Users Only

    If your user account has a role with the Upload Files permission and Manage Investigations permission, a Delete button is available next to the Edit button. This button performs a "soft" delete of the project, which means that the data can be recovered, if necessary. For information, refer to Tentatively Deleting an Investigation Project.

    Portion of Upload ISA TAB Files page with Edit and Delete button.

Uploading Large Files with Globus

Globus is a service that enables large file transfers securely. You must have an account with Globus before you use it to upload investigation files to CSSI DCC. If you do not already have an account, you are prompted to create one when you start the upload process.

...

  1. Begin uploading your ISA-Tab file by creating a project in CSSI DCC and selecting a file. For more information on this process, go to Uploading ISA-Tab Files.
  2. On the Upload ISA TAB Files page, click Upload with Globus button.
    If you have not yet logged into Globus, a log in page appears.
    Log in to use Globus web app

    Info
    titleGlobus Documentation and Support

    For more information about using Globus, consult their documentation

    Multiexcerpt include
    MultiExcerptNameExitDisclaimer
    nopaneltrue
    PageWithExcerptwikicontent:Exit Disclaimer to Include
    and/or support
    Multiexcerpt include
    MultiExcerptNameExitDisclaimer
    nopaneltrue
    PageWithExcerptwikicontent:Exit Disclaimer to Include
    .

    After you successfully log in, the Globus Transfer Files page appears. One of the Endpoints you configured is already populated, though you can change it.
    Globus Transfer Files page

  3. Select the starting endpoint (on the left) where the file(s) you want to upload reside(s). Narrow down to the path if necessary. 
    Globus Transfer Files page with files selected.

  4. Confirm or change the destination endpoint (on the right).

  5. Click the right arrow button that points to the destination to begin the transfer request. A message briefly appears on the screen when the transfer request is submitted successfully. When the transfer succeeds, Globus sends a notification email message.
    Globus Transfer Files page, transfer request submitted successfully

  6. To view the resulting list of files in the destination endpoint, click refresh list on the right.
    Globus Transfer Files page after refreshing the list.
    Once an administrator approves the upload request, the uploaded, not-yet-published file appears as a new project version in the Investigation Projects section of the page.

  7. Since you have not yet published the uploaded file, you must publish it to use it in CSSI DCC. For instructions on previewing and publishing it, refer to Publishing ISA-Tab Files to the CSSI DCC Portal.
    Upload ISA TAB Files, Investigation Projects section

Understanding Upload Errors

Include Page
DSE:Understanding Upload ErrorsDSE:
Understanding Upload Errors

Controlling Access to Investigation Data

Include Page
DSE:Controlling Access to Investigation DataDSE:
Controlling Access to Investigation Data

Publishing ISA-Tab Files to the CSSI DCC Portal

Include Page
DSE:Publishing ISA-Tab Files to the CSSI DCC PortalDSE:
Publishing ISA-Tab Files to the CSSI DCC Portal

Editing or Removing the Embargo Date for an Investigation

Include Page
DSE:Editing or Removing the Embargo Date for an InvestigationDSE:
Editing or Removing the Embargo Date for an Investigation

Viewing Publish History

Include Page
DSE:Viewing Publish HistoryDSE:
Viewing Publish History

HTML Comment
hiddentrue

Unpublishing ISA-Tab Files

After publishing a file, you may want to unpublish a version of it to remove that version completely from the CSSI DCC server.

Info
titleAccess Control and Unpublishing

When you unpublish a file, all access restrictions that may have been applied to it are removed from the investigation. If you decide to publish this investigation later, you must reapply any access restrictions you want.

To unpublish an ISA-Tab file

  1. Open a previously published file.
  2. Next to the version you want to unpublish, click Unpublish.
    The status of this version becomes Unpublication Request Pending. Once an administrator approves the request, the version returns to its unpublished state.

...