Genomics Reporting Implementation Guide
3.0.0 - release 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

Appendix H: Grouping Guidance

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.

Overview with examples

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.

Click on the images to enlarge them.

Example showing diagnostic report directly referencing the resultant genomic observations without grouping (similar to this oncology example without grouping and this pharmacogenomics example based on EMERGE):

Example of grouping on the basis of type of genomic observation, similar to the oncology example above and the pharmacogenomics example based on EMERGE :

Example layout of how a mixed use of group could appear. This is an exaggeration but is meant to give an impression of the mixture grouping observations could allow. Note, there are some genomics observation profiles directly referenced as results and some that are not.

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.