Skip to end of banner
Go to start of banner

Quick Start: Files and Folders

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

This tutorial will guide you through fundamental Synapse features for managing files and folders via the web interface. You will learn how to:

  • Add a folder to a project and upload a file

  • Annotate a file

  • Add a description to your folder with a wiki

  • Download a file

Prerequisites

Anyone can browse public content on the Synapse website, but to download and create content using this tutorial, you will need to register for an account using your email address. You will receive an email message for verification to complete the registration process.

To upload files to Synapse, you will need to perform the additional step of becoming a certified user. Because Synapse stores data from human subjects research, Sage Bionetworks requires that you demonstrate understanding of privacy and security issues. You can complete your certification by taking a short certification quiz on Synapse.Creating folders and uploading files

Before you begin, make sure you have already created a project (see Quick Start: Setting Up a Project), and that you have certified your user account. To create a folder and upload a file:

  1. Navigate to the Files tab.

  2. Use the Files Tools menu to select Add New Folder.

  3. Decide on a folder name and click Save.

  4. Navigate into your new folder by clicking on the name, then use the Folder Tools menu to select Upload or Link to a File.

  5. Use the Browse button to select the file, or drag and drop it to upload, and click Save.

To learn more, see Files and folders. To explore other features available for files and folders, read about Sharing settings, /wiki/spaces/DOCS/pages/1972405096, Versioning files, and /wiki/spaces/DOCS/pages/1972470373.

Annotating Files

Annotations help you find files and search for data. In Synapse, annotations are stored as key-value pairs, where the key defines a particular aspect of your data (for example, species, assay, file format) and the value defines a variable that belongs to that category (mouse, RNAseq, .bam). You can add annotations to projects, files, folders, tables, and views in Synapse. In this example, you will annotate the file that you uploaded in the previous section of this tutorial:

  1. Navigate to the file and click on the file name.

  2. Click on the File Tools menu and select Annotations.

  3. A new panel will appear with a list of any previously added annotations for this file. Click Edit to add new annotations.

  4. In the pop-up window, add your annotations one at a time. Use the + icon to add multiple values for a single key and the x icon to remove values. Use the Add New Key button to add a new key.

Once you add annotations to a file, you can use them to query for data, or you can build /wiki/spaces/DOCS/pages/2011070739 to display annotation information for many files at once.

Downloading Files

You can download files from the Synapse web interface or use one of the programmatic clients. If you are downloading files from the web, you can either download single files at once, or you can add multiple files to a download list, which is similar to an online shopping cart. On the web, the maximum size of a download is 5 GB, or a maximum of 100 files if using the download list. To download larger files in greater numbers, we recommend using one of the programmatic clients.

Before you can download a file from Synapse, you must determine whether you have access to it. Click on a file name and look for a green or yellow lock symbol. A green unlock symbol means that the file is available for you to download. A yellow locked symbol means that the file is not available to you. Contact the project owner or click Request Access.

To download a file from the web:

  1. Navigate to the Files tab of your project and find a file to download. Note that you cannot download entire folders from the web interface, so you may need to expand a folder in the directory to see its contents.

  2. Click the file name to navigate to the file details page.

  3. Click Download Options button and then Download File.

  4. From this menu, you can also choose to Add to Download list, which will start a list of files that you can download all at once. Alternatively, you can view the Programmatic Options to see example code that you can use to download files with one of the programmatic clients.

For more instructions on how to download using the programmatic clients, visit the docs for Python, R, and command line.

Unable to render {include} The included page could not be found.

  • No labels