Release 5 Ballot

This page is part of the FHIR Specification (v5.0.0-ballot: FHIR R5 Ballot Preview). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

10.4 Resource GenomicStudy - Content

Clinical Genomics Work GroupMaturity Level: 0 Trial UseSecurity Category: Patient Compartments: Patient

A Genomic Study is a set of analysis performed to analyze and generate genomic data.

Note to Implementers: The material on this page is currently undergoing work to be refactored in a future release as further analysis is done. Reviewers are encouraged to provide their comments and feedback about the example codes for terminology binding purposes.

10.4.1 Scope and Usage

GenomicStudy resource aims at delineating relevant information of a genomic study. A genomic study might comprise one or more analyses, each serving a specific purpose. These analyses may vary in method (e.g., karyotyping, CNV, or SNV detection), performer, software, devices used, or regions targeted.

GenomicStudy describes relevant information including the reasons, purpose, and performers of the study. It also provides technical endpoints to access these data. It could be a logical aggregator for complex genomic analyses.

A genomic study might be based on one or more service requests or care plans. The reasons for performing a genomic study might be driven by specific Conditions or Observations. Although the genomic study subject is the focus of the study, the analysis-level subject could be used to specify other relevant subjects or specimens. For example, trio testing may involve three subjects: the proband, and both parents. The proband would be the subject listed directly under the genomic study, while each of the analyses could represent proband, mother, and father genomic analyses.

In clinical use, the study interpreters use all the results of these various analyses to provide diagnostic and therapeutic insights for the patient. Where performers are listed according to their participation in each genomic analysis. Each analysis may be based on a set of defined protocols that may differ from the performed protocols.

The regionStudied and regionCalled elements can refer to DocumentReference instances carrying BED files. Other types of files used in an analysis can be provided similarly, and listed either as inputs or outputs.

Detailed information about the results of the analyses may be represented by Observations and gathered in a DiagnosticReport. Both resources may refer back to the originating GenomicStudy to allow navigation.

10.4.2 Boundaries and Relationships

A main function of GenomicStudy is to provide additional metadata for one or more clinical genomic analysis pipelines where DocumentReference instances are used to track inputs and outputs of those pipelines. Device is used to represent both hardware and software used in the sequencing and in the analyses.

It is intended that this resource be referenced by Observation and DiagnosticReport similarly to how ImagingStudy is currently referenced on those resources. Of note, the results of the study would be captured in Observations and referenced on a DiagnosticReport.

Important contextual references include Patient, Specimen, Encounter, ServiceRequest, Practitioner, and Organization.

Observation or Condition instances may also be referenced from genomic study to designate a given reason for performing the study

GenomicStudy can support the event-definition workflow pattern by referencing PlanDefinition(s) via the instantiatesCanonical relationship when implementers wish to describe more specifics of the pipelines and devices used in the analysis.

10.4.3 References to this Resource

10.4.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. GenomicStudy TUDomainResourceGenomic Study

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier 0..*IdentifierIdentifiers for this genomic study

... status ?!Σ1..1CodeableConceptThe status of the genomic study
GenomicStudyStatus (Required)
... type 0..*CodeableConceptThe type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling)
GenomicStudyType (Example)

... encounter 0..1Reference(Encounter)The healthcare event with which this genomics study is associated
... startDate 0..1dateTimeWhen the genomic study was started
... basedOn 0..*Reference(ServiceRequest | Task)Event resources that the genomic study is based on

... referrer 0..1Reference(Practitioner | PractitionerRole)Healthcare professional who requested or referred the genomic study
... interpreter 0..*Reference(Practitioner | PractitionerRole)Healthcare professionals who interpreted the genomic study

... reason 0..*CodeableReference(Condition | Observation)Why the genomic study was performed

... instantiatesCanonical 0..1canonical(PlanDefinition)The defined protocol that describes the study
... instantiatesUri 0..1uriThe URL pointing to an externally maintained protocol that describes the study
... note 0..*AnnotationComments related to the genomic study

... description 0..1stringDescription of the genomic study
... analysis 0..*BackboneElementGenomic Analysis Event

.... identifier 0..*IdentifierIdentifiers for the analysis event

.... methodType 0..*CodeableConceptType of the methods used in the analysis (e.g., FISH, Karyotyping, MSI)
GenomicStudyMethodType (Example)

.... changeType 0..*CodeableConceptType of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change)
GenomicStudyChangeType (Example)

.... genomeBuild 0..1CodeableConceptGenome build that is used in this analysis
HumanRefSeqNCBIBuildId (Extensible)
.... instantiatesCanonical 0..1canonical(PlanDefinition | ActivityDefinition)The defined protocol that describes the analysis
.... instantiatesUri 0..1uriThe URL pointing to an externally maintained protocol that describes the analysis
.... title 0..1stringName of the analysis event (human friendly)
.... subject 0..1Reference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct | NutritionProduct)The subject of the analysis event
.... specimen 0..*Reference(Specimen)The specimen used in the analysis event

.... date 0..1dateTimeThe date of the analysis event
.... note 0..*AnnotationAny notes capture with the analysis event

.... protocolPerformed 0..1Reference(Procedure | Task)The protocol that was performed for the analysis event
.... regionsStudied 0..*Reference(DocumentReference | Observation)The genomic regions to be studied in the analysis (BED file)

.... regionsCalled 0..*Reference(DocumentReference | Observation)Genomic regions actually called in the analysis event (BED file)

.... input 0..*BackboneElementInputs for the analysis event

..... file 0..1Reference(DocumentReference)File containing input data
..... type 0..1CodeableConceptType of input data (e.g., BAM, CRAM, or FASTA)
GenomicStudyDataFormat (Example)
..... generatedBy[x] 0..1The analysis event or other GenomicStudy that generated this input file
...... generatedByIdentifierIdentifier
...... generatedByReferenceReference(GenomicStudy)
.... output 0..*BackboneElementOutputs for the analysis event

..... file 0..1Reference(DocumentReference)File containing output data
..... type 0..1CodeableConceptType of output data (e.g., VCF, MAF, or BAM)
GenomicStudyDataFormat (Example)
.... performer 0..*BackboneElementPerformer for the analysis event

..... actor 0..1Reference(Practitioner | PractitionerRole | Organization | Device)The organization, healthcare professional, or others who participated in performing this analysis
..... role 0..1CodeableConceptRole of the actor for this analysis
.... device 0..*BackboneElementDevices used for the analysis (e.g., instruments, software), with settings and parameters

..... device 0..1Reference(Device)Device used for the analysis
..... function 0..1CodeableConceptSpecific function for the device used for the analysis

doco Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

