This page is part of the FHIR Specification (v4.5.0: R5 Preview #3). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

14.13.0 Statistic

Clinical Decision Support

Work Group

Maturity Level: 1

Standards Status: Trial Use

This type is still undergoing development and review by the appropriate Workgroups. At this time, is considered only as a draft design not suitable for production implementation

The Statistic data type represents single datum (quantitative value), computed from a sample, and its attributes.

Note: the Statistic structure allows modifier extensions.

Structure

Name	Flags	Card.	Type	Description & Constraints
Statistic	Σ D		Element	Single statistic Elements defined in Ancestors: id, extension, modifierExtension
description	Σ	0..1	string	Description of content
note	Σ	0..*	Annotation	Footnotes and/or explanatory notes
statisticType	Σ	0..1	CodeableConcept	Type of statistic, eg relative risk StatisticType (Extensible)
quantity	Σ	0..1	Quantity	Statistic value
numberOfEvents	Σ	0..1	integer	The number of events associated with the statistic
sampleSize	Σ	0..1	Element	Number of samples in the statistic
description	Σ	0..1	string	Textual description of sample size for statistic
note	Σ	0..*	Annotation	Footnote or explanatory note about the sample size
numberOfStudies	Σ	0..1	integer	Number of contributing studies
numberOfParticipants	Σ	0..1	integer	Cumulative number of participants
knownDataCount	Σ	0..1	integer	Number of participants with known results for measured variables
attributeEstimate	Σ	0..*	Element	An attribute of the Statistic
description	Σ	0..1	string	Textual description of the attribute estimate
note	Σ	0..*	Annotation	Footnote or explanatory note about the estimate
type	Σ	0..1	CodeableConcept	The type of attribute estimate, eg confidence interval or p value StatisticAttributeEstimateType (Extensible)
quantity	Σ	0..1	Quantity	The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure
level	Σ	0..1	decimal	Level of confidence interval, eg 0.95 for 95% confidence interval
range	Σ	0..1	Range	Lower and upper bound values of the attribute estimate
attributeEstimate	Σ	0..*	Element	A nested attribute estimate; which is the attribute estimate of an attribute estimate
description	Σ	0..1	string	Textual description of the attribute estimate
note	Σ	0..*	Annotation	Footnote or explanatory note about the estimate
type	Σ	0..1	CodeableConcept	The type of attribute estimate, eg confidence interval or p value StatisticAttributeEstimateType (Extensible)
quantity	Σ	0..1	Quantity	The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure
level	Σ	0..1	decimal	Level of confidence interval, eg 0.95 for 95% confidence interval
range	Σ	0..1	Range	Lower and upper bound values of the attribute estimate
modelCharacteristic	Σ	0..*	Element	Model characteristic
code	Σ	0..1	CodeableConcept	Model specification StatisticModelCode (Extensible)
value[x]	Σ	0..1		Model specification details StatisticModelMethod (Extensible)
valueCodeableConcept			CodeableConcept
valueBoolean			boolean
valueQuantity			SimpleQuantity
valueRange			Range
variable	Σ	0..*	Element	A variable adjusted for in the adjusted analysis
variableDefinition	Σ	1..1	Reference(Group \| EvidenceVariable)	Description of the variable
handling	Σ	0..1	code	continuous \| dichotomous \| ordinal \| polychotomous EvidenceVariableHandling (Required)
valueCategory	Σ	0..*	CodeableConcept	Description for grouping of ordinal or polychotomous variables
valueQuantity	Σ	0..*	Quantity	Discrete value for grouping of ordinal or polychotomous variables
valueRange	Σ	0..*	Range	Range of values for grouping of ordinal or polychotomous variables
Documentation for this format

UML Diagram (Legend)

XML Template

<Statistic xmlns="http://hl7.org/fhir">
 <!-- from Element: extension -->
 <description value="[string]"/><!-- 0..1 Description of content -->
 <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
 <statisticType><!-- 0..1 CodeableConcept Type of statistic, eg relative risk --></statisticType>
 <quantity><!-- 0..1 Quantity Statistic value --></quantity>
 <numberOfEvents value="[integer]"/><!-- 0..1 The number of events associated with the statistic -->
 <sampleSize>  <!-- 0..1 Number of samples in the statistic -->
  <description value="[string]"/><!-- 0..1 Textual description of sample size for statistic -->
  <note><!-- 0..* Annotation Footnote or explanatory note about the sample size --></note>
  <numberOfStudies value="[integer]"/><!-- 0..1 Number of contributing studies -->
  <numberOfParticipants value="[integer]"/><!-- 0..1 Cumulative number of participants -->
  <knownDataCount value="[integer]"/><!-- 0..1 Number of participants with known results for measured variables -->
 </sampleSize>
 <attributeEstimate>  <!-- 0..* An attribute of the Statistic -->
  <description value="[string]"/><!-- 0..1 Textual description of the attribute estimate -->
  <note><!-- 0..* Annotation Footnote or explanatory note about the estimate --></note>
  <type><!-- 0..1 CodeableConcept The type of attribute estimate, eg confidence interval or p value --></type>
  <quantity><!-- 0..1 Quantity The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure --></quantity>
  <level value="[decimal]"/><!-- 0..1 Level of confidence interval, eg 0.95 for 95% confidence interval -->
  <range><!-- 0..1 Range Lower and upper bound values of the attribute estimate --></range>
  <attributeEstimate>  <!-- 0..* A nested attribute estimate; which is the attribute estimate of an attribute estimate -->
   <description value="[string]"/><!-- 0..1 Textual description of the attribute estimate -->
   <note><!-- 0..* Annotation Footnote or explanatory note about the estimate --></note>
   <type><!-- 0..1 CodeableConcept The type of attribute estimate, eg confidence interval or p value --></type>
   <quantity><!-- 0..1 Quantity The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure --></quantity>
   <level value="[decimal]"/><!-- 0..1 Level of confidence interval, eg 0.95 for 95% confidence interval -->
   <range><!-- 0..1 Range Lower and upper bound values of the attribute estimate --></range>
  </attributeEstimate>
 </attributeEstimate>
 <modelCharacteristic>  <!-- 0..* Model characteristic -->
  <code><!-- 0..1 CodeableConcept Model specification --></code>
  <value[x]><!-- 0..1 CodeableConcept|boolean|Quantity(SimpleQuantity)|Range Model specification details --></value[x]>
  <variable>  <!-- 0..* A variable adjusted for in the adjusted analysis -->
   <variableDefinition><!-- 1..1 Reference(EvidenceVariable|Group) Description of the variable --></variableDefinition>
   <handling value="[code]"/><!-- 0..1 continuous | dichotomous | ordinal | polychotomous -->
   <valueCategory><!-- 0..* CodeableConcept Description for grouping of ordinal or polychotomous variables --></valueCategory>
   <valueQuantity><!-- 0..* Quantity Discrete value for grouping of ordinal or polychotomous variables --></valueQuantity>
   <valueRange><!-- 0..* Range Range of values for grouping of ordinal or polychotomous variables --></valueRange>
  </variable>
 </modelCharacteristic>
</Statistic>

JSON Template

{
  // from Element: extension
  "description" : "<string>", // Description of content
  "note" : [{ Annotation }], // Footnotes and/or explanatory notes
  "statisticType" : { CodeableConcept }, // Type of statistic, eg relative risk
  "quantity" : { Quantity }, // Statistic value
  "numberOfEvents" : <integer>, // The number of events associated with the statistic
  "sampleSize" : { // Number of samples in the statistic
    "description" : "<string>", // Textual description of sample size for statistic
    "note" : [{ Annotation }], // Footnote or explanatory note about the sample size
    "numberOfStudies" : <integer>, // Number of contributing studies
    "numberOfParticipants" : <integer>, // Cumulative number of participants
    "knownDataCount" : <integer> // Number of participants with known results for measured variables
  },
  "attributeEstimate" : [{ // An attribute of the Statistic
    "description" : "<string>", // Textual description of the attribute estimate
    "note" : [{ Annotation }], // Footnote or explanatory note about the estimate
    "type" : { CodeableConcept }, // The type of attribute estimate, eg confidence interval or p value
    "quantity" : { Quantity }, // The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure
    "level" : <decimal>, // Level of confidence interval, eg 0.95 for 95% confidence interval
    "range" : { Range }, // Lower and upper bound values of the attribute estimate
    "attributeEstimate" : [{ // A nested attribute estimate; which is the attribute estimate of an attribute estimate
      "description" : "<string>", // Textual description of the attribute estimate
      "note" : [{ Annotation }], // Footnote or explanatory note about the estimate
      "type" : { CodeableConcept }, // The type of attribute estimate, eg confidence interval or p value
      "quantity" : { Quantity }, // The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure
      "level" : <decimal>, // Level of confidence interval, eg 0.95 for 95% confidence interval
      "range" : { Range } // Lower and upper bound values of the attribute estimate
    }]
  }],
  "modelCharacteristic" : [{ // Model characteristic
    "code" : { CodeableConcept }, // Model specification
    // value[x]: Model specification details. One of these 4:
    "valueCodeableConcept" : { CodeableConcept },
    "valueBoolean" : <boolean>,
    "valueQuantity" : { Quantity(SimpleQuantity) },
    "valueRange" : { Range },
    "variable" : [{ // A variable adjusted for in the adjusted analysis
      "variableDefinition" : { Reference(EvidenceVariable|Group) }, // R!  Description of the variable
      "handling" : "<code>", // continuous | dichotomous | ordinal | polychotomous
      "valueCategory" : [{ CodeableConcept }], // Description for grouping of ordinal or polychotomous variables
      "valueQuantity" : [{ Quantity }], // Discrete value for grouping of ordinal or polychotomous variables
      "valueRange" : [{ Range }] // Range of values for grouping of ordinal or polychotomous variables
    }]
  }]
}

Turtle Template

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

[
 # from Element: Element.extension
  fhir:Statistic.description [ string ]; # 0..1 Description of content
  fhir:Statistic.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
  fhir:Statistic.statisticType [ CodeableConcept ]; # 0..1 Type of statistic, eg relative risk
  fhir:Statistic.quantity [ Quantity ]; # 0..1 Statistic value
  fhir:Statistic.numberOfEvents [ integer ]; # 0..1 The number of events associated with the statistic
  fhir:Statistic.sampleSize [ # 0..1 Number of samples in the statistic
    fhir:Statistic.sampleSize.description [ string ]; # 0..1 Textual description of sample size for statistic
    fhir:Statistic.sampleSize.note [ Annotation ], ... ; # 0..* Footnote or explanatory note about the sample size
    fhir:Statistic.sampleSize.numberOfStudies [ integer ]; # 0..1 Number of contributing studies
    fhir:Statistic.sampleSize.numberOfParticipants [ integer ]; # 0..1 Cumulative number of participants
    fhir:Statistic.sampleSize.knownDataCount [ integer ]; # 0..1 Number of participants with known results for measured variables
  ];
  fhir:Statistic.attributeEstimate [ # 0..* An attribute of the Statistic
    fhir:Statistic.attributeEstimate.description [ string ]; # 0..1 Textual description of the attribute estimate
    fhir:Statistic.attributeEstimate.note [ Annotation ], ... ; # 0..* Footnote or explanatory note about the estimate
    fhir:Statistic.attributeEstimate.type [ CodeableConcept ]; # 0..1 The type of attribute estimate, eg confidence interval or p value
    fhir:Statistic.attributeEstimate.quantity [ Quantity ]; # 0..1 The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure
    fhir:Statistic.attributeEstimate.level [ decimal ]; # 0..1 Level of confidence interval, eg 0.95 for 95% confidence interval
    fhir:Statistic.attributeEstimate.range [ Range ]; # 0..1 Lower and upper bound values of the attribute estimate
    fhir:Statistic.attributeEstimate.attributeEstimate [ # 0..* A nested attribute estimate; which is the attribute estimate of an attribute estimate
      fhir:Statistic.attributeEstimate.attributeEstimate.description [ string ]; # 0..1 Textual description of the attribute estimate
      fhir:Statistic.attributeEstimate.attributeEstimate.note [ Annotation ], ... ; # 0..* Footnote or explanatory note about the estimate
      fhir:Statistic.attributeEstimate.attributeEstimate.type [ CodeableConcept ]; # 0..1 The type of attribute estimate, eg confidence interval or p value
      fhir:Statistic.attributeEstimate.attributeEstimate.quantity [ Quantity ]; # 0..1 The singular quantity of the attribute estimate, for attribute estimates represented as single values; also used to report unit of measure
      fhir:Statistic.attributeEstimate.attributeEstimate.level [ decimal ]; # 0..1 Level of confidence interval, eg 0.95 for 95% confidence interval
      fhir:Statistic.attributeEstimate.attributeEstimate.range [ Range ]; # 0..1 Lower and upper bound values of the attribute estimate
    ], ...;
  ], ...;
  fhir:Statistic.modelCharacteristic [ # 0..* Model characteristic
    fhir:Statistic.modelCharacteristic.code [ CodeableConcept ]; # 0..1 Model specification
    # Statistic.modelCharacteristic.value[x] : 0..1 Model specification details. One of these 4
      fhir:Statistic.modelCharacteristic.valueCodeableConcept [ CodeableConcept ]
      fhir:Statistic.modelCharacteristic.valueBoolean [ boolean ]
      fhir:Statistic.modelCharacteristic.valueSimpleQuantity [ Quantity(SimpleQuantity) ]
      fhir:Statistic.modelCharacteristic.valueRange [ Range ]
    fhir:Statistic.modelCharacteristic.variable [ # 0..* A variable adjusted for in the adjusted analysis
      fhir:Statistic.modelCharacteristic.variable.variableDefinition [ Reference(EvidenceVariable|Group) ]; # 1..1 Description of the variable
      fhir:Statistic.modelCharacteristic.variable.handling [ code ]; # 0..1 continuous | dichotomous | ordinal | polychotomous
      fhir:Statistic.modelCharacteristic.variable.valueCategory [ CodeableConcept ], ... ; # 0..* Description for grouping of ordinal or polychotomous variables
      fhir:Statistic.modelCharacteristic.variable.valueQuantity [ Quantity ], ... ; # 0..* Discrete value for grouping of ordinal or polychotomous variables
      fhir:Statistic.modelCharacteristic.variable.valueRange [ Range ], ... ; # 0..* Range of values for grouping of ordinal or polychotomous variables
    ], ...;
  ], ...;
]

Changes since Release 3

This complex-type did not exist in Release 2