This vignette use case will combine concepts from Annotations and QueriesAnnotating Data With Metadata, /wiki/spaces/DOCS/pages/2011070739, Uploading and Downloading Data in BulkOrganizing Data Into Projects, Files, and Folders. You will learn how to:
Create a manifest
Upload 100 files
Edit annotations on these files using the Synapse programmatic clients
...
To batch upload files, create a tab-delimited manifest which contains, at minimum, the columns path
and parent
. You can also add additional annotations as columns in your manifest. For example, your manifest might have the following headers: path
, parent
, specimenID
, assay
, species
, platform
, sex
, and fileFormat
. See Creating a Manifest in Uploading and Downloading Data in Bulk for additional details.
path: the local path to your file
parent: the Synapse ID (in the format syn123456) of the folder or project where your files will be uploaded
specimenID: the unique identifier for each of your specimens
assay: the technology used to generate the data in this file (for example, RNASeq, ChIPSeq, wholeGenomeSeq)
species: the species of your sample (for example, Mouse, Rat, Human, Triceratops)
platform: the hardware used to generate the data (for example, HiSeq2500, Affy6.0, HoodDNASequencer)
sex: a label assigned at birth based on biological attributes (for example, male or female)
fileFormat: is the type of file (e.g. fastq, R script)
path | parent | specimenID | assay | species | platform | sex | fileFormat |
---|---|---|---|---|---|---|---|
/local/path/to/velociraptor_b.fastq | syn123 | blue_1 | wholeGenomeSeq | Velociraptor mongoliensis | HoodDNASequencer | female | fastq |
/local/path/to/velociraptor_d.fastq | syn123 | delta_1 | wholeGenomeSeq | Velociraptor mongoliensis | HoodDNASequencer | female | fastq |
Save this file in a tab-delimited format called velociraptor_manifest.tsv
.
...
Navigate to your project.
Go to the tables tab, select Tables Tools in the upper right corner, and click Add File View.
In the resulting pop-up, give the new file view a name.
Select the container (Synapse project or folder) of files, and click Next. In this case, you would want the synID of the
parent
column in the manifest.Select the columns you would like to keep. Since we are going to edit the annotations later, make sure you have the column
etag
listed as one of your columns.Add All Annotations at the end of the opened window will add all existing annotations.
Click Finish to create the file view.
For more information on file views, see /wiki/spaces/DOCS/pages/2011070739.
Perform a One-Time Annotation Update or Deletion (web)
...
Query for the file view with
synTableQuery()
orsyn.tableQuery()
. To delete all the annotations of a key, you have to keep the column in the file view but remove the values.Update and then store the annotations in the R client or Python client.
...