Radiobiologic Metric - CodeX Radiation Therapy v2.0.0

CodeX Radiation Therapy
2.0.0 - STU2 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 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
Active as of 2025-02-17				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: Dose Planned to Volume
Extension: Radiotherapy Dose Delivered To Volume Extension
Extension: 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

Name	Flags	Card.	Type	Description & Constraints
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
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints
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"
value[x]		1..1	Quantity	Value of extension
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
Documentation for this format

Differential View

This structure is derived from Extension

Name	Flags	Card.	Type	Description & Constraints
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
Documentation for this format

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
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"
value[x]		1..1	Quantity	Value of extension
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
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>).

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

Path	Conformance	ValueSet	URI
Extension.value[x].comparator	required	QuantityComparator `http://hl7.org/fhir/ValueSet/quantity-comparator\|4.0.1` from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
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+)?)\$)$')

IG © 2021+ HL7 International / Cross-Group Projects. Package hl7.fhir.us.codex-radiation-therapy#2.0.0 based on FHIR 4.0.1. Generated 2025-02-17
Links: Table of Contents | QA Report | Version History | | Propose a change