1. Clone the template workspace
1.1. Click on the three-dot menu at the top-right of the workspace and select Clone.
1.2. Fill in a Workspace name. In this example, I’ve added my initials and the date so it’s easy to identify. Select your Terra Billing project and click the CLONE WORKSPACE button.
1.3. Your cloned workspace will take a few minutes to create.
2. Examine the workspace data table
2.1. Navigate to your cloned workspace (Main menu > Workspaces > Genomic Screening with ClinVar) and click on the DATA tab.
2.2. The workspace comes with a data table called cohorts. Click on the name to examine the table.
2.3. This table contains one row and five columns of data.
The bed_file and input_vcfs columns contain links to the files in the Terra workspace’s Azure storage container that will be used as inputs for the VariantAnnotation workflow.
3. Run the VariantAnnotation workflow
Workflows are orchestrated in Terra by the workflows application - Cromwell. When you are in a new workspace, you will need to launch Cromwell. Note that you only need to do this once, the first time you set up or run a workflow in the workspace.
3.1. Go to the Workflows tab.
3.2. Click the blue Launch Workflows App button.
The Workflows app may take between 5-15 minutes to launch.
When workflows are ready
After a few minutes, you will see the workflows menu on the left-hand side and the VariantAnnotation workflow from the original workspace in the center under Workflows in this workspace.
3.3. Click the blue Configure button for the VariantAnnotation workflow.
3.4. The data table should already be set to the cohorts table. If it is not already selected, choose it from the dropdown menu. Check the box to select the only row in the table.
3.5. The Inputs and Outputs have already been configured for you. You can click on the Input tab to see which workflow attribute (input table column) holds each variable.
Inputs configuration
Clicking the outputs tab lists the workflow outputs (genes annotation and position annotation JSONs, a variant report PDF and a variant table TSV) and where output data will be written back to the table (in the Output name column).
Outputs configuration
3.6. When you’re ready to run the workflow, click the blue SUBMIT button. You can add a comment for this submission if you wish, then click SUBMIT again.
What to expect
The first time you run a workflow in your workspace, Cromwell will take some time to launch. The workflow will submit automatically once Cromwell is up and running and you will be redirected to the Submission details page.
The Submission history shows an overview of the run at any time.
3.9. Once the submission is complete, you will see the status change to Success. From the submission history, you can click on the submission name for more details including log files for troubleshooting.
4. Find/explore results
4.1. Click on the DATA tab to examine the cohorts table once more.
4.2. Click to open the cohorts table and scroll to the right to see the newly generated output files that have been added to the table in four new columns.
Accessing output files
4.3. Clicking on the link in the genes_annotation_json column will expose where the file is stored in your workspace cloud storage and allow you to download the output file to local storage.