GenomicStudy (DomainResource)Identifiers for this genomic studyidentifier : Identifier [0..*]The status of the genomic study (this element modifies the meaning of other elements)status : CodeableConcept [1..1] « null (Strength=Required)GenomicStudyStatus! »The type of the study, e.g., Familial variant segregation, Functional variation detection, or Gene expression profilingtype : CodeableConcept [0..*] « null (Strength=Example)GenomicStudyType?? »The primary subject of the genomic studysubject : Reference [1..1] « Patient|Group|Device|Location| Organization|Procedure|Practitioner|Medication|Substance| BiologicallyDerivedProduct|NutritionProduct »The healthcare event with which this genomics study is associatedencounter : Reference [0..1] « Encounter »When the genomic study was startedstartDate : dateTime [0..1]Event resources that the genomic study is based onbasedOn : Reference [0..*] « ServiceRequest|Task »Healthcare professional who requested or referred the genomic studyreferrer : Reference [0..1] « Practitioner|PractitionerRole »Healthcare professionals who interpreted the genomic studyinterpreter : Reference [0..*] « Practitioner|PractitionerRole »Why the genomic study was performedreason : CodeableReference [0..*] « Condition|Observation »The defined protocol that describes the studyinstantiatesCanonical : canonical [0..1] « PlanDefinition »The URL pointing to an externally maintained protocol that describes the studyinstantiatesUri : uri [0..1]Comments related to the genomic studynote : Annotation [0..*]Description of the genomic studydescription : string [0..1]AnalysisIdentifiers for the analysis eventidentifier : Identifier [0..*]Type of the methods used in the analysis, e.g., Fluorescence in situ hybridization (FISH), Karyotyping, or Microsatellite instability testing (MSI)methodType : CodeableConcept [0..*] « null (Strength=Example)GenomicStudyMethodType?? »Type of the genomic changes studied in the analysis, e.g., DNA, RNA, or amino acid changechangeType : CodeableConcept [0..*] « null (Strength=Example)GenomicStudyChangeType?? »The reference genome build that is used in this analysisgenomeBuild : CodeableConcept [0..1] « null (Strength=Extensible)HumanRefSeqNCBIBuildId+ »The defined protocol that describes the analysisinstantiatesCanonical : canonical [0..1] « PlanDefinition| ActivityDefinition »The URL pointing to an externally maintained protocol that describes the analysisinstantiatesUri : uri [0..1]Name of the analysis event (human friendly)title : string [0..1]The subject of the analysis eventsubject : Reference [0..1] « Patient|Group|Device|Location| Organization|Procedure|Practitioner|Medication|Substance| BiologicallyDerivedProduct|NutritionProduct »The specimen used in the analysis eventspecimen : Reference [0..*] « Specimen »The date of the analysis eventdate : dateTime [0..1]Any notes capture with the analysis eventnote : Annotation [0..*]The protocol that was performed for the analysis eventprotocolPerformed : Reference [0..1] « Procedure|Task »The genomic regions to be studied in the analysis (BED file)regionsStudied : Reference [0..*] « DocumentReference|Observation »Genomic regions actually called in the analysis event (BED file)regionsCalled : Reference [0..*] « DocumentReference|Observation »InputFile containing input datafile : Reference [0..1] « DocumentReference »Type of input data, e.g., BAM, CRAM, or FASTAtype : CodeableConcept [0..1] « null (Strength=Example)GenomicStudyDataFormat?? »The analysis event or other GenomicStudy that generated this input filegeneratedBy[x] : DataType [0..1] « Identifier|Reference(GenomicStudy) »OutputFile containing output datafile : Reference [0..1] « DocumentReference »Type of output data, e.g., VCF, MAF, or BAMtype : CodeableConcept [0..1] « null (Strength=Example)GenomicStudyDataFormat?? »PerformerThe organization, healthcare professional, or others who participated in performing this analysisactor : Reference [0..1] « Practitioner|PractitionerRole| Organization|Device »Role of the actor for this analysisrole : CodeableConcept [0..1]DeviceDevice used for the analysisdevice : Reference [0..1] « Device »Specific function for the device used for the analysisfunction : CodeableConcept [0..1]Inputs for the analysis eventinput[0..*]Outputs for the analysis eventoutput[0..*]Performer for the analysis eventperformer[0..*]Devices used for the analysis (e.g., instruments, software), with settings and parametersdevice[0..*]The details about a specific analysis that was performed in this GenomicStudyanalysis[0..*]

XML Template

<GenomicStudy xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Identifiers for this genomic study --></identifier>
 <status><!-- 1..1 CodeableConcept The status of the genomic study --></status>
 <type><!-- 0..* CodeableConcept The type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling) --></type>
 <subject><!-- 1..1 Reference(BiologicallyDerivedProduct|Device|Group|Location|
   Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
   Substance) The primary subject of the genomic study --></subject>
 <encounter><!-- 0..1 Reference(Encounter) The healthcare event with which this genomics study is associated --></encounter>
 <startDate value="[dateTime]"/><!-- 0..1 When the genomic study was started -->
 <basedOn><!-- 0..* Reference(ServiceRequest|Task) Event resources that the genomic study is based on --></basedOn>
 <referrer><!-- 0..1 Reference(Practitioner|PractitionerRole) Healthcare professional who requested or referred the genomic study --></referrer>
 <interpreter><!-- 0..* Reference(Practitioner|PractitionerRole) Healthcare professionals who interpreted the genomic study --></interpreter>
 <reason><!-- 0..* CodeableReference(Condition|Observation) Why the genomic study was performed --></reason>
 <instantiatesCanonical><!-- 0..1 canonical(PlanDefinition) The defined protocol that describes the study --></instantiatesCanonical>
 <instantiatesUri value="[uri]"/><!-- 0..1 The URL pointing to an externally maintained protocol that describes the study -->
 <note><!-- 0..* Annotation Comments related to the genomic study --></note>
 <description value="[string]"/><!-- 0..1 Description of the genomic study -->
 <analysis>  <!-- 0..* Genomic Analysis Event -->
  <identifier><!-- 0..* Identifier Identifiers for the analysis event --></identifier>
  <methodType><!-- 0..* CodeableConcept Type of the methods used in the analysis (e.g., FISH, Karyotyping, MSI) --></methodType>
  <changeType><!-- 0..* CodeableConcept Type of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change) --></changeType>
  <genomeBuild><!-- 0..1 CodeableConcept Genome build that is used in this analysis  --></genomeBuild>
  <instantiatesCanonical><!-- 0..1 canonical(ActivityDefinition|PlanDefinition) The defined protocol that describes the analysis --></instantiatesCanonical>
  <instantiatesUri value="[uri]"/><!-- 0..1 The URL pointing to an externally maintained protocol that describes the analysis -->
  <title value="[string]"/><!-- 0..1 Name of the analysis event (human friendly) -->
  <subject><!-- 0..1 Reference(BiologicallyDerivedProduct|Device|Group|Location|
    Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
    Substance) The subject of the analysis event --></subject>
  <specimen><!-- 0..* Reference(Specimen) The specimen used in the analysis event --></specimen>
  <date value="[dateTime]"/><!-- 0..1 The date of the analysis event -->
  <note><!-- 0..* Annotation Any notes capture with the analysis event --></note>
  <protocolPerformed><!-- 0..1 Reference(Procedure|Task) The protocol that was performed for the analysis event --></protocolPerformed>
  <regionsStudied><!-- 0..* Reference(DocumentReference|Observation) The genomic regions to be studied in the analysis (BED file) --></regionsStudied>
  <regionsCalled><!-- 0..* Reference(DocumentReference|Observation) Genomic regions actually called in the analysis event (BED file) --></regionsCalled>
  <input>  <!-- 0..* Inputs for the analysis event -->
   <file><!-- 0..1 Reference(DocumentReference) File containing input data --></file>
   <type><!-- 0..1 CodeableConcept Type of input data (e.g., BAM, CRAM, or FASTA) --></type>
   <generatedBy[x]><!-- 0..1 Identifier|Reference(GenomicStudy) The analysis event or other GenomicStudy that generated this input file --></generatedBy[x]>
  </input>
  <output>  <!-- 0..* Outputs for the analysis event -->
   <file><!-- 0..1 Reference(DocumentReference) File containing output data --></file>
   <type><!-- 0..1 CodeableConcept Type of output data (e.g., VCF, MAF, or BAM) --></type>
  </output>
  <performer>  <!-- 0..* Performer for the analysis event -->
   <actor><!-- 0..1 Reference(Device|Organization|Practitioner|PractitionerRole) The organization, healthcare professional, or others who participated in performing this analysis --></actor>
   <role><!-- 0..1 CodeableConcept Role of the actor for this analysis --></role>
  </performer>
  <device>  <!-- 0..* Devices used for the analysis (e.g., instruments, software), with settings and parameters -->
   <device><!-- 0..1 Reference(Device) Device used for the analysis --></device>
   <function><!-- 0..1 CodeableConcept Specific function for the device used for the analysis --></function>
  </device>
 </analysis>
