FHIR Release 3 (STU) 4

This page is part of the FHIR Specification (v3.0.2: (v4.0.1: R4 - Mixed Normative and STU 3). ) in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R4 R3

10.8 10.10 Genomics Implementation Guidance

Clinical Genomics Work Group Maturity Level : 1 Ballot Standards Status : Trial Use

Table of Contents

  1. Background
  2. Overview
  3. Sequence MolecularSequence Resource
  4. Observation-genetics Profile
  5. DiagnosticReport-genetics Profile
  6. ProcedureRequest-genetics ServiceRequest-genetics Profile
  7. HLA genotyping results Profile
  8. Relationship among Sequence MolecularSequence resource and genetics profiles
  9. HL7 Domain Analysis Model Use Cases
  10. Other Genomics Use Cases
  11. Clinical Genomics Apps
  12. Appendix 1: From DSTU2 Genomics to STU3

Trial-Use Note:

The material on this page is currently undergoing work to be refactored in a future release as further analysis is done, for example as part of the Genomics Reporting Implementation Guide .

10.8 10.10 Background

Rapid advances in sequencing technologies, clinical genetics tests for whole genome and exome sequencing are allowing sophisticated genetics testing to be used by providers and patients in clinical decisions. Results from such tests are used to identify distinct genetic variants that may contribute to syndromes, conditions and/or predictive responses to treatments. The implementation of precision medicine will depend upon having such data to diagnose patients, choose medications, and predict the course of disease and care, but will require standards and effective user interfaces.

A current technical challenge exists in interoperability, the ability to access and share clinical and genetics data. The challenges of interoperability includes collection, coding, and retrieval to scale. An individual's genetic data set is large, complex and requires curation. Unfortunately, incompatible systems and nomenclatures are already in use. A standards-based ontology that could be adopted to integrate both genetic data and clinical information systems will be crucial to accelerating the integration of precision medicine and to make sense of genetic testing results in a complete clinical context.

One approach for collecting, coding, and retrieving genetics data comes from the Global Alliance for Genomics and Health ( GA4GH ). The GA4GH organization has built and is refining an API and data model for the exchange of full sequence genomic information across multiple research organizations and platforms. The GA4GH focuses on the needs of researchers.

A second approach is evolving from HL7 through FHIR . FHIR is attractive because it is relatively easy to implement because it is comprised of a set of modular components called resources, which can be easily and incrementally assembled into working systems. The clinical requirements for genetics data is, relative to genomics research needs, utilitarian and reductive because it is about distilling and extracting particular genetics data produced by ever more sophisticated testing for use at the point-of-care. This has made FHIR a very functional framework to initiate an interoperable clinical genetics data standardization to which multiple stakeholders have contributed to this guide.

FHIR DSTU2 introduced a standard genetics profile that applies to the FHIR Observation resource. Using this profile, Observation payloads can return genetic testing results in a standardized manner.

Extending Observations rather than creating a new, dedicated FHIR genetics data resource is consistent with the FHIR community mandate because it only adds new resources to an existing resource library when there is a compelling case to do so. We provide the case to add a Sequence MolecularSequence resource in this specification.

10.8 10.10 Overview

STU3 moves beyond FHIR DSTU2 Standard Genetics profile on Observation allowing increased granularity and less ambiguity by creating a new resource to be called Sequence MolecularSequence . This resource will be used to hold clinically relevant sequence data in a manner that is both efficient and versatile integrating new and as yet undefined types of genomic and other -omics data that will soon be commonly entered into health records for clinical use. Sequence MolecularSequence will be leveraged by other FHIR resources, including Observation. This is consistent with how all FHIR resources are designed and used.

The September 2014 Informative Ballot (“HL7 Clinical Genomics, Domain Analysis Model: Clinical Sequencing Release 1”) provided guiding use cases, which initially informed development of the initial Standard Genetics profile that is found in FHIR DSTU2. The same use cases also led to a second Project to develop a Sequence MolecularSequence resource (“Develop FHIR sequence resource for Clinical Genomics”). A preliminary effort to address these issues has been explored and published in context of the Substitutable Medical Applications and Reusable Technologies ( SMART ) Platforms Project and described in an article (“ SMART on FHIR Genomics: Facilitating standardized clinico-genomic apps ”).

Sequence MolecularSequence is designed to hold genetic sequences in blocks relevant to actionable clinical decision-making. Extensions to Sequence MolecularSequence address complex cases and can associate it with repositories for retrieving a patient’s full sequence data, such as those defined by GA4GH. Other changes include a suite of genetics profiles for other FHIR resources. In addition, the Observation-genetics profile adds new references so that an Observation can report genetics test results to be integrated into the EHR. There are also new genetics-extension profiles for DiagnosticReport, ProcedureRequest ServiceRequest and FamilyMemberHistory, respectively, to extend them to report genetics results. We have given all of these FHIR genetics profiles the suffix “-genetics” (e.g. “DiagnosticReport-genetics profile”). New profiles on top of DiagnosticReport have been created for reporting HLA genotyping results.

On the following pages, we elaborate upon the rationale for the proposed design, introducing in some detail the following resource and profiles:

  • A Sequence MolecularSequence resource
  • An Observation-genetics profile on Observation
  • A DiagnosticReport-genetics profile on DiagnosticReport
  • A ProcedureRequest-genetics ServiceRequest-genetics profile on ProcedureRequest ServiceRequest
  • An HLA-genotyping-results profile on DiagnosticReport

With these resource and profiles, FHIR can support a large set of clinical use cases (see Section 9 , 10 , and 11 ) and is thus positioned to address all emergent -omics use cases, including Next-Generation Sequencing ( NGS ). These tools are simple to implement, will optimize payload sizes, and help developers avoid redundant retrieval of data. Appendix 1 of this document shows how DSTU 2.0 can be mapped to the new additions to the resource.

10.8 10.10 Sequence MolecularSequence Resource

10.8.1 10.10.1 Structure Diagram

