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

Resource Profile: Radiotherapy Treated Plan

Official URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-treated-plan Version: 2.0.0
Draft as of 2025-02-17 Computable Name: RadiotherapyTreatedPlan
Other Identifiers: OID:2.16.840.1.113883.4.642.40.14.42.32

A summary of radiotherapy treatment delivered with a single treatment plan.

This profile is used to capture a radiotherapy treatment plan delivered to a patient. An overview of radiotherapy courses, phases, and treatment plans is shown here. The relationships between the various radiotherapy profiles are shown here.

Conformance

Procedure resources whose code is SNOMEDCT 1255724003 (Radiotherapy treatment plan (regime/therapy)) MUST conform to this profile. Any resource intended to conform to this profile SHOULD populate meta.profile accordingly.

Usage:

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Procedure C 0..* USCoreProcedureProfile An action that is being or was performed on a patient
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
dom-6: A resource should have narrative for robust management
us-core-7: Performed SHALL be present if the status is 'completed' or 'in-progress'
codexrt-procedure-status: Only the following status values are supported: in-progress | not-done | on-hold | stopped | completed
codexrt-motion-management-none: If the respiratory motion management is 'none', then no other respiratory motion management extensions are allowed. They would also be 'none' or contradict the 'none'. SNOMEDCT code 721031000124102 is "External beam radiotherapy without respiratory motion management (procedure)"
codexrt-free-breathing-technique: The extension for the technique of free-breathing motion management is only allowed if motion management is free-breathing. SNOMEDCT code 721071000124104 is "External beam radiotherapy with free breathing (procedure)"
CategoryPreferred: This code 108290001 is inactive and should be used only for backward compatibility.
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
ele-1: All FHIR elements must have a @value or children
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... modalityAndTechnique SC 0..1 (Complex) Radiotherapy Modality And Technique Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality-and-technique
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
TechniquesForNeutronBeamModality: Allowed Techniques for Neutron Beam Modality
TechniquesForPhotonBeamModality: Allowed Techniques for Photon Beam Modality
TechniquesForElectronBeamModality: Allowed Techniques for Electron Beam Modality
TechniquesForCarbonIonBeamModality: Allowed Techniques for Carbon Ion Beam Modality
TechniquesForProtonBeamModality: Allowed Techniques for Proton Beam Modality
TechniquesForInternalRadiotherapyPermanentSeeds: Allowed Techniques for Internal Radiotherapy - Permanent Seeds
TechniquesForLowDoseRateUsingTempRadSource: Allowed Techniques for Low Dose Rate Using Temp Radiation Source
TechniquesForPulsedDoseRate: Allowed Techniques for Pulsed Dose Rate
TechniquesForHighDoseRate: Allowed Techniques for High Dose Rate
TechniquesForHighDoseRateElectronic: Allowed Techniques for High Dose Rate Electronic
TechniquesForRadioPharmaceutical: Allowed Techniques for Radiopharmaceutical
ModalityTextRequiredForOther: Require a text literal for code other
TechniqueTextRequiredForOther: Require a text literal for code other
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... modality S 1..1 (Complex) Radiotherapy Modality Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality"
....... value[x] 1..1 CodeableConcept Value of extension
Binding: Radiotherapy Modality Value Set (required)
ele-1: All FHIR elements must have a @value or children
...... technique S 0..* (Complex) Radiotherapy Technique Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-technique
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-technique"
....... value[x] 1..1 CodeableConcept Value of extension
Binding: Radiotherapy Technique Value Set (required)
ele-1: All FHIR elements must have a @value or children
...... radiotherapyEnergyOrIsotope S 0..* SimpleQuantity Radiotherapy Energy or Isotope
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-energy-or-isotope
Binding: Radiotherapy Energy Unit Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... radiotherapyTreatmentApplicatorType S 0..* CodeableConcept Radiotherapy Treatment Applicator Type
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-treatment-applicator-type
Binding: Brachytherapy Applicator Type Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality-and-technique"
.... imageGuidedRadiotherapyModality SC 0..* (Complex) Image Guided Radiotherapy Modality
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-image-guided-radiotherapy-modality
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
IGRTEnergyAllowed: Energy is only allowed for X-Ray, Fluorograph, or CT Modalities.
.... fractionsDelivered S 0..1 unsignedInt Number of Fractions Delivered
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-fractions-delivered
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... doseDeliveredToVolume S 0..* (Complex) Radiotherapy Dose Delivered To Volume Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-dose-delivered-to-volume
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... extension:volume S 1..1 Extension Volume in the body where radiation was delivered
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "volume"
...... extension:totalDoseDelivered S 0..1 Extension Extension
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "totalDoseDelivered"
....... value[x] 0..1 Quantity Value of extension
ele-1: All FHIR elements must have a @value or children
Required Pattern: At least the following
........ system 1..1 uri System that defines coded unit form
Fixed Value: http://unitsofmeasure.org
........ code 1..1 code Coded form of the unit
Fixed Value: cGy
...... pointDose S 0..1 boolean Point Dose
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-point-dose
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... primaryPlanDose S 0..1 boolean Primary Plan Dose
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-primary-plan-dose
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... radiobiologicMetric S 0..* Quantity Radiotherapy Biologically Effective Dose
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-dose-delivered-to-volume"
.... radiotherapyReasonForRevisionOrAdaptation S 0..* CodeableConcept Reason for Revision or Adaptation
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-reason-for-revision-or-adaptation
Binding: Radiotherapy Reason for Revision or Adaptation Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... respiratoryMotionManagement S 0..* CodeableConcept Respiratory Motion Management
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management
Binding: Radiotherapy Respiratory Motion Management Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... freeBreathingMotionManagementTechnique S 0..* CodeableConcept Free-Breathing Motion Management Technique
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-free-breathing-motion-mgmt-technique
Binding: Radiotherapy Free-Breathing Motion Management Technique Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... intrafractionVerification SC 0..* (Complex) Intrafraction Verification
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-intrafraction-verification
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
IntrafractionVerificationQualifierAllowed: Qualifier is only allowed for X-Ray procedure.
.... radiotherapyDicomRecord 0..* (Complex) DICOM Treatment Record
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-dicom-reference
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... identifier:displayName SΣ 1..1 Identifier The name that is displayed to the user.
ele-1: All FHIR elements must have a @value or children
..... use ?!Σ 1..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .


