SampledData
type: StructureDefinition
node role: treeRoot
id:
  v: SampledData
text:
  status:
    v: generated
  div:
    v: Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> <img src="[binary]" alt="." style="background-color: white; background-color: inherit" title="Element" class="hierarchy"/> SampledData N Element A series of measurements taken by a device + Rule: A SampledData SHALL have either an interval and offsets but not both Elements defined in Ancestors: id, <a href="types.html#Element" title="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.">extension #xD; <img src="[binary]" alt="." style="background-color: #F7F7F7; background-color: inherit" title="Data Type" class="hierarchy"/> origin Σ 1..1 SimpleQuantity Zero value and units #xD; interval ΣC 0..1 decimal Number of intervalUnits between samples #xD; intervalUnit Σ 1..1 code The measurement unit of the interval between samples Binding: UCUM Codes (Required) #xD; factor Σ 0..1 decimal Multiply data by this before adding to origin #xD; lowerLimit Σ 0..1 decimal Lower limit of detection #xD; upperLimit Σ 0..1 decimal Upper limit of detection #xD; dimensions Σ 1..1 positiveInt Number of sample points at each time point #xD; <img src="[binary]" alt="." style="background-color: white; background-color: inherit" title="Reference to another Resource" class="hierarchy"/> codeMap 0..1 canonical(ConceptMap) Defines the codes used in the data #xD; <a href="datatypes-definitions.html#SampledData.offsets" title="SampledData.offsets : A series of increasing decimal values separated by a single space (character u20), which represent the offset from the logical start point. Offset values may be negative. The units in which the offsets are expressed ar…
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
    l: structuredefinition-standards-status
  value: Code
    v: normative
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
    l: structuredefinition-wg
  value: Code
    v: fhir
url:
  v: http://hl7.org/fhir/StructureDefinition/SampledData
  l: SampledData
version:
  v: 6.0.0-ballot4
name:
  v: SampledData
status:
  v: active
experimental:
  v: false
date:
  v: 2026-06-18T01:02:34+00:00
publisher:
  v: HL7 International / FHIR Infrastructure
contact:
  telecom:
    system:
      v: url
    value:
      v: http://hl7.org/fhir
contact:
  telecom:
    system:
      v: url
    value:
      v: http://www.hl7.org/Special/committees/fiwg
description:
  v: SampledData Type: A series of measurements taken by a device, with upper and lower limits. There may be more than one dimension in the data.
jurisdiction:
  coding:
    system:
      v: http://unstats.un.org/unsd/methods/m49/m49.htm
      l: m49.htm
    code:
      v: 001
    display:
      v: World
purpose:
  v: There is a need for a concise way to handle the data produced by devices that sample a physical state at a high frequency.
fhir version:
  v: 6.0.0-ballot4
mapping:
  identity:
    v: v2
  uri:
    v: http://hl7.org/v2
    l: v2
  name:
    v: HL7 V2 Mapping
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
    l: v3
  name:
    v: RIM Mapping
kind:
  v: complex-type
abstract:
  v: false
type:
  v: SampledData
  l: SampledData
base definition:
  v: http://hl7.org/fhir/StructureDefinition/DataType
  l: DataType
derivation:
  v: specialization