</GenomicStudy>

JSON Template

{doco
  "resourceType" : "GenomicStudy",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Identifiers for this genomic study
  "status" : { CodeableConcept }, // R!  The status of the genomic study
  "type" : [{ CodeableConcept }], // The type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling)
  "subject" : { Reference(BiologicallyDerivedProduct|Device|Group|Location|
   Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
   Substance) }, // R!  The primary subject of the genomic study
  "encounter" : { Reference(Encounter) }, // The healthcare event with which this genomics study is associated
  "startDate" : "<dateTime>", // When the genomic study was started
  "basedOn" : [{ Reference(ServiceRequest|Task) }], // Event resources that the genomic study is based on
  "referrer" : { Reference(Practitioner|PractitionerRole) }, // Healthcare professional who requested or referred the genomic study
  "interpreter" : [{ Reference(Practitioner|PractitionerRole) }], // Healthcare professionals who interpreted the genomic study
  "reason" : [{ CodeableReference(Condition|Observation) }], // Why the genomic study was performed
  "instantiatesCanonical" : "<canonical(PlanDefinition)>", // The defined protocol that describes the study
  "instantiatesUri" : "<uri>", // The URL pointing to an externally maintained protocol that describes the study
  "note" : [{ Annotation }], // Comments related to the genomic study
  "description" : "<string>", // Description of the genomic study
  "analysis" : [{ // Genomic Analysis Event
    "identifier" : [{ Identifier }], // Identifiers for the analysis event
    "methodType" : [{ CodeableConcept }], // Type of the methods used in the analysis (e.g., FISH, Karyotyping, MSI)
    "changeType" : [{ CodeableConcept }], // Type of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change)
    "genomeBuild" : { CodeableConcept }, // Genome build that is used in this analysis 
    "instantiatesCanonical" : "<canonical(PlanDefinition|ActivityDefinition)>", // The defined protocol that describes the analysis
    "instantiatesUri" : "<uri>", // The URL pointing to an externally maintained protocol that describes the analysis
    "title" : "<string>", // Name of the analysis event (human friendly)
    "subject" : { Reference(BiologicallyDerivedProduct|Device|Group|Location|
    Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
    Substance) }, // The subject of the analysis event
    "specimen" : [{ Reference(Specimen) }], // The specimen used in the analysis event
    "date" : "<dateTime>", // The date of the analysis event
    "note" : [{ Annotation }], // Any notes capture with the analysis event
    "protocolPerformed" : { Reference(Procedure|Task) }, // The protocol that was performed for the analysis event
    "regionsStudied" : [{ Reference(DocumentReference|Observation) }], // The genomic regions to be studied in the analysis (BED file)
    "regionsCalled" : [{ Reference(DocumentReference|Observation) }], // Genomic regions actually called in the analysis event (BED file)
    "input" : [{ // Inputs for the analysis event
      "file" : { Reference(DocumentReference) }, // File containing input data
      "type" : { CodeableConcept }, // Type of input data (e.g., BAM, CRAM, or FASTA)
      // generatedBy[x]: The analysis event or other GenomicStudy that generated this input file. One of these 2:
      "generatedByIdentifier" : { Identifier },
      "generatedByReference" : { Reference(GenomicStudy) }
    }],
    "output" : [{ // Outputs for the analysis event
      "file" : { Reference(DocumentReference) }, // File containing output data
      "type" : { CodeableConcept } // Type of output data (e.g., VCF, MAF, or BAM)
    }],
    "performer" : [{ // Performer for the analysis event
      "actor" : { Reference(Device|Organization|Practitioner|PractitionerRole) }, // The organization, healthcare professional, or others who participated in performing this analysis
      "role" : { CodeableConcept } // Role of the actor for this analysis
    }],
    "device" : [{ // Devices used for the analysis (e.g., instruments, software), with settings and parameters
      "device" : { Reference(Device) }, // Device used for the analysis
      "function" : { CodeableConcept } // Specific function for the device used for the analysis
    }]
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:GenomicStudy;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:GenomicStudy.identifier [ Identifier ], ... ; # 0..* Identifiers for this genomic study
  fhir:GenomicStudy.status [ CodeableConcept ]; # 1..1 The status of the genomic study
  fhir:GenomicStudy.type [ CodeableConcept ], ... ; # 0..* The type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling)
  fhir:GenomicStudy.subject [ Reference(BiologicallyDerivedProduct|Device|Group|Location|Medication|NutritionProduct|
  Organization|Patient|Practitioner|Procedure|Substance) ]; # 1..1 The primary subject of the genomic study
  fhir:GenomicStudy.encounter [ Reference(Encounter) ]; # 0..1 The healthcare event with which this genomics study is associated
  fhir:GenomicStudy.startDate [ dateTime ]; # 0..1 When the genomic study was started
  fhir:GenomicStudy.basedOn [ Reference(ServiceRequest|Task) ], ... ; # 0..* Event resources that the genomic study is based on
  fhir:GenomicStudy.referrer [ Reference(Practitioner|PractitionerRole) ]; # 0..1 Healthcare professional who requested or referred the genomic study
  fhir:GenomicStudy.interpreter [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Healthcare professionals who interpreted the genomic study
  fhir:GenomicStudy.reason [ CodeableReference(Condition|Observation) ], ... ; # 0..* Why the genomic study was performed
  fhir:GenomicStudy.instantiatesCanonical [ canonical(PlanDefinition) ]; # 0..1 The defined protocol that describes the study
  fhir:GenomicStudy.instantiatesUri [ uri ]; # 0..1 The URL pointing to an externally maintained protocol that describes the study
  fhir:GenomicStudy.note [ Annotation ], ... ; # 0..* Comments related to the genomic study
  fhir:GenomicStudy.description [ string ]; # 0..1 Description of the genomic study
  fhir:GenomicStudy.analysis [ # 0..* Genomic Analysis Event
    fhir:GenomicStudy.analysis.identifier [ Identifier ], ... ; # 0..* Identifiers for the analysis event
    fhir:GenomicStudy.analysis.methodType [ CodeableConcept ], ... ; # 0..* Type of the methods used in the analysis (e.g., FISH, Karyotyping, MSI)
    fhir:GenomicStudy.analysis.changeType [ CodeableConcept ], ... ; # 0..* Type of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change)
    fhir:GenomicStudy.analysis.genomeBuild [ CodeableConcept ]; # 0..1 Genome build that is used in this analysis
    fhir:GenomicStudy.analysis.instantiatesCanonical [ canonical(ActivityDefinition|PlanDefinition) ]; # 0..1 The defined protocol that describes the analysis
    fhir:GenomicStudy.analysis.instantiatesUri [ uri ]; # 0..1 The URL pointing to an externally maintained protocol that describes the analysis
    fhir:GenomicStudy.analysis.title [ string ]; # 0..1 Name of the analysis event (human friendly)
    fhir:GenomicStudy.analysis.subject [ Reference(BiologicallyDerivedProduct|Device|Group|Location|Medication|NutritionProduct|
  Organization|Patient|Practitioner|Procedure|Substance) ]; # 0..1 The subject of the analysis event
    fhir:GenomicStudy.analysis.specimen [ Reference(Specimen) ], ... ; # 0..* The specimen used in the analysis event
    fhir:GenomicStudy.analysis.date [ dateTime ]; # 0..1 The date of the analysis event
    fhir:GenomicStudy.analysis.note [ Annotation ], ... ; # 0..* Any notes capture with the analysis event
    fhir:GenomicStudy.analysis.protocolPerformed [ Reference(Procedure|Task) ]; # 0..1 The protocol that was performed for the analysis event
    fhir:GenomicStudy.analysis.regionsStudied [ Reference(DocumentReference|Observation) ], ... ; # 0..* The genomic regions to be studied in the analysis (BED file)
    fhir:GenomicStudy.analysis.regionsCalled [ Reference(DocumentReference|Observation) ], ... ; # 0..* Genomic regions actually called in the analysis event (BED file)
    fhir:GenomicStudy.analysis.input [ # 0..* Inputs for the analysis event
      fhir:GenomicStudy.analysis.input.file [ Reference(DocumentReference) ]; # 0..1 File containing input data
      fhir:GenomicStudy.analysis.input.type [ CodeableConcept ]; # 0..1 Type of input data (e.g., BAM, CRAM, or FASTA)
      # GenomicStudy.analysis.input.generatedBy[x] : 0..1 The analysis event or other GenomicStudy that generated this input file. One of these 2
        fhir:GenomicStudy.analysis.input.generatedByIdentifier [ Identifier ]
        fhir:GenomicStudy.analysis.input.generatedByReference [ Reference(GenomicStudy) ]
    ], ...;
    fhir:GenomicStudy.analysis.output [ # 0..* Outputs for the analysis event
      fhir:GenomicStudy.analysis.output.file [ Reference(DocumentReference) ]; # 0..1 File containing output data
      fhir:GenomicStudy.analysis.output.type [ CodeableConcept ]; # 0..1 Type of output data (e.g., VCF, MAF, or BAM)
    ], ...;
    fhir:GenomicStudy.analysis.performer [ # 0..* Performer for the analysis event
      fhir:GenomicStudy.analysis.performer.actor [ Reference(Device|Organization|Practitioner|PractitionerRole) ]; # 0..1 The organization, healthcare professional, or others who participated in performing this analysis
      fhir:GenomicStudy.analysis.performer.role [ CodeableConcept ]; # 0..1 Role of the actor for this analysis
    ], ...;
    fhir:GenomicStudy.analysis.device [ # 0..* Devices used for the analysis (e.g., instruments, software), with settings and parameters
      fhir:GenomicStudy.analysis.device.device [ Reference(Device) ]; # 0..1 Device used for the analysis
      fhir:GenomicStudy.analysis.device.function [ CodeableConcept ]; # 0..1 Specific function for the device used for the analysis
    ], ...;
  ], ...;
]

Changes since R4

This resource did not exist in Release 3

This analysis is available as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. GenomicStudy TUDomainResourceGenomic Study

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier 0..*IdentifierIdentifiers for this genomic study

... status ?!Σ1..1CodeableConceptThe status of the genomic study
GenomicStudyStatus (Required)
... type 0..*CodeableConceptThe type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling)
GenomicStudyType (Example)

... encounter 0..1Reference(Encounter)The healthcare event with which this genomics study is associated
... startDate 0..1dateTimeWhen the genomic study was started
... basedOn 0..*Reference(ServiceRequest | Task)Event resources that the genomic study is based on

... referrer 0..1Reference(Practitioner | PractitionerRole)Healthcare professional who requested or referred the genomic study
... interpreter 0..*Reference(Practitioner | PractitionerRole)Healthcare professionals who interpreted the genomic study

... reason 0..*CodeableReference(Condition | Observation)Why the genomic study was performed

... instantiatesCanonical 0..1canonical(PlanDefinition)The defined protocol that describes the study
... instantiatesUri 0..1uriThe URL pointing to an externally maintained protocol that describes the study
... note 0..*AnnotationComments related to the genomic study

... description 0..1stringDescription of the genomic study
... analysis 0..*BackboneElementGenomic Analysis Event

.... identifier 0..*IdentifierIdentifiers for the analysis event

.... methodType 0..*CodeableConceptType of the methods used in the analysis (e.g., FISH, Karyotyping, MSI)
GenomicStudyMethodType (Example)

.... changeType 0..*CodeableConceptType of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change)
GenomicStudyChangeType (Example)

.... genomeBuild 0..1CodeableConceptGenome build that is used in this analysis
HumanRefSeqNCBIBuildId (Extensible)
.... instantiatesCanonical 0..1canonical(PlanDefinition | ActivityDefinition)The defined protocol that describes the analysis
.... instantiatesUri 0..1uriThe URL pointing to an externally maintained protocol that describes the analysis
.... title 0..1stringName of the analysis event (human friendly)
.... subject 0..1Reference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct | NutritionProduct)The subject of the analysis event
.... specimen 0..*Reference(Specimen)The specimen used in the analysis event

