This document intends to explain the process by which external, non-consortium members can gain access to a given cohort that is housed within the AnVIL.
- Inform a novice user how to link their Terra Account to their eRA Commons address.
- Inform a novice user how to navigate to dbGaP and submit a Data Access Request (DAR).
- Explain how the AnVIL uses dbGaP telemetry files to grant access.
- Inform a user with a valid, approved DAR how to gain access to the data.
- Have an eRA Commons or NIH account. Go here for instructions to set up an eRA Commons or NIH account.
- Establish a link in Terra to your eRA Commons/NIH Account. To link an eRA Commons to your Terra account, go to your Profile page in Terra and log in with your NIH credentials. (Note: Once per month, you will need to relink these accounts to ensure that you still have proper access).
- Identify the phsID of the cohort you wish to access. A helpful list of datasets can be found on our datasets page.
- Request Access. Navigate to the dbGaP page for that study and click “Request Access” near the top of the screen.
- Navigate to your DAR. Follow the prompts for dbGaP Data Download to submit a Data Access Request (DAR). Include as much information as you can, as this will help the Data Access Committee evaluate your application.
- Wait for a response. Each Data Access Committee hand evaluates their own DARs. Depending on the DAC, this can take some time. You will be notified via email when your application is approved or rejected.
- Your access is granted! Using telemetry files, dbGaP informs Terra which users should be given access to each dataset. For more detail, see the section on Telemetry files below.
Once a user has been granted access by the relevant Data Access Committee (DAC), dbGaP will list their eRA Commons ID within that cohort’s telemetry file - a secure list provided to external data sources like the AnVIL.
The names on the cohort’s telemetry file are synced with the relevant workspace using a Terra Authorization Domain. Using the linkage between a user’s Terra Account and their eRA Commons ID, the system automatically grants access when the user attempts to view or access that workspace.
Once your access is granted, your data will appear as one or more workspaces on your Terra workspaces page.
Can't See Your Workspace? For your workspaces to appear in Terra, make sure you have a Terra account and your Terra account is linked with your eRA Commons or NIH account as described above.
Once you can see your workspace(s):
- Select the workspace you are interested in.
- General information about the workspace can be found on the main workspace page.
- Tables containing phenotypic data and subject/sample information are available on the workspace's Data Tab.
- If you plan to work on the cloud, you can clone the workspace to your own billing account. Click the "three vertical dots" icon in the top right, click "Clone" and follow the prompts.
- If you want to work with, or download the files in the command line, information about the bucket path is readily accessible on the Data Tab > Files listing (as well as a bucket path on the main page).
Note that when cloning a workspace, any authorization domains on the source workspace will follow any clones, but you will still need to share the workspace for anyone to access it.
- All AnVIL buckets have Requester Pays enabled, meaning that you will need to provide a billing account in order to cover any costs associated with egress, storage, or compute.
- If working in gsutil, using the -u argument will be critical to provide this billing account.
If you are having trouble with your access to AnVIL data, please email our help desk at firstname.lastname@example.org and someone will reach out to you as soon as we are able.