snapshot:
  element:
    id:
      v: SampledData
    path:
      v: SampledData
    short:
      v: A series of measurements taken by a device
    definition:
      v: A series of measurements taken by a device, with upper and lower limits. There may be more than one dimension in the data.
    comment:
      v: The data is not interpretable without at least origin, period, and dimensions, but these are optional to allow a separation between the template of measurement and the actual measurement, such as between DeviceCapabilities and DeviceLog. When providing a summary view (for example with Observation.value[x]) SampledData should be represented with a brief display text such as "Sampled Data".
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: SampledData
      min:
        v: 0
      max:
        v: *
    constraint:
      key:
        v: ele-1
      severity:
        v: error
      human:
        v: All FHIR elements must have a @value or children
      expression:
        v: hasValue() or (children().count() > id.count())
      source:
        v: http://hl7.org/fhir/StructureDefinition/Element
        l: Element
    constraint:
      key:
        v: sdd-1
      severity:
        v: error
      human:
        v: A SampledData SHALL have either an interval and offsets but not both
      expression:
        v: interval.exists().not() xor offsets.exists().not()
      source:
        v: http://hl7.org/fhir/StructureDefinition/SampledData
        l: SampledData
    is modifier:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a,SLIST + GLIST
    mapping:
      identity:
        v: v2
      map:
        v: N/A (but see section 7.14 in v2.7)
  element:
    id:
      v: SampledData.id
    path:
      v: SampledData.id
    representation:
      v: xmlAttr
    short:
      v: Unique id for inter-element referencing
    definition:
      v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
    min:
      v: 0
    max:
      v: 1
    base:
      path:
        v: Element.id
      min:
        v: 0
      max:
        v: 1
    type:
      extension:
        value: Url
      code:
        v: http://hl7.org/fhirpath/System.String
        l: System.String
    condition:
      v: ele-1
    is modifier:
      v: false
    is summary:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
  element:
    id:
      v: SampledData.extension
    path:
      v: SampledData.extension
    slicing:
      description:
        v: Extensions are always sliced by (at least) url
      rules:
        v: open
    short:
      v: Additional content defined by implementations
    definition:
      v: May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Url
v: string
l: string

v: value

v: url

v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

v: extensions

v: user content

v: 0

v: *

path:
  v: Element.extension
min:
  v: 0
max:
  v: *

code:
  v: Extension
  l: Extension

key:
  v: ele-1
severity:
  v: error
human:
  v: All FHIR elements must have a @value or children
expression:
  v: hasValue() or (children().count() > id.count())
source:
  v: http://hl7.org/fhir/StructureDefinition/Element
  l: Element

v: false

v: false

identity:
  v: rim
map:
  v: n/a

id:
  v: SampledData.origin
path:
  v: SampledData.origin
short:
  v: Zero value and units
definition:
  v: The base quantity that a measured value of zero represents. In addition, this provides the units of the entire measurement series.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: SampledData.origin
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: Quantity
    l: Quantity
  profile:
    v: http://hl7.org/fhir/StructureDefinition/SimpleQuantity
    l: SimpleQuantity
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: SLIST.origin

id:
  v: SampledData.interval
path:
  v: SampledData.interval
short:
  v: Number of intervalUnits between samples
definition:
  v: Amount of intervalUnits between samples, e.g. milliseconds for time-based sampling.
comment:
  v: This is usually a whole number.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.interval
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: decimal
    l: decimal
condition:
  v: sdd-1
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: GLIST.increment

id:
  v: SampledData.intervalUnit
path:
  v: SampledData.intervalUnit
short:
  v: The measurement unit of the interval between samples
definition:
  v: The measurement unit in which the sample interval is expressed.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: SampledData.intervalUnit
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: code
    l: code
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
binding:
  extension:
    url:
      v: http://hl7.org/fhir/tools/StructureDefinition/binding-definition
      l: binding-definition
    value: Markdown
      v: Units of measure allowed for an element.
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName
      l: elementdefinition-bindingName
    value: String
      v: Units
  strength:
    v: required
  description:
    v: Units of measure allowed for an element.
  value set:
    v: http://hl7.org/fhir/ValueSet/ucum-units|6.0.0-ballot4
    l: http://hl7.org/fhir/ValueSet/ucum-units

id:
  v: SampledData.factor
path:
  v: SampledData.factor
short:
  v: Multiply data by this before adding to origin
definition:
  v: A correction factor that is applied to the sampled data points before they are added to the origin.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.factor
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: decimal
    l: decimal
meaning when missing:
  v: If no factor is assigned, the data is not adjusted before adding to the origin
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: SLIST.factor

id:
  v: SampledData.lowerLimit
path:
  v: SampledData.lowerLimit
short:
  v: Lower limit of detection
definition:
  v: The lower limit of detection of the measured points. This is needed if any of the data points have the value "L" (lower than detection limit).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.lowerLimit
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: decimal
    l: decimal
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: N/A (use SLIST.digits.nullFlavor)

id:
  v: SampledData.upperLimit
path:
  v: SampledData.upperLimit
short:
  v: Upper limit of detection
definition:
  v: The upper limit of detection of the measured points. This is needed if any of the data points have the value "U" (higher than detection limit).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.upperLimit
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: decimal
    l: decimal
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: N/A (use SLIST.digits.nullFlavor)

