How Can I Download Complete Project Datasets?

You can easily download complete Projects, provided that the following conditions are met:

  • You are entitled to that Project.
  • The Project's Data Contributor has given permission for the Project to be downloaded.

All Users are entitled to Zone 1 Projects, but you need to be a Qualified Researcher to use Zone 2 Projects or a Designated User to access and use Zone 3 Projects. You can find out more about the different levels of access here.

Step 1: Check if a Project is available for download

You can find Projects that are available for download in the Project Gallery by checking if they display the button "Request Download". 

Projects that do not meet the criteria above do not have this button and you will not be able to download them.

Step 2: Configure your Download

Your Project will be delivered as a ZIP package, so before you can download it, you will need to choose the format (TSV or JSON) for structured data and whether you would like to include all of the Project's unstructured files.
Note: See the discussion of retrieving structured data files, detailing the file format, at the end of the Querying the Database Using the SDK article..

WARNING!

Adding unstructured files may result in a very large download, potentially more than 1 TB in size.

Step 3: Checkout

Once you have submitted your Download request, it will be available for 7 days from your "My Stuff" page. 

After 7 days, the download link expires. If you need to Download the same Project again, you will need to submit a new request.

In order to complete your "Checkout" process, you need to select how you would like your download to be delivered:

  1. Direct Download: your Project file will be downloaded directly from your browser. This is only recommended for smaller Projects that will only take a few minuted to download.
  2. Copy to S3 buckett: your Project file will be copied to a S3 bucket of your choice. This option is recommended for larger downloads that would take too long to download from the browser.

Important!

You can only use S3 buckets in US East-1 AWS region and you must ensure that the BRAINCommons IAM Policy is added to it, so that BRAINCommons can connect to it and copy the files.