This page is part of the Genetic Reporting Implementation Guide (v1.1.0: STU 2 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
General constraints on FHIR resources to be adhered to as part of the CG implementation guide that apply regardless of what area(s) of genomics are of interest
Request for Genomics Test |
The lab order or request that triggered the execution of the genomics test |
Specimen |
Constraints on Specimen for use with clinical genomics reporting |
Genomics Report |
Defines the overall genomic report |
Region Studied |
Provides a description of the region studied. |
Grouper |
Organizes information within a genomic report |
Overall Interpretation |
Provides a coarse overall interpretation of the genomic results reported. |
Haplotype |
Assertion of a particular haplotype on the basis of one or more variants |
Genotype |
Assertion of a particular genotype on the basis of one or more variants or haplotypes |
Variant |
Details about a set of changes in the tested sample compared to a reference sequence. |
Sequence Phase Relationship |
Indicates whether two entities are in Cis (same strand) or Trans (opposite strand) relationship to each other |
Tumor mutation burden |
Tumor mutational burden (TMB), also known as mutation load. |
Microsatellite instability |
Microsatellite instability (MSI) is the condition of genetic hypermutability (predisposition to mutation) that results from impaired DNA mismatch repair (MMR). |
Profiles needed for linking genomic findings to knowledgebases for diagnostic or therapeutic use
Diagnostic Implication |
Profile with properties for observations that convey the potential impact of genomic characteristics on a diagnosis |
Therapeutic Implication |
Profile with properties for observations that convey the potential impact of genomic characteristics on a medication or non-medicinal therapy. |
Medication Usage Task |
Task describing what sort of change (if any) should be made in a patient’s medication based on an identified finding |
Recommended Followup |
Task describing the followup that is recommended |
Abstract profiles holding common properties, outlining similarities in implementable profiles
Genomics Base |
Base profile that defines characteristics shared by all genetic observations. |
Genomic Finding |
Properties common to genomic findings whose results are expressed as computable discrete elements (e.g. genotypes, haplotypes, variants, etc.) |
Genomic Implication |
Abstract profile for observations linking a genomic finding to an external knowledgebase. |
Extensions defined as part of the CG implementation guide
Related Artifact |
Captures citations, evidence and other supporting documentation for the observation or report |
Recommended Action |
References a proposed action that is recommended based on the results of the report or observations |
Supporting Information |
Additional information relevant to interpreting/understanding the report |
Code Systems defined in this implementation guide
TBD Code System |
Code System for codes yet to be defined in LOINC |
Sequence Phase Relationship |
Code System for specific types of relationships |
Value Sets defined in this implementation guide
High/Low codes |
High/Low codes for Observation.interpretation |
HGVS Value Set |
Value Set for HGVS |
HGNC Value Set |
Value Set for HGNC (genes and gene groups) |
TBD Value Set |
Value Set for codes yet to be defined in LOINC |
DNA Change Type |
DNA change type for variants |
Molecular Consequence |
Changes in structural features of a sequence due to the observed variant. |
Sequence Phase Relationship |
Value Set for specific types of relationships |
Variant Inheritance |
origins of variants |
Concept Maps defined in this implementation guide
Concept mapping for DNA Change Type |
Mapping LOINC answers to SequenceOntology |
Operations defined in this implementation guide
Operation: $find-subject-variants |
Retrieves variants from a specified genomic region |
Examples showing the use of the CG profiles
Example Org |
Example Org |
Example - TherapeuticImplication |
Test instance of TherapeuticImplication |
Example - Genotype |
Test instance of Genotype |
Example - TaskMedChg |
Test instance of TaskMedChg |
Example - GenomicsReport |
Test instance of GenomicsReport |
Example - Sequence Phase Relation |
Test instance of Sequence Phase Relationship |
Example - Overall Interpretation |
Test instance of Overall Interpretation |
Example - TMB |
Test instance of TMB |
Example - MSI |
Test instance of MSI |
Example - Service Request |
Test instance of Service Request |
Example - Variant1 |
Test instance of Variant given by Clinvar ID |
Example - Variant2 |
Test instance of Variant given by VCF columns |
Example - Patient |
Test instance a patient |
Example - Specimen |
Test instance a specimen |
Example - Observation PGx Genotype 1 |
Test instance of PGx Genotype given by star allele |
Example - Observation PGx Genotype 2 |
Test instance of PGx Genotype given by star allele |
Example - Observation PGx Genotype 3 |
Test instance of PGx Genotype given by rs ID and allele |
Example - Observation PGx interpretation |
Test instance of PGx overall report interpretation |
Example - Observation-GrouperEx01 |
Test instance of PGx Observation grouper consisting of Implications from the lab |
Example - Observation-GrouperEx02 |
Test instance of PGx Observation grouper consisting of genotypes from the lab |
Example - Observation-GrouperEx03 |
Test instance of PGx Observation grouper consisting of variants and regions studied from the lab |
Example - DiagnosticReport-PGxGenomicsReportEMERGE |
Test instance of PGx Diagnostic report based on eMERGE panel |
Example - Observation-Pgx-var-1011 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1012 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1013 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1014 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1015 |
Test instance of PGx variant defined by HGVS nomenclature |
Example - Observation-Pgx-var-1016 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1017 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1018 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1019 |
Test instance of PGx variant defined by HGVS nomenclature |
Example - Observation-Pgx-var-1020 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-Pgx-var-1021 |
Test instance of PGx variant defined by VCF column data |
Example - Observation-RegionStudiedPGx1 |
Test instance of region studied report for one gene |
Example - Observation-RegionStudiedPGx2 |
Test instance of region studied report for one gene |
Example - Observation-RegionStudiedPGx3 |
Test instance of region studied report for one gene |
Example - Observation-TxImp01 |
Test instance of observation stating therapeutic implication from guideline |
Example - Observation-TxImp02 |
Test instance of observation stating therapeutic implication from guideline |
Example - Observation-TxImp03 |
Test instance of observation stating therapeutic implication from guideline |
Example - Observation-TxImp04 |
Test instance of observation stating therapeutic implication from guideline |
Example - Observation-TxImp05 |
Test instance of observation stating therapeutic implication from guideline |
Example - Observation-TxImp06 |
Test instance of observation stating therapeutic implication from guideline |
Example - ServiceRequest-eMERGEServiceRequest |
Test instance of service request for PGx test |
Example - Genomics Reporting |
Test instance showing data from the CG v2 spec |
Example - Complex Variant (HGVS) |
Compound Heterozygote Variant Example |
Example - Complex Variant (unpacked) |
Compound Heterozygote Variant example, using position, reference, and alternate allele instead of HGVS. |
Example - NGS |
SNV example |
Example - ACMG Screening result |
ACMG annotation |
Example - Inherited Disease Pathogenicity |
Inherited Disease Pathogenicity |
Example - Pharmacogenomics |
Pharmacogenomic Report Example instances |
Example - CYP2C19 report from 1000 Genomes |
CYP2C19 report from 1000 Genomes |
Example - subset of CYP2C19 report from 1000 Genomes showing phase |
Phase relation on CYP2C19 report |
Example - Full Bundle HLA genotyping for HLA-A, HLA-B, and HLA-C, using GLStrings |
Full Bundle HLA Typing Example |
Example - HLA genotyping for HLA-A, HLA-B, and HLA-C, using GLStrings |
DiagnosticReport HLA Typing Example |
Example - HLA genotyping for HLA-A, using GLStrings |
HLA-A genoyping Example: HLA-A03:01:01:01+HLA-A30:01:01 |
Example - Observation for a single HLA-A allele |
HLA-A allele observaation: HLA-A*03:01:01:01 |
Example - Buccal swab for HLA typing |
Specimen example: Buccal swab for HLA typing |
Example - Service request for high-resolution HLA-A genotyping |
ServiceRequest example: High-resolution HLA-A genotyping |
Example - Multiple Oncology Variant Report Example |
Oncology Example Report with 12 reported variants |
Example - Melanoma implication |
Small example report with 1 reported variant and somatic diagnostic implication |
Example - Full Bundle Oncology Example |
Full Bundle Oncology Example |
These define constraints on FHIR data types for systems conforming to this implementation guide
Risk Assessment Reference |
Extension reference to RiskAssessment resource |
These define sets of codes used by systems conforming to this implementation guide
Condition Inheritance Pattern |
Value Set for specific ttransmission patterns of a condition in a pedigree |
Functional Effect |
The effect of a variant on downstream biological products or pathways. |
These define new code systems used by systems conforming to this implementation guide
Condition Inheritance Pattern |
A set of terms that describe the transmission pattern of a condition in a pedigree. |
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like
Example Task - PGxRecEx01 |
For clopidogrel, individuals with this diplotype are expected to have significantly reduced platelet inhibition, increased residual platelet aggregation and increased risk for adverse cardiovascular events in response to clopidogrel. Alternative antiplatelet therapy (if no contraindication) is recommended. Refer to current guidelines for dosage and recommendations at https://cpicpgx.org/guidelines/guideline- for-clopidogrel-and-cyp2c19/ |
Example Task - PGxRecEx02 |
voriconazole - An alternative agent that is not dependent on CYP2C19 metabolism such as isavuconazole, liposomal amphotericin B, or posaconazole is recommended as primary therapy in lieu of voriconazole. A lower than standard dosage of voriconazole with careful therapeutic drug monitoring is another alternative. Refer to current guidelines for dosage and recommendations at https://cpicpgx.org/guidelines/guideline-for-voriconazole-and-cyp2c19/. |
Example Task - PGxRecEx03 |
For citalopram, a 50% reduction in starting dose is recommended with therapeutic drug monitoring to guide dose adjustment or select an alternate drug not predominantly metabolized by CYP2C19. Refer to current guidelines for dosage and recommendations at https://cpicpgx.org/guidelines/guideline-for-selective-serotonin-reuptake-inhibitors-and-cyp2d6-and-cyp2c19/. If CYP2D6 genotyping is available, refer to the current guidelines for dosing recommendations. |
Example Task - PGxRecEx04 |
For escitalopram, a 50% reduction in starting dose is recommended with therapeutic drug monitoring to guide dose adjustment or select an alternate drug not predominantly metabolized by CYP2C19. Refer to current guidelines for dosage and recommendations at https://cpicpgx.org/guidelines/guideline-for-selective-serotonin-reuptake-inhibitors-and-cyp2d6-and-cyp2c19/. If CYP2D6 genotyping is available, refer to the current guidelines for dosing recommendations. |
Example Task - PGxRecEx05 |
For amitriptyline, a 50% reduction in starting dose is recommended with therapeutic drug monitoring to guide dose adjustment. Refer to current guidelines for dosage and recommendations at https://cpicpgx.org/guidelines/guideline-for- tricyclic-antidepressants-and-cyp2d6-and-cyp2c19/. If CYP2D6 genotyping is available, refer to the current guidelines for dosing recommendations. |