DICOM PS3.16 2024d - Content Mapping Resource |
---|
Templates are patterns that specify the Concept Names, Requirements, Conditions, Value Types, Value Multiplicity, Value Set restrictions, Relationship Types and other attributes of Content Items for a particular application.
An IOD may specify that particular Standard Templates shall be used or may be used to define or constrain the content of a Content Item construct. A Content Item construct includes a coded concept name and one of several types of coded values. Content Item constructs are used in:
the main Data Set and recursively nested Content Sequences (0040,A730) of the SR Document Content Module
the Acquisition Context Sequence (0040,0555) of the Acquisition Context Module,
the Protocol Context Sequence (0040,0440) and Content Item Modifier Sequence (0040,0441) of the Scheduled Procedure Step Module, Image Acquisition Results Module, and others.
the Specimen Preparation Step Content Item Sequence (0040,0612) of the Specimen Module.
Annex A and Annex C of this Part define Standard Templates.
Standard Extended and Private Templates may be defined by implementers of the Standard. The rules for definition of Standard Extended and Private SR Templates are similar to the rules for definition of Standard Extended and Private SOP Classes. One row of a Template definition table corresponds to one row of a Module table.
Each Standard Template is specified by a Template table in this Part. Each Template table specifies exactly one Template, corresponding to a pattern of content within a Content Item construct.
Each Template table identifies whether the order of Content Items is significant or not significant. SOP Instances whose content is based on a Template where the order is significant shall encode the top level Content Items in the order they are specified in the Template, and the subsidiary Content Items under each parent item in the order they are specified, and so on for each Nesting Level. The significance of the order applies only to the Template itself; subsidiary included Templates may have a different order significance.
Even if a Template specifies that the order is not significant, there may be significance to the order in which Content Items are encoded in a SOP Instance. For example, CONTAINER Content Items with Attribute Continuity of Content (0040,A050) value CONTINUOUS encode Content Items in narrative sequence, and procedure logs encode Content Items in time order.
The Content Items from subsidiary Templates may be intermingled if and only if the parent and subsidiary all specify that the order is not significant. This permits later refactoring into reusable Templates.
The range of concepts and the options that are permitted in a family of SR Documents vary inversely with the level of constraint that is applied by the corresponding SR Template. The more narrow the range of concepts and the more restricted the options permitted by a Template, the more predictable the content of the SR Documents will be.
A very specific Template defines a family of SR Documents that are very similar to each other. They have a narrow range of content options (e.g., high level of constraint of Content Item values; use of CODE or NUM with Enumerated Context Groups) and their content is therefore highly predictable. A very general (e.g., permissive or broad) Template defines a family of SR Documents that may differ considerably from one another. They have a broader range of content options (e.g., low level of constraint of Content Item values; use of TEXT and relatively little restriction of Content Item values) and their content is less predictable.
The degree of interoperability that may be achieved with a family of SR Documents generated from a Template may be determined intentionally and precisely at a desired level by appropriate Template design to achieve the necessary degree of predictability of SR Document contents.
SR Templates are described using tables of the following form:
Acquisition Context Templates are described using tables of the following form:
Protocol Context Templates are described using tables of the following form:
The semantics of the fields (columns) of Template tables are defined by subsections of this Section. A row of a Template table specifies either one Content Item or inclusion of another Template that may specify any number of Content Items (see Section 6.2.3 for definition of Included Templates). Each Template table is named by a title, identified by a TID number and further explained by a description such as explanation of Template contents, purpose and use cases.
The following conventions are defined for the form of references to coded concepts, Context Groups and Templates.
Code Meanings are enclosed in quotation marks (for example "cm"). Code Values and Coding Scheme Designators are not enclosed in quotation marks unless a comma occurs in the string.
References to coded concepts take the following form:
If reference to a specific Coding Scheme version is required, it takes the following form:
References to Context Groups take the following form:
References to Templates take the following form:
Each row of a Template Table is denoted by a row number. The first row is numbered 1 and subsequent rows are numbered in ascending order with increments of 1. This number denotes a row for convenient description as well as reference in conditions.
When templates are amended, temporary assignments of new rows between existing rows may be indicated by an alphabetic suffix, as in "6a" after "6", etc.
The Row Number of a Content Item in a Template may or may not be the same as the ordinal position of the corresponding Sequence Item (representing the Content Item) in a Content Sequence (0040,A730), depending on the number of times the Content Item is repeated.
The Content Item specified in the first row of a Template table may be of any Value Type. Specifically, it is not constrained to be a CONTAINER.
The nesting level of Content Items is denoted by ">" symbols, one per level of nesting below the initial Source Content Item (of the Template) in a manner similar to the depiction of nested Sequences of Items in Modules Tables in PS3.3. When it is necessary to specify the Target Content Item(s) of a relationship, they are specified in the row(s) immediately following the corresponding Source Content Item. The Nesting Level of a Target Content Item is one greater than the Nesting Level of the corresponding (parent) Source Content Item. The Content Item specified in row 1 of a Template Table is at the top level (i.e., no ">" symbol is ever present in the NL field for the first Content Item in the table).
Acquisition Context Templates have no Nesting Level field. Protocol Context and UPS Processing Parameter Templates allow a single Nesting Level implemented through the Content Item Modifier Sequence (see PS3.3).
Relationship Type and Relationship Mode (i.e., By-value or By-reference) constraints, if defined, are specified in this field, as described Table 6.1.3-1.
Relationship Type and Mode are specified for each row that specifies a target Content Item.
Relationship Type and Mode may also be specified when another Template is included, either "top-down" or "bottom-up" or both (i.e., in the "INCLUDE Template" row of the calling Template, or in all rows of the included Template, or in both places). There shall be no conflict between the Relationship Type and Mode of a row that includes another Template and the Relationship Type and Mode of the rows of the included Template.
SR IODs specify Enumerated Values for Relationship Types. If a Relationship Type other than one of the Defined Terms for Relationship Type (0040,A010) is specified in a Private SOP Class, there is a significant risk to interoperability. Documentation accompanying Templates for Private SOP Classes should define any Relationship-type extensions in the manner that the Standard Relationship Types are defined in PS3.3.
Acquisition Context and Protocol Context Templates have no Relationship field.
The Value Type field specifies the SR Value Type of the Content Item or conveys the word "INCLUDE" to indicate that another Template is to be included (substituted for the row). See Section 6.2.3 for further description of "Included Templates".
Any constraints on the Concept Name are specified in the Concept Name field as defined or enumerated coded entries, or as baseline or defined Context Groups. Alternatively, when the VT field is "INCLUDE", the Concept Name field specifies the Template to be included.
The absence of an entry in the Concept Name field means that any code may be used, from any Coding Scheme, including codes from private Coding Schemes.
The VM field indicates the number of times that either a Content Item of the specified pattern or an included Template may appear in this position. Table 6.1.6-1 specifies the values that are permitted in this field.
Table 6.1.6-1. Permitted Values for VM
The Requirement Type field specifies the requirements on the presence or absence of the Content Item or included Template.
There is typically no need to specify Requirement Type separately for SCU and SCP of the Basic SR SOP Classes, because the SCP is required to support the entire content of any SR Document it receives. Therefore, for Basic SR SOP Classes, Requirement Type effectively only applies to the SCU.
The following symbols are used:
Mandatory. Shall be present. An empty Measured Value Sequence (0040,A300) is not permitted when unknown, only for failures. See Section 6.1.7.1.
Mandatory Conditional. Shall be present if the specified condition is satisfied. An empty Measured Value Sequence (0040,A300) is not permitted when unknown, only for failures. See Section 6.1.7.1.
User Option Conditional. May not be present. May be present according to the specified condition.
There is an interaction between the VM and the Requirement Type with respect to the number of times that a Content Item (or included Template) may actually be present, as follows:
Section C.18.1 Numeric Measurement Macro in PS3.3 permits the Measured Value Sequence (0040,A300), which contains the Numeric Value (0040,A30A) and Measurement Units Code Sequence (0040,08EA) to be zero length.
This does not apply to the Section 10.2 Content Item Macro in PS3.3 , which does not permit an empty Measured Value Sequence (0040,A300) nor does it include a Numeric Value Qualifier Code Sequence (0040,A301).
The unknown state shall be distinguished from valid arithmetic or device or algorithm failure related states (in which cases a numeric string that complies with the PS3.5 Value Representation for DS cannot be created).
If the Template Requirement Type is M or MC, then:
A zero length Measured Value Sequence (0040,A300) is permitted for any of the reasons listed in CID 43 “Numeric Value Failure Qualifier”
A zero length Measured Value Sequence (0040,A300) is not permitted for any of the reasons listed in CID 44 “Numeric Value Unknown Qualifier”, or any other semantically equivalent reason
The Condition field specifies any conditions upon which presence or absence of the Content Item or its values depends. This field specifies any Concept Name(s) or Values upon which there are dependencies.
References in Condition statements to coded concepts or values, whether to select a Content Item to test or to specify a value to test against, are of the form (CV, CSD, "CM"). As is always the case for coded entries, the matching is performed against CV and CSD, irrespective of the string value of CM.
References may also be made to row numbers (e.g., to specify exclusive OR conditions that span multiple rows of a Template table).
The following abbreviations are used:
Any constraints on the Value Set for a CODE Content Item are specified in this field as defined or enumerated coded entries, or as baseline or defined Context Groups.
The absence of an entry in the Value Set Constraint field for a CODE Content Item means that any code may be used, from any Coding Scheme, including codes from private Coding Schemes.
The Value Set Constraint column may specify a default value for the Content Item if the Content Item is not present, either as a fixed value, or by reference to another Content Item, or by reference to an Attribute from the Data Set other than within the Content Sequence (0040,A730). For example:
Defaults to (121006, DCM, "Person")
Defaults to Value of Institution Name (0008,0080) of the General Equipment Module
A default value may also be specified to indicate that a Content Item is expected to have a particular value unless there is a reason for it to be different. This is especially true in the case where a Content Item is mandatory and, therefore, must not be absent.
For the UIDREF Content Item in Row 1 of TID 1004 “Device Observer Identifying Attributes”, the Value Set Constraint column specifies: "Defaults to Value of Device UID (0018,1002) of the General Equipment Module". That means, the value of this Content Item should be the same as the value of the referenced Attribute unless there is a reason for it to be different.
Any constraints on units of measurement are specified in the Value Set Constraint field if and only if the Value Type is NUM. The constraints are specified either as defined or enumerated coded entries, or as baseline or defined Context Groups. For example:
UNITS = DCID 7460 “Linear Measurement Unit”
The constraints on the units apply only when Measured Value Sequence (0040,A300) contains an item (i.e., a numeric value is present).
The presence of constraints on the units does not imply that a value is required to be sent, since Measured Value Sequence (0040,A300) is Type 2 and may be zero length if permitted by the Requirement Type for the Content Item in the Template.
The absence of any constraint on units of measurement means that any code for units may be used, from any coding scheme, including codes from private coding schemes.
The value of the Continuity of Content Flag (0040,A050) may be specified in the Value Set Constraint field if and only if the Value Type is CONTAINER.
The SR Document Content Module specifies "SEPARATE" and "CONTINUOUS" as the Enumerated Values for Continuity of Content Flag (0040,A050).
Constraints on the value of the Graphic Type(0070,0023) may be specified in the Value Set Constraint field if and only if the Value Type is SCOORD. The constraint may specify a set of allowed values, or a set of disallowed values. For example:
Constraints on various aspects of the TABLE Content Item may be specified in the Value Set Constraint field, including the manner of encoding the tabulated values, either by row, by column, by individual cells, or by reference to other Content Items, by specifying:
Fixed values, minimums and/or maximums for the number of table rows (NROWS) and/or columns (NCOLUMNS)
Defined or enumerated coded entries, or baseline or defined Context Groups for Concept Name Code Sequence (0040,A043) to use in Table Row Definition Sequence (0040,A806) (ROW n) and/or Table Column Definition Sequence (0040,A807) (COLUMN n)
Defined or enumerated coded entries, or baseline or defined Context Groups for Concept Code Sequence (0040,A168) to use in Cell Values Sequence (0040,A808) (ROW n VALUES) and/or (COLUMN n VALUES) and/or (CELL r, c VALUES)
Defined or enumerated coded entries, or baseline or defined Context Groups for Measurement Units Code Sequence (0040,08EA) to use in Table Row Definition Sequence (0040,A806) (ROW n UNITS) and/or Table Column Definition Sequence (0040,A807) (COLUMN n UNITS) and/or Cell Values Sequence (0040,A808) (CELL r, c UNITS)
Permitted VR to use in Selector Attribute VR (0072,0050) for specified rows (ROW n VR) , columns (COLUMN n VR) or cells (CELL r,c VR) , when values are encoded literally
Permitted referenced Content Item target (TID ttt ROW rrr) for specified rows (ROW n REF) , columns (COLUMN n REF) or cells (CELL r,c REF), when values are specified by reference
It is also helpful to provide a detailed description of the form of the table in the corresponding Content Item Description.
COLUMN 1 = EV (111526, DCM, "DateTime Started") COLUMN 2 = EV (113734, DCM, "X-Ray Tube Current") |
The X-Ray Source Transformation Matrix is encoded as a 4 by 4 matrix of dimensionless numbers of the form defined in Section C.20.2.1.1 Frame of Reference Transformation Matrix in PS3.3 . The table may be encoded as entire rows, entire columns or individual cells of double float numeric values. |
COLUMN 1 = EV (111526, DCM, "DateTime Started") COLUMN 2 = EV (111632, DCM, "Anode Target Material") |
DICOM PS3.16 2024d - Content Mapping Resource |
---|