.... date 0..1dateTimeThe date of the analysis event
.... note 0..*AnnotationAny notes capture with the analysis event

.... protocolPerformed 0..1Reference(Procedure | Task)The protocol that was performed for the analysis event
.... regionsStudied 0..*Reference(DocumentReference | Observation)The genomic regions to be studied in the analysis (BED file)

.... regionsCalled 0..*Reference(DocumentReference | Observation)Genomic regions actually called in the analysis event (BED file)

.... input 0..*BackboneElementInputs for the analysis event

..... file 0..1Reference(DocumentReference)File containing input data
..... type 0..1CodeableConceptType of input data (e.g., BAM, CRAM, or FASTA)
GenomicStudyDataFormat (Example)
..... generatedBy[x] 0..1The analysis event or other GenomicStudy that generated this input file
...... generatedByIdentifierIdentifier
...... generatedByReferenceReference(GenomicStudy)
.... output 0..*BackboneElementOutputs for the analysis event

..... file 0..1Reference(DocumentReference)File containing output data
..... type 0..1CodeableConceptType of output data (e.g., VCF, MAF, or BAM)
GenomicStudyDataFormat (Example)
.... performer 0..*BackboneElementPerformer for the analysis event

..... actor 0..1Reference(Practitioner | PractitionerRole | Organization | Device)The organization, healthcare professional, or others who participated in performing this analysis
..... role 0..1CodeableConceptRole of the actor for this analysis
.... device 0..*BackboneElementDevices used for the analysis (e.g., instruments, software), with settings and parameters

