Operation
Definition
The Statistics operation performs a set of statistical calculations on a set of clinical
measurements such as a blood pressure as stored on the server. This operation is focused
on
resources with valueQuantity elements that have UCUM unit codes.
the subject of the observations for which the statistics are being generated (
)
which observations to generate statistics for (
and
, or
)
the time period over which to generate statistics
or
)
the set of statistical analyses to return (
)
Possible statistical analyses (see
):
("Average"): The
of N measurements over the stated period
("Maximum"): The
value of N measurements over the stated period
("Minimum"): The
value of N measurements over the stated period
("Count"): The [number] of valid measurements over the stated period that contributed
to the other statistical outputs
("Total Count"): The total [number] of valid measurements over the stated period,
including observations that were ignored because they did not contain valid result values
("Median"): The
of N measurements over the stated period
("Standard Deviation"): The
of N measurements over the stated period
("Sum"): The
of N measurements over the stated period
("Variance"): The
of N measurements over the stated period
("20th Percentile"): The 20th
of N measurements over the stated period
("80th Percentile"): The 80th
of N measurements over the stated period
("Lower Quartile"): The lower
Boundary of N measurements over the stated period
("Upper Quartile"): The upper
Boundary of N measurements over the stated period
("Quartile Deviation"): The difference between the upper and lower
is called the Interquartile range. (IQR = Q3-Q1) Quartile deviation or Semi-interquartile
range is one-half the difference between the first and the third quartiles.
("1st Quintile"): The lowest of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
("2nd Quintile"): The second of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
("3rd Quintile"): The third of four values that divide the N measurements into
a frequency distribution of five classes with each containing one fifth of the total population
("4th Quintile"): The fourth of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
("Skew"): Skewness is a measure of the asymmetry of the probability distribution
of a real-valued random variable about its mean. The skewness value can be positive or
negative, or even undefined. Source:
("Kurtosis"): Kurtosis is a measure of the "tailedness" of the probability
distribution of a real-valued random variable. Source:
("Regression"): Linear regression is an approach for modeling two-dimensional
sample points with one independent variable and one dependent variable (conventionally,
the x and y coordinates in a Cartesian coordinate system) and finds a linear function
(a non-vertical straight line) that, as accurately as possible, predicts the dependent
variable values as a function of the independent variables. Source:
This Statistic code will return both a gradient and an intercept value.
If successful, the operation returns an Observation resource for each code with the results
of the statistical calculations as component value pairs where the component code = the
statistical code. The Observation also contains the input parameters
,
and
parameters. If unsuccessful, an
with an error message will be returned.
The client can request that all the observations on which the statistics are based be
returned as well, using the include parameter. If an include parameter is specified, a
limit may also be specified; the sources observations are subsetted at the server's discretion
if count > limit. This functionality is included with the intent of supporting graphical
presentation
The subject of the relevant Observations, which has the value of the Observation.subject.reference.
E.g. 'Patient/123'. Reference can be to an absolute URL, but servers only perform stats
on their own observations
The test code(s) upon which the statistics are being performed. Provide along with a system,
or as a coding. For example, the code = "45667-2" will evaluate all relevant
Observations with this code in Observation.code. For LOINC codes that are panels, (e.g.
55284-4) this means to include all the individual codes that are part of a panel
<?xml version="1.0" encoding="UTF-8"?>
<OperationDefinition xmlns="http://hl7.org/fhir">
<id value="Observation-stats"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml">
<p class="res-header-id">
<b> Generated Narrative: OperationDefinition Observation-stats</b>
</p>
<a name="Observation-stats"> </a>
<a name="hcObservation-stats"> </a>
<p> URL: [base]/Observation/$stats</p>
<h3> Parameters</h3>
<table class="grid">
<tr>
<td>
<b> Use</b>
</td>
<td>
<b> Name</b>
</td>
<td>
<b> Scope</b>
</td>
<td>
<b> Cardinality</b>
</td>
<td>
<b> Type</b>
</td>
<td>
<b> Binding</b>
</td>
<td>
<b> Documentation</b>
</td>
</tr>
<tr>
<td> IN</td>
<td> subject</td>
<td/>
<td> 1..1</td>
<td>
<a href="datatypes.html#uri">uri</a>
</td>
<td/>
<td>
<div>
<p> The subject of the relevant Observations, which has the value of the Observation.subject.refe
rence. E.g. 'Patient/123'. Reference can be to an absolute URL, but servers only
perform stats on their own observations</p>
</div> </td> </tr> <tr> <td> IN</td> <td> code</td> <td/> <td> 0..*</td> <td> <a href="datatypes.html#string">string</a> </td> <td/> <td> <div> <p> The test code(s) upon which the statistics are being performed. Provide along with
a system, or as a coding. For example, the LOINC code =
2339-0 (Glucose [Mass/volume] in Blood) will evaluate all relevant Observations
with this code in
<code> Observation.code</code> and <code> Observation.component.code</code> . For LOINC codes that are panels, e.g., 85354-9(Blood pressure panel with all
children optional), the stats operation returns statistics for each of the individual
panel measurements. That means it will include and evaluate all values grouped
by code for all the individual observations that are: 1) referenced in
<code> .related</code> for <code> .related.type</code> = 'has-member' and 2) component observations in <code> Observation.component</code> . </p> </div> </td> </tr> <tr> <td> IN</td> <td> system</td> <td/> <td> 0..1</td> <td> <a href="datatypes.html#uri">uri</a> </td> <td/> <td> <div> <p> The system for the code(s). Or provide a coding instead</p> </div> </td> </tr> <tr> <td> IN</td> <td> coding</td> <td/> <td> 0..*</td> <td> <a href="datatypes.html#Coding">Coding</a> </td> <td/> <td> <div> <p> The test code upon which the statistics are being performed, as a Coding</p> </div> </td> </tr> <tr> <td> IN</td> <td> duration</td> <td/> <td> 0..1</td> <td> <a href="datatypes.html#decimal">decimal</a> </td> <td/> <td> <div>
<p> The time period of interest given as hours. For example, the duration = "1"
represents the last hour - the time period from on hour ago to now
average|max|min|count The statistical operations to be performed on the relevant operations.
Multiple statistics operations can be specified. These codes are defined
If an include parameter is specified, a limit may also be specified to limit the number
of source Observations returned. If the include paramter is absent or equal to "false"
the limit parameter SHALL be ignored by the server
A set of observations, one observation for each code, each containing one component for
each statistic. The Observation.component.code contains the statistic, and is relative
to the Observation.code and cannot be interpreted independently. The Observation will
also contain a subject, effectivePeriod, and code reflecting the input parameters. The
status is fixed to
.
This operation cannot be performed on observations that the user is not authorized to
see. It is assumed that the server has identified and secured the context appropriately,
represents the last hour - the time period from on hour ago to now</p>
</div> </td> </tr> <tr> <td> IN</td> <td> period</td> <td/> <td> 0..1</td> <td> <a href="datatypes.html#Period">Period</a> </td> <td/> <td> <div> <p> The time period over which the calculations to be performed, if a duration is not
provided</p>
</div> </td> </tr> <tr> <td> IN</td> <td> statistic</td> <td/> <td> 1..*</td> <td> <a href="datatypes.html#code">code</a> </td> <td> <a href="valueset-observation-statistics.html">Statistics Code</a> (Required) </td> <td> <div> <p> average|max|min|count The statistical operations to be performed on the relevant
operations. Multiple statistics operations can be specified. These codes are defined
<a href="valueset-observation-statistics.html">here</a> </p> </div> </td> </tr> <tr> <td> IN</td> <td> include</td> <td/> <td> 0..1</td> <td> <a href="datatypes.html#boolean">boolean</a> </td> <td/> <td> <div> <p> Whether to return the observations on which the statistics are based</p> </div> </td> </tr> <tr> <td> IN</td> <td> limit</td> <td/> <td> 0..1</td> <td> <a href="datatypes.html#positiveInt">positiveInt</a> </td> <td/> <td> <div> <p> If an include parameter is specified, a limit may also be specified to limit the
number of source Observations returned. If the include parameter is absent or
equal to "false" the limit parameter SHALL be ignored by the server</p>
</div> </td> </tr> <tr> <td> IN</td> <td> include-statuses</td> <td/> <td> 0..*</td> <td> <a href="datatypes.html#code">code</a> </td> <td/> <td> <div> <p> This parameter is used to specify inclusion of observations in the response based
on Observation.status by including the Observation instances with a status listed
in this parameter. When the parameter is absent, the default is to include all
values except
<code> entered-in-error</code> </p> </div> </td> </tr> <tr> <td> OUT</td> <td> statistics</td> <td/> <td> 1..*</td> <td> <a href="observation.html">Observation</a> </td> <td/> <td> <div> <p> A set of observations, one observation for each code, each containing one component
for each statistic. The Observation.component.code contains the statistic, and
is relative to the Observation.code and cannot be interpreted independently. The
Observation will also contain a subject, effectivePeriod, and code reflecting the
input parameters. The status is fixed to
<code> final</code> . </p> </div> </td> </tr> <tr> <td> OUT</td> <td> source</td> <td/> <td> 0..*</td> <td> <a href="observation.html">Observation</a> </td> <td/> <td> <div> <p> Source observations on which the statistics are based</p> </div> </td> </tr> </table> <div> <p> If <a href="extensibility.html#modifierExtension">modifier extensions</a> are present in the Observation, they must be accounted for by implementers. A
modifier extension may affect the observation.value in a way that it should be
excluded from the from the calculations.
</p> <p> This operation cannot be performed on observations that the user is not authorized
to see. It is assumed that the server has identified and secured the context appropriately,
and can either associate the authorization context with a single patient, or determine
whether the context has the rights to the nominated patient, if there is one. If there
is no nominated patient (e.g. the operation is invoked at the system level) and the context
is not associated with a single patient record, then the server should return an error.
Specifying the relationship between the context, a user and patient records is outside
the scope of this specification.
The Statistics operation performs a set of statistical calculations on a set of clinical
measurements such as a blood pressure as stored on the server. This operation is focused
on [Observation](observation.html) resources with valueQuantity elements that have UCUM
unit codes.
The set of Observations is defined by 4 parameters:
* the subject of the observations for which the statistics are being generated (`subject`)
* which observations to generate statistics for (`code` and `system`, or `coding`)
* the time period over which to generate statistics `'duration` or `period`)
* the set of statistical analyses to return (`statistic`)
Possible statistical analyses (see [StatisticsCode](valueset-observation-statistics.html)):
- **average** ("Average"): The [mean](https://en.wikipedia.org/wiki/Arithmetic_mean)
of N measurements over the stated period
- **maximum** ("Maximum"): The [maximum](https://en.wikipedia.org/wiki/Maximal_element)
value of N measurements over the stated period
- **minimum** ("Minimum"): The [minimum](https://en.wikipedia.org/wiki/Minimal_element)
value of N measurements over the stated period
- **count** ("Count"): The [number] of valid measurements over the stated period
that contributed to the other statistical outputs
- **totalcount** ("Total Count"): The total [number] of valid measurements
over the stated period, including observations that were ignored because they did not
contain valid result values
whether the context has the rights to the nominated patient, if there is one. If
there is no nominated patient (e.g. the operation is invoked at the system level)
and the context is not associated with a single patient record, then the server
should return an error. Specifying the relationship between the context, a user
and patient records is outside the scope of this specification.</p>
</div> </div> </text> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm"> <valueInteger value="3"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status"> <valueCode value="trial-use"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg"> <valueCode value="oo"/> </extension> <url value="http://hl7.org/fhir/OperationDefinition/Observation-stats"/> <version value="6.0.0-ballot3"/> <name value="Stats"/> <title value="Observation Statistics"/> <status value="draft"/> <kind value="operation"/> <experimental value="false"/> <date value="2025-11-07T10:05:27+00:00"/> <publisher value="HL7 International / Orders and Observations"/> <contact> <telecom> <system value="url"/> <value value="http://hl7.org/fhir"/> </telecom> <telecom> <system value="email"/> <value value="fhir@lists.hl7.org"/> </telecom> </contact> <contact> <telecom> <system value="url"/> <value value="http://www.hl7.org/Special/committees/orders"/> </telecom> </contact> <description value="The Statistics operation performs a set of statistical calculations on a set of
clinical measurements such as a blood pressure as stored on the server. This operation
evaluates [Observation](observation.html) resources having valueQuantity elements
that have UCUM unit codes.
Alternatively, the [measure workflow pattern](measure.html) should be used when
defining a quality measure (e.g. a description of how to calculate a particular
measurement or set of measurements) as part of a workflow.
The set of Observations is defined by 4 parameters:
* the subject of the observations for which the statistics are being generated
(`subject`)
* which observations to generate statistics for (`code` and `system`, or `coding`)
* the time period over which to generate statistics 'duration` or `period`)
* the set of statistical analyses to return (`statistic`)
Possible statistical analyses (see [StatisticsCode](valueset-observation-statistics.html)):
- **average** ("Average"): The [mean](https://en.wikipedia.org/wiki/Arithmetic_mea
n) of N measurements over the stated period.
- **maximum** ("Maximum"): The [maximum](https://en.wikipedia.org/wiki/Maximal_ele
ment) value of N measurements over the stated period.
- **minimum** ("Minimum"): The [minimum](https://en.wikipedia.org/wiki/Minimal_ele
ment) value of N measurements over the stated period.
- **count** ("Count"): The [number] of valid measurements over the stated
period that contributed to the other statistical outputs.
- **total-count** ("Total Count"): The total [number] of valid measurements
over the stated period, including observations that were ignored because they did
not contain valid result values.
- **median** ("Median"): The [median](https://en.wikipedia.org/wiki/Median)
of N measurements over the stated period
- **std-dev** ("Standard Deviation"): The [standard deviation](https://en.wikipedia.org/w
iki/Standard_deviation) of N measurements over the stated period
- **sum** ("Sum"): The [sum](https://en.wikipedia.org/wiki/Summation) of N
measurements over the stated period
- **variance** ("Variance"): The [variance](https://en.wikipedia.org/wiki/Variance)
of N measurements over the stated period
- **20-percent** ("20th Percentile"): The 20th [Percentile](https://en.wikipedia.org/wiki
/Percentile) of N measurements over the stated period
- **80-percent** ("80th Percentile"): The 80th [Percentile](https://en.wikipedia.org/wiki
/Percentile) of N measurements over the stated period
- **4-lower** ("Lower Quartile"): The lower [Quartile](https://en.wikipedia.org/wiki/Quar
tile) Boundary of N measurements over the stated period
- **4-upper** ("Upper Quartile"): The upper [Quartile](https://en.wikipedia.org/wiki/Quar
tile) Boundary of N measurements over the stated period
- **4-dev** ("Quartile Deviation"): The difference between the upper and lower
[Quartiles](https://en.wikipedia.org/wiki/Quartile) is called the Interquartile range.
(IQR = Q3-Q1) Quartile deviation or Semi-interquartile range is one-half the difference
between the first and the third quartiles.
- **5-1** ("1st Quintile"): The lowest of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
- **5-2** ("2nd Quintile"): The second of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
- **5-3** ("3rd Quintile"): The third of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
- **5-4** ("4th Quintile"): The fourth of four values that divide the N measurements
into a frequency distribution of five classes with each containing one fifth of the total
population
of N measurements over the stated period.
- **std-dev** ("Standard Deviation"): The [standard deviation](https://en.wikipedi
a.org/wiki/Standard_deviation) of N measurements over the stated period.
- **sum** ("Sum"): The [sum](https://en.wikipedia.org/wiki/Summation)
of N measurements over the stated period.
- **variance** ("Variance"): The [variance](https://en.wikipedia.org/wiki/Variance
) of N measurements over the stated period.
- **20-percent** ("20th Percentile"): The 20th [Percentile](https://en.wikipedia.o
rg/wiki/Percentile) of N measurements over the stated period.
- **80-percent** ("80th Percentile"): The 80th [Percentile](https://en.wikipedia.o
rg/wiki/Percentile) of N measurements over the stated period.
- **4-lower** ("Lower Quartile"): The lower [Quartile](https://en.wikipedia.org/wi
ki/Quartile) Boundary of N measurements over the stated period.
- **4-upper** ("Upper Quartile"): The upper [Quartile](https://en.wikipedia.org/wi
ki/Quartile) Boundary of N measurements over the stated period.
- **4-dev** ("Quartile Deviation"): The difference between the upper
and lower [Quartiles](https://en.wikipedia.org/wiki/Quartile) is called the Interquartile
range. (IQR = Q3-Q1) Quartile deviation or Semi-interquartile range is one-half
the difference between the first and the third quartiles.
- **5-1** ("1st Quintile"): The lowest of four values that divide the
N measurements into a frequency distribution of five classes with each containing
one fifth of the total population.
- **5-2** ("2nd Quintile"): The second of four values that divide the
N measurements into a frequency distribution of five classes with each containing
one fifth of the total population.
- **5-3** ("3rd Quintile"): The third of four values that divide the
N measurements into a frequency distribution of five classes with each containing
one fifth of the total population.
- **5-4** ("4th Quintile"): The fourth of four values that divide the
N measurements into a frequency distribution of five classes with each containing
one fifth of the total population.
- **skew** ("Skew"): Skewness is a measure of the asymmetry of the probability
distribution of a real-valued random variable about its mean. The skewness value can be
positive or negative, or even undefined. Source: [Wikipedia](https://en.wikipedia.org/wiki/Skewness
)
distribution of a real-valued random variable about its mean. The skewness value
can be positive or negative, or even undefined. Source: [Wikipedia](https://en.wikipedia.org
/wiki/Skewness).
- **kurtosis** ("Kurtosis"): Kurtosis is a measure of the "tailedness"
of the probability distribution of a real-valued random variable. Source: [Wikipedia](https://en.w
ikipedia.org/wiki/Kurtosis)
- **regression** ("Regression"): Linear regression is an approach for modeling
two-dimensional sample points with one independent variable and one dependent variable
(conventionally, the x and y coordinates in a Cartesian coordinate system) and finds a
linear function (a non-vertical straight line) that, as accurately as possible, predicts
the dependent variable values as a function of the independent variables. Source: [Wikipedia](https:
//en.wikipedia.org/wiki/Simple_linear_regression) This Statistic code will return both
a gradient and an intercept value.
If successful, the operation returns an Observation resource for each code with the results
of the statistical calculations as component value pairs where the component code = the
statistical code. The Observation also contains the input parameters `patient`,`code`
and `duration` parameters. If unsuccessful, an [OperationOutcome](operationoutcome.html)
with an error message will be returned.
The client can request that all the observations on which the statistics are based be
returned as well, using the include parameter. If an include parameter is specified, a
limit may also be specified; the sources observations are subsetted at the server's discretion
if count > limit. This functionality is included with the intent of supporting graphical
presentation
This operation cannot be performed on observations that the user is not authorized to
see. It is assumed that the server has identified and secured the context appropriately,
of the probability distribution of a real-valued random variable. Source: [Wikipedia](https
://en.wikipedia.org/wiki/Kurtosis).
- **regression** ("Regression"): Linear regression is an approach for
modeling two-dimensional sample points with one independent variable and one dependent
variable (conventionally, the x and y coordinates in a Cartesian coordinate system)
and finds a linear function (a non-vertical straight line) that, as accurately
as possible, predicts the dependent variable values as a function of the independent
variables. Source: [Wikipedia](https://en.wikipedia.org/wiki/Simple_linear_regression)
This Statistic code will return both a gradient and an intercept value.
If successful, the operation returns an Observation resource for each code with
the results of the statistical calculations as component value pairs where the
component code = the statistical code. The Observation also contains the input
parameters `patient`,`code` and `duration` parameters. If unsuccessful, an [OperationOutcome]
(operationoutcome.html) with an error message will be returned.
The client can request that all the observations on which the statistics are based
be returned as well, using the include parameter. If an include parameter is specified,
a limit may also be specified; the sources observations are subsetted at the server's
discretion if count > limit. This functionality is included with the intent
of supporting graphical presentation"/>
<jurisdiction> <coding> <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/> <code value="001"/> <display value="World"/> </coding> </jurisdiction> <affectsState value="false"/> <code value="stats"/> <comment value="If [modifier extensions](extensibility.html#modifierExtension) are present in the
Observation, they must be accounted for by implementers. A modifier extension
may affect the observation.value in a way that it should be excluded from the from
the calculations.
This operation cannot be performed on observations that the user is not authorized
to see. It is assumed that the server has identified and secured the context appropriately,
and can either associate the authorization context with a single patient, or determine
whether the context has the rights to the nominated patient, if there is one. If there
is no nominated patient (e.g. the operation is invoked at the system level) and the context
is not associated with a single patient record, then the server should return an error.
Specifying the relationship between the context, a user and patient records is outside
the scope of this specification.
The subject of the relevant Observations, which has the value of the Observation.subject.reference.
E.g. 'Patient/123'. Reference can be to an absolute URL, but servers only perform stats
on their own observations
The test code(s) upon which the statistics are being performed. Provide along with a system,
or as a coding. For example, the code = "45667-2" will evaluate all relevant
Observations with this code in Observation.code. For LOINC codes that are panels, (e.g.
55284-4) this means to include all the individual codes that are part of a panel
whether the context has the rights to the nominated patient, if there is one. If
there is no nominated patient (e.g. the operation is invoked at the system level)
and the context is not associated with a single patient record, then the server
should return an error. Specifying the relationship between the context, a user
and patient records is outside the scope of this specification."/>
<resource value="Observation"/> <system value="false"/> <type value="true"/> <instance value="false"/> <parameter> <name value="subject"/> <use value="in"/> <min value="1"/> <max value="1"/> <documentation value="The subject of the relevant Observations, which has the value of the Observation.subject.refe
rence. E.g. 'Patient/123'. Reference can be to an absolute URL, but servers only
perform stats on their own observations"/>
<type value="uri"/> </parameter> <parameter> <name value="code"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="The test code(s) upon which the statistics are being performed. Provide along with
a system, or as a coding. For example, the LOINC code =
2339-0 (Glucose [Mass/volume] in Blood) will evaluate all relevant Observations
with this code in `Observation.code` and `Observation.component.code`. For LOINC
codes that are panels, e.g., 85354-9(Blood pressure panel with all children optional),
the stats operation returns statistics for each of the individual panel measurements.
That means it will include and evaluate all values grouped by code for all the
individual observations that are: 1) referenced in `.related` for `.related.type`
= 'has-member' and 2) component observations in `Observation.component`."/>
<type value="string"/> </parameter> <parameter> <name value="system"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The system for the code(s). Or provide a coding instead"/> <type value="uri"/> </parameter> <parameter> <name value="coding"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="The test code upon which the statistics are being performed, as a Coding"/> <type value="Coding"/> </parameter> <parameter> <name value="duration"/> <use value="in"/> <min value="0"/> <max value="1"/>
<documentation value="The time period of interest given as hours. For example, the duration = "1"
represents the last hour - the time period from on hour ago to now
average|max|min|count The statistical operations to be performed on the relevant operations.
Multiple statistics operations can be specified. These codes are defined [here](valueset-observation
-statistics.html)
If an include parameter is specified, a limit may also be specified to limit the number
of source Observations returned. If the include paramter is absent or equal to "false"
the limit parameter SHALL be ignored by the server
A set of observations, one observation for each code, each containing one component for
each statistic. The Observation.component.code contains the statistic, and is relative
to the Observation.code and cannot be interpreted independently. The Observation will
also contain a subject, effectivePeriod, and code reflecting the input parameters. The
status is fixed to `final`.
represents the last hour - the time period from on hour ago to now"/>
<type value="decimal"/> </parameter> <parameter> <name value="period"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The time period over which the calculations to be performed, if a duration is not
provided"/>
<type value="Period"/> </parameter> <parameter> <name value="statistic"/> <use value="in"/> <min value="1"/> <max value="*"/> <documentation value="average|max|min|count The statistical operations to be performed on the relevant
operations. Multiple statistics operations can be specified. These codes are defined
[here](valueset-observation-statistics.html)"/>
<type value="code"/> <binding> <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName"> <valueString value="ObservationStatsCode"/> </extension> <strength value="required"/> <valueSet value="http://hl7.org/fhir/ValueSet/observation-statistics|6.0.0-ballot3"/> </binding> </parameter> <parameter> <name value="include"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="Whether to return the observations on which the statistics are based"/> <type value="boolean"/> </parameter> <parameter> <name value="limit"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="If an include parameter is specified, a limit may also be specified to limit the
number of source Observations returned. If the include parameter is absent or
equal to "false" the limit parameter SHALL be ignored by the server"/>
<type value="positiveInt"/> </parameter> <parameter> <name value="include-statuses"/> <use value="in"/> <min value="0"/> <max value="*"/> <documentation value="This parameter is used to specify inclusion of observations in the response based
on Observation.status by including the Observation instances with a status listed
in this parameter. When the parameter is absent, the default is to include all
values except `entered-in-error`"/>
<type value="code"/> </parameter> <parameter> <name value="statistics"/> <use value="out"/> <min value="1"/> <max value="*"/> <documentation value="A set of observations, one observation for each code, each containing one component
for each statistic. The Observation.component.code contains the statistic, and
is relative to the Observation.code and cannot be interpreted independently. The
Observation will also contain a subject, effectivePeriod, and code reflecting the
input parameters. The status is fixed to `final`."/>
<type value="Observation"/> </parameter> <parameter> <name value="source"/> <use value="out"/> <min value="0"/> <max value="*"/> <documentation value="Source observations on which the statistics are based"/> <type value="Observation"/> </parameter>
</
OperationDefinition
>
Usage
note:
every
effort
has
been
made
to
ensure
that
the
examples
are
correct
and
useful,
but
they
are
not
a
normative
part
of
the
specification.