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 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
| Official URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric | Version: 2.0.0 | |||
| Standards status: Trial-use Active as of 2026-01-27 | 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)
Procedure
ServiceRequest
ActivityDefinition
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:
The units are assumed to be Gy.
One of the above metrics SHOULD be used. Use of other metrics will generate a warning.
Usage info
Usages:
You can also check for usages in the FHIR IG Statistics
Description Differentials, Snapshots, and other representations.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Extension | Radiotherapy Biologically Effective Dose | |
![]() ![]() |
0..0 | Extension | ||
![]() ![]() |
1..1 | uri | "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric" | |
![]() ![]() |
1..1 | Quantity | Value of extension | |
![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() |
C | 1..1 | string | Unit representation Constraints: TG263RadiobiologicMetric |
Documentation for this format | ||||
| Id | Grade | Path(s) | Description | Expression |
| TG263RadiobiologicMetric | warning | Extension.value[x].unit | Unit 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+)?)\\))$')
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Extension | Radiotherapy Biologically Effective Dose | |
![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() |
1..1 | uri | "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric" | |
![]() ![]() |
1..1 | Quantity | Value of extension | |
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() |
?!Σ | 0..1 | code | < | <= | >= | > - how to understand the value Binding: QuantityComparator (required): How the Quantity should be understood and represented. |
![]() ![]() ![]() |
ΣC | 1..1 | string | Unit representation Constraints: TG263RadiobiologicMetric |
![]() ![]() ![]() |
ΣC | 0..1 | uri | System that defines coded unit form |
![]() ![]() ![]() |
Σ | 0..1 | code | Coded form of the unit |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x].comparator | Base | required | QuantityComparator | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| TG263RadiobiologicMetric | warning | Extension.value[x].unit | Unit 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+)?)\\))$')
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Differential ViewDifferential View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Extension | Radiotherapy Biologically Effective Dose | |
![]() ![]() |
0..0 | Extension | ||
![]() ![]() |
1..1 | uri | "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric" | |
![]() ![]() |
1..1 | Quantity | Value of extension | |
![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() |
C | 1..1 | string | Unit representation Constraints: TG263RadiobiologicMetric |
Documentation for this format | ||||
| Id | Grade | Path(s) | Description | Expression |
| TG263RadiobiologicMetric | warning | Extension.value[x].unit | Unit 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+)?)\\))$')
|
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Extension | Radiotherapy Biologically Effective Dose | |
![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() |
1..1 | uri | "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric" | |
![]() ![]() |
1..1 | Quantity | Value of extension | |
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() |
?!Σ | 0..1 | code | < | <= | >= | > - how to understand the value Binding: QuantityComparator (required): How the Quantity should be understood and represented. |
![]() ![]() ![]() |
ΣC | 1..1 | string | Unit representation Constraints: TG263RadiobiologicMetric |
![]() ![]() ![]() |
ΣC | 0..1 | uri | System that defines coded unit form |
![]() ![]() ![]() |
Σ | 0..1 | code | Coded form of the unit |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x].comparator | Base | required | QuantityComparator | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| TG263RadiobiologicMetric | warning | Extension.value[x].unit | Unit 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+)?)\\))$')
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Other representations of profile: CSV, Excel, Schematron