..... device 0..1Reference(Device)Device used for the analysis
..... function 0..1CodeableConceptSpecific function for the device used for the analysis

doco Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

GenomicStudy (DomainResource)Identifiers for this genomic studyidentifier : Identifier [0..*]The status of the genomic study (this element modifies the meaning of other elements)status : CodeableConcept [1..1] « null (Strength=Required)GenomicStudyStatus! »The type of the study, e.g., Familial variant segregation, Functional variation detection, or Gene expression profilingtype : CodeableConcept [0..*] « null (Strength=Example)GenomicStudyType?? »The primary subject of the genomic studysubject : Reference [1..1] « Patient|Group|Device|Location| Organization|Procedure|Practitioner|Medication|Substance| BiologicallyDerivedProduct|NutritionProduct »The healthcare event with which this genomics study is associatedencounter : Reference [0..1] « Encounter »When the genomic study was startedstartDate : dateTime [0..1]Event resources that the genomic study is based onbasedOn : Reference [0..*] « ServiceRequest|Task »Healthcare professional who requested or referred the genomic studyreferrer : Reference [0..1] « Practitioner|PractitionerRole »Healthcare professionals who interpreted the genomic studyinterpreter : Reference [0..*] « Practitioner|PractitionerRole »Why the genomic study was performedreason : CodeableReference [0..*] « Condition|Observation »The defined protocol that describes the studyinstantiatesCanonical : canonical [0..1] « PlanDefinition »The URL pointing to an externally maintained protocol that describes the studyinstantiatesUri : uri [0..1]Comments related to the genomic studynote : Annotation [0..*]Description of the genomic studydescription : string [0..1]AnalysisIdentifiers for the analysis eventidentifier : Identifier [0..*]Type of the methods used in the analysis, e.g., Fluorescence in situ hybridization (FISH), Karyotyping, or Microsatellite instability testing (MSI)methodType : CodeableConcept [0..*] « null (Strength=Example)GenomicStudyMethodType?? »Type of the genomic changes studied in the analysis, e.g., DNA, RNA, or amino acid changechangeType : CodeableConcept [0..*] « null (Strength=Example)GenomicStudyChangeType?? »The reference genome build that is used in this analysisgenomeBuild : CodeableConcept [0..1] « null (Strength=Extensible)HumanRefSeqNCBIBuildId+ »The defined protocol that describes the analysisinstantiatesCanonical : canonical [0..1] « PlanDefinition| ActivityDefinition »The URL pointing to an externally maintained protocol that describes the analysisinstantiatesUri : uri [0..1]Name of the analysis event (human friendly)title : string [0..1]The subject of the analysis eventsubject : Reference [0..1] « Patient|Group|Device|Location| Organization|Procedure|Practitioner|Medication|Substance| BiologicallyDerivedProduct|NutritionProduct »The specimen used in the analysis eventspecimen : Reference [0..*] « Specimen »The date of the analysis eventdate : dateTime [0..1]Any notes capture with the analysis eventnote : Annotation [0..*]The protocol that was performed for the analysis eventprotocolPerformed : Reference [0..1] « Procedure|Task »The genomic regions to be studied in the analysis (BED file)regionsStudied : Reference [0..*] « DocumentReference|Observation »Genomic regions actually called in the analysis event (BED file)regionsCalled : Reference [0..*] « DocumentReference|Observation »InputFile containing input datafile : Reference [0..1] « DocumentReference »Type of input data, e.g., BAM, CRAM, or FASTAtype : CodeableConcept [0..1] « null (Strength=Example)GenomicStudyDataFormat?? »The analysis event or other GenomicStudy that generated this input filegeneratedBy[x] : DataType [0..1] « Identifier|Reference(GenomicStudy) »OutputFile containing output datafile : Reference [0..1] « DocumentReference »Type of output data, e.g., VCF, MAF, or BAMtype : CodeableConcept [0..1] « null (Strength=Example)GenomicStudyDataFormat?? »PerformerThe organization, healthcare professional, or others who participated in performing this analysisactor : Reference [0..1] « Practitioner|PractitionerRole| Organization|Device »Role of the actor for this analysisrole : CodeableConcept [0..1]DeviceDevice used for the analysisdevice : Reference [0..1] « Device »Specific function for the device used for the analysisfunction : CodeableConcept [0..1]Inputs for the analysis eventinput[0..*]Outputs for the analysis eventoutput[0..*]Performer for the analysis eventperformer[0..*]Devices used for the analysis (e.g., instruments, software), with settings and parametersdevice[0..*]The details about a specific analysis that was performed in this GenomicStudyanalysis[0..*]