1..1
Name Flags Card. Type Description & Constraints doco
. . Sequence MolecularSequence Σ I TU DomainResource Information about a biological sequence
+ Rule: Only 0 and 1 are valid for coordinateSystem
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Unique ID for this particular sequence. This is a FHIR-defined id
. . . type Σ 0..1 code aa | dna | rna
sequenceType ( Example Required )
. . . coordinateSystem Σ 1..1 integer Base number of coordinate system (0 for 0-based numbering or coordinates, inclusive start, exclusive end, 1 for 1-based numbering, inclusive start, inclusive end)
. . . patient Σ 0..1 Reference ( Patient ) Who and/or what this is about
. . . specimen Σ 0..1 Reference ( Specimen ) Specimen used for sequencing
. . . device Σ 0..1 Reference ( Device ) The method for sequencing
. . . performer Σ 0..1 Reference ( Organization ) Who should be responsible for test result
. . . quantity Σ 0..1 Quantity The number of copies of the seqeunce sequence of interest. (RNASeq)
. . . referenceSeq Σ I 0..1 BackboneElement A sequence used as reference
+ Only +1 and -1 are valid for strand + Rule: GenomeBuild and chromosome must be both contained if either one of them is contained
+ Rule: Have and only have one of the following elements in referenceSeq : 1. genomeBuild ; 2 referenceSeqId; 3. referenceSeqPointer; 4. referenceSeqString;
. . . . chromosome Σ 0..1 CodeableConcept Chromosome containing genetic finding
chromosome-human ( Example )
. . . . genomeBuild Σ 0..1 string The Genome Build used for reference, following GRCh build versions e.g. 'GRCh 37'
. . . referenceSeqId . orientation Σ 0..1 code sense | antisense
orientationType ( Required )
.... referenceSeqId Σ 0..1 CodeableConcept Reference identifier
ENSEMBL E n s e m b l ( Example )
. . . . referenceSeqPointer Σ 0..1 Reference ( Sequence MolecularSequence ) A Pointer pointer to another Sequence MolecularSequence entity as reference sequence
. . . . referenceSeqString Σ 0..1 string A string to represent reference sequence
. . . . strand Σ 0..1 integer code Directionality of DNA watson | crick
strandType ( +1/-1) Required )
. . . . windowStart Σ 0..1 integer Start position of the window on the reference sequence
. . . . windowEnd Σ 1..1 0..1 integer End position of the window on the reference sequence
. . . variant Σ 0..* BackboneElement Variant in sequence
. . . . start Σ 0..1 integer Start position of the variant on the reference sequence
. . . . end Σ 0..1 integer End position of the variant on the reference sequence
. . . . observedAllele Σ 0..1 string Allele that was observed
. . . . referenceAllele Σ 0..1 string Allele in the reference sequence
. . . . cigar Σ 0..1 string Extended CIGAR string for aligning the sequence with reference bases
. . . . variantPointer Σ 0..1 Reference ( Observation ) Pointer to observed variant information
. . . observedSeq Σ 0..1 string Sequence that was observed
. . . quality Σ 0..* BackboneElement An set of value as quality of sequence
. . . . type Σ 1..1 code indel | snp | unknown
qualityType ( Required )
. . . . standardSequence Σ 0..1 CodeableConcept Standard sequence for comparison
FDA-StandardSequence F d a- standard sequence ( Example )
. . . . start Σ 0..1 integer Start position of the sequence
. . . . end Σ 0..1 integer End position of the sequence
. . . . score Σ 0..1 Quantity Quality score for the comparison
. . . . method Σ 0..1 CodeableConcept Method to get quality
FDA-Method F d a- method ( Example )
. . . . truthTP Σ 0..1 decimal True positives from the perspective of the truth data
. . . . queryTP Σ 0..1 decimal True positives from the perspective of the query data
. . . . truthFN Σ 0..1 decimal False negatives
. . . . queryFP Σ 0..1 decimal False positives
. . . . gtFP Σ 0..1 decimal False positives where the non-REF alleles in the Truth and Query Call Sets match
. . . . precision Σ 0..1 decimal Precision of comparison
. . . . recall Σ 0..1 decimal Recall of comparison
. . . . fScore Σ 0..1 decimal F-score
. . . fScore . roc Σ 0..1 BackboneElement Receiver Operator Characteristic (ROC) Curve
..... score Σ 0..* integer Genotype quality score
..... numTP Σ 0..* integer Roc score true positive numbers
..... numFP Σ 0..* integer Roc score false positive numbers
..... numFN Σ 0..* integer Roc score false negative numbers
..... precision Σ 0..* decimal Precision of the GQ score
..... sensitivity F-score Σ 0..* decimal Sensitivity of the GQ score
..... fMeasure Σ 0..* decimal FScore of the GQ score
. . . readCoverage Σ 0..1 integer Average number of reads representing a given nucleotide in the reconstructed sequence
. . . repository Σ 0..* BackboneElement External repository which contains detailed report related with observedSeq in this resource
. . . . type Σ 1..1 code directlink | openapi | login | oauth | other
repositoryType ( Required )
. . . . url Σ 0..1 uri URI of the repository
. . . . name Σ 0..1 string Repository's name
. . . . datasetId Σ 0..1 string Id of the dataset that used to call for dataset in repository
. . . . variantsetId Σ 0..1 string Id of the variantset that used to call for variantset in repository
. . . . readsetId Σ 0..1 string Id of the read
. . . pointer Σ 0..* Reference ( Sequence MolecularSequence ) Pointer to next atomic sequence
. . . structureVariant Σ 0..* BackboneElement Structural variant
.... variantType Σ 0..1 CodeableConcept Structural variant change type
LOINC LL379-9 answerlist ( Required )
.... exact Σ 0..1 boolean Does the structural variant have base pair resolution breakpoints?
.... length Σ 0..1 integer Structural variant length
.... outer Σ 0..1 BackboneElement Structural variant outer
..... start Σ 0..1 integer Structural variant outer start
..... end Σ 0..1 integer Structural variant outer end
.... inner Σ 0..1 BackboneElement Structural variant inner
..... start Σ 0..1 integer Structural variant inner start
..... end Σ 0..1 integer Structural variant inner end

doco Documentation for this format

10.8.2 10.10.2 Description

The Sequence MolecularSequence resource is designed for next-generation sequencing data. Patients’ observed sequences should be represented by recording reference sequence id/string and detected variants. To specify how it proceed, here is a picture below:

null

Sequence.coordinateSystem: MolecularSequence.coordinateSystem: This element shall be constrained into only two possible values: 0 for 0-based system and 1 for 1-based system. Below is the picture that could explain what’s the difference between these two systems:

coordinateSystem

Here are two examples that clarify the usage in both cases (they represent same segment part):

Sequence.referenceSeq: MolecularSequence.referenceSeq: Four optional ways are provided to represent reference sequence in Sequence MolecularSequence resource:

  1. Sequence.referenceSeq.referenceSeqId: MolecularSequence.referenceSeq.referenceSeqId: Reference sequence id in public database;
  2. Sequence.referenceSeq.referenceSeqString: MolecularSequence.referenceSeq.referenceSeqString: Reference sequence string;
  3. Sequence.referenceSeq.referenceSeqPointer: MolecularSequence.referenceSeq.referenceSeqPointer: Reference to observed sequence stored in another sequence entity;
  4. Sequence.referenceSeq.genomeBuild, Sequence.reference.chromosome: MolecularSequence.referenceSeq.genomeBuild, MolecularSequence.reference.chromosome: The combination of genome build and chromosome.

The window selects a range from the reference sequence (or genome) that is used to define building block of a current sequence (e.g. Sequence MolecularSequence resource instance 1).

Sequence.referenceSeq.strand: MolecularSequence.referenceSeq.strand: Only two possible values can be made by strand, +1 for plus strand while -1 for minus strand. Since the directionality of the sequence string might be represented in different word in different omics scenario, below are simple example of how to map other expressions into its correlated value:

Map to +1 Map to -1
5′-to-3′ direction 3′-to-5′ direction
Watson Crick
Sense Antisense
Positive Negative

Sequence.quality: MolecularSequence.quality: Quality scores for bases in the sequence. Is It is intended to be compliant with emerging regulatory needs needs (eg: those found at PrecisionFDA ).

Sequence.variant: MolecularSequence.variant: This complex element is used for encoding sequence. When the information of reference sequence and variants are provided, the observed sequence will be derived.

10.8.2.1 10.10.2.1 Internal Pointers

Sequence.patient: MolecularSequence.patient: This element points to a Patient identifier to show that this sequence is related to the same patient.

Sequence.specimen: MolecularSequence.specimen: A pointer to specimen identifier, if needed.

Sequence.device: MolecularSequence.device: A pointer to Device identifier which is used for describing sequencing method (such as chip id, chip manufacturer etc.)

Sequence.pointer: MolecularSequence.pointer: A pointer to a Sequence MolecularSequence instance for the next sequence block to build a sequence graph.

10.8.2.2 10.10.2.2 External Pointers

Sequence.repository: MolecularSequence.repository: This complex element is used to provide a clarifying structure, a base URL, and/or relevant IDs when referring to an external repository.

GA4GH Repository Example. If the Sequence MolecularSequence resource refers to a GA4GH repository for read info, references to a GA4GH full sequence dataset should conform to GA4GH data models and accessed via the GA4GH API. The URL of a GA4GH repository, ids of a GA4GH variant and read group are contained in the Sequence MolecularSequence resource. The URL of a GA4GH repository is an api_base of a GA4GH server that could be called for sequence data. The GA4GH variant set is a collection of call sets and the GA4GH call set is a collection of variant calls, typically for one sample. A variant call represents a determination of genotype with respect to that variant.

VariantSet definition: A VariantSet is a collection of variants and variant calls intended to be analyzed together.

CallSet definition: A CallSet is a collection of calls that were generated by the same analysis of the same sample.

A read group is a collection of reads produced by a sequencer. A read group set typically models reads corresponding to one sample, sequenced one way, and aligned one way. The API reference of Google Genomics is a GA4GH repository built by Google and provides details of the data models, such as the resource representations.

10.8.3 10.10.3 Usage Examples

10.8.3.1 10.10.3.1 Different way to represent sequence record with variations

We provide a detailed example to show how sequence resource can be used to represent record of observed sequence by different method.

MolecularSequence Graph

The diagram above describes 4 optional ways provided in the Sequence MolecularSequence resource to encode sequencing data. Here are the corresponding examples

10.8.3.2 10.10.3.2 Example from precision FDA

We provide one example to show how precision FDA vcf data can be upload and comform FHIR specification, and how quality in sequence resource is represented by comparison between a reference sequence and the observed sequence.

Source: XML , JSON , Turtle .

10.8.3.3 10.10.3.3 Complex Variation example

We provide one example to show how a complex variant can be represented with the help of cigar. The deletion, insertion and mutation is represented in characters along with the number of repetition.

Source: XML , JSON , Turtle .

10.8 10.10 Observation-genetics Profile

10.8.1 10.10.1 Structure Diagram

Name of allele Allele frequency CodeableConcept 0 .. 1 CodeableConcept Genomic source class uri 0 .. * Reference ( Sequence ) Sequence Reference ( Observation )
Name Flags Card. Type Description & Constraints doco
. . Observation 0 .. * observation-geneticsDNASequenceVariantName 0 .. 1 CodeableConcept DNA sequence variant URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsDNASequenceVariantName Binding: ???? ( preferred ) observation-geneticsDNAVariantId 0 .. 1 CodeableConcept DNA sequence variant ID URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsDNAVariantId observation-geneticsDNASequenceVariantType 0 .. 1 CodeableConcept DNA sequence variant type URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsDNASequenceVariantType observation-geneticsAminoAcidChangeName 0 .. 1 CodeableConcept Amino acid change URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsAminoAcidChangeName Binding: ???? ( preferred ) observation-geneticsAminoAcidChangeType 0 .. 1 0..* CodeableConcept Amino Acid Change Type URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsAminoAcidChangeType
. . . observation-geneticsGene 0 .. 1 0..1 CodeableConcept HGNC gene symbol
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsGene
Binding: ???? H g n c ( preferred )
. . . observation-geneticsDNARegionName 0 .. 1 0..1 string DNA region name
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsDNARegionName
. . observation-geneticsAlleleName . observation-geneticsCopyNumberEvent 0 .. 1 0..1 CodeableConcept Copy number variation
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsAlleleName http://hl7.org/fhir/StructureDefinition/observation-geneticsCopyNumberEvent Binding: ???? ( preferred )
. . . observation-geneticsAllelicState observation-geneticsGenomicSourceClass 0 .. 1 0..1 CodeableConcept The level of occurrence of a single DNA sequence variant within a set of chromosomes: Heteroplasmic / Homoplasmic / Homozygous / Heterozygous / Hemizygous Genomic source class
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsAllelicState http://hl7.org/fhir/StructureDefinition/observation-geneticsGenomicSourceClass
. . observation-geneticsAllelicFrequency . observation-geneticsInterpretation 0 .. 1 0..1 decimal Reference ( Observation ) Clinical interpretations for variant
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsAllelicFrequency http://hl7.org/fhir/StructureDefinition/observation-geneticsInterpretation
. . observation-geneticsCopyNumberEvent . observation-geneticsVariant 0 .. 1 0..1 (Complex) Copy number variation Variant
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsCopyNumberEvent http://hl7.org/fhir/StructureDefinition/observation-geneticsVariant
. . observation-geneticsGenomicSourceClass . observation-geneticsAminoAcidChange 0..1 (Complex) AminoAcidChange
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsGenomicSourceClass http://hl7.org/fhir/StructureDefinition/observation-geneticsAminoAcidChange
. . observation-geneticsPhaseSet . observation-geneticsAllele 0 .. 1 0..1 (Complex) Phase set identifier (UUID/OID) Allele
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsPhaseSet http://hl7.org/fhir/StructureDefinition/observation-geneticsAllele
. . observation-geneticsSequence . observation-geneticsAncestry 0..1 (Complex) Ancestry
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsSequence http://hl7.org/fhir/StructureDefinition/observation-geneticsAncestry
. . observation-geneticsInterpretation . observation-geneticsPhaseSet 0 .. 1 0..* (Complex) Clinical interpretations for variant Phase set
URL: http://hl7.org/fhir/StructureDefinition/observation-geneticsInterpretation http://hl7.org/fhir/StructureDefinition/observation-geneticsPhaseSet

doco Documentation for this format

10.8.2 10.10.2 Description

The Observation-genetics profile Observation-genetics profile is used to interpret variants from sequence resource. Clinical usage may need more specific representation of variant at locus or structural variant in whole genome.

