# BDC-Terra Tutorials

## **Onboarding Webinars**

For the latest training webinars, view the recordings of our [first onboarding webinar](https://www.youtube.com/watch?v=dhdD72BKo8g) - with a data-focused [agenda](https://support.terra.bio/hc/en-us/articles/360058701831) - and our [second onboarding webinar](https://www.youtube.com/watch?v=LL9s4_zoB9I) - with an [agenda](https://support.terra.bio/hc/en-us/articles/360059355151) covering more advanced workflow concepts such as configuration and WDL scripts.

## End-to-End Workspace-Based Tutorials

These hands-on tutorials cover the full flow of selecting data in Gen3, then handing off that data to Terra for analysis.

* [Getting Started with Gen3 Data on Terra Tutorial Workspace](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/fc-product-demo/BioDataCatalyst-Gen3-data-on-Terra-Tutorial)
* [TOPMed Aligner, or, How to Import Data From Gen3 into Terra and Run a Workflow on It](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/biodata-catalyst/TOPMed%20Aligner%20Gen3%20Data)
* [Genome-Wide Association Study Tutorial using 1000 Genomes in BioData Catalyst Powered by Terra, Gen3, and Dockstore](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/biodata-catalyst/BioData%20Catalyst%20GWAS%201000%20Genomes%20Tutorial)
* [Genome-Wide Association Study using TOPMed data in BioData Catalyst Powered by Terra, Gen3, and Dockstore](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/biodata-catalyst/BioData%20Catalyst%20GWAS%20blood%20pressure%20trait)
* [BioData Catalyst Collection](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/biodata-catalyst/BioData%20Catalyst%20Collection) is a catalog of utilities and analysis notebooks

## PIC-SURE Tutorials in Terra

These workspaces hit the PIC-SURE API that offers search features for controlled-access data from BDC. You can query studies and subset based on patients matching specified criteria, as well as retrieve a cohort that has been created using the [PIC-SURE interface](https://picsure.biodatacatalyst.nhlbi.nih.gov/). 

* [PIC-SURE Tutorials in R](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/biodata-catalyst/BioData%20Catalyst%20PIC-SURE%20API%20R%20Examples)
* [PIC-SURE API Tutorials in Python](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/biodata-catalyst/BioData%20Catalyst%20PIC-SURE%20API%20Python%20examples)

## Additional Tutorial Articles <a href="#template-blood-pressure-trait-gwas-in-nhlbis-biodata-catalyst" id="template-blood-pressure-trait-gwas-in-nhlbis-biodata-catalyst"></a>

* [Understanding and using Gen3 data in Terra](https://support.terra.bio/hc/en-us/articles/360038087312)
* [Importing a Dockstore workflow into Terra](https://support.terra.bio/hc/en-us/articles/360038137292)

## Additional Tutorial Resources

These tutorials often use Terra’s data model. If you would like to use Gen3 data with these examples, we suggest that you begin with [Getting Started with Gen3 Data on Terra](https://terra.biodatacatalyst.nhlbi.nih.gov/#workspaces/fc-product-demo/BioDataCatalyst-Gen3-data-on-Terra-Tutorial), which can help you transform graph-structured data into a data model easier to use with our entire suite of tutorials.

* [Terra Showcase and Example Workspaces](https://terra.biodatacatalyst.nhlbi.nih.gov/#library/showcase)

\ <a href="#template-blood-pressure-trait-gwas-in-nhlbis-biodata-catalyst" id="template-blood-pressure-trait-gwas-in-nhlbis-biodata-catalyst"></a>
--------------------------------------------------------------------------------------------------------------------------------------------------


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bdcatalyst.gitbook.io/biodata-catalyst-documentation/tutorials-videos-and-modules/terra-tutorials.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.