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
Genomic observations can be organized and grouped together in a wide variety of ways. This page is a brief guidance on how observations might be grouped. Generally, grouping is used to provide a visualization which may be helpful to a developer. An exception is grouping a panel, where the appropriate panel code is used (e.g., a specific Panel LOINC code in an observation used to tie all the variants of the panel together). Implementers should pay close attention to the considerations in Associated Observations and Observation Grouping describing proper usage of the relationships “diagnosticReport.result”, “Observation.hasMember”, and “Observation.derivedFrom”. With any form of grouping or Panels, a system consuming a Genomic Diagnostic Report MUST navigate through all hasMember
relations and navigate through derivedFrom
relationships, to ensure that all clinically relevant information is seen.
Observations are the core representation of structured genomic information. Result observations profiles are typically referenced directly in a Diagnostic Report (e.g., the genomic report). The genetic findings and implication profiles all contain links to computably define which profiles go together (e.g., the variant observation is referenced within the implication profile using derivedFrom
). That is, the relationships define a semantic grouping, a composite relationship between implication, haplotype, or genotype observations and the appropriate variant observation(s).
However, sometimes it is desired to group observations with a grouping observation. In this version of the specification, no guidance is provided on where or if a grouping observation should be used (the HL7 Orders and Observation work group owns the Observation resource and may issue guidance in the future). This is left up to the discretion of the reporting lab. Currently, observations might be organized for visualization purposes on the basis of subject, specimen, chromosome, gene, condition/disease, medication, etc. The recursive hasMember
relationship on observation supports a nested tree-structure of observations if appropriate, though more than two levels of grouping observations is likely excessive. This example uses grouping to separately reference variants and other Observations as results of the report. For a version of the same report without grouping see this example without grouping. In the grouping examples, the NCI Metathesaurus code C43359 (for 'Group' or 'Panel') is used for the grouping Observation.code
field. Genomic panels that have specific codes, such as a specific LOINC code, could also be used if the grouping observation contains all the elements typically reported by the specific panel.
Due to the possibility that a lab may only reference grouping observations as results, consumers of Genomic Diagnostic Reports MUST follow hasMember
relationships iteratively and derivedFrom
recursively to ensure that all clinically relevant information is seen. This will ensure complete processing of the DiagnosticReport
results.
For questions on FHIR querying look here: query guidance.
Final caveat, any organization of observations into groups or sub-groups is purely for navigation and presentation purposes. It carries no additional "meaning." Each observation can be interpreted on its own without knowing the associated group or sub-group and must be able to stand alone as a resource and be independently valuable. The organization of observations in groups does not assert any relationship between observations.