Some of the attributes of the profile follow:

  • The observation-geneticsSequence extension will refer to the Sequence MolecularSequence resource for sequence information related to this variant.
  • The observation-geneticsInterpretation extension will refer to an Observation instance which contains clinical interpretations for the variant described.
  • The code, effective[x], issued, performer, method, specimen elements can be used to describe how the genetic observation (variant and sequence data) is obtained.
  • Other extensions are used to describe attributes of this variant such as Genomics Source Class, Amino Acid Change Type, etc. These are mappings from v2 and lonic code reference with details can be found in this list .

Additional Observations instance will be created for variant's further analysis. For example, Observation.component element will be used for knowledge-based interpretations of the sequence variant. Here are some examples for the component.code.

LOINC Code LOINC Element Name Comments
51963-7 Medication Assessed A coded medication accessed in a pharmacogenetic test (recommend RxNorm).
51967-8 Genetic disease assessed A coded disease that is associated with the region of DNA covered by the genetic test (recommend SNOMED).
53037-8 Genetic Disease Sequence Variant Interpretation Interpretation of the pathogenicity of the DNA Sequence Variant in the context of the assessed genetic disease.
53040-2 Drug Metabolism Sequence Variant Interpretation Predicted phenotype for drug efficacy. A sequence variant interpretation value known to allow (responsive) or prevent (resistant) the drug to perform.
51961-1 Drug Efficacy Sequence Variant Interpretation Predicted phenotype for ability of drug to bind to intended site in order to deliver intended effect. A Sequence Variant interpretation value known to allow (responsive) or prevent (resistant) the drug to perform.

In the meantime, the related element in this Observation instance will point to Observaiton-genetics profile to show these clinical interpretations are further analysis for the variant. (For example, sequence variant has its pointer back to the observation, see PGx example )

10.8.3 10.10.3 Usage Examples

10.8.3.1 10.10.3.1 An Observation-genetics instance and its two related Observation instances for interpretations

We provide an example of an Observation-genetics instance which records a variant detected in the patient. (we call this example A)

Source: XML , JSON , Turtle .

An example of an Observation instance which records knowledge-based clinical interpretations for the variant represented in A.

Source: XML , JSON , Turtle .

An example of an Observation instance which records PCR validation test for the variant in A.

Source: XML , JSON , Turtle .

10.8.3.2 10.10.3.2 Phenotype, Diplotype and Haplotye

We provide the following examples to reveal how PGx data can be harmonized within the FHIR specification. Detailed discussion will be put here.

10.8 10.10 DiagnosticReport-genetics Profile

10.8.1 10.10.1 Structure Diagram

codedDiagnosis 0 .. 0 .. *
Name Flags Card. Type Description & Constraints doco
. . DiagnosticReport 0 .. * 0..* 0 .. 0
. . . DiagnosticReport-geneticsAssessedCondition * 0..* Reference ( Condition ) AssessedCondition
URL: http://hl7.org/fhir/StructureDefinition/DiagnosticReport-geneticsAssessedCondition
. . . DiagnosticReport-geneticsFamilyMemberHistory 0 .. * 0..* Reference ( FamilyMemberHistory ) FamilyHistory
URL: http://hl7.org/fhir/StructureDefinition/DiagnosticReport-geneticsFamilyMemberHistory
. . . DiagnosticReport-geneticsAnalysis 0..* (Complex) Analysis
URL: http://hl7.org/fhir/StructureDefinition/DiagnosticReport-geneticsAnalysis
... DiagnosticReport-geneticsReferences 0..* (Complex) Analysis References
URL: http://hl7.org/fhir/StructureDefinition/DiagnosticReport-geneticsAnalysis http://hl7.org/fhir/StructureDefinition/DiagnosticReport-geneticsReferences
. . . conclusionCode 0 .. 0

doco Documentation for this format

This DiagnosticReport-genetics is built on top of DiagnosticReport. The new profile is used to describe a genetics test report. The result element in DiagnosticReport will refer to the Observation resource that can lead to a bundle of genetic observations. And the The element of code, effective[x], issued, performer, request, specimen are be used to describe the details of the genetic test. Extensions about AssessedCondition and FamilyMemberHistory are added. Overall, this profile extends the DiagnosticReport resource to enable reporting of structured genetic test results. In addition, it denotes condition context for genetic testing, which may influence reported variants and interpretations for large genomic testing panels.

  • The DiagnosticReport-genetics profile contains two extensions referring to other resources/profiles and one complex extension.
  • AssessedCondition is used to denote condition context for genetic testing, which may influence reported variants and interpretation for large genomic testing panels. It refers to the Condition resource.
  • FamilyMemberHistory are significant health events and conditions for one or more persons related to the patient. It refers to the FamilyMemberHistory-Genetic profile.
  • Analysis provides knowledge-based interpretation of overall results of tests performed on patients.

Examples for analysis.code:

LOINC Code LOINC Element Name Comments
51968-6 Genetic Disease Analysis Overall Interpretation Interpretation of all identified DNA Sequence variants along with any known clinical information for the benefit of aiding clinicians in understanding the results overall in either the context of diagnosis or increased risk of disease.
51964-5 Drug Efficacy Analysis Overall Interpretation Overall predicted phenotype for drug efficacy for all DNA Sequence Variants identified in a single case.
51971-0 Drug metabolism analysis overall interpretation Overall predicted phenotype for drug metabolism for all DNA Sequence Variants identified in a single case.

10.8.2 10.10.2 Usage Examples

An example of a genetic test report for a patient with FamilyHistory.

Source: XML , JSON , Turtle .

An example of a comprehensive bone marrow report.

Source: XML , JSON , Turtle .

10.8 10.10 ProcedureRequest-genetics ServiceRequest-genetics profile

10.8.1 10.10.1 Structure Diagram

A complex extension is added on top of the ProcedureRequest ServiceRequest resource. Here is the structure of the extension:

.. * 0 ..
Name Flags Card. Type Description & Constraints doco
. . ProcedureRequest ServiceRequest 0 0..*
. . procedurerequest-geneticsItem . servicerequest-geneticsItem * 0..* (Complex) The items the orderer requested
URL: http://hl7.org/fhir/StructureDefinition/procedurerequest-geneticsItem http://hl7.org/fhir/StructureDefinition/servicerequest-geneticsItem

doco Documentation for this format

10.8.2 10.10.2 Description

To describe an order requested sequence variants detection. User must set up the code for the request and they can also refer to the corresponding sequence instance for that variant.

10.8.3 10.10.3 Usage Example

10.8.3.1 10.10.3.1 An order for genetics test

Here is a diagnostic request for testing 185delAG variant. The mother of the patient received results from a mutation panel (eg. MyRisk from Myriad) and she has a BRCA1 185delAG mutation. The clinician the would like to request to test the patient only for an 185delAG mutation. In this case, the diagnostic request for the patient will specify the sequence variant - 185delAG.

10.8 10.10 HLA genotyping results Profile