ele-1: All FHIR elements must have a @value or children
Required Pattern: usual
..... system SΣ 1..1 uri The namespace for the identifier value
ele-1: All FHIR elements must have a @value or children
Example General: http://www.acme.com/identifiers/patient
..... value SΣ 1..1 string The value that is unique
ele-1: All FHIR elements must have a @value or children
Example General: 123456
.... identifier:official SΣ 1..* Identifier A business identifier for the request or procedure, which is independent of its FHIR representation, such as a GUID or DICOM UID.
ele-1: All FHIR elements must have a @value or children
..... use ?!Σ 1..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .


ele-1: All FHIR elements must have a @value or children
Required Pattern: official
..... system SΣ 1..1 uri The namespace for the identifier value
ele-1: All FHIR elements must have a @value or children
Example General: http://www.acme.com/identifiers/patient
..... value SΣ 1..1 string The value that is unique
ele-1: All FHIR elements must have a @value or children
Example General: 123456
... Slices for basedOn Σ 0..* Reference(US Core CarePlan Profile | US Core ServiceRequest Profile) (USCDI) A request for this procedure
Slice: Unordered, Open by profile:$this.resolve()
ele-1: All FHIR elements must have a @value or children
.... basedOn:treatment-plan SΣ 0..1 Reference(Radiotherapy Treatment Plan) Radiotherapy Treatment Plan that planned the treatment summarized in this Radiotherapy Treated Plan.
ele-1: All FHIR elements must have a @value or children
.... basedOn:plan-prescription SΣ 0..1 Reference(Radiotherapy Plan Prescription) Radiotherapy Plan Prescription that prescribed the treatment summarized in this Radiotherapy Treated Plan.
ele-1: All FHIR elements must have a @value or children
... Slices for partOf Σ 0..* Reference(Procedure | Observation | MedicationAdministration) Part of referenced event
Slice: Unordered, Open by profile:$this.resolve()
ele-1: All FHIR elements must have a @value or children
.... partOf:course-summary SΣ 0..1 Reference(Radiotherapy Course Summary) Radiotherapy Course Summary that summarizes the course of which this Radiotherapy Treated Plan is a part.
ele-1: All FHIR elements must have a @value or children
.... partOf:treated-phase SΣ 0..1 Reference(Radiotherapy Treated Phase) Radiotherapy Treated Phase that summarizes the phase of which this Radiotherapy Treated Plan is a part.
ele-1: All FHIR elements must have a @value or children
... status ?!SΣC 1..1 code (USCDI) preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown
Binding: EventStatus (required)
ele-1: All FHIR elements must have a @value or children
... category Σ 1..1 CodeableConcept Classification of the procedure
Binding: Radiotherapy Category Code Max Value Set (required)
ele-1: All FHIR elements must have a @value or children
... code SΣ 1..1 CodeableConcept (USCDI) Identification of the procedure
Binding: US Core Procedure Codes (extensible): Codes describing the type of Procedure


