CodeX Radiation Therapy
2.0.0-ballot - Ballot United States of America flag

CodeX Radiation Therapy, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/codex-radiation-therapy/ and changes regularly. See the Directory of published versions

Extension: Radiobiologic Metric

Official URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric Version: 2.0.0-ballot
Active as of 2024-04-09 Computable Name: RadiobiologicMetric
Other Identifiers: OID:2.16.840.1.113883.4.642.40.14.42.4

Extension providing radiobiologic dose metric using a regular expression: BED, CGE, RBE, RBE(factor = <decimal>), EQD2Gy, EQD2Gy(a/b = <decimal>).

Context of Use

This extension may be used on the following element(s):

  • Element ID Procedure
  • Element ID ServiceRequest
  • Element ID ActivityDefinition
  • Extension URL http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-dose-planned-to-volume
  • Extension URL http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-dose-delivered-to-volume
  • Extension URL http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-dose-prescribed-to-volume

Usage

This extension is used to capture the radiobiologic metric of effective dose, as defined by the TG-263 in section 9.2 of AAPM Task Group 263 Report on Standardizing Nomenclatures in Radiation Oncology. The following metrics are supported:

  • CGE - Cobalt Gray Equivalent
  • BED - Biological Effective Dose
  • BED(a/b=<decimal>) - BED with alpha/beta
  • RBE - Relative Biological Effectiveness corrected dose
  • RBE(factor=<decimal>) - RBE with factor
  • EQD2Gy - Equivalent Dose in 2 Gy per Fraction
  • EQD2Gy(a/b=<decimal>) - EQD2Gy with alpha/beta

The units are assumed to be Gy.

Conformance

One of the above metrics SHOULD be used. Use of other metrics will generate a warning.

Usage info

Usage:

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

Summary

Simple Extension of type Quantity: Extension providing radiobiologic dose metric using a regular expression: BED, CGE, RBE, RBE(factor = <decimal>), EQD2Gy, EQD2Gy(a/b = <decimal>).

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..* Extension Radiotherapy Biologically Effective Dose
... extension 0..0
... url 1..1 uri "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric"
... value[x] 1..1 Quantity Value of extension
.... value 1..1 decimal Numerical value (with implicit precision)
.... unit C 1..1 string Unit representation
TG263RadiobiologicMetric: Unit SHOULD match TG-263 Radiobiologic Metric Regexp

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..* Extension Radiotherapy Biologically Effective Dose
... id 0..1 string Unique id for inter-element referencing
... extension 0..0
... url 1..1 uri "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric"
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 1..1 decimal Numerical value (with implicit precision)
.... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.

.... unit ΣC 1..1 string Unit representation
TG263RadiobiologicMetric: Unit SHOULD match TG-263 Radiobiologic Metric Regexp
.... system ΣC 0..1 uri System that defines coded unit form
.... code Σ 0..1 code Coded form of the unit

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension of type Quantity: Extension providing radiobiologic dose metric using a regular expression: BED, CGE, RBE, RBE(factor = <decimal>), EQD2Gy, EQD2Gy(a/b = <decimal>).

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..* Extension Radiotherapy Biologically Effective Dose
... extension 0..0
... url 1..1 uri "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric"
... value[x] 1..1 Quantity Value of extension
.... value 1..1 decimal Numerical value (with implicit precision)
.... unit C 1..1 string Unit representation
TG263RadiobiologicMetric: Unit SHOULD match TG-263 Radiobiologic Metric Regexp

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..* Extension Radiotherapy Biologically Effective Dose
... id 0..1 string Unique id for inter-element referencing
... extension 0..0
... url 1..1 uri "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric"
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 1..1 decimal Numerical value (with implicit precision)
.... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.

.... unit ΣC 1..1 string Unit representation
TG263RadiobiologicMetric: Unit SHOULD match TG-263 Radiobiologic Metric Regexp
.... system ΣC 0..1 uri System that defines coded unit form
.... code Σ 0..1 code Coded form of the unit

doco Documentation for this format

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSetURI
Extension.value[x].comparatorrequiredQuantityComparator
http://hl7.org/fhir/ValueSet/quantity-comparator|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
TG263RadiobiologicMetricwarningExtension.value[x].unitUnit SHOULD match TG-263 Radiobiologic Metric Regexp
: $this.toString().matches('^(BED|CGE|RBE|RBE\\(factor\\s*=\\s*(\\d?(\\.\\d+)?)\\)|EQD2Gy|EQD2Gy\\(a\\/b\\s*=\\s*(\\d?(\\.\\d+)?)\\))$')