minimal Common Oncology Data Elements (mCODE) Implementation Guide, published by HL7 International / Clinical Interoperability Council. This guide is not an authorized publication; it is the continuous build for version 4.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/fhir-mCODE-ig/ and changes regularly. See the Directory of published versions
Official URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-volume | Version: 4.0.0-ballot | |||
Active as of 2024-10-30 | Maturity Level: 3 | Computable Name: RadiotherapyVolume | ||
Other Identifiers: OID:2.16.840.1.113883.4.642.40.15.42.49 |
A volume of the body used in radiotherapy planning or treatment delivery.
Radiotherapy is a directed treatment that targets a specific areas or volumes in or on the body. The RadiotherapyVolume profile describes these areas or volumes in terms of a BodyStructure resource. Using a standalone resource permits reuse of the same body volume in planning, executing, and reporting a radiotherapy treatment, as opposed to repeating the same elements in multiple places.
The code list of anatomic structures and location qualifiers applicable to RadiotherapyVolume follows the recommendations of the American Association of Physicists in Medicine (AAPM) Task Group 263 report on Standardizing Nomenclatures in Radiation Oncology]. Volumes are further classified according to their type, including the following Burnet et al., 2004:
An additional volume types referenced by ICRU62 is the term Internal Target Volume (ITV), represents a volume encompassing the CTV with an internal margin compensating for patient movement. As defined by Ezhil et al the Internal Gross Tumor Volume (IGTV) represents the GTV with an internal margin to compensate for all movements.
The treatment location should be expressed using the anatomical concepts in the American Association of Physicists in Medicine (AAPM) Task Group 263 report on Standardizing Nomenclatures in Radiation Oncology], expressed using SNOMED CT. The mapping from AAPM TG263 concepts to SNOMEDCT codes (RadiotherapyTreatmentLocationVS) and qualifiers (RadiotherapyTreatmentLocationQualifierVS) can be found in this spreadsheet. An excerpt of this spreadsheet is shown below.
For example, if the treatment location was the Left Breast, with TG263 primary name Breast_L, the location would be expressed by using the SNOMEDCT 76752008
(Breast structure (body structure)) for location, and 7771000
(Left) for the locationQualifier.
A known limitation of the RadiotherapyVolume is that it accepts only one coded location. This limitation stems from the base BodyStructure resource. As a result, a compound volume (such as prostate plus seminal vesicles) cannot be represented. If this presents a serious limitation in practice, an extension with additional pairs (location, location qualifiers) will be required.
BodyStructure resources whose morphology has a code from the value set RadiotherapyVolumeTypeVS SHALL conform to this profile. Beyond this requirement, a producer of resources SHOULD ensure that any resource instance associated with an in-scope patient that would reasonably be expected to conform to this profile SHOULD be published in this form. Any resource intended to conform to this profile SHOULD populate meta.profile
accordingly.
Usage:
Changes since version true:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from BodyStructure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
BodyStructure | C | 0..* | BodyStructure | Specific and identified anatomical structure mcode-description-or-id-required: One of description or identifier MUST be present |
Slices for identifier | S | 0..* | Identifier | Volume Identifier Slice: Unordered, Open by value:use |
identifier:displayName | S | 0..1 | Identifier | Bodystructure identifier |
use | 1..1 | code | usual | official | temp | secondary | old (If known) Required Pattern: usual | |
value | S | 1..1 | string | The value that is unique |
morphology | S | 0..1 | CodeableConcept | Type of Radiotherapy Volume Binding: Radiotherapy Volume Type Value Set (extensible) |
location | S | 0..1 | CodeableConcept | Body Location Code. Binding: Radiotherapy Treatment Location Value Set (extensible) |
locationQualifier | S | 0..* | CodeableConcept | Qualifiers on location used to specify a TG263 body structure comprising the irradiated volume. Binding: Radiotherapy Treatment Location Qualifier Value Set (extensible) |
description | S | 0..1 | string | Volume Description |
patient | S | 1..1 | Reference(Cancer Patient Profile) | Who this is about |
Documentation for this format |
Path | Conformance | ValueSet | URI |
BodyStructure.morphology | extensible | RadiotherapyVolumeTypeVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-volume-type-vs from this IG | |
BodyStructure.location | extensible | RadiotherapyTreatmentLocationVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs from this IG | |
BodyStructure.locationQualifier | extensible | RadiotherapyTreatmentLocationQualifierVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-qualifier-vs from this IG |
Id | Grade | Path(s) | Details | Requirements |
mcode-description-or-id-required | error | BodyStructure | One of description or identifier MUST be present : description.exists() or identifier.exists() |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
BodyStructure | C | 0..* | BodyStructure | Specific and identified anatomical structure mcode-description-or-id-required: One of description or identifier MUST be present |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
Slices for identifier | SΣ | 0..* | Identifier | Volume Identifier Slice: Unordered, Open by value:use |
identifier:displayName | SΣ | 0..1 | Identifier | Bodystructure identifier |
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . Required Pattern: usual |
value | SΣ | 1..1 | string | The value that is unique Example General: 123456 |
active | ?!Σ | 0..1 | boolean | Whether this record is in active use |
morphology | SΣ | 0..1 | CodeableConcept | Type of Radiotherapy Volume Binding: Radiotherapy Volume Type Value Set (extensible) |
location | SΣ | 0..1 | CodeableConcept | Body Location Code. Binding: Radiotherapy Treatment Location Value Set (extensible) |
locationQualifier | S | 0..* | CodeableConcept | Qualifiers on location used to specify a TG263 body structure comprising the irradiated volume. Binding: Radiotherapy Treatment Location Qualifier Value Set (extensible) |
description | SΣ | 0..1 | string | Volume Description |
patient | SΣ | 1..1 | Reference(Cancer Patient Profile) | Who this is about |
Documentation for this format |
Path | Conformance | ValueSet / Code | URI |
BodyStructure.identifier:displayName.use | required | Pattern: usualhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1 from the FHIR Standard | |
BodyStructure.morphology | extensible | RadiotherapyVolumeTypeVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-volume-type-vs from this IG | |
BodyStructure.location | extensible | RadiotherapyTreatmentLocationVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs from this IG | |
BodyStructure.locationQualifier | extensible | RadiotherapyTreatmentLocationQualifierVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-qualifier-vs from this IG |
Id | Grade | Path(s) | Details | Requirements |
mcode-description-or-id-required | error | BodyStructure | One of description or identifier MUST be present : description.exists() or identifier.exists() |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
BodyStructure | C | 0..* | BodyStructure | Specific and identified anatomical structure mcode-description-or-id-required: One of description or identifier MUST be present | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
Slices for identifier | SΣ | 0..* | Identifier | Volume Identifier Slice: Unordered, Open by value:use | ||||
identifier:displayName | SΣ | 0..1 | Identifier | Bodystructure identifier | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . Required Pattern: usual | ||||
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 0..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||
value | SΣ | 1..1 | string | The value that is unique Example General: 123456 | ||||
period | Σ | 0..1 | Period | Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
active | ?!Σ | 0..1 | boolean | Whether this record is in active use | ||||
morphology | SΣ | 0..1 | CodeableConcept | Type of Radiotherapy Volume Binding: Radiotherapy Volume Type Value Set (extensible) | ||||
location | SΣ | 0..1 | CodeableConcept | Body Location Code. Binding: Radiotherapy Treatment Location Value Set (extensible) | ||||
locationQualifier | S | 0..* | CodeableConcept | Qualifiers on location used to specify a TG263 body structure comprising the irradiated volume. Binding: Radiotherapy Treatment Location Qualifier Value Set (extensible) | ||||
description | SΣ | 0..1 | string | Volume Description | ||||
image | 0..* | Attachment | Attached images | |||||
patient | SΣ | 1..1 | Reference(Cancer Patient Profile) | Who this is about | ||||
Documentation for this format |
Path | Conformance | ValueSet / Code | URI | |||
BodyStructure.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
BodyStructure.identifier:displayName.use | required | Pattern: usualhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1 from the FHIR Standard | ||||
BodyStructure.identifier:displayName.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-type from the FHIR Standard | ||||
BodyStructure.morphology | extensible | RadiotherapyVolumeTypeVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-volume-type-vs from this IG | ||||
BodyStructure.location | extensible | RadiotherapyTreatmentLocationVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs from this IG | ||||
BodyStructure.locationQualifier | extensible | RadiotherapyTreatmentLocationQualifierVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-qualifier-vs from this IG |
Id | Grade | Path(s) | Details | Requirements |
mcode-description-or-id-required | error | BodyStructure | One of description or identifier MUST be present : description.exists() or identifier.exists() |
This structure is derived from BodyStructure
Differential View
This structure is derived from BodyStructure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
BodyStructure | C | 0..* | BodyStructure | Specific and identified anatomical structure mcode-description-or-id-required: One of description or identifier MUST be present |
Slices for identifier | S | 0..* | Identifier | Volume Identifier Slice: Unordered, Open by value:use |
identifier:displayName | S | 0..1 | Identifier | Bodystructure identifier |
use | 1..1 | code | usual | official | temp | secondary | old (If known) Required Pattern: usual | |
value | S | 1..1 | string | The value that is unique |
morphology | S | 0..1 | CodeableConcept | Type of Radiotherapy Volume Binding: Radiotherapy Volume Type Value Set (extensible) |
location | S | 0..1 | CodeableConcept | Body Location Code. Binding: Radiotherapy Treatment Location Value Set (extensible) |
locationQualifier | S | 0..* | CodeableConcept | Qualifiers on location used to specify a TG263 body structure comprising the irradiated volume. Binding: Radiotherapy Treatment Location Qualifier Value Set (extensible) |
description | S | 0..1 | string | Volume Description |
patient | S | 1..1 | Reference(Cancer Patient Profile) | Who this is about |
Documentation for this format |
Path | Conformance | ValueSet | URI |
BodyStructure.morphology | extensible | RadiotherapyVolumeTypeVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-volume-type-vs from this IG | |
BodyStructure.location | extensible | RadiotherapyTreatmentLocationVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs from this IG | |
BodyStructure.locationQualifier | extensible | RadiotherapyTreatmentLocationQualifierVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-qualifier-vs from this IG |
Id | Grade | Path(s) | Details | Requirements |
mcode-description-or-id-required | error | BodyStructure | One of description or identifier MUST be present : description.exists() or identifier.exists() |
Key Elements View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
BodyStructure | C | 0..* | BodyStructure | Specific and identified anatomical structure mcode-description-or-id-required: One of description or identifier MUST be present |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
Slices for identifier | SΣ | 0..* | Identifier | Volume Identifier Slice: Unordered, Open by value:use |
identifier:displayName | SΣ | 0..1 | Identifier | Bodystructure identifier |
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . Required Pattern: usual |
value | SΣ | 1..1 | string | The value that is unique Example General: 123456 |
active | ?!Σ | 0..1 | boolean | Whether this record is in active use |
morphology | SΣ | 0..1 | CodeableConcept | Type of Radiotherapy Volume Binding: Radiotherapy Volume Type Value Set (extensible) |
location | SΣ | 0..1 | CodeableConcept | Body Location Code. Binding: Radiotherapy Treatment Location Value Set (extensible) |
locationQualifier | S | 0..* | CodeableConcept | Qualifiers on location used to specify a TG263 body structure comprising the irradiated volume. Binding: Radiotherapy Treatment Location Qualifier Value Set (extensible) |
description | SΣ | 0..1 | string | Volume Description |
patient | SΣ | 1..1 | Reference(Cancer Patient Profile) | Who this is about |
Documentation for this format |
Path | Conformance | ValueSet / Code | URI |
BodyStructure.identifier:displayName.use | required | Pattern: usualhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1 from the FHIR Standard | |
BodyStructure.morphology | extensible | RadiotherapyVolumeTypeVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-volume-type-vs from this IG | |
BodyStructure.location | extensible | RadiotherapyTreatmentLocationVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs from this IG | |
BodyStructure.locationQualifier | extensible | RadiotherapyTreatmentLocationQualifierVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-qualifier-vs from this IG |
Id | Grade | Path(s) | Details | Requirements |
mcode-description-or-id-required | error | BodyStructure | One of description or identifier MUST be present : description.exists() or identifier.exists() |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
BodyStructure | C | 0..* | BodyStructure | Specific and identified anatomical structure mcode-description-or-id-required: One of description or identifier MUST be present | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
Slices for identifier | SΣ | 0..* | Identifier | Volume Identifier Slice: Unordered, Open by value:use | ||||
identifier:displayName | SΣ | 0..1 | Identifier | Bodystructure identifier | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . Required Pattern: usual | ||||
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 0..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||
value | SΣ | 1..1 | string | The value that is unique Example General: 123456 | ||||
period | Σ | 0..1 | Period | Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
active | ?!Σ | 0..1 | boolean | Whether this record is in active use | ||||
morphology | SΣ | 0..1 | CodeableConcept | Type of Radiotherapy Volume Binding: Radiotherapy Volume Type Value Set (extensible) | ||||
location | SΣ | 0..1 | CodeableConcept | Body Location Code. Binding: Radiotherapy Treatment Location Value Set (extensible) | ||||
locationQualifier | S | 0..* | CodeableConcept | Qualifiers on location used to specify a TG263 body structure comprising the irradiated volume. Binding: Radiotherapy Treatment Location Qualifier Value Set (extensible) | ||||
description | SΣ | 0..1 | string | Volume Description | ||||
image | 0..* | Attachment | Attached images | |||||
patient | SΣ | 1..1 | Reference(Cancer Patient Profile) | Who this is about | ||||
Documentation for this format |
Path | Conformance | ValueSet / Code | URI | |||
BodyStructure.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
BodyStructure.identifier:displayName.use | required | Pattern: usualhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1 from the FHIR Standard | ||||
BodyStructure.identifier:displayName.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-type from the FHIR Standard | ||||
BodyStructure.morphology | extensible | RadiotherapyVolumeTypeVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-volume-type-vs from this IG | ||||
BodyStructure.location | extensible | RadiotherapyTreatmentLocationVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs from this IG | ||||
BodyStructure.locationQualifier | extensible | RadiotherapyTreatmentLocationQualifierVShttp://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-qualifier-vs from this IG |
Id | Grade | Path(s) | Details | Requirements |
mcode-description-or-id-required | error | BodyStructure | One of description or identifier MUST be present : description.exists() or identifier.exists() |
This structure is derived from BodyStructure
Other representations of profile: CSV, Excel, Schematron