XML Template

<GenomicStudy xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Identifiers for this genomic study --></identifier>
 <status><!-- 1..1 CodeableConcept The status of the genomic study --></status>
 <type><!-- 0..* CodeableConcept The type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling) --></type>
 <subject><!-- 1..1 Reference(BiologicallyDerivedProduct|Device|Group|Location|
   Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
   Substance) The primary subject of the genomic study --></subject>
 <encounter><!-- 0..1 Reference(Encounter) The healthcare event with which this genomics study is associated --></encounter>
 <startDate value="[dateTime]"/><!-- 0..1 When the genomic study was started -->
 <basedOn><!-- 0..* Reference(ServiceRequest|Task) Event resources that the genomic study is based on --></basedOn>
 <referrer><!-- 0..1 Reference(Practitioner|PractitionerRole) Healthcare professional who requested or referred the genomic study --></referrer>
 <interpreter><!-- 0..* Reference(Practitioner|PractitionerRole) Healthcare professionals who interpreted the genomic study --></interpreter>
 <reason><!-- 0..* CodeableReference(Condition|Observation) Why the genomic study was performed --></reason>
 <instantiatesCanonical><!-- 0..1 canonical(PlanDefinition) The defined protocol that describes the study --></instantiatesCanonical>
 <instantiatesUri value="[uri]"/><!-- 0..1 The URL pointing to an externally maintained protocol that describes the study -->
 <note><!-- 0..* Annotation Comments related to the genomic study --></note>
 <description value="[string]"/><!-- 0..1 Description of the genomic study -->
 <analysis>  <!-- 0..* Genomic Analysis Event -->
  <identifier><!-- 0..* Identifier Identifiers for the analysis event --></identifier>
  <methodType><!-- 0..* CodeableConcept Type of the methods used in the analysis (e.g., FISH, Karyotyping, MSI) --></methodType>
  <changeType><!-- 0..* CodeableConcept Type of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change) --></changeType>
  <genomeBuild><!-- 0..1 CodeableConcept Genome build that is used in this analysis  --></genomeBuild>
  <instantiatesCanonical><!-- 0..1 canonical(ActivityDefinition|PlanDefinition) The defined protocol that describes the analysis --></instantiatesCanonical>
  <instantiatesUri value="[uri]"/><!-- 0..1 The URL pointing to an externally maintained protocol that describes the analysis -->
  <title value="[string]"/><!-- 0..1 Name of the analysis event (human friendly) -->
  <subject><!-- 0..1 Reference(BiologicallyDerivedProduct|Device|Group|Location|
    Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
    Substance) The subject of the analysis event --></subject>
  <specimen><!-- 0..* Reference(Specimen) The specimen used in the analysis event --></specimen>
  <date value="[dateTime]"/><!-- 0..1 The date of the analysis event -->
  <note><!-- 0..* Annotation Any notes capture with the analysis event --></note>
  <protocolPerformed><!-- 0..1 Reference(Procedure|Task) The protocol that was performed for the analysis event --></protocolPerformed>
  <regionsStudied><!-- 0..* Reference(DocumentReference|Observation) The genomic regions to be studied in the analysis (BED file) --></regionsStudied>
  <regionsCalled><!-- 0..* Reference(DocumentReference|Observation) Genomic regions actually called in the analysis event (BED file) --></regionsCalled>
  <input>  <!-- 0..* Inputs for the analysis event -->
   <file><!-- 0..1 Reference(DocumentReference) File containing input data --></file>
   <type><!-- 0..1 CodeableConcept Type of input data (e.g., BAM, CRAM, or FASTA) --></type>
   <generatedBy[x]><!-- 0..1 Identifier|Reference(GenomicStudy) The analysis event or other GenomicStudy that generated this input file --></generatedBy[x]>
  </input>
  <output>  <!-- 0..* Outputs for the analysis event -->
   <file><!-- 0..1 Reference(DocumentReference) File containing output data --></file>
   <type><!-- 0..1 CodeableConcept Type of output data (e.g., VCF, MAF, or BAM) --></type>
  </output>
  <performer>  <!-- 0..* Performer for the analysis event -->
   <actor><!-- 0..1 Reference(Device|Organization|Practitioner|PractitionerRole) The organization, healthcare professional, or others who participated in performing this analysis --></actor>
   <role><!-- 0..1 CodeableConcept Role of the actor for this analysis --></role>
  </performer>
  <device>  <!-- 0..* Devices used for the analysis (e.g., instruments, software), with settings and parameters -->
   <device><!-- 0..1 Reference(Device) Device used for the analysis --></device>
   <function><!-- 0..1 CodeableConcept Specific function for the device used for the analysis --></function>
  </device>
 </analysis>
</GenomicStudy>

JSON Template

