Difference between revisions of "201901 Clinical Genomics"
m (→Scenarios) |
|||
Line 39: | Line 39: | ||
==Scenarios== | ==Scenarios== | ||
<!-- What will be the actions performed by participants? --> | <!-- What will be the actions performed by participants? --> | ||
− | Scenarios 2-6 are taken from use cases in the [HL7 Domain Analysis Model (DAM): Clinical Genomics, Release 1, | + | Scenarios 2-6 are taken from use cases in the [http://www.hl7.org/implement/standards/product_brief.cfm?product_id=479/ HL7 Domain Analysis Model (DAM): Clinical Genomics, Release 1, July 2018 Informative Publication]. See links below each scenario for relevant DAM excerpts. |
− | A couple new use cases may be considered as approved by CG workgroup and time permits. | + | A couple new use cases may be considered as approved by the CG workgroup and time permits. |
===Scenario 1 Register a New MolecularSequence, DescribedVariant, and GenomicsReport === | ===Scenario 1 Register a New MolecularSequence, DescribedVariant, and GenomicsReport === | ||
Line 51: | Line 51: | ||
===Scenario 2 Clinical Sequencing - Germline Testing=== | ===Scenario 2 Clinical Sequencing - Germline Testing=== | ||
[https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.gjdgxs?usp=sharing/ More on Scenario 2] | [https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.gjdgxs?usp=sharing/ More on Scenario 2] | ||
− | :'''Action''': (FHIR Client) Search target genetic-profile-based observation with given patient ID. This target observation has | + | :'''Action''': (FHIR Client) Search target genetic-profile-based observation with given patient ID. This target observation has a component - Genomic Source Class (code={"coding":[{"system":"http://loinc.org","code":"48002-0"}]}, value="LA6683-2") corresponding to Germline. |
:'''Precondition''': Relevant patient and observations have been created | :'''Precondition''': Relevant patient and observations have been created | ||
:'''Success Criteria''': A bundle of genetics observations from germline analysis of that patient are returned.<!-- How will the participants know if the test was successful? --> | :'''Success Criteria''': A bundle of genetics observations from germline analysis of that patient are returned.<!-- How will the participants know if the test was successful? --> | ||
Line 58: | Line 58: | ||
===Scenario 3 Family Member History=== | ===Scenario 3 Family Member History=== | ||
[https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.3dy6vkm?usp=sharing/ More on Scenario 3] | [https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.3dy6vkm?usp=sharing/ More on Scenario 3] | ||
− | :'''Action''': (FHIR Client) 1. Search the | + | :'''Action''': (FHIR Client) 1. Search the genomics reports of a given patient. Get the reference id of this patient’s familymemberhistory from the supportingInfo extension - Family History (http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/dr-supportingInfo). 2. Retrieve this FamilyMemberHistory instance and get the reference id of Observation instances from extension - Genetic markers, ethnicity, etc. (url: http://hl7.org/fhir/StructureDefinition/family-member-history-genetics-observation). 3. Retrieve the target Observation instance. |
:'''Precondition''': Relevant diagnostic report, observation, family member history have been created. | :'''Precondition''': Relevant diagnostic report, observation, family member history have been created. | ||
:'''Success Criteria''': The target Observation instances of the given patient's family member are returned.<!-- How will the participants know if the test was successful? --> | :'''Success Criteria''': The target Observation instances of the given patient's family member are returned.<!-- How will the participants know if the test was successful? --> | ||
Line 65: | Line 65: | ||
===Scenario 4 Clinical and Research Data Warehouses=== | ===Scenario 4 Clinical and Research Data Warehouses=== | ||
[https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.4d34og8?usp=sharing/ More on Scenario 4] | [https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.4d34og8?usp=sharing/ More on Scenario 4] | ||
− | :'''Action''': (FHIR Client) Search for all | + | :'''Action''': (FHIR Client) Search for all observations with a given described variant (e.g. rs587778247) |
:'''Precondition''': Observation instances with this variant have been created | :'''Precondition''': Observation instances with this variant have been created | ||
− | :'''Success Criteria''': A bundle of | + | :'''Success Criteria''': A bundle of describedVariant observations, where the code value of component - dbSNP Id ({"coding":[{"system":"http://loinc.org","code":"81255-2"}]} is rs587778247. <!-- How will the participants know if the test was successful? --> |
:'''Bonus point''': More parameters can be added for searching<!-- Any additional complexity to make the scenario more challenging --> | :'''Bonus point''': More parameters can be added for searching<!-- Any additional complexity to make the scenario more challenging --> | ||
===Scenario 5 HLA Typing=== | ===Scenario 5 HLA Typing=== | ||
[https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.17dp8vu?usp=sharing/ More on Scenario 5] | [https://docs.google.com/document/d/1-PULyIwtpCZmsANpafzYA2CKJ1ZMiIysdNnFoGf2-KY/edit#heading=h.17dp8vu?usp=sharing/ More on Scenario 5] | ||
− | :'''Action''': (FHIR Client) Create an HLA genotyping | + | :'''Action''': (FHIR Client) Create an HLA genotyping genomics report. |
− | :'''Precondition''': This | + | :'''Precondition''': This genomicsReport instance does not exist in service prior to action. |
− | :'''Success Criteria''': The HLA | + | :'''Success Criteria''': The genomics report carrying HLA information is created correctly on server and in the desired format. |
:'''Bonus point''': Extensions can be added<!-- Any additional complexity to make the scenario more challenging --> | :'''Bonus point''': Extensions can be added<!-- Any additional complexity to make the scenario more challenging --> | ||
Line 84: | Line 84: | ||
===Scenario 7 Comprehensive Pathology Report=== | ===Scenario 7 Comprehensive Pathology Report=== | ||
− | :'''Action''': (FHIR Client) Create a comprehensive pathology report which includes genetic information for a patient. A comprehensive pathology report integrates pertinent information gathered from various methods (e.g. morphology, immunohistochemistry, flow cytometry, cytogenetics, fluorescence ''in situ'' hybridization [FISH], and molecular testing [e.g., NGS]). The | + | :'''Action''': (FHIR Client) Create a comprehensive pathology report which includes genetic information for a patient. A comprehensive pathology report integrates pertinent information gathered from various methods (e.g. morphology, immunohistochemistry, flow cytometry, cytogenetics, fluorescence ''in situ'' hybridization [FISH], and molecular testing [e.g., NGS]). The genomicsReport profile has the capability to support results with simple or complex genetics observations. |
− | :'''Precondition''': This | + | :'''Precondition''': This genomics report has never been created |
− | :'''Success Criteria''': | + | :'''Success Criteria''': Report created correctly on server and in the desired format. |
:'''Bonus point''': Extensions can be added. | :'''Bonus point''': Extensions can be added. | ||
Revision as of 21:16, 5 November 2018
Clinical Genomics Track
Zulip Chat
The Zulip Chat will be used to coordinate among participants during the connectathon:
Submitting WG/Project/Implementer Group
Justification
Genomic data are of increasing importance to clinical care and secondary analysis. After initial Feedback from the first ballot of the Clinical Genomics Implementation Guide, considerable updates have been made, and the recently balloted IG and profiles should be tested in the Connectathon for more feedback and trial use.
Proposed Track Lead
Gil Alterovitz, Patrick Werner
Expected participants
Gil Alterovitz, James Jones, Kevin Power, Lloyd Mckenzie, Bret Heale, Bob Millius, Joel Schneider, Bob Dolin, ...
Roles
FHIR Client
Support the sending of the MolecularSequence resource and genetics profiles operations: create, history, read, search and update.
FHIR Server
Support the receiving and processing of the MolecularSequence resource/genetics profiles operations: create, history, read, search and update.
Scenarios
Scenarios 2-6 are taken from use cases in the HL7 Domain Analysis Model (DAM): Clinical Genomics, Release 1, July 2018 Informative Publication. See links below each scenario for relevant DAM excerpts. A couple new use cases may be considered as approved by the CG workgroup and time permits.
Scenario 1 Register a New MolecularSequence, DescribedVariant, and GenomicsReport
- Action: (FHIR Client) (FHIR Client) Create 1 or all of: a MolecularSequence instance, a (DescribedVariant-profiled) Observation instance, and/or a (GenomicsReport-profiled) DiagnosticReport instance to represent genetics data and interpretations (DNA variant, RNA sequence, structural variant, etc).
- Precondition: The instances do not exist in server prior to action.
- Success Criteria: Instances created correctly on server and in the desired format.
- Bonus point: New profiles from the IG can be built on top of the MolecularSequence resource for complex representation
Scenario 2 Clinical Sequencing - Germline Testing
- Action: (FHIR Client) Search target genetic-profile-based observation with given patient ID. This target observation has a component - Genomic Source Class (code={"coding":[{"system":"http://loinc.org","code":"48002-0"}]}, value="LA6683-2") corresponding to Germline.
- Precondition: Relevant patient and observations have been created
- Success Criteria: A bundle of genetics observations from germline analysis of that patient are returned.
- Bonus point: More parameters can be added for searching
Scenario 3 Family Member History
- Action: (FHIR Client) 1. Search the genomics reports of a given patient. Get the reference id of this patient’s familymemberhistory from the supportingInfo extension - Family History (http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/dr-supportingInfo). 2. Retrieve this FamilyMemberHistory instance and get the reference id of Observation instances from extension - Genetic markers, ethnicity, etc. (url: http://hl7.org/fhir/StructureDefinition/family-member-history-genetics-observation). 3. Retrieve the target Observation instance.
- Precondition: Relevant diagnostic report, observation, family member history have been created.
- Success Criteria: The target Observation instances of the given patient's family member are returned.
- Bonus point: More parameters can be added for searching
Scenario 4 Clinical and Research Data Warehouses
- Action: (FHIR Client) Search for all observations with a given described variant (e.g. rs587778247)
- Precondition: Observation instances with this variant have been created
- Success Criteria: A bundle of describedVariant observations, where the code value of component - dbSNP Id ({"coding":[{"system":"http://loinc.org","code":"81255-2"}]} is rs587778247.
- Bonus point: More parameters can be added for searching
Scenario 5 HLA Typing
- Action: (FHIR Client) Create an HLA genotyping genomics report.
- Precondition: This genomicsReport instance does not exist in service prior to action.
- Success Criteria: The genomics report carrying HLA information is created correctly on server and in the desired format.
- Bonus point: Extensions can be added
Scenario 6 Species Identification
- Action: (FHIR Client) Search for sequences from human (Homo sapiens).
- Precondition: Sequence(s) have been created where the species is defined as human (Homo sapiens).
- Success Criteria: A bundle of Sequence instances where the value of the species element is Homo sapiens.
Scenario 7 Comprehensive Pathology Report
- Action: (FHIR Client) Create a comprehensive pathology report which includes genetic information for a patient. A comprehensive pathology report integrates pertinent information gathered from various methods (e.g. morphology, immunohistochemistry, flow cytometry, cytogenetics, fluorescence in situ hybridization [FISH], and molecular testing [e.g., NGS]). The genomicsReport profile has the capability to support results with simple or complex genetics observations.
- Precondition: This genomics report has never been created
- Success Criteria: Report created correctly on server and in the desired format.
- Bonus point: Extensions can be added.
Scenario 8 Sequence quality
- Action: (FHIR Client) Get the quality of the sequence under consideration. In the sequencing reads, each base is assigned with a quality score generated by the sequencer, which represents the confidence of a base call. Base quality is a critical factor for accurate variant detection in the downstream analysis.
- Precondition: This sequence instance has been created
- Success Criteria: Target sequence instance is returned.
- Bonus point: More parameters can be added for searching
Scenario 9 PGx CDS
This scenario demonstrates an implementation of CPIC Pharmacogenomic Guidelines [1] based on FHIR, CDS Hooks [2], and genomics results formatted per our latest HL7 FHIR Clinical Genomics Reporting guide [3]
- Action: In this scenario, a medication order arises in the EHR (which is also a CDS Hooks client), triggering a notification to a PGx CDS Service (which is also a CDS Hooks server). The "medication-prescribe" hook also provides the PGX CDS Service with a FHIR Medication resource that includes an RxNorm code for the ordered drug. Having been triggered by the “medication-prescribe” CDS hook, the PGx CDS Service now executes a decision support rule that [1] determines if the ordered drug has a known gene interaction; [2] determines, where there is a known drug-gene interaction, whether or not the patient has genetic test results on file; [3] determines, where there are genetic test results on file, if the patient has an interacting genotype; [4] determines, where there are not genetic test results on file, if the patient needs pre-testing. The PGx CDS Service returns a CDS hooks “suggestion card” back to the EHR, with appropriate recommendations.
- Precondition: Genomic observation(s) are available for some patients.
- Success Criteria: Retrieve relevant observations (variants, haplotype, genotype, etc) on a pharmacogene where they exist.
- Bonus point: Correctly identify that there are no observations for the gene in question.
A swim-lane overview of the scenario is here ('GACS' is a Genomic Archiving and Communication System, used to store genomic test results):