Genomics Reporting Implementation Guide
3.0.0 - STU3 International flag

Genomics Reporting Implementation Guide, published by HL7 International / Clinical Genomics. This guide is not an authorized publication; it is the continuous build for version 3.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/genomics-reporting/ and changes regularly. See the Directory of published versions

Resource Profile: Variant

Official URL: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/variant Version: 3.0.0
Active as of 2024-12-12 Computable Name: Variant

Copyright/Legal: This material contains content from LOINC (http://loinc.org). LOINC is copyright © 1995-2020, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license at http://loinc.org/license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.

Details about a set of changes in the tested sample compared to a reference sequence.

Scope and Usage

This profile allows a full description of the variant found using properties from a variety of testing approaches and allowing for a variety of descriptive mechanisms. Labs are encouraged to populate what properties they know. In future versions of this implementation guide, HL7 may provide additional guidance on what properties should be sent in which situations and may subdivide Variant into multiple sub-profiles with more specific purpose.

Other Guidance

See Variant Reporting for details on use.

A variety of annotations (see variant implications) can be applied to identified variants, such as: (1) predicted molecular consequences (e.g. a prediction that a variant leads to loss of gene function); (2) diagnostic implications (e.g. presence of a variant indicates increased risk for breast cancer); (3) therapeutic implications (e.g. presence of a somatic variant is associated with sensitivity to a particular drug or eligibility into a clinical trial).

Most human genes are transcribed into multiple transcripts. The molecular consequences profile can be used to indicate transcript-specific predicted consequences, for one or more transcripts. In the Variant instance itself, one can also indicate a representative transcript-level HGVS and/or protein HGVS.

If implementers have additional variant annotations, the Variant profile is defined to allow flexibility. See the section on flexibility for additional guidancem, especially the guidance for the Open Slicing allowed on Observation.component.

Note on Molecular Consequence in STU2

The STU2 Variant profile contained the component slice molecular-consequence, which is no longer present in this profile. The functionality to communicate predicted molecular consequences has been moved to the Molecular Consequence profile. For those that have already implemented the STU2 solution and are in a transition, open slicing allows components above and beyond those specified in the Implementation Guide and therefore the STU2 method of communicating molecular consequence will not cause conformance errors. This approach should be used carefully and only during a transition period to ensure full compatibility with other systems that implement the full features of this guide.

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from GenomicFinding

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation 0..* GenomicFinding Variant
... code 1..1 CodeableConcept 69548-6
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 69548-6
... Slices for value[x] 0..1 Quantity, CodeableConcept, string, boolean, integer, Range, Ratio, SampledData, time, dateTime, Period Actual result
Slice: Unordered, Open by type:$this
.... value[x]:valueCodeableConcept 0..1 CodeableConcept Indeterminate | No call | Present | Absent.
Binding: LOINC Answer List LL1971-2 (required)
... method 0..1 CodeableConcept Sequencing | SNP array | PCR | Computational analysis | ...
Binding: LOINC Answer List LL4048-6 (extensible)
.... component:representative-coding-hgvs 0..1 BackboneElement DNA change (c.HGVS)
..... code 1..1 CodeableConcept 48004-6
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 48004-6
..... value[x] 1..1 CodeableConcept A valid HGVS-formatted 'c.' string, e.g. NM_005228.5:c.2369C>T.
Binding: Human Genome Variation Society (HGVS) Nomenclature (required)
.... component:genomic-hgvs 0..1 BackboneElement Genomic (gDNA) Change - gHGVS
..... code 1..1 CodeableConcept 81290-9
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81290-9
..... value[x] 1..1 CodeableConcept A valid HGVS-formatted 'g.' string, e.g. NC_000016.9:g.2124200_2138612dup
Binding: Human Genome Variation Society (HGVS) Nomenclature (required)
.... component:cytogenomic-nomenclature 0..1 BackboneElement Cytogenomic Nomenclature (ISCN)
..... code 1..1 CodeableConcept 81291-7
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81291-7
..... value[x] 1..1 CodeableConcept Actual component result
Binding Description (No ValueSet): (example): Binding not yet defined

.... component:genomic-ref-seq 0..1 BackboneElement Genomic Reference Sequence
..... code 1..1 CodeableConcept 48013-7
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 48013-7
..... value[x] 1..1 CodeableConcept Versioned genomic reference sequence identifier
Binding Description (No ValueSet): (example): Multiple bindings acceptable (NCBI or LRG)

.... component:representative-protein-ref-seq 0..1 BackboneElement Protein Reference Sequence
..... code 1..1 CodeableConcept protein-ref-seq
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://hl7.org/fhir/uv/genomics-reporting/CodeSystem/tbd-codes-cs
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: protein-ref-seq
..... value[x] 1..1 CodeableConcept Versioned protein reference sequence identifier
Binding Description (No ValueSet): (example): Multiple bindings acceptable (NCBI or LRG)

.... component:representative-transcript-ref-seq 0..1 BackboneElement Reference Transcript
..... code 1..1 CodeableConcept 51958-7
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 51958-7
..... value[x] 1..1 CodeableConcept Versioned transcript reference sequence identifier
Binding Description (No ValueSet): (example): Multiple bindings acceptable (NCBI or LRG)

.... component:exact-start-end 0..1 BackboneElement Exact Start-End
..... code 1..1 CodeableConcept 81254-5
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81254-5
..... value[x] 0..1 Range Range in question. 'High' can be omitted for single nucleotide variants.
.... component:inner-start-end 0..1 BackboneElement Inner Start-End
..... code 1..1 CodeableConcept 81302-2
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81302-2
..... value[x] 0..1 Range Imprecise variant inner-bounding range
.... component:outer-start-end 0..1 BackboneElement Outer Start-End
..... code 1..1 CodeableConcept 81301-4
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81301-4
..... value[x] 0..1 Range Imprecise variant outer-bounding range
.... component:coordinate-system 0..1 BackboneElement Coordinate System
..... code 1..1 CodeableConcept 92822-6
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 92822-6
..... value[x] 1..1 CodeableConcept 0-based interval counting | 0-based character counting | 1-based character counting
Binding: LOINC Answer List LL5323-2 (extensible)
.... component:ref-allele 0..1 BackboneElement Genomic Ref Allele
..... code 1..1 CodeableConcept 69547-8
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 69547-8
..... value[x] 0..1 string Normalized string per the VCF format.
.... component:alt-allele 0..1 BackboneElement Genomic Alt Allele
..... code 1..1 CodeableConcept 69551-0
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 69551-0
..... value[x] 0..1 string Normalized string per the VCF format.
.... component:coding-change-type 0..1 BackboneElement Coding DNA Change Type
..... code 1..1 CodeableConcept 48019-4
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 48019-4
..... value[x] 1..1 CodeableConcept deletion | insertion | delins | SNV | copy_number_gain | copy_number_loss | ... (many)
Binding: DNA Change Type (extensible): Concepts in sequence ontology under SO:0002072

.... component:genomic-source-class 0..1 BackboneElement Genomic Source Class
..... code 1..1 CodeableConcept 48002-0
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 48002-0
..... value[x] 1..1 CodeableConcept Germline | Somatic | Fetal | Likely germline | Likely somatic | Likely fetal | Unknown genomic origin | De novo
Binding: LOINC Answer List LL378-1 (extensible)
.... component:sample-allelic-frequency 0..1 BackboneElement Sample Allelic Frequency
..... code 1..1 CodeableConcept 81258-6
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81258-6
..... value[x] 0..1 Quantity Relative frequency in the sample
...... system 0..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... component:allelic-read-depth 0..1 BackboneElement Allelic Read Depth
..... code 1..1 CodeableConcept 82121-5
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 82121-5
..... value[x] 0..1 Quantity Unfiltered count of supporting reads
.... component:allelic-state 0..1 BackboneElement Allelic State
..... code 1..1 CodeableConcept 53034-5
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 53034-5
..... value[x] 1..1 CodeableConcept Heteroplasmic | Homoplasmic | Homozygous | Heterozygous | Hemizygous
Binding: LOINC Answer List LL381-5 (extensible)
.... component:variant-inheritance 0..1 BackboneElement Origin of germline genetic variant
..... code 1..1 CodeableConcept 94186-4
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 94186-4
..... value[x] 1..1 CodeableConcept Maternal | Paternal | Unknown
Binding: LOINC Answer List LL5489-1 (extensible)
.... component:variant-inheritance-basis 0..1 BackboneElement Evidential basis for variant inheritance
..... code 1..1 CodeableConcept Basis for allelic phase
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 82309-6
..... value[x] 1..1 CodeableConcept Directly measured | Family DNA | Family history | Inferred from population data
Binding: LOINC Answer List LL4050-2 (extensible)
.... component:variation-code 0..* BackboneElement Variation Code
..... code 1..1 CodeableConcept 81252-9
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 81252-9
..... value[x] 1..1 CodeableConcept ClinVar ID or similar
Binding Description (No ValueSet): (example): Multiple bindings acceptable

.... component:representative-protein-hgvs 0..1 BackboneElement Protein (Amino Acid) Change - pHGVS
..... code 1..1 CodeableConcept 48005-3
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 48005-3
..... value[x] 1..1 CodeableConcept A valid HGVS-formatted 'p.' string, e.g. NP_000050.2:p.(Asn1836Lys)
Binding: Human Genome Variation Society (HGVS) Nomenclature (required)
.... component:copy-number 0..1 BackboneElement Genomic Structural Variant Copy Number
..... code 1..1 CodeableConcept 82155-3
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://loinc.org
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 82155-3
..... value[x] 0..1 Actual component result
...... valueQuantity Quantity
...... valueRange Range
.... component:variant-confidence-status 0..1 BackboneElement Variant Confidence Status
..... code 1..1 CodeableConcept variant-confidence-status
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://hl7.org/fhir/uv/genomics-reporting/CodeSystem/tbd-codes-cs
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: variant-confidence-status
..... value[x] 1..1 CodeableConcept High | Intermediate | Low
Binding: Variant Confidence Status (required)
.... component:repeat-motif 0..* BackboneElement Repeat Motif
..... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
...... repeat-motif-order 0..1 positiveInt Repeat Motif Order
URL: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/repeat-motif-order
..... code 1..1 CodeableConcept repeat-motif
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://hl7.org/fhir/uv/genomics-reporting/CodeSystem/tbd-codes-cs
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: repeat-motif
..... value[x] 1..1 string CAG
.... component:repeat-number 0..* BackboneElement Repeat Number
..... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
...... repeat-motif-order 0..1 positiveInt Repeat Motif Order
URL: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/repeat-motif-order
..... code 1..1 CodeableConcept repeat-number
Required Pattern: At least the following
...... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
....... system 1..1 uri Identity of the terminology system
Fixed Value: http://hl7.org/fhir/uv/genomics-reporting/CodeSystem/tbd-codes-cs
....... code 1..1 code Symbol in syntax defined by the system
Fixed Value: repeat-number
..... value[x] 1..1 Quantity 40

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Observation.value[x]:valueCodeableConceptrequiredLOINC LL1971-2
http://loinc.org/vs/LL1971-2
Observation.methodextensibleLOINC LL4048-6
http://loinc.org/vs/LL4048-6
Observation.component:representative-coding-hgvs.value[x]requiredHGVSVS
http://hl7.org/fhir/uv/genomics-reporting/ValueSet/hgvs-vs
from this IG
Observation.component:genomic-hgvs.value[x]requiredHGVSVS
http://hl7.org/fhir/uv/genomics-reporting/ValueSet/hgvs-vs
from this IG
Observation.component:cytogenomic-nomenclature.value[x]example
Observation.component:genomic-ref-seq.value[x]example
Observation.component:representative-protein-ref-seq.value[x]example
Observation.component:representative-transcript-ref-seq.value[x]example
Observation.component:coordinate-system.value[x]extensibleLOINC LL5323-2
http://loinc.org/vs/LL5323-2
Observation.component:coding-change-type.value[x]extensibleDNAChangeTypeVS
http://hl7.org/fhir/uv/genomics-reporting/ValueSet/dna-change-type-vs
from this IG
Observation.component:genomic-source-class.value[x]extensibleLOINC LL378-1
http://loinc.org/vs/LL378-1
Observation.component:allelic-state.value[x]extensibleLOINC LL381-5
http://loinc.org/vs/LL381-5
Observation.component:variant-inheritance.value[x]extensibleLOINC LL5489-1
http://loinc.org/vs/LL5489-1
Observation.component:variant-inheritance-basis.value[x]extensibleLOINC LL4050-2
http://loinc.org/vs/LL4050-2
Observation.component:variation-code.value[x]example
Observation.component:representative-protein-hgvs.value[x]requiredHGVSVS
http://hl7.org/fhir/uv/genomics-reporting/ValueSet/hgvs-vs
from this IG
Observation.component:variant-confidence-status.value[x]requiredVariantConfidenceStatusVS (a valid code from Variant Confidence Status Codes)
http://hl7.org/fhir/uv/genomics-reporting/ValueSet/variant-confidence-status-vs
from this IG

 

Other representations of profile: CSV, Excel, Schematron