Uploading Data Files to Terra
Francis J Ambrosio
Abstract
Uploading data to Terra.bio is an essential step in the protocol for analyzing locally stored genomic sequencing data. The Terra.bio uploads page allows users to easily organize their data files using an associated metadata file via a browser-based graphical user interface. This protocol explains the process to prepare the data files and the associated metadata file for upload, and provides the link to the Terra.bio uploads page.
Steps
Upload Data Files
Navigate to the Terra.bio uploads page.
Select an existing workspace or create the workspace where the data will be uploaded. If there are no workspaces created under the billing project associated with this account please reach out to support@theiagen.com and we will facilitate the creation of a workspace pre-loaded with workflows to perform the analyses needed to meet any variety of research objectives.
Select an existing collection or create the collection where the data will be uploaded.
Drag and drop files into the indicated region of the page (or use the file browser by selecting the plus button in the bottom right hand of the window).
Upload Metadata File
Using the sample names and file names of the the files that have been uploaded to Terra, create a spreadsheet of this "metadata" to upload to Terra as well.
Cell A1 defines the root entity. This will be the name of the table where the data is stored in Terra. The root entity is defined using the " entity: " notation and must end with " _id ".
*NOTE: It is best practices to include the run_id of each sample in an addition column:
Save the file as a tab delimited text file:
Drag and drop the metadata file into the indicated region of the page (or use the file browser by selecting the plus button in the bottom right hand of the window).
Review the entries in the datatable and click 'CREATE TABLE' to complete the upload process
If you experience any issues during this process please reach out to our support email:
support@terrapublichealth.zendesk.com
If video is your preferred medium of support check out our youtube video on uploading paired end sequencing data to Terra.bio:
