GenomeX Data Exchange FHIR IG
0.2.0 - draft
GenomeX Data Exchange FHIR IG, published by MITRE. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/CodeX-HL7-FHIR-Accelerator/GenomeX-DataExchange/ and changes regularly. See the Directory of published versions
Carrier screening reports introduce additional complexity to genomics reporting. Carrier screening for a single parent may report variant, zygosity, genetic disease diagnosis, and reproductive risk results.
A single-parent carrier screening report focuses on the risk that the hypothetical child of that parent inherits certain germline genetic diseases. When representing a single patient’s carrier status, the report is represented as a single Genomic Report resource. This section introduces the challenges of carrier screening reporting and outlines measures to address them.
Here is a sample prenatal carrier screening report for a single patient.
The following entity relationship diagram (ERD) gives a visual representation for how FHIR resources based on the above sample report relate to each other. Note that only one genomic report is created—while this report contains resources pertaining both to the prospective parent and hypothetical child, the parent is the subject of all resources. This is because any risk assessments or diagnostic implications are considered here in a 'reproductive' context and thus pertain to the parent. Additionally, health systems do not typically store data for hypothetical patients. This implementation follows that principle. All 'reproductive' diagnostic implications include inheritance codes under the 'component' field to indicate that they refer to a reproductive context. They are further differentiated in this example by the abbreviation "Repr" within each id and filename.
This test also distinguishes between multiple types of risk assessments:
The germline Genomic Report which connects to all the FHIR Genomic instances for this detailed germline example is found here. The table below relates FHIR resource examples for a single-parent prenatal carrier screening report to the report in the ERD above (the numbers in the 'Label' column correspond to the numbers in the ERD).
Label | Resource/Profile | Description of germline usage | Example(s) | Example Notes |
---|---|---|---|---|
1 | Genomic Report | Primary container of the overall report, including a report conclusion. Because this is a single-parent prenatal carrier screening report, one single genomic report will encompass all reported results. | PrenatalGenomicReportPatientMale | |
2 | Patient | The genomic report references the subject of the report, invariably the patient. Although a carrier screening report may pertain to a patient's hypothetical future child, as a rule, health systems store results for concrete patients. Thus the most appropriate subject for genomics reporting remains the prospective parent. | PatientMale | |
3 | Specimen | The genomic report references specimens that this report is based on. | PrenatalSpecimenPatientMale | |
4 | Task | The genomic report references follow up recommendations for the patient(s). | PrenatalRecommendedFollowup1PatientMale, PrenatalRecommendedFollowup2PatientMale | |
5 | Practitioner | The genomic report refers to the medical professional that ordered the reported test. | OrderingPractitioner | |
6 | Organization | The genomic report refers to the organization that performed the reported test. | Organization | |
7 | RiskAssessment | Post-test Reproductive Risk Assessments estimate the risk of passing a given disease to a hypothetical child after the genomic test has been performed. This is the most diagnostically relevant risk estimate in the prenatal carrier screening. These risk assessments are each linked from a diagnostic implication resource using the 'Genomic Risk Assessment' extension. | PrenatalReproductivePostRiskAlpha1ADPatientMale, PrenatalReproductivePostRiskAutosomalRecessiveSAoCSPatientMale, PrenatalReproductivePostRiskFamilialHyperinsulinismPatientMale | |
8 | RiskAssessment | Pre-test Reproductive Risk Assessments estimate the risk of passing a given disease to a hypothetical child prior to the genomic test being performed. This is based off of allelic population frequencies. | PrenatalReproductivePreRiskAlpha1ADPatientMale, PrenatalReproductivePreRiskAutosomalRecessiveSAoCSPatientMale, PrenatalReproductivePreRiskFamilialHyperinsulinismPatientMale | |
9 | Diagnostic Implication | The genomic report can include various types of genomic annotations such as diagnostic implications related to identified variants. These Diagnostic Implications represent a diagnosis of the given patient as a carrier of a given disease. | PrenatalDiagImpAlpha1ADPatientMale, PrenatalDiagImpAutosomalRecessiveSAoCSPatientMale, PrenatalDiagImpFamilialHyperinsulinismPatientMale | Variant annotation knowledgebases generally differ in the types of annotations they supply. Different labs can potentially report different annotations. Annotations such as 'variants of unknown significance' can be updated in the future through reanalysis. |
10 | Variant | The genomic report can reference variants and other findings identified via testing. | PrenatalVariant1SNPAlpha1ADPatientMale, PrenatalVariantAutosomalRecessiveSAoCSPatientMale, PrenatalVariantFamilialHyperinsulinismPatientMale | |
11 | RiskAssessment | Residual Risk Assessments estimate the "residual" risk that the patient in fact does have the variant, given the test performed. For example, if the test came back positive, the residual risk will be 1. If the test instead came back negative, there is a small risk that the test's result was a false negative. | PrenatalResidualRiskAlpha1ADPatientMale, PrenatalResidualRiskAutosomalRecessiveSAoCSPatientMale, PrenatalResidualRiskFamilialHyperinsulinismPatientMale | |
12 | Diagnostic Implication | The genomic report also references Reproductive Diagnostic Implications, representing a conceptual reproductive diagnosis of a future child with a given disease. This resource is important to represent because it is tied to a Risk Assessment resource which quantifies hypothetical child's risk of inheriting the disease. | PrenatalReprDiagImpAlpha1ADPatientMale, PrenatalReprDiagImpAutosomalRecessiveSAoCSPatientMale, PrenatalReprDiagImpFamilialHyperinsulinismPatientMale | Variant annotation knowledgebases generally differ in the types of annotations they supply. Different labs can potentially report different annotations. Annotations such as 'variants of unknown significance' can be updated in the future through reanalysis. |
13 | Service Request | The genomic report references orders that lead to the testing being reported. | PrenatalServiceRequestPatientMale | |
14 | Practitioner | The genomic report references a results interpreter / lab director. | PractionerKarlaBowles | |
15 | Genomic Study Analysis | Each genomic report's single referenced genomic study can be comprised of one or more (but typically many) genomic study analyses that detail the testing procedures performed. Each of these genomic analyses represents a single disease, reflecting a disease-level reporting design. | PrenatalGenomicStudyAnalysisAlpha1ADPatientMale, PrenatalGenomicStudyAnalysisAutosomalRecessiveSAoCSPatientMale, PrenatalGenomicStudyAnalysisFamilialHyperinsulinismPatientMale | |
16 | Genomic Study | The genomic report can reference details of the genomic study that was performed in order to identify variants / haplotypes / genotypes / biomarkers. There will typically be a single genomic study resource per report—each of these genomic study resources will reference all <i>derivative</i> genomic study analysis resources. | PrenatalGenomicStudyPatientMale | Raw genomic data files such as VCF generally contain far more data than that communicated in the report. BED files can precisely define regions of the genome that were studied or deemed uncallable. |
Carrier screening reports may also surface a report for two prospective parents or reproductive partners jointly. When representing two patients in a partnership, this report consists of one Genomic Report for each respective parent, as well as one additional shared Genomic Report which extends the other two. This shared Genomic Report also surfaces results deriving from the base results of both prospective parents. There are multiple reasons for this design. One is to avoid surfacing observations from multiple patients under a single report. As a principle, each FHIR resource should unambiguously belong to a single patient. Furthermore, many health systems cannot store private data for patients outside their own system. In this case, the reproductive partner's personally identifiable information may be anonymized. This design also allows the reports to be split in the case of the reproductive partners' separation.
Many of the fields used in single-parent carrier screening reports are also applicable in a partnered report. As you will see in the following entity relationship diagram (ERD), the differences between single and partnered reports lie mostly in the arrangement, organization, and interdependencies of the FHIR resources. Keep in mind that one single overarching report is sent to a hospital system as the definitive report signed off by the lab. That single report will include three Genomic Report resource instances that have been created for each subject: one for each partner and one combined report for representing their joint reproductive risk assessments.
The germline Genomic Report which connects to all the FHIR Genomic instances for this detailed germline example is here. The table below relates FHIR resource examples for single prenatal carrier screening to the ERD above (the numbers in the 'Label' column correspond to the numbers in the ERD).
In this example, PatientFemale and PatientMale are the subjects of the report. As discussed, each has their own genomic report and a set of results which points to them and only them as subject. Each of these results includes either 'PatientFemale' or 'PatientMale' in its filename and FHIR resource ID. In addition, a third, overarching report extends both of these patients' individual genomic reports. This overarching report also contains results pertaining to both patients—these results will reference a Reproductive Group resource as subject, representing both PatientFemale and PatientMale. All joint resources belonging to both reproductive partners include 'Couple' in their filename and FHIR resource ID.
Label | Resource/Profile | Description of germline usage | Example(s) | Example Notes |
---|---|---|---|---|
1 | Genomic Report | Primary container of the overall report, including a report conclusion. In a partnered report, one overarching genomic report will "extend" two derivative genomic reports—one for each patient / partner. In a single report, one single genomic report will encompass all reported results. | PrenatalGenomicReportCouple, PrenatalGenomicReportCouple, PrenatalGenomicReportPatientMale | |
2 | Patient | All resources based solely on the results of one of the parents will reference that patient alone as the subject. Reproductive results based on both parents will instead reference a Group resource as the subject. | PatientFemale, PatientMale | |
3 | Specimen | The genomic report references specimens that this report is based on. | PrenatalSpecimenPatientFemale, PrenatalSpecimenPatientMale | |
4 | Task | The genomic report references follow up recommendations for the patient(s). | PrenatalRecommendedFollowup1PatientFemale, PrenatalRecommendedFollowup1PatientMale | |
5 | Practitioner | The genomic report refers to the medical professional that ordered the reported test. | OrderingPractitioner | |
6 | Organization | The genomic report refers to the organization that performed the reported test. | Organization | |
7 | RiskAssessment | Post-test Reproductive Risk Assessments estimate the risk of passing a given disease to a hypothetical child after the genetic test has been performed. This is functionally the most diagnostically relevant risk estimate in the prenatal carrier screening. These risk assessments are each linked from a diagnostic implication resource using the 'Genomic Risk Assessment' extension. Risk Assessments associated with detected _absent_ variants will be grouped into a single resource as they are less important to highlight than risk assessments for positive variants. | PrenatalReproductivePostRiskFactorXiDeficiencyCouple | |
8 | RiskAssessment | Pre-test Reproductive Risk Assessments estimate the risk of passing a given disease to a hypothetical child prior to the genetic test being performed. This is based off of allelic population frequencies. | PrenatalReproductivePreRiskFactorXiDeficiencyCouple | |
9 | Diagnostic Implication | The genomic report can include various types of genomic annotations such as diagnostic implications related to identified variants. These Diagnostic Implications represent a diagnosis of the given patient as a carrier of a given disease. | PrenatalDiagImpFactorXiDeficiencyPatientFemale, PrenatalDiagImpFactorXiDeficiencyPatientMale, PrenatalDiagImpFragileXSyndromePatientFemale, PrenatalDiagImpGlycogenStorageDiseasePatientFemale, PrenatalDiagImpGlycogenStorageDiseasePatientMale, PrenatalDiagImpHereditaryHemochromatoPatientFemale, PrenatalDiagImpHereditaryHemochromatoPatientMale, PrenatalDiagImpPrimaryHyperoxaluriaPatientFemale, PrenatalDiagImpPrimaryHyperoxaluriaPatientMale | Variant annotation knowledgebases generally differ in the types of annotations they supply. Different labs can potentially report different annotations. Annotations such as 'variants of unknown significance' can be updated in the future through reanalysis. |
10 | Variant | The genomic report can reference variants and other findings identified via testing. | PrenatalVariant1CNVFactorXiDeficiencyPatientMale, PrenatalVariant1FragileXSyndromePatientFemale, PrenatalVariant1SNPHereditaryHemochromatoPatientFemale, PrenatalVariant1SNPHereditaryHemochromatoPatientMale, PrenatalVariant2FragileXSyndromePatientFemale, PrenatalVariant2SNPHereditaryHemochromatoPatientFemale, PrenatalVariantFactorXiDeficiencyPatientFemale, PrenatalVariantGlycogenStorageDiseaseTypePatientFemale, PrenatalVariantGlycogenStorageDiseaseTypePatientMale, PrenatalVariantPrimaryHyperoxaluriaPatientFemale, PrenatalVariantPrimaryHyperoxaluriaPatientMale | |
11 | RiskAssessment | Residual Risk Assessments estimate the "residual" risk that the patient in fact does have the variant, given the test performed. For example, if the test came back positive, the residual risk will be 1. If the test instead came back negative, there is a small risk that the test's result was a false negative. | PrenatalResidualRiskFactorXiDeficiencyPatientFemale, PrenatalResidualRiskFactorXiDeficiencyPatientMale, PrenatalResidualRiskGlycogenStorageDiseasePatientFemale, PrenatalResidualRiskGlycogenStorageDiseasePatientMale, PrenatalResidualRiskPrimaryHyperoxaluriaPatientFemale, PrenatalResidualRiskPrimaryHyperoxaluriaPatientMale | |
12 | Diagnostic Implication | The genomic report also references Reproductive Diagnostic Implications, representing a conceptual reproductive diagnosis of a future child with a given disease. This resource is important to represent because it is tied to a Risk Assessment resource which quantifies hypothetical child's risk of inheriting the disease. | PrenatalReprDiagImpFactorXiDeficiencyCouple, PrenatalReprDiagImpFragileXSyndromeCouple, PrenatalReprDiagImpHereditaryHemochromatoCouple | Variant annotation knowledgebases generally differ in the types of annotations they supply. Different labs can potentially report different annotations. Annotations such as 'variants of unknown significance' can be updated in the future through reanalysis. |
13 | Service Request | The genomic report references orders that lead to the testing being reported. | PrenatalServiceRequestCouple | |
14 | Practitioner | The genomic report references a results interpreter / lab director. | PractionerKarlaBowles | |
15 | Genomic Study Analysis | Each genomic report's single referenced genomic study can be comprised of one or more (but typically many) genomic study analyses that detail the testing procedures performed. Each of these genomic analyses represents a single disease, reflecting a disease-level reporting design. | PrenatalGenomicStudyAnalysisFactorXiDeficiencyCouple, PrenatalGenomicStudyAnalysisFactorXiDeficiencyPatientFemale, PrenatalGenomicStudyAnalysisFactorXiDeficiencyPatientMale, PrenatalGenomicStudyAnalysisFragileXSyndromePatientFemale, PrenatalGenomicStudyAnalysisGlycogenStorageDiseaseCouple, PrenatalGenomicStudyAnalysisGlycogenStorageDiseasePatientFemale, PrenatalGenomicStudyAnalysisGlycogenStorageDiseasePatientMale, PrenatalGenomicStudyAnalysisHereditaryHemochromatoCouple, PrenatalGenomicStudyAnalysisHereditaryHemochromatoPatientFemale, PrenatalGenomicStudyAnalysisHereditaryHemochromatoPatientMale, PrenatalGenomicStudyAnalysisPrimaryHyperoxaluriaCouple, PrenatalGenomicStudyAnalysisPrimaryHyperoxaluriaPatientFemale, PrenatalGenomicStudyAnalysisPrimaryHyperoxaluriaPatientMale | |
16 | Genomic Study | The genomic report can reference details of the genomic study that was performed in order to identify variants / haplotypes / genotypes / biomarkers. There will typically be a single genomic study resource per report—each of these genomic study resources will reference all <i>derivative</i> genomic study analysis resources. | PrenatalGenomicStudyCouple, PrenatalGenomicStudyPatientFemale, PrenatalGenomicStudyPatientMale | Raw genomic data files such as VCF generally contain far more data than that communicated in the report. BED files can precisely define regions of the genome that were studied or deemed uncallable. |
17 | Group | For a partnered genomic report, the subject should reference a Group resource that includes both partners. The two genomics report resources for the partners should reference each subject respectively. | GroupPatientFemaleAndPatientMale | |
- | RelatedPerson | A genomic report representing a partnered report should include two additional RelatedPerson objects to represent the relationship between the reproductive partners | RelatedPersonPatientFemale, RelatedPersonPatientMale |