{doco
  "resourceType" : "GenomicStudy",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Identifiers for this genomic study
  "status" : { CodeableConcept }, // R!  The status of the genomic study
  "type" : [{ CodeableConcept }], // The type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling)
  "subject" : { Reference(BiologicallyDerivedProduct|Device|Group|Location|
   Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
   Substance) }, // R!  The primary subject of the genomic study
  "encounter" : { Reference(Encounter) }, // The healthcare event with which this genomics study is associated
  "startDate" : "<dateTime>", // When the genomic study was started
  "basedOn" : [{ Reference(ServiceRequest|Task) }], // Event resources that the genomic study is based on
  "referrer" : { Reference(Practitioner|PractitionerRole) }, // Healthcare professional who requested or referred the genomic study
  "interpreter" : [{ Reference(Practitioner|PractitionerRole) }], // Healthcare professionals who interpreted the genomic study
  "reason" : [{ CodeableReference(Condition|Observation) }], // Why the genomic study was performed
  "instantiatesCanonical" : "<canonical(PlanDefinition)>", // The defined protocol that describes the study
  "instantiatesUri" : "<uri>", // The URL pointing to an externally maintained protocol that describes the study
  "note" : [{ Annotation }], // Comments related to the genomic study
  "description" : "<string>", // Description of the genomic study
  "analysis" : [{ // Genomic Analysis Event
    "identifier" : [{ Identifier }], // Identifiers for the analysis event
    "methodType" : [{ CodeableConcept }], // Type of the methods used in the analysis (e.g., FISH, Karyotyping, MSI)
    "changeType" : [{ CodeableConcept }], // Type of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change)
    "genomeBuild" : { CodeableConcept }, // Genome build that is used in this analysis 
    "instantiatesCanonical" : "<canonical(PlanDefinition|ActivityDefinition)>", // The defined protocol that describes the analysis
    "instantiatesUri" : "<uri>", // The URL pointing to an externally maintained protocol that describes the analysis
    "title" : "<string>", // Name of the analysis event (human friendly)
    "subject" : { Reference(BiologicallyDerivedProduct|Device|Group|Location|
    Medication|NutritionProduct|Organization|Patient|Practitioner|Procedure|
    Substance) }, // The subject of the analysis event
    "specimen" : [{ Reference(Specimen) }], // The specimen used in the analysis event
    "date" : "<dateTime>", // The date of the analysis event
    "note" : [{ Annotation }], // Any notes capture with the analysis event
    "protocolPerformed" : { Reference(Procedure|Task) }, // The protocol that was performed for the analysis event
    "regionsStudied" : [{ Reference(DocumentReference|Observation) }], // The genomic regions to be studied in the analysis (BED file)
    "regionsCalled" : [{ Reference(DocumentReference|Observation) }], // Genomic regions actually called in the analysis event (BED file)
    "input" : [{ // Inputs for the analysis event
      "file" : { Reference(DocumentReference) }, // File containing input data
      "type" : { CodeableConcept }, // Type of input data (e.g., BAM, CRAM, or FASTA)
      // generatedBy[x]: The analysis event or other GenomicStudy that generated this input file. One of these 2:
      "generatedByIdentifier" : { Identifier },
      "generatedByReference" : { Reference(GenomicStudy) }
    }],
    "output" : [{ // Outputs for the analysis event
      "file" : { Reference(DocumentReference) }, // File containing output data
      "type" : { CodeableConcept } // Type of output data (e.g., VCF, MAF, or BAM)
    }],
    "performer" : [{ // Performer for the analysis event
      "actor" : { Reference(Device|Organization|Practitioner|PractitionerRole) }, // The organization, healthcare professional, or others who participated in performing this analysis
      "role" : { CodeableConcept } // Role of the actor for this analysis
    }],
    "device" : [{ // Devices used for the analysis (e.g., instruments, software), with settings and parameters
      "device" : { Reference(Device) }, // Device used for the analysis
      "function" : { CodeableConcept } // Specific function for the device used for the analysis
    }]
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:GenomicStudy;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:GenomicStudy.identifier [ Identifier ], ... ; # 0..* Identifiers for this genomic study
  fhir:GenomicStudy.status [ CodeableConcept ]; # 1..1 The status of the genomic study
  fhir:GenomicStudy.type [ CodeableConcept ], ... ; # 0..* The type of the study (e.g., Familial variant segregation, Functional variation detection, or Gene expression profiling)
  fhir:GenomicStudy.subject [ Reference(BiologicallyDerivedProduct|Device|Group|Location|Medication|NutritionProduct|
  Organization|Patient|Practitioner|Procedure|Substance) ]; # 1..1 The primary subject of the genomic study
  fhir:GenomicStudy.encounter [ Reference(Encounter) ]; # 0..1 The healthcare event with which this genomics study is associated
  fhir:GenomicStudy.startDate [ dateTime ]; # 0..1 When the genomic study was started
  fhir:GenomicStudy.basedOn [ Reference(ServiceRequest|Task) ], ... ; # 0..* Event resources that the genomic study is based on
  fhir:GenomicStudy.referrer [ Reference(Practitioner|PractitionerRole) ]; # 0..1 Healthcare professional who requested or referred the genomic study
  fhir:GenomicStudy.interpreter [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Healthcare professionals who interpreted the genomic study
  fhir:GenomicStudy.reason [ CodeableReference(Condition|Observation) ], ... ; # 0..* Why the genomic study was performed
  fhir:GenomicStudy.instantiatesCanonical [ canonical(PlanDefinition) ]; # 0..1 The defined protocol that describes the study
  fhir:GenomicStudy.instantiatesUri [ uri ]; # 0..1 The URL pointing to an externally maintained protocol that describes the study
  fhir:GenomicStudy.note [ Annotation ], ... ; # 0..* Comments related to the genomic study
  fhir:GenomicStudy.description [ string ]; # 0..1 Description of the genomic study
  fhir:GenomicStudy.analysis [ # 0..* Genomic Analysis Event
    fhir:GenomicStudy.analysis.identifier [ Identifier ], ... ; # 0..* Identifiers for the analysis event
    fhir:GenomicStudy.analysis.methodType [ CodeableConcept ], ... ; # 0..* Type of the methods used in the analysis (e.g., FISH, Karyotyping, MSI)
    fhir:GenomicStudy.analysis.changeType [ CodeableConcept ], ... ; # 0..* Type of the genomic changes studied in the analysis (e.g., DNA, RNA, or AA change)
    fhir:GenomicStudy.analysis.genomeBuild [ CodeableConcept ]; # 0..1 Genome build that is used in this analysis
    fhir:GenomicStudy.analysis.instantiatesCanonical [ canonical(ActivityDefinition|PlanDefinition) ]; # 0..1 The defined protocol that describes the analysis
    fhir:GenomicStudy.analysis.instantiatesUri [ uri ]; # 0..1 The URL pointing to an externally maintained protocol that describes the analysis
    fhir:GenomicStudy.analysis.title [ string ]; # 0..1 Name of the analysis event (human friendly)
    fhir:GenomicStudy.analysis.subject [ Reference(BiologicallyDerivedProduct|Device|Group|Location|Medication|NutritionProduct|
  Organization|Patient|Practitioner|Procedure|Substance) ]; # 0..1 The subject of the analysis event
    fhir:GenomicStudy.analysis.specimen [ Reference(Specimen) ], ... ; # 0..* The specimen used in the analysis event
    fhir:GenomicStudy.analysis.date [ dateTime ]; # 0..1 The date of the analysis event
    fhir:GenomicStudy.analysis.note [ Annotation ], ... ; # 0..* Any notes capture with the analysis event
    fhir:GenomicStudy.analysis.protocolPerformed [ Reference(Procedure|Task) ]; # 0..1 The protocol that was performed for the analysis event
    fhir:GenomicStudy.analysis.regionsStudied [ Reference(DocumentReference|Observation) ], ... ; # 0..* The genomic regions to be studied in the analysis (BED file)
    fhir:GenomicStudy.analysis.regionsCalled [ Reference(DocumentReference|Observation) ], ... ; # 0..* Genomic regions actually called in the analysis event (BED file)
    fhir:GenomicStudy.analysis.input [ # 0..* Inputs for the analysis event
      fhir:GenomicStudy.analysis.input.file [ Reference(DocumentReference) ]; # 0..1 File containing input data
      fhir:GenomicStudy.analysis.input.type [ CodeableConcept ]; # 0..1 Type of input data (e.g., BAM, CRAM, or FASTA)
      # GenomicStudy.analysis.input.generatedBy[x] : 0..1 The analysis event or other GenomicStudy that generated this input file. One of these 2
        fhir:GenomicStudy.analysis.input.generatedByIdentifier [ Identifier ]
        fhir:GenomicStudy.analysis.input.generatedByReference [ Reference(GenomicStudy) ]
    ], ...;
    fhir:GenomicStudy.analysis.output [ # 0..* Outputs for the analysis event
      fhir:GenomicStudy.analysis.output.file [ Reference(DocumentReference) ]; # 0..1 File containing output data
      fhir:GenomicStudy.analysis.output.type [ CodeableConcept ]; # 0..1 Type of output data (e.g., VCF, MAF, or BAM)
    ], ...;
    fhir:GenomicStudy.analysis.performer [ # 0..* Performer for the analysis event
      fhir:GenomicStudy.analysis.performer.actor [ Reference(Device|Organization|Practitioner|PractitionerRole) ]; # 0..1 The organization, healthcare professional, or others who participated in performing this analysis
      fhir:GenomicStudy.analysis.performer.role [ CodeableConcept ]; # 0..1 Role of the actor for this analysis
    ], ...;
    fhir:GenomicStudy.analysis.device [ # 0..* Devices used for the analysis (e.g., instruments, software), with settings and parameters
      fhir:GenomicStudy.analysis.device.device [ Reference(Device) ]; # 0..1 Device used for the analysis
      fhir:GenomicStudy.analysis.device.function [ CodeableConcept ]; # 0..1 Specific function for the device used for the analysis
    ], ...;
  ], ...;
]

Changes since Release 4

This resource did not exist in Release 3

This analysis is available as XML or JSON.

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

10.4.4.1 Terminology Bindings

PathDefinitionTypeReference
GenomicStudy.status

The status of the GenomicStudy.

RequiredGenomicStudyStatus
GenomicStudy.type

The type of the GenomicStudy.

ExampleGenomicStudyType
GenomicStudy.analysis.methodType

The method type of the GenomicStudy analysis.

ExampleGenomicStudyMethodType
GenomicStudy.analysis.changeType

The change type of the GenomicStudy analysis.

ExampleGenomicStudyChangeType
GenomicStudy.analysis.genomeBuild Extensiblehttp://loinc.org/vs/LL1040-6
GenomicStudy.analysis.input.type

The data formats relevant to Genomic Study analysis.

ExampleGenomicStudyDataFormat
GenomicStudy.analysis.output.type

The data formats relevant to Genomic Study analysis.

ExampleGenomicStudyDataFormat

10.4.4.2 Example Codes

Genomic Study resource uses many example codes for terminology binding. Reviewers and implementers are strongly encouraged to provide their comments and feedback about the example codes for terminology binding purposes.

Below the attributes of provided example bindings are listed. Links are included to indicate where the example codes from were pulled from.

10.4.4.2.1 GenomicStudy.type

The type example codes were based on discussions by Clinical Genomics Workgroup.

10.4.4.2.2 GenomicStudy.analysis.methodType

The method type example codes were pulled from National Library of Medicine-Genetic Testing Registry (NCBI-GTR) values of describing different testing methods on various levels: major method category , method category , and primary methodology .

10.4.4.2.3 GenomicStudy.analysis.input.type and GenomicStudy.analysis.output.type

The input and output type example codes were pulled from Integrative Genomics Viewer Documentation by Broad Institute.

10.4.4.2.4 GenomicStudy.analysis.changeType

The change type example codes were based on discussions by Clinical Genomics Workgroup.

10.4.4.3 Implementation Notes

10.4.4.4 Use Cases

GenomicStudy.subject and GenomicStudy.analysis.subject can reference a lot of resource types besides Patient such as Group, BiologicallyDerivedProduct, or Substance. In addition, it can provide more details about involved genomic files as inputs or outputs. These various options allow the GenomicStudy resource to cover many use cases besides direct patient care, e.g., research studies that involve multiple patients or environmental samples. Through the following subsections, some of these use cases are described.

10.4.4.4.1 Trio studies

Trio studies involve a proband and two more subjects such as proband’s mother and father for a de novo mutation detection study. GenomicStudy would list the proband as GenomicStudy.subject because it is the main subject of the study. While each of the study participants, i.e., proband, mother, and father, may have their own individual GenomicStudy.analysis.

GenomicStudy.analysis.input lists various files that may be used for each individual analysis, their types, and their generation context. GenomicStudy.analysis.input.file elements may link these files to DocumentReference resources that provides more details about each individual files. One of the main details is the subject of a file. If a file is linked to a specific patient, the corresponding DocumentReference.subject may reference this Patient Resource. If the file contains data from multiple persons, the corresponding DocumentReference.subject may reference a Group resource that lists these persons, and their relationship to each other if available.

10.4.4.4.2 Somatic mutation detection studies

Somatic mutation studies may use multiple samples from the patient to support mutation detection, e.g., tumor-normal sample pair. GenomicStudy.analysis may describe conducted analyses per each sample, where GenomicStudy.analysis.specimen elements may provide more details about each individual element. In addition GenomicStudy.analysis.input can list relevant input files, where the DocumentReference provide by GenomicStudy.analysis.input.file can list the specific specimen this input file is related to using DocumentReference.subject as a Specimen resource instance.

10.4.4.4.3 EHR access to genomic studies

10.4.5 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
analysis-patientreferenceWho the analysis is aboutGenomicStudy.analysis.subject.where(resolve() is Patient)
(Practitioner, Group, Organization, BiologicallyDerivedProduct, NutritionProduct, Device, Medication, Patient, Procedure, Substance, Location)
analysis-subjectreferenceWho the analysis is aboutGenomicStudy.analysis.subject
(Practitioner, Group, Organization, BiologicallyDerivedProduct, NutritionProduct, Device, Medication, Patient, Procedure, Substance, Location)
identifiertokenIdentifiers for the StudyGenomicStudy.identifier
patientreferenceWho the study is aboutGenomicStudy.subject.where(resolve() is Patient)
(Practitioner, Group, Organization, BiologicallyDerivedProduct, NutritionProduct, Device, Medication, Patient, Procedure, Substance, Location)
statustokenThe status of the studyGenomicStudy.status
subjectreferenceWho the study is aboutGenomicStudy.subject
(Practitioner, Group, Organization, BiologicallyDerivedProduct, NutritionProduct, Device, Medication, Patient, Procedure, Substance, Location)