ele-1: All FHIR elements must have a @value or children
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 1255724003
..... display 1..1 string Representation defined by the system
Fixed Value: Radiotherapy treatment plan (regime/therapy)
... subject SΣ 1..1 Reference(Cancer Patient Profile) (USCDI) Who the procedure was performed on
ele-1: All FHIR elements must have a @value or children
... performed[x] SΣC 0..1 Period (USCDI) When the procedure was performed
ele-1: All FHIR elements must have a @value or children
.... start SΣC 0..1 dateTime The date and time when the first therapeutic radiation was delivered.
ele-1: All FHIR elements must have a @value or children
.... end SΣC 0..1 dateTime An end date is expected if the status is 'stopped' or 'completed'
ele-1: All FHIR elements must have a @value or children
... Slices for performer SΣ 0..* BackboneElement The people who performed the procedure
Slice: Unordered, Open by profile:actor.resolve()
ele-1: All FHIR elements must have a @value or children
.... performer:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... actor Σ 1..1 Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device) The reference to the practitioner
ele-1: All FHIR elements must have a @value or children
.... performer:organization SΣ 0..* BackboneElement The people who performed the procedure
ele-1: All FHIR elements must have a @value or children
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... actor Σ 1..1 Reference(US Core Organization Profile) Organization that provided the radiotherapy treatment.
ele-1: All FHIR elements must have a @value or children
... location SΣ 0..1 Reference(US Core Location Profile) Location where the radiotherapy treatment was performed.
ele-1: All FHIR elements must have a @value or children
... reasonCode SΣ 0..* CodeableConcept Coded reason procedure performed
Binding: Cancer Disorder Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
... reasonReference SΣ 0..* Reference(Condition | Observation | Procedure | DiagnosticReport | DocumentReference) The justification that the procedure was performed
ele-1: All FHIR elements must have a @value or children
... bodySite SΣ 0..* CodeableConcept All body structure(s) treated with this procedure.
Binding: Radiotherapy Treatment Location Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
.... Slices for extension Content/Rules for all slices
..... locationQualifier 0..* CodeableConcept General location qualifier (excluding laterality) for this bodySite
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... lateralityQualifier 0..1 CodeableConcept Laterality qualifier for this bodySite
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... Slices for focalDevice 0..* BackboneElement Manipulated, implanted, or removed device
Slice: Unordered, Open by profile:manipulated.resolve()
ele-1: All FHIR elements must have a @value or children
.... focalDevice:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... manipulated 1..1 Reference(Device) Device that was changed
ele-1: All FHIR elements must have a @value or children
.... focalDevice:seedDevice S 0..* BackboneElement Radiotherapy Seed Device used as part of therapy.
ele-1: All FHIR elements must have a @value or children
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... manipulated 1..1 Reference(Radiotherapy Seed Device) Device that was changed
ele-1: All FHIR elements must have a @value or children
... Slices for usedReference S 0..* Reference(Device | Medication | Substance) Items used during procedure
Slice: Unordered, Open by profile:$this.resolve()
ele-1: All FHIR elements must have a @value or children
.... usedReference:treatmentDevice S 0..* Reference(Radiotherapy Treatment Device) Radiotherapy Treatment Device used as part of therapy.
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Procedure.extension:modalityAndTechnique.extension:modality.value[x]requiredRadiotherapyModalityVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-modality-vs
Procedure.extension:modalityAndTechnique.extension:technique.value[x]requiredRadiotherapyTechniqueVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-technique-vs
Procedure.identifier:displayName.userequiredPattern: usual
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
Procedure.identifier:official.userequiredPattern: official
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
Procedure.statusrequiredEventStatus
http://hl7.org/fhir/ValueSet/event-status
from the FHIR Standard
Procedure.categoryrequiredRadiotherapyCategoryVS
http://hl7.org/fhir/us/codex-radiation-therapy/ValueSet/codexrt-radiotherapy-category-vs
from this IG
Procedure.codeextensiblePattern: SNOMED-CT Code 1255724003("Radiotherapy treatment plan (regime/therapy)")
http://hl7.org/fhir/us/core/ValueSet/us-core-procedure-code
Procedure.reasonCodeextensibleCancerDisorderVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
Procedure.bodySiteextensibleRadiotherapyTreatmentLocationVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs

Constraints

IdGradePath(s)DetailsRequirements
CategoryPreferredwarningProcedureThis code 108290001 is inactive and should be used only for backward compatibility.
: category.exists() and category.coding.exists( code = '108290001' ).not()
codexrt-free-breathing-techniqueerrorProcedureThe extension for the technique of free-breathing motion management is only allowed if motion management is free-breathing. SNOMEDCT code 721071000124104 is "External beam radiotherapy with free breathing (procedure)"
: extension.exists(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-free-breathing-motion-mgmt-technique') implies extension.exists(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management' and value.exists(coding.exists(code = '721071000124104' and system = 'http://snomed.info/sct')))
codexrt-motion-management-noneerrorProcedureIf the respiratory motion management is 'none', then no other respiratory motion management extensions are allowed. They would also be 'none' or contradict the 'none'. SNOMEDCT code 721031000124102 is "External beam radiotherapy without respiratory motion management (procedure)"
: extension.exists(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management' and value.exists(coding.exists(code = '721031000124102' and system = 'http://snomed.info/sct'))) implies extension.where(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management').count() = 1
codexrt-procedure-statuserrorProcedureOnly the following status values are supported: in-progress | not-done | on-hold | stopped | completed
: status = 'in-progress' or status = 'not-done' or status = 'on-hold' or status = 'stopped' or status = 'completed'

 

Other representations of profile: CSV, Excel, Schematron