Using the Variant Search Feature within the Cohort Builder

  • Updated

Note: We recommend reading “Selecting participants using the Cohort Builder” before reading the following article as a basic understanding of the Cohort Builder is helpful to using the variant search feature.

To include participants with genomic data in your cohort, you can use the variant search feature in the point-and-click tool, the Cohort Builder.

The variant search feature allows you to filter by gene, consequence, ClinVar significance filter, allele count, allele number, and allele frequency. You can also sort by participant count and add all participants with structural variants (SVs) to your inclusion criteria.

Note: The variant search feature sets the query parameters to identify person IDs based on the inclusion and exclusion criteria you select in the Cohort Builder. The feature does not extract the genomic data. To extract genomic data, you must follow the extraction process directly in your analysis tool or use the Genomic Extraction tool.

To select all participants with SV data as your cohort

  1. Click “white plus sign on top of a blue circle” to the right of “Cohorts.”

    The workspace’s data tab includes the Cohort Builder and the Dataset Builder. The Cohort Builder is displayed on the left inside of the screen in a white card with the title Cohorts. A cohort is a group of participants based on specific criteria. Think of your cohort as a subsection of all of the All of Us participants. The white plus sign on top of a blue circle is to the right of the “Cohorts” title. After you click the white plus sign on top of a blue circle, the Build Cohort Criteria page appears with include participants, group 1, and add criteria.

  2. Select “Add Criteria.”

    After clicking add criteria button, a dropdown appears. You can search or browse through the program data, domains, and concepts available in the Researcher Workbench. This includes demographics, surveys, physical measurements, conditions, procedures, genomics, etc.

  3. Under “Genomics,” select “Structural Variant Data.”

    In the top right corner of the create cohort screen, there will be a grayed out create cohort button. After you select the structural variant data, the create cohort button will be blue and no longer grayed out.

  4. Click “Create Cohort.”

To select participants with SNP/Indel variants

  1. Click “white plus sign on top of a blue circle” to the right of “Cohorts.”

    The workspace’s data tab includes the Cohort Builder and the Dataset Builder. The Cohort Builder is displayed on the left inside of the screen in a white card with the title Cohorts. A cohort is a group of participants based on specific criteria. Think of your cohort as a subsection of all of the All of Us participants. The white plus sign on top of a blue circle is to the right of the “Cohorts” title. After you click the white plus sign on top of a blue circle, the Build Cohort Criteria page appears with include participants, group 1, and add criteria.

  2. Select “Add Criteria.”

    After clicking the add criteria button, a dropdown appears. You can search or browse through the program data, domains, and concepts available in the Researcher Workbench. This includes demographics, surveys, physical measurements, conditions, procedures, genomics, etc.

  3. Under “Genomics,” select “SNP/Indel Variants.”

    After you select the SNP/Indel Variants, the SNP/Indel Variants will appear with a search box for searching for variants.

  4. Search for your variant of interest by typing the gene, variant, RS number, or genomic region in the search bar.
    • You can also filter your search by selecting "Filter & Sort" and choosing your filter and sort criteria based on gene, consequence, ClinVar significance filter, allele count, allele number, and allele frequency.

      After searching for your variant of interest, a list of variants matching your search will appear including the variant ID, the gene, the consequence, the protein change, and more.

  5. Select your variant of interest.

    You can select variants by clicking on the green plus sign within a green circle icon to the left of the variant of interest. At the bottom right, there will be a blue finish and review button.

  6. Click “Finish & Review.”

    After clicking finish and review, the Build Cohort Criteria screen will return.

  7. Follow steps 1-6 for as many inclusion criteria as needed for your research project. You can also add exclusion criteria to your cohort.
  8. Click “Create Cohort.”
    The cohort you created can now be used to create a dataset using the Dataset Builder. For using short-read whole genome sequencing (srWGS) data, use the Genomic Extraction tool in the Dataset Builder.

    The blue create cohort button is in the top right of the Build Cohort Criteria screen.

To select all variants

With the variant search feature, you can select all variants if the result count is less than 10,000.

  1. Click “white plus sign on top of a blue circle” to the right of “Cohorts.”

    The workspace’s data tab includes the Cohort Builder and the Dataset Builder. The Cohort Builder is displayed on the left inside of the screen in a white card with the title Cohorts. A cohort is a group of participants based on specific criteria. Think of your cohort as a subsection of all of the All of Us participants. The white plus sign on top of a blue circle is to the right of the “Cohorts” title. After you click the white plus sign on top of a blue circle, the Build Cohort Criteria page appears with include participants, group 1, and add criteria.

  2. Select “Add Criteria.”

    After clicking the add criteria button, a dropdown appears. You can search or browse through the program data, domains, and concepts available in the Researcher Workbench. This includes demographics, surveys, physical measurements, conditions, procedures, genomics, etc.

  3. Under “Genomics,” select “SNP/Indel Variants.”

    After you select the SNP/Indel Variants, the SNP/Indel Variants will appear with a search box for searching for variants.

  4. Search for your variant of interest by typing the gene, variant, RS number, or genomic region in the search bar.

    After searching for your variant of interest, a list of variants matching your search will appear including the variant ID, the gene, the consequence, the protein change, and more.

    Directly under the search function, there is a filter and sort option and a select all results option.

  5. Click “Select All Results” to the right of “Filter & Sort.”
    Note: The variant count should be less than 10,000. To bring the count below 10,000, use the filter function to narrow the results.

    After you select all results, the grayed out finish and review button is no longer grayed out. The blue finish and review button is in the bottom right of the screen.

  6. Click “Finish & Review.”

    After you click the Finish & review button, a pop up appears on the right hand side. The pop up provides you a summary of the criteria you selected during the prior steps. You can remove the criteria by selecting the red circle and x to the left of the criteria listed.

  7. Click “Save Criteria.”

    After you click save criteria, the screen will return to the Build Cohort Criteria page.

To exclude variants from select all

You can also exclude variants with the variant search feature.

  1. Follow steps 1-6 for selecting all variants.
  2. Click “Gray pencil line icon.”

    The gray pencil line icon is in the pop-up for reviewing your selected criteria that appears after clicking finish and review. The gray pencil line icon is directly to the left of the Select All Group: your variant of interest. After clicking the gray pencil icon, all the variants related to your variant group search will appear in a list. Each line will include a green plus sign circle and a red x circle to the left of the variant id. You can include and exclude specific variations using the green plus sign and the red x sign respectively.

  3. Exclude specific variations by clicking “Red X within a red line circle” next to the variant name.

    If you click the red x next to a variant ID, the green plus sign icon will become clickable for you to include that variant again and vice versa. After you include and exclude your variants of interest, you will see the linked text of save select all exclusions. The link is directly above the table with the list of each variant and in between the filter and sort link and a cancel edit link.

  4. Click "Save Select All Exclusions."

    After clicking save select all exclusions, the pop-up on the right will reappear showing your selected criteria for your cohort. At the bottom right of the pop-up, there will be a blue save criteria button.

  5. Click “Save Criteria.”

    After you click save criteria, the screen will return to the Build Cohort Criteria page. In the top right of the Cohort Builder screen you will see a blue create cohort button.

  6. Click “Create Cohort.”
    • The cohort you created can now be used to create a dataset using the Dataset Builder. For using short-read whole genome sequencing (srWGS) data, use the Genomic Extraction tool in the Dataset Builder.

Was this article helpful?

2 out of 2 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.