id:
  v: SampledData.dimensions
path:
  v: SampledData.dimensions
short:
  v: Number of sample points at each time point
definition:
  v: The number of sample points at each time point. If this value is greater than one, then the dimensions will be interlaced - all the sample points for a point in time will be recorded at once.
comment:
  v: If there is more than one dimension, the code for the type of data will define the meaning of the dimensions (typically ECG data).
min:
  v: 1
max:
  v: 1
base:
  path:
    v: SampledData.dimensions
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: positiveInt
    l: positiveInt
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: N/A (fixed to 1)

id:
  v: SampledData.codeMap
path:
  v: SampledData.codeMap
short:
  v: Defines the codes used in the data
definition:
  v: Reference to ConceptMap that defines the codes used in the data.
comment:
  v: The ConceptMap cannot define meanings for the codes 'E', 'U', or 'L' (nor 'e', 'u', or 'l').
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.codeMap
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: canonical
    l: canonical
  target profile:
    v: http://hl7.org/fhir/StructureDefinition/ConceptMap
    l: ConceptMap
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: SampledData.offsets
path:
  v: SampledData.offsets
short:
  v: Offsets, typically in time, at which data values were taken
definition:
  v: A series of increasing decimal values separated by a single space (character u20), which represent the offset from the logical start point. Offset values may be negative. The units in which the offsets are expressed are found in intervalUnit. The absolute point at which the measurements begin SHALL be conveyed outside the scope of this datatype, e.g. Observation.effectiveDateTime for a timing offset.
comment:
  v: If offsets is present, the number of data points must be equal to the number of offsets multipled by the dimensions.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.offsets
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
condition:
  v: sdd-1
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: SampledData.data
path:
  v: SampledData.data
short:
  v: Decimal values with spaces, or "E" | "U" | "L", or another code
definition:
  v: A series of data points which are decimal values or codes separated by a single space (character u20). The special codes "E" (error), "L" (below detection limit) and "U" (above detection limit) are also defined for used in place of decimal values.
comment:
  v: The data may be missing if it is omitted for summarization purposes. In general, data is required for any actual use of a SampledData.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: SampledData.data
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: SLIST.digits

element:
  id:
    v: SampledData
  path:
    v: SampledData
  short:
    v: A series of measurements taken by a device
  definition:
    v: A series of measurements taken by a device, with upper and lower limits. There may be more than one dimension in the data.
  comment:
    v: The data is not interpretable without at least origin, period, and dimensions, but these are optional to allow a separation between the template of measurement and the actual measurement, such as between DeviceCapabilities and DeviceLog. When providing a summary view (for example with Observation.value[x]) SampledData should be represented with a brief display text such as "Sampled Data".
  min:
    v: 0
  max:
    v: *
  constraint:
    key:
      v: sdd-1
    severity:
      v: error
    human:
      v: A SampledData SHALL have either an interval and offsets but not both
    expression:
      v: interval.exists().not() xor offsets.exists().not()
    source:
      v: http://hl7.org/fhir/StructureDefinition/SampledData
      l: SampledData
  mapping:
    identity:
      v: v2
    map:
      v: N/A (but see section 7.14 in v2.7)
  mapping:
    identity:
      v: rim
    map:
      v: SLIST + GLIST
element:
  id:
    v: SampledData.origin
  path:
    v: SampledData.origin
  short:
    v: Zero value and units
  definition:
    v: The base quantity that a measured value of zero represents. In addition, this provides the units of the entire measurement series.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: Quantity
      l: Quantity
    profile:
      v: http://hl7.org/fhir/StructureDefinition/SimpleQuantity
      l: SimpleQuantity
  is summary:
    v: true
  mapping:
    identity:
      v: rim
    map:
      v: SLIST.origin
element:
  id:
    v: SampledData.interval
  path:
    v: SampledData.interval
  short:
    v: Number of intervalUnits between samples
  definition:
    v: Amount of intervalUnits between samples, e.g. milliseconds for time-based sampling.
  comment:
    v: This is usually a whole number.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: decimal
      l: decimal
  condition:
    v: sdd-1
  is summary:
    v: true
  mapping:
    identity:
      v: rim
    map:
      v: GLIST.increment
