Uploading investigation data to the CSSI DCC Portal allows you to curate, manage, and reuse datasets in a standards-compliant way. The ISA-Tab specification describes this standard and 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 made for this purpose.
An ISA-Tab archive file is a compressed (.zip) file containing multiple text files and data files. Each tab-delimited text file in an ISA-Tab file describes the structure, meaning the column headers and row values when considered in spreadsheet format, of the investigation, study, and assay components of the archive. The data files correspond to each assay and are included in the archive in their native format, for example, Microsoft Excel. An ISA-Tab archive file may also contain images and other files.
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.
Before uploading a file to the CSSI DCC portal, consult the ISA-Tab specification . 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 made for this purpose.
ISA-Tab files that you upload must be in .zip
format. Use Globus to upload files larger than 10 GB.
To upload ISA-Tab files
Click New Project.
The Project Properties page appears.
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. |
Click Save Project.
The new project is listed under Investigation Projects.
If the File Upload section of the page is not visible, click Open next to the project name to show it. |
If needed now or later, click Edit to change the project name. Depending on your privileges, you may not see the Delete button. |
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:
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.
If the file is smaller than 10 GB, click Upload selected files. If the file is larger than 10 GB, use Globus instead.
The file begins processing and the status moves through the following stages:
Success: file processed successfully
Once an administrator approves the upload request, the uploaded, unpublished file appears 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.
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.
To upload files using Globus
On the Upload ISA TAB Files page, click .
If you have not yet logged into Globus, a log in page appears.
For more information about using Globus, consult their documentation and/or support . |
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.
Select the starting endpoint (on the left) where the file(s) you want to upload reside(s). Narrow down to the path if necessary.
Confirm or change the destination endpoint (on the right).
Click the right arrow button that points to the destination to begin the transfer request.
A message appears on the screen when the transfer request is submitted successfully. You receive an email when the request is granted and the transfer succeeds.
Once an administrator approves the upload request, the uploaded, unpublished file appears in the Investigation Projects section of the page.
Since you have not yet published the uploaded file, you must publish it to use it in CSSI DCC.
Unpublishing ISA-Tab FilesAfter publishing a file, you may want to unpublish a version of it to remove that version completely from the CSSI DCC server.
To unpublish an ISA-Tab file
|