HL7 FHIR Implementation Guide: minimal Common Oncology Data Elements (mCODE) Release 1 - US Realm | STU Ballot 1

This page is part of the HL7 FHIR Implementation Guide: minimal Common Oncology Data Elements (mCODE) Release 1 - US Realm | STU1 (v0.9.1: STU 1 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions

RelationToLandmark

 

The official URL for this extension is:

http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-RelationToLandmark-extension

The relationship between a landmark that helps determine a body location and the body location itself. The location relative to a landmark is specified by:

  • Specifying the location and type of landmark using a body site code and optional laterality/orientation,
  • Specifying the direction from the landmark to the body location, and
  • Specifying the distance from the landmark to the body location.

The RelationToLandmark element is part of BodyLocation, a flexible structure that allows the location to be determined by a single code, or a code plus laterality and/or orientation. The body location can also be specified in relation to one or more body landmarks. SNOMED CT is used in all cases.

  • Code only: The code should include (precoordinate) laterality and/orientation to the degree necessary to completely specify the body location.
  • Code plus laterality and/or orientation: The basic code augmented by codes specifying the body side and/or anatomical orientation.
  • Relation to landmark: The location relative to a landmark is specified by:
    1. Establishing the location and type of landmark using a body site code and optional laterality/orientation, and
    2. Specifying the direction and distance from the landmark to the body location.

Note that BodyLocation is a data type (a reusable structure), not a stand-alone entity. The concept is similar to how a postal address can apply to a person, location, or organization. This contrasts with FHIR’s stand-alone BodySite (aka BodyStructure in r4) which ‘is not … intended for describing the type of anatomical location but rather a specific body site on a specific patient’ (FHIR 3.5).

This extension was published on Thu Aug 01 00:00:00 EDT 2019 as a draft by HL7 International Clinical Interoperability Council.

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*RelationToLandmark
... obf-datatype-LandmarkType-extension 0..1CodeableConceptLandmarkType
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkType-extension
Binding: LandmarkTypeVS (extensible)
... obf-datatype-LandmarkLocation-extension 0..1(Complex)LandmarkLocation
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkLocation-extension
... obf-datatype-LandmarkToBodyLocationDirection-extension 0..1CodeableConceptLandmarkToBodyLocationDirection
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDirection-extension
Binding: AnatomicalDirectionVS (preferred)
... obf-datatype-LandmarkToBodyLocationDistance-extension 0..1QuantityLandmarkToBodyLocationDistance
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDistance-extension
Binding: UnitsOfLengthVS (required)
... url uri"http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-RelationToLandmark-extension"
... value[x] 0..0

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension I0..*RelationToLandmark
ext-1: Must have either extensions or value[x], not both
... id 0..1stringUnique id for inter-element referencing
... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... obf-datatype-LandmarkType-extension 0..1CodeableConceptLandmarkType
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkType-extension
Binding: LandmarkTypeVS (extensible)
... obf-datatype-LandmarkLocation-extension 0..1(Complex)LandmarkLocation
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkLocation-extension
... obf-datatype-LandmarkToBodyLocationDirection-extension 0..1CodeableConceptLandmarkToBodyLocationDirection
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDirection-extension
Binding: AnatomicalDirectionVS (preferred)
... obf-datatype-LandmarkToBodyLocationDistance-extension 0..1QuantityLandmarkToBodyLocationDistance
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDistance-extension
Binding: UnitsOfLengthVS (required)
... url 1..1uri"http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-RelationToLandmark-extension"

doco Documentation for this format

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*RelationToLandmark
... obf-datatype-LandmarkType-extension 0..1CodeableConceptLandmarkType
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkType-extension
Binding: LandmarkTypeVS (extensible)
... obf-datatype-LandmarkLocation-extension 0..1(Complex)LandmarkLocation
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkLocation-extension
... obf-datatype-LandmarkToBodyLocationDirection-extension 0..1CodeableConceptLandmarkToBodyLocationDirection
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDirection-extension
Binding: AnatomicalDirectionVS (preferred)
... obf-datatype-LandmarkToBodyLocationDistance-extension 0..1QuantityLandmarkToBodyLocationDistance
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDistance-extension
Binding: UnitsOfLengthVS (required)
... url uri"http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-RelationToLandmark-extension"
... value[x] 0..0

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension I0..*RelationToLandmark
ext-1: Must have either extensions or value[x], not both
... id 0..1stringUnique id for inter-element referencing
... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... obf-datatype-LandmarkType-extension 0..1CodeableConceptLandmarkType
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkType-extension
Binding: LandmarkTypeVS (extensible)
... obf-datatype-LandmarkLocation-extension 0..1(Complex)LandmarkLocation
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkLocation-extension
... obf-datatype-LandmarkToBodyLocationDirection-extension 0..1CodeableConceptLandmarkToBodyLocationDirection
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDirection-extension
Binding: AnatomicalDirectionVS (preferred)
... obf-datatype-LandmarkToBodyLocationDistance-extension 0..1QuantityLandmarkToBodyLocationDistance
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-LandmarkToBodyLocationDistance-extension
Binding: UnitsOfLengthVS (required)
... url 1..1uri"http://hl7.org/fhir/us/mcode/StructureDefinition/obf-datatype-RelationToLandmark-extension"

doco Documentation for this format

Downloads: StructureDefinition: (XML, JSON, TTL), Schema: XML Schematron

 

 

Constraints

IdPathDetailsRequirements
ele-1ExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1ExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()

 

Usage

This extension is used in the following profiles: