NIH | National Cancer Institute | NCI Wiki  

WIKI MAINTENANCE NOTICE

Please be advised that NCI Wiki will be will be undergoing maintenance on Monday, June 24th between 1000 ET and 1100 ET.
Wiki will remain available, but users may experience screen refreshes or HTTP 502 errors during the maintenance period. If you encounter these errors, wait 1-2 minutes, then refresh your page.

If you have any questions or concerns, please contact the CBIIT Atlassian Management Team.

Versions Compared

Key

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

...

  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 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

    Info

    If needed now or later, click Edit to change the project name. Depending on your privileges, you may not see the Delete button.

  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.

      Info

      ISA-TAB files that you upload must be in .zip format. The file can be no larger than 20 GB.

  7. Click Upload files.
    The status of the file becomes Ready.

  8. Click Upload files.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

       

      Info

      There is also a chance you may encounter an upload error. A sample error message you may encounter upon upload is as follows:

      Missing Data Files: File processed successfully. 1 files referenced in the assay(s) were not found. Click here to view the missing file lists (limited to 1000 entries each).

      The CSSI DCC Portal enforces standards and conventions described in the ISA-TAB specification

      Multiexcerpt include
      MultiExcerptNameExitDisclaimer
      nopaneltrue
      PageWithExcerptwikicontent:Exit Disclaimer to Include
      . The ISA tools site
      Multiexcerpt include
      MultiExcerptNameExitDisclaimer
      nopaneltrue
      PageWithExcerptwikicontent:Exit Disclaimer to Include
      provides additional technical information about validating ISA-TAB files.
       


     
  9.  Refresh the page to see the new upload listed in the Investigation Projects section of the page.
  1.  Project with uploaded file processed successfully

    Info
    titleVersioning ISA TAB Files

    The first time you upload an ISA TAB file to a new project, it is the first version of that file.

    While it It is a best practice to associate only one investigation with a project, you can make changes to your investigation data, create a new ISA TAB file that reflects those changes, and then upload the new file to the original project. You can upload multiple versions of an ISA-TAB file to that project. You may want to do this if you change your investigation data or need to fix it due to an upload error. Each time you upload a new ISA TAB file to a project, the version number increases by one.

     You are now ready to publish the ISA-TAB file to CSSI DCC.

...

  1. Upload at least one ISA-TAB file to a project. 
  2. If you have uploaded multiple versions of the file to the project, decide which version of the ISA-TAB file you want to publish to CSSI DCC.  
  3. Click the Preview button next to that version.
    The Publish Preview page appears.

  4. Review the uploaded file by exploring the investigation details. If you are satisfied with the content of this version, request its publication by clicking Publish this Version. If you are not satisfied or the upload generated an error, click Return to go back to your project and upload a new version of the ISA-TAB file.

    Info

    A sample error message you may encounter upon upload is as follows:

    Missing Data Files: File processed successfully. 1 files referenced in the assay(s) were not found. Click here to view the missing file lists (limited to 1000 entries each).

     

  5. Check your inbox for an email with the subject line "Investigation Published." You can also confirm the published state of your file by checking the value of the Published Version field (the number should equal the number of the version you intended to publish) and the Published field (should be true) on the Upload ISA TAB Files page.