Human leukocyte antigen (HLA) genotyping is fundamental for research and clinical practice in immunogenetics and histocompatibility. Pointers to external locations refer to registered methods, raw NGS reads, and reference standards can be conveyed in this profile. Information about allele assignment including ambiguous results and the allele database used for assignments is stored in extensions.

The structure of the HLA typing report in this profile attempts to follow the principles outlined in the Minimum Information for ReportIng Next-generation sequence Genotyping (MIRING). These principles were identified through a series of meetings with international group of stakeholders in the application of Next Generation Sequencing (NGS) technology for genotyping the HLA and KIR loci as well as other immune-related loci (http://igdawg.org/ngs.html). MIRING describes eight principles, described in detail in Human Immunology. 2015 Dec; 76(12):954-962 . These include detailed metadata about:

  1. MIRING Annotation
  2. Reference Context
  3. Full Genotype
  4. Consensus Sequence
  5. Novel Polymorphisms
  6. Platform Documentation
  7. Read Processing Documentation
  8. Primary Data
(see the publication above for details about each)

These principles were implemented in a technical specification by extending an existing XML based format for exchanging histocompatibility and immunogenetic genotyping data called Histoimmunogenetics Markup Language (HML) to include results from NGS methodologies (https://bioinformatics.bethematchclinical.org/hla-resources/hml/). The resulting schema may be found in https://schemas.nmdp.org/. The National Marrow Donor Program (NMDP)/Be The Match uses this format for reporting HLA genotyping from potential donors and for patients needing stem cell transplants.

Both MIRING and HML were used to inform mapping data elements to FHIR resources such as Patient, Specimen, Sequence, MolecularSequence, Observation-Genetic Profile, and DiagnosticReport where possible. Several additional data elements were needed specifically for this use case, resulting in the development of a specific profile for reporting HLA genotyping results (Diagnostic Report Profile for HLA Genotyping Results).

  • Minimum information for reporting next generation sequence genotyping (MIRING): Guidelines for reporting HLA and KIR genotyping via next generation sequencing (see here )
  • Histoimmunogenetics Markup Language 1.0: Reporting Next Generation Sequencing-based HLA and KIR Genotyping (see here )

10.8.1 10.10.1 Structure Diagram of HLA genotyping results Profile

Name Flags Card. Type Description & Constraints doco
. . extension haploid 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-haploid
haploid: haploid.


Use on element: Element ID DiagnosticReport
. . . locus 0..1 CodeableConcept gene region.

. . . type 0..1 CodeableConcept haploid type.

. . . method 0..1 CodeableConcept haploid method.


doco Documentation for this format

Both hla-genotyping-results-glstring and hla-genotyping-results-haploid are complex extensions.

The development of these extensions were informed from the allele-assignment structure found in HML. While allele assignment for individual loci can be reported in an Observation, here they are used to summarize the assignments at a report level. Two methods may be used for reporting HLA allele-assignments: Haploid and GL String.

Structure of hla-genotyping-results-haploid:

Name Flags Card. Type Description & Constraints doco
. . extension haploid 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-haploid
haploid: haploid.


Use on element: Element ID DiagnosticReport
. . . locus 0..1 CodeableConcept gene region.

. . . type 0..1 CodeableConcept haploid type.

. . . method 0..1 CodeableConcept haploid method.


doco Documentation for this format

Haploid reporting is a method that is used to report an individual allele, or a list of possible alleles if the results are ambiguous, using NMDP Multiple Allele Codes (MAC) which is a shorthand for describing allele ambiguity (https://bioinformatics.bethematchclinical.org/hla-resources/allele-codes/). MACs are widely used for reporting HLA typing results because they are able to report long allele lists in a small amount of space, but the system has a number of shortcomings ( Tissue Antigens. 2013 Aug;82(2):106-12 ). When reporting data using haploid, typical use is one or two haploid elements for a particular locus, but possibly more if multiple loci are covered (ex: two HLA-DRB1 haploids + one HLA-DRB3 haploid).

Within Haploid, Method indicates whether the general methodology is DNA based typing (e.g., Sequence Specific Primers (SSP), Sequence Specific Oligonucleotide Probes (SSOP), or Sequence Based Typing (SBT)), or SER which indicates serology based methods.

Example of using two hla-genotyping-results-haploid extensions to report a HLA-A genotype of HLA-A*01:AB and HLA-A*02:MN which expands to HLA-A*01:01/HLA-A*01:02 and HLA-A:02:01/HLA-A:02:02/HLA-A:02:03 

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-haploid" >

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-haploid" >

    <extension url=”locus”>
        <valueCodeableConcept>
            <coding>
                <system value="http://www.genenames.org"/>
                <code value="4931"/>
                <display value="HLA-A"/>

                <system value="http://www.genenames.org"/>
                <code value="4931"/>
                <display value="HLA-A"/>

            </coding>
            <text value="HLA-A"/>

            <text value="HLA-A"/>

        </valueCodeableConcept>
    </extension>
    <extension url=”type”>
        <valueCodeableConcept>
             <coding>
                <system value="https://bioinformatics.bethematchclinical.org/hla-resources/allele-codes/"/>
                <code value="AB"/>
                <display value="01/02"/>

                <system value="https://bioinformatics.bethematchclinical.org/hla-resources/allele-codes/"/>
                <code value="AB"/>
                <display value="01/02"/>

            </coding>
            <text value="HLA-A*01:AB"/>

            <text value="HLA-A*01:AB"/>

        </valueCodeableConcept>
    </extension>
    <extension url=”method”>
        <valueCodeableConcept>
            <text value=”DNA”/>
        </valueCodeableConcept>
    </extension>
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-haploid" >

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-haploid" >

    <extension url=”locus”>
        <valueCodeableConcept>
            <coding>
                <system value="http://www.genenames.org"/>
                <code value="4931"/>
                <display value="HLA-A"/>

                <system value="http://www.genenames.org"/>
                <code value="4931"/>
                <display value="HLA-A"/>

            </coding>
            <text value="HLA-A"/>

            <text value="HLA-A"/>

        </valueCodeableConcept>
    </extension>
    <extension url=”type”>
        <valueCodeableConcept>
             <coding>
                <system value="https://bioinformatics.bethematchclinical.org/hla-resources/allele-codes/"/>
                <code value="AB"/>
                <display value="01/02/03"/>

                <system value="https://bioinformatics.bethematchclinical.org/hla-resources/allele-codes/"/>
                <code value="AB"/>
                <display value="01/02/03"/>

            </coding>
            <text value="HLA-A*02:MN"/>

            <text value="HLA-A*02:MN"/>

        </valueCodeableConcept>
    </extension>
    <extension url=”method”>
        <valueCodeableConcept>
            <text value=”DNA”/>
        </valueCodeableConcept>
    </extension>
  </extension>

Because of limitations with MAC, another method called GL Strings was developed that encodes the results in a text string with hierarchical set of operators to describe the relationships between alleles, lists of possible alleles, phased alleles, genotypes, lists of possible genotypes, and multilocus unphased genotypes, without losing typing information or increasing typing ambiguity. ( Tissue Antigens. 2013 Aug;82(2):106-12 ).

The structure of HLA-genotyping-results-glstring:

Name Flags Card. Type Description & Constraints doco
. . extension glstring 0..1 Extension URL = http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-glstring
glstring: glstring.


Use on element: Element ID DiagnosticReport
. . . url 0..1 uri glstring using a URI reference.

. . . text 0..1 string glstring using inline data.


doco Documentation for this format

While the string format is easily parsed into separate components to be rendered for user viewing, GL Strings by themselves are potentially quite long and difficult to read. It often advantageous to point to a URI which may return the GL String on demand to avoid manual data entry. This is available through the URI element in this extension.

Example of using the hla-genotyping-results-glstring to report a GL String in both text and URI formats 

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-glstring">

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-glstring">

    <extension url=”text”>
        <valueString value="HLA-A*01:01:01:01/HLA-A*01:02+HLA-A*02:01:02/HLA-A*02:02:02/HLA-A*02:03:01"/>

        <valueString value="HLA-A*01:01:01:01/HLA-A*01:02+HLA-A*02:01:02/HLA-A*02:02:02/HLA-A*02:03:01"/>

    </extension>
    <extension url=”uri”>
        <valueUri value="https://gl.nmdp.org/imgt-hla/3.23.0/genotype/1h"/>

        <valueUri value="https://gl.nmdp.org/imgt-hla/3.23.0/genotype/1h"/>

    </extension>
  </extension>

Whether reporting in Haploid or GL String formats, it is important to identify the version of the IMGT/HLA allele database, as new HLA alleles are constantly being discovered and allele assignment is based on the known alleles at the time, and so results may need to be reinterpreted later. This is done through the Allele Database element.

Structure of hla-genotyping-results-allele-database

Name Flags Card. Type Description & Constraints doco
. . extension allele-database 0..1 CodeableConcept URL = http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-allele-database
allele-database: Allele Database.


Use on element: Element ID DiagnosticReport

doco Documentation for this format

Example of using hla-genotyping-results-allele-database to report using the IMGT/HLA database, version 3.23 

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-allele-database">

  <extension url="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-allele-database">

    <valueCodeableConcept>
        <coding>
            <system value="http://www.ebi.ac.uk/ipd/imgt/hla/"/>
            <version value="3.23"/>

            <system value="http://www.ebi.ac.uk/ipd/imgt/hla"/>
            <version value="3.23"/>

        </coding>
        <text value="IMGT/HLA 3.23"/>

        <text value="IMGT/HLA 3.23"/>

    </valueCodeableConcept>
  </extension>

Overall methodology may be reported using hla-genotyping-results-method. Here a codeable concept may be used to refer to method entered into a public registry, such as the NCBI Genetic Test Registry, or a local private registry.

Structure of hla-genotyping-results-method

Name Flags Card. Type Description & Constraints doco
. . extension method 0..1 CodeableConcept URL = http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-method
method: The platform, methodology and software applied at the time of the genotyping.


Use on element: Element ID DiagnosticReport

doco Documentation for this format

Example of hla-genotyping-results-method to report a lab test registered in the NCBI Genetic Test Registry 

  <extension  uri="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-method">

  <extension  uri="http://hl7.org/fhir/StructureDefinition/hla-genotyping-results-method">

    <valueCodeableConcept>
          <coding>
              <system value="http://www.ncbi.nlm.nih.gov/gtr/"/>
              <code value="GTR000000000.0"/>

              <system value="http://www.ncbi.nlm.nih.gov/gtr/"/>
              <code value="GTR000000000.0"/>

          </coding>
          <text value=”NGS based HLA-A genotyping”
    </valueCodeableConcept>
  </extension>

10.8.2 10.10.2 Usage Example

Example of a HLA genotyping report

  • that was requested in a Diagnostic Request,
  • with results for HLA-A, HLA-B, HLA-C loci,
  • by Sequence Based Typing (SBT) of exons 2 and 3,
  • using Next Generation Sequencing technologies,
  • allele assignment based on the IMGT/HLA database version 3.23,
  • reported as a multilocus unphased genotype using GL Strings,
  • and with genotyping results for individual loci available in separate Observations

Source: XML , JSON , Turtle .

In the above example, three Observations are referenced, each containing the details surrounding the genotyping of each gene/locus. Those observations would further refer to other observations (using Observation.related) that point to phased exon sequences which are the basis for individual allele assignment. This strategy is illustrated in the following figure for one gene, and sequencing two exons for each allele. Note that references from DiagnosticReport and Observation back to Patient/Donor and Specimen are not shown for clarity, although we would include them in the resource instances.

Phasing

10.8 10.10 Relationship among Sequence MolecularSequence resource and genetics profiles

null

10.8.1 10.10.1 Pointers to Sequence MolecularSequence resource

Sequence MolecularSequence resource is used to transmit and represent sequencing data. In FHIR Genomics, there are several genetics profiles containing internal pointers to Sequence MolecularSequence resource for genetic data reporting. Here is the summary:

Sequence.pointer: MolecularSequence.pointer: A bundle of Sequence MolecularSequence instances can be connected by Sequence.pointer MolecularSequence.pointer to build sequence graph described in Section 3. Sequence.pointer MolecularSequence.pointer will point to the next sequence block.

Sequence MolecularSequence extension in Observation-genetics profile: Observation-genetics profile is used to report a genetic variant found in patients. Sequence MolecularSequence extension contains a pointer to Sequence MolecularSequence identifier which has related sequencing read info. It will provide reference/observed allele information and quality scores for each base/sequence block.

10.8.2 10.10.2 Pointer to Observation resource (based on genetics profile)

Observation-genetics based Observation resource is used for interpretative genetic data. Sequence MolecularSequence resource and genetics profiles will use internal pointers to Observation-genetics-profile based Observation instance for variant report.

Sequence.observation: MolecularSequence.observation: A pointer to genetics Observation instance which is used for interpretations of this sequence block. Interpretations are generally about genetic variant found in this sequence block.

DiagnosticReport.result: A pointer to Observation instance. This element is used for reporting genetic result.

Item extension in ProcedureRequest-genetics ServiceRequest-genetics profile: It is used to describe the genetic test order.

FamilyMemberHistory: A pointer to genetics Observation instance to report genetic test results of family member

10.8.3 10.10.3 Observation vs. Sequence MolecularSequence

Sequence MolecularSequence is used for raw sequencing data while genetic-profile-based Observation resource is used for reporting interpretative genetic information (eg. DNA/amino acid variant detected in the patient). Although both Sequence MolecularSequence and Observation-genetics profiles contain variant info, they are used differently: Sequence.variant MolecularSequence.variant is used for encoding the sequence block; the Observation-genetics profile is mainly used for a variants test result or interpretations of raw data in Sequence MolecularSequence resource.

10.8.4 10.10.4 Usage example

This picture depicts the logical relationship among these resources. And the The definition of pointers are described above:

null

Here are the details and examples mentioned above.

Resource Details of data structures and pointers Links of resources example
Sequence MolecularSequence Sequence MolecularSequence Data Structure Example Here
Observation Observation Data Structure Example Here
ProcedureRequest ServiceRequest ProcedureRequest ServiceRequest Data Structure Example Here
DiagnosticReport DiagnosticReport Data Structure Example Here

Here is a specific use case to depict the whole story of FHIR in the clinical genomics setting: a ProcedureRequest ServiceRequest is requested, then a Diagnosticreport are reported. Two Sequence MolecularSequence instance, two Observation-haplotype instance, a Observation-diplotype and a Observation-phenotype for further interpretation are also created. (You can see the xml code and json code if you click the link.)

  • Haplotype: A haplotype is a set of DNA variations, or polymorphisms, that tend to be inherited together. A haplotype can refer to a combination of alleles or to a set of single nucleotide polymorphisms (SNPs) found on the same chromosome.
  • Diplotype: A diplotype is defined as a specific combination of two haplotypes.
  • Genotype: A genotype is an individual’s collection of genes.
  • Phenotype: A phenotype is the composite of an organism’s observable characteristics or traits, such as its morphology, development, biochemical or physiological properties, behavior and products of behavior.

You can see the relationship among these resources in following picture:

null

10.8 10.10 HL7 Domain Analysis Use Cases

Simulated use of the proposed Sequence MolecularSequence resource and profiles on other FHIR resources are shown for many of the examples in Section 5 – Use Case Scenarios in the HL7 Domain Analysis Model (DAM): Clinical Genomics, Release 1, September 2014 Informative Ballot .

We show use of the FHIR design we are proposing for these cases:

  1. Specimen Identification
    1. Get references to all variants obtained from germline analysis.
    2. Explore antibacterial drug resistance over time (non-patient DNA)
  2. Clinical Sequencing – Germline Testing
  3. Cancer Profiling
  4. Decision Making Tools – Family History and Drug Dosage Calculators
    1. Today clinicians translate (i.e. manually re-enter) genetic data into tools for decision making. This includes family history tools and drug dosage calculators. In the future, this data will automatically be incorporated into clinical decision making tools.
    2. Get pharmacogenomic reporting and disease risk or diagnosis associated with variant
  5. Public Health
  6. Clinical and Research Data Warehouses

10.8.1 10.10.1 Specimen Identification

  • Germline testing for biomarkers/mutations (usually inherited)
  • Tumor testing for biomarkers/mutations (somatic / tumor specific)
  • Pediatric Testing
  • Infectious Disease Testing

10.8.1.1 10.10.1.1 Get references to all variants obtained from germline analysis 

GET   /Observation?
    _profile=http://hl7.org/fhir/StructureDefinition/observation-genetics&
    GenomicSourceClass=http://loinc.org|LA6683-2

null

*Return a bundle of genetics-profile-based Observation instances

10.8.2 10.10.2 Clinical Sequencing – Germline Testing

For a chart review, get references to all DNA sequences related to mutations with an interpretation “Unknown Significance” 

GET /Observation?
    subject=123&
    component-code-value-[x]= http://loinc.org|53037-8$LA6682-4

53037-8: LOINC code for “Genetic disease sequence variant interpretation”

LA6682-4: LOINC answer code for “Unknown Significance”.

null

10.8.3 10.10.3 Cancer Profiling

The goal of this profile methodology is to get references from all variants obtained from somatic analysis. Changes in the population of cells with particular mutations will change overtime as well as in conjunction with events such as therapy. For instance, targeted chemotherapy may kill a specific population of cancer cells with specific mutations and other cancer cell populations may survive and continue to divide. Therefore, clearly annotating these specimens as somatic variants and capturing annotations related to a time relevant to a treatment timeline may be critical for analysis. 

GET /Observation?
    _profile=http://hl7.org/fhir/StructureDefinition/observation-genetics&
    GenomicsSourceClass=http://loinc.org|LA6684-0&
    date=2015-07-04&
    subject=123

null

10.8.4 10.10.4 Decision Making Tools – Family History and Drug Dosage Calculators

Today clinicians translate (i.e. manually re-enter) genetic data into tools for decision making. This includes family history tools and drug dosage calculators. In the future, this data will automatically be incorporated into clinical decision making tools.

Get family history related to one observation: 

GET /DiagnosticReport?
    _profile=http://hl7.org/fhir/StructureDefinition/diagnosticreport-genetic&
    subject=123

null

10.8.4.1 10.10.4.1 Get pharmacogenomic reporting and disease risk or diagnosis associated with variant 

GET /Observation?
    _profile=http://hl7.org/fhir/StructureDefinition/observation-genetics&
    subject=123&
    Interpretation.component-code= http://loinc.org|51963-7

51963-7 : LOINC code for “Medication Assessed ”

null

10.8.5 10.10.5 Public Health

Today Registrars manually translate clinical data into public health reporting systems. This data is used to monitor and improve public health (e.g. surveillance and clinical research). In the future, this data will be extracted from the EHR in an automated (or semi-automated) fashion.

For a breast cancer clinical genomic study, get all genetic-profile-based observations of patients with breast cancer: 

GET /DiagnosticReport?
    _profile=http://hl7.org/fhir/StructureDefinition/diagnosticreport-genetic&
    AssessedCondition.code=http://snomed.info/sct|254837009

null

10.8.6 10.10.6 Clinical and Research Data Warehouses

Health data warehousing should persist data in its standardized formats, while allowing users to export subsets of the data in the warehouse into multiple ‘data marts’, optimized for specific use cases, analysis type or reporting needs.

Get all genetic-profile-based observations of patients with the variant c.181T>G 

GET /Observation?
    _profile=http://hl7.org/fhir/StructureDefinition/observation-genetics&
    DNAVariantID=http://www.ncbi.nlm.nih.gov/projects/SNP|rs58238560

null

10.8 10.10 Other Genomics Use Cases

During the development of the FHIR Genomics design, CGWG participants have commented on the earlier use cases and/or proposed new use cases. In this section, we list describe of these new cases and demonstrate how the proposed design will address them.

10.8.1 10.10.1 Get a patient’s family members genetics report

This example is proposed by Kevin Hughes. Family history is useful for clinicians to know more about the condition of the patient. 

Get /FamilyMemberHistory?
    _profile=http://hl7.org/fhir/StructureDefinition/familymemberhistory-genetic&
    patient=123

null

10.8.2 10.10.2 Panel

Search for results from nephrotic syndrome panel 

Get /DiagnosticReport&
    _profile=http://hl7.org/fhir/StructureDefinition/diagnosticreport-genetic&
    code=N0336&
    patient=123

null

10.8.3 10.10.3 Sequence Basic Queries

Find patients by condition and affected status 


GET /Condition?
    component-code-value-[x]=http://snomed.info/sct|439401001

Find patients by phenotypical attribute 


Get /Observation?
    =http://hl7.org/fhir/StructureDefinition/observation-geneticsGene&
    CodeableConcept=http://loinc.org|79716-7

79716-7: LOINC code for “CYP2C9 gene product metabolic activity interpretation”


Find patients by molecular data type available 


Get /Observation?
    =http://hl7.org/fhir/StructureDefinition/observation-genetics&
    Interpretation.component-code=http://loinc.org|34193-3

34193-3: LOINC code for “SMPD1 gene mutations tested for in Blood or Tissue by Molecular genetics method Nominal"


Find patients by specific molecular marker (genomic region, position, gene, SNP) 


Get /Observation?
    =http://hl7.org/fhir/StructureDefinition/observation-genetics&
    DNARegionName=NC_000017.10:g.497469T>A

53035-2: LOINC code for “DNA marker assessed"


Find mutation by mutation type and position 


Get /Observation?
    =http://hl7.org/fhir/StructureDefinition/observation-geneticsVariant&
    Name=NM_000059.3:c.706C;A&
	Type=http://loinc.org|81289-1

Find patients based on mode of inheritance (genomic region, position, gene, SNP) 


Get /FamilyMemberHistory?
    _profile=http://hl7.org/fhir/StructureDefinition/familymemberhistory-genetic&
    reasonCode=http://snomed.info/sct|272398008

7272398008: SNOMED code for “ Inheritance types "


Search for patient by ID 


Get /Patient?
    subject=123

Search for diagnostic reports with a given variant 


GET /DiagnosticReport?
    _profile=http://hl7.org/fhir/StructureDefinition/diagnosticreport-genetics&
    geneticsAnalysis=http://www.ncbi.nlm.nih.gov/projects/SNP|rs58238560

Given diagnostic report, return associated family history information 


GET /DiagnosticReport?
    _profile=http://hl7.org/fhir/StructureDefinition/diagnosticreport-geneticsFamilyMemberHistory&
    id=123

Search for variants given gene and variant classification 


GET /Observation?
    =http://hl7.org/fhir/StructureDefinition/observation-genetics&
    Gene=http://www.genenames.org|3236&
	GenomicSourceClass=http://loinc.org|LA6684-0

Search for patients based on genetic ancestry 


GET /Observation?
    =http://hl7.org/fhir/StructureDefinition/observation-genetics&
    Ancestry=http://www.genenames.org|186044009
	GenomicSourceClass=http://snomed.info/sct|LA6684-0

10.10.4 Boolean Queries

Find all patients with a set of variants 


GET /Observation?
    _profile=http://hl7.org/fhir/StructureDefinition/observaiton-genetics&
    DNAVariantID=http://www.ncbi.nlm.nih.gov/projects/SNP|rs58238560$rs58238559$rs58238565

rs58238560: variant: NC_000017.10:g.497469T>A

rs58238559: variant: NC_000007.13:g.87082273T>C

rs58238565: variant: NC_000005.10:g.131929452C>A


10.10.5 Specimen-based Queries

Find specimens collected from specific specimen body sites 


GET /Specimen?
   bodySite=http://snomed.info/sct|85151006

Find specimens from this patient's pedigree 


Get /FamilyMemberHistory?
    =http://hl7.org/fhir/StructureDefinition/familymemberhistory-genetic&
    patient=123

Find specimens based on patient disease status 


Get /DiagnosticReport?
    =http://hl7.org/fhir/StructureDefinition/diagnosticreport-genetic&
    AssessedCondition.code=http://snomed.info/sct|254837009&
    patient=123

Find specimens based on specimen disease status 


Get /Specimen?
    status=available&

Find specimens based on technology platform 


Get /Specimen?
    =http://hl7.org/fhir/StructureDefinition/shareablecodesystem&
    code=Information Technology

Find specimens based on instrument identifier 


Get /Specimen?   
    container.identifier=48736-15394-75465

10.10.6 Time-based Queries

Find specimens collected within an absolute date range 


Get /Specimen?   
    receivedTime=2011-03-04T07:03:00Z

Find specimens collected within a relative date range 


Get /Specimen?
    =http://hl7.org/fhir/StructureDefinition/specimen-treatmentTime&   
    duration=quot

10.10.7 MolecularSequence Test Metrics

10.8 10.10 Clinical Genomic Apps

The idea for a Sequence MolecularSequence resource grew out, in part, the SMART Platforms Project, which explored creating clinical genomic apps to integrated traditional EMR clinical data and genomic data to show data visualization and analysis, including CDS that depended upon both types of data. Below are a couple of examples. Several apps have already been designed including Genomics Advisor, SMART Precision Cancer Medicine, and Diabetes Bear EMR. Below, one of these apps will be described. To include other apps in this section, please feel free to add a note on it and how it uses FHIR/Genomics calls.

10.8.1 10.10.1 Genomics Advisor

The SMART on FHIR Genomics Advisor was an app incorporating genomics data to show risk of disease, drug susceptibility, and related conditions based upon genotype. Technically, this app was architected (see below) by combining data from independent data services, a SMART on FHIR clinical server for clinical information and one for a SMART on FHIR Genomics data server for genomic data. The set of FHIR API calls that are necessary to support this app are shown below:

null

The presentation of the app looks like this:

null

10.8 10.10 Appendix 1: From DSTU2 Genomics to STU3

The table shows how the data elements in the DSTU2 Observation resource as extended by the Standard Genetics Profile would be mapped to the new Sequence MolecularSequence resource.

DSTU2 Standard Genetics profile on Observation Observation-genetics profile Maps to Sequence MolecularSequence (Proposed)
geneticsGenomeBuild Sequence MolecularSequence extension referenceSeq.genomicsBuild
geneticsChromosome Sequence MolecularSequence extension referenceSeq.chromosome
geneticsGenomicsStart Sequence MolecularSequence extension variant.start
geneticsGenomicsStop Sequence MolecularSequence extension variant.end
geneticsReferenceAllele Sequence MolecularSequence extension variant.referenceAllele
geneticsObservedAllele Sequence MolecularSequence extension variant.observedAllele
geneticsSpecies Sequence MolecularSequence extension specimen
geneticsAllelicState Allelic State extension
geneticsAllelicFrequency Allelic Frequency extension
geneticsReadCoverage Sequence MolecularSequence extension readCoverage
geneticsCopyNumberEvent Copy number event extension
geneticsTranscriptReferenceSequenceId Transcript reference sequence identifier extension
geneticsProteinReferenceSequenceId Protein reference sequence identifier
geneticsCIGAR Sequence MolecularSequence extension variant.cigar
geneticsVariationId DNA variation id extension
geneticsVariationType DNA sequence variation type extension
geneticsAminoAcidChange Amino acid change extension
geneticsAminoAcidChangeType Amino acid change type extension
geneticsGene Gene extension
geneticsDNARegionName DNA region name extension
geneticsGenomicSourceClass Genomic source class extension