element:
  id:
    v: SampledData.intervalUnit
  path:
    v: SampledData.intervalUnit
  short:
    v: The measurement unit of the interval between samples
  definition:
    v: The measurement unit in which the sample interval is expressed.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
  is summary:
    v: true
  binding:
    extension:
      url:
        v: http://hl7.org/fhir/tools/StructureDefinition/binding-definition
        l: binding-definition
      value: Markdown
        v: Units of measure allowed for an element.
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName
        l: elementdefinition-bindingName
      value: String
        v: Units
    strength:
      v: required
    description:
      v: Units of measure allowed for an element.
    value set:
      v: http://hl7.org/fhir/ValueSet/ucum-units|6.0.0-ballot4
      l: http://hl7.org/fhir/ValueSet/ucum-units
element:
  id:
    v: SampledData.factor
  path:
    v: SampledData.factor
  short:
    v: Multiply data by this before adding to origin
  definition:
    v: A correction factor that is applied to the sampled data points before they are added to the origin.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: decimal
      l: decimal
  meaning when missing:
    v: If no factor is assigned, the data is not adjusted before adding to the origin
  is summary:
    v: true
  mapping:
    identity:
      v: rim
    map:
      v: SLIST.factor
element:
  id:
    v: SampledData.lowerLimit
  path:
    v: SampledData.lowerLimit
  short:
    v: Lower limit of detection
  definition:
    v: The lower limit of detection of the measured points. This is needed if any of the data points have the value "L" (lower than detection limit).
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: decimal
      l: decimal
  is summary:
    v: true
  mapping:
    identity:
      v: rim
    map:
      v: N/A (use SLIST.digits.nullFlavor)
element:
  id:
    v: SampledData.upperLimit
  path:
    v: SampledData.upperLimit
  short:
    v: Upper limit of detection
  definition:
    v: The upper limit of detection of the measured points. This is needed if any of the data points have the value "U" (higher than detection limit).
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: decimal
      l: decimal
  is summary:
    v: true
  mapping:
    identity:
      v: rim

v: N/A (use SLIST.digits.nullFlavor)

id:
  v: SampledData.dimensions
path:
  v: SampledData.dimensions
short:
  v: Number of sample points at each time point
definition:
  v: The number of sample points at each time point. If this value is greater than one, then the dimensions will be interlaced - all the sample points for a point in time will be recorded at once.
comment:
  v: If there is more than one dimension, the code for the type of data will define the meaning of the dimensions (typically ECG data).
min:
  v: 1
max:
  v: 1
type:
  code:
    v: positiveInt
    l: positiveInt
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: N/A (fixed to 1)

id:
  v: SampledData.codeMap
path:
  v: SampledData.codeMap
short:
  v: Defines the codes used in the data
definition:
  v: Reference to ConceptMap that defines the codes used in the data.
comment:
  v: The ConceptMap cannot define meanings for the codes 'E', 'U', or 'L' (nor 'e', 'u', or 'l').
min:
  v: 0
max:
  v: 1
type:
  code:
    v: canonical
    l: canonical
  target profile:
    v: http://hl7.org/fhir/StructureDefinition/ConceptMap
    l: ConceptMap
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: SampledData.offsets
path:
  v: SampledData.offsets
short:
  v: Offsets, typically in time, at which data values were taken
definition:
  v: A series of increasing decimal values separated by a single space (character u20), which represent the offset from the logical start point. Offset values may be negative. The units in which the offsets are expressed are found in intervalUnit. The absolute point at which the measurements begin SHALL be conveyed outside the scope of this datatype, e.g. Observation.effectiveDateTime for a timing offset.
comment:
  v: If offsets is present, the number of data points must be equal to the number of offsets multipled by the dimensions.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string
condition:
  v: sdd-1
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: SampledData.data
path:
  v: SampledData.data
short:
  v: Decimal values with spaces, or "E" | "U" | "L", or another code
definition:
  v: A series of data points which are decimal values or codes separated by a single space (character u20). The special codes "E" (error), "L" (below detection limit) and "U" (above detection limit) are also defined for used in place of decimal values.
comment:
  v: The data may be missing if it is omitted for summarization purposes. In general, data is required for any actual use of a SampledData.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string
mapping:
  identity:
    v: rim
  map:
    v: SLIST.digits