Frame Label Attribute
| Tag | (0020,9453) |
|---|---|
| Type | Optional (3) |
| Keyword | FrameLabel |
| Value Multiplicity | 1 |
| Value Representation | Long String (LO) |
Label corresponding to a specific dimension index value. Selected from a set of dimension values defined by the application.
This Attribute may be referenced by the Dimension Index Pointer (0020,9165) Attribute in the Multi-frame Dimension Module.
See Section C.7.6.16.2.2.5 for further explanation.
Note
Part of the Frame Content Functional Group Macro with usage: M
Multi-frame Dimension Module
C.7.6.17 Multi-frame Dimension Module
The Multi-frame Dimension Module contains a Sequence with Items pointing to Attributes defining a set of dimensions that are usually known prior to the acquisition commencing. It is up to the generating applications to decide what Attributes are important to describe the multi-frame dimensions.
The application that generates the Concatenation or SOP Instances may use the order of Dimension Index Pointers (0020,9165) in the Dimension Index Sequence (0020,9222) to guide the receiving application in determining the order of the presentation of image frames. The first index has the highest ranking, the next index has a lower ranking, etc. Frames with higher values for the dimension with the highest ranking would only be presented after all frames that have values for Dimension Index Pointers (0020,9165) of the lower rankings have been presented.
If the set of Dimension Index Pointers does not provide an Attribute set whose values are unique for each frame then the order for the frames with the same value set will be incompletely specified. The receiving application could use the logical frame number to resolve this ambiguity. If the Attribute set contains more dimensions than are needed to specify a unique ordering, the lower order ranking Attribute(s) will have no effect on the ordering.
Note
For example if there were the following indices in the following order:
-
Stack ID (1-3)
-
In-stack Position Number (1-2 for Stack ID 1, 1-4 for Stack ID 2, 1-3 for Stack ID 3)
-
Effective Echo Time (1-2), i.e., every slice has been scanned with 2 different effective echo's
Then the frames could be presented in the following order:
(Stack ID, In-stack Position, Effective Echo Time)
(1,1,1), (1,1,2), (1,2,1), (1,2,2),
(2,1,1), (2,1,2), (2,2,1), (2,2,2), (2,3,1), (2,3,2), (2,4,1), (2,4,2)
(3,1,1), (3,1,2), (3,2,1), (3,2,2), (3,3,1), (3,3,2)
The actual order of the frames in the object is up to the generating application.
If the effective echo time was not included in the Dimension Index Pointers in the above example then the order of sorting for the frames with the same indices will be undefined - in this case there would be 2 frames with the index set (Stack ID, In-stack Position) = (1,1) and the order of these frames is not specified.
If there were another Attribute appended to the Dimension Index Pointers, for example TR, then the TR index would not be used in determining the order of the frames. So the Index Frame Pointers would contain (Stack ID, In-stack Position, Effective Echo Time, TR) but the TR index would be irrelevant for frame ordering purposes.
Table C.7.6.17-1 specifies the Attributes of the Multi-frame Dimension Module.
Table C.7.6.17-1. Multi-frame Dimension Module Attributes
|
Attribute Name |
Tag |
Type |
Attribute Description |
|---|---|---|---|
|
Dimension Organization Sequence |
(0020,9221) |
1 |
Sequence that lists the Dimension Organization UIDs referenced by the containing SOP Instance. See Section C.7.6.17.2 for further explanation. One or more Items shall be included in this Sequence. |
|
>Dimension Organization UID |
(0020,9164) |
1 |
Uniquely identifies a set of dimensions referenced within the containing SOP Instance. See Section C.7.6.17.2 for further explanation. |
|
Dimension Organization Type |
(0020,9311) |
3 |
Dimension organization of the Instance. Defined Terms:
|
|
Dimension Index Sequence |
(0020,9222) |
1C |
Identifies the Sequence containing the indices used to specify the dimension of the multi-frame object. One or more Items shall be included in this Sequence. Required if Dimension Organization Type (0020,9311) is absent or not TILED_FULL. May be present otherwise. |
|
>Dimension Index Pointer |
(0020,9165) |
1 |
Contains the Data Element Tag that is used to identify the Attribute connected with the index. See Section C.7.6.17.1 for further explanation. |
|
>Dimension Index Private Creator |
(0020,9213) |
1C |
Identification of the creator of a group of Private Data Elements. Required if the Dimension Index Pointer (0020,9165) value is the Data Element Tag of a Private Attribute. |
|
>Functional Group Pointer |
(0020,9167) |
1C |
Contains the Data Element Tag of the Functional Group Sequence that contains the Attribute that is referenced by the Dimension Index Pointer (0020,9165). See Section C.7.6.17.1 for further explanation. Required if the value of Dimension Index Pointer (0020,9165) is the Data Element Tag of an Attribute that is contained within a Functional Group Sequence. |
|
>Functional Group Private Creator |
(0020,9238) |
1C |
Identification of the creator of a group of Private Data Elements. Required if the Functional Group Pointer (0020,9167) value is the Data Element Tag of a Private Attribute. |
|
>Dimension Organization UID |
(0020,9164) |
1 |
Uniquely identifies a set of dimensions referenced within the containing SOP Instance. In particular the dimension described by this Sequence Item is associated with this Dimension Organization UID. See Section C.7.6.17.2 for further explanation. |
|
>Dimension Description Label |
(0020,9421) |
3 |
Free text description that explains the meaning of the dimension. |
C.7.6.17.1 Dimension Indices
With the Dimension Index Sequence (0020,9222), Data Element Tags are specified that identify the indices used for a particular SOP Instance.
The actual index values for each frame in a multi-frame header are stored in a single Dimension Index Values Attribute (0020,9157) defined in the Frame Content Functional Group. For each SOP Instance this Attribute has a Value Multiplicity equal to the number of Items in the Sequence. The ordering of the Items in the Sequence defines the ordering in the Dimension Index Values Attribute: Item 1 of the Sequence relates to Value 1, Item 2 to Value 2, etc.
The Dimension Index Pointer (0020,9165) references a single Attribute that describes the actual values that define the dimension. Each Attribute referenced in the Dimension Index Sequence (0020,9222) will have an index stored in the Dimension Index Values (0020,9157) for each frame. Each index value is an ordinal number starting from 1 and monotonically increasing by 1 within the scope of a Dimension Organization UID (0020,9164). These values are independent of the actual values of the Attribute referenced by the Dimension Index Pointer (0020,9165), i.e., the index values are logical indices, rather than actual indices. Frames assigned the same index shall contain nominally the same value for the referenced Attribute. If the referenced Attribute is not present for some frames, or is present but has no value, then a single index shall be assigned to indicate the lack of the value (i.e., all such frames shall have the same index value, which is different from other index values). It is at the discretion of the SOP Instance creator whether the Attribute values are equivalent, and therefore appropriate for assignment to the same index value.
The Dimension Index Pointer (0020,9165) shall contain the Data Element Tag (gggg,eeee) of the Attribute being indexed.
The Dimension Index Pointer (0020,9165) shall not contain the Data Element Tag for Frame Content Sequence (0020,9111) or Dimension Index Values (0020,9157).
Note
-
Dimension Index Pointer (0020,9165) may point to a Sequence containing a Functional Group. In that case all the Attributes of the Sequence are associated with the index value.
-
The Dimension Index Pointer (0020,9165) may point to a Data Element Tag (gggg,eeee) that is not present for all frames of an object, or does not have a value for all frames of an object. For such frames, index values are still assigned, as described above.
-
The indices used in the Dimension Index Values (0020,9157) may or may not be identical to the value of indexed Attribute referenced by Dimension Index Pointer (0020,9165). For example, if the referenced Attribute is itself encoded in an index-like fashion (being an ordinal number starting from 1), such as In-Stack Position Number (0020,9057), then index value 1 would typically correspond to In-Stack Position Number (0020,9057) value 1. On the other hand, if the referenced Attribute encodes some physical measure, such as a time or distance, or a categorical value, such as a string describing the phase of contrast, or a more complex description such as an entire Functional Group, then the index value is independent of the encoded value.
-
The scope of the values of Dimension Index Pointer (0020,9165) is defined to be within a single Dimension Organization UID (0020,9164). If the same Dimension Organization UID (0020,9164) is present in multiple Instances (whether part of a Concatenation or not), at least one of those Instances (though not necessarily every Instance) will contain a value of 1 for the Dimension Index Values (0020,9157).
The Functional Group Pointer (0020,9167) value is the Data Element Tag (gggg,eeee) of the Functional Group Sequence that contains the Attribute being indexed. If the Dimension Index Pointer (0020,9165) contains a Data Element Tag that identifies a Functional Group Sequence then the Functional Group Pointer (0020,9167) shall not be present.
If the Dimension Index Pointer (0020,9165) Attribute contains a Private Data Element, then the Dimension Index Private Creator (0020,9213) shall contain the Private Creator of the block of Private Data Elements.
If the Functional Group Pointer (0020,9167) Attribute contains a Private Data Element, then the Functional Group Private Creator (0020,9238) shall contain the Private Creator of the block of Private Data Elements.
Note
An example of the usage of the Dimension Index Sequence (0020,9222) and Dimension Index Values (0020,9157) Attributes:
Dimension Index Sequence (0020,9222) specifies two indices:
-
Cardiac Trigger Delay Time (0020,9153)
-
Image Position (Patient) (0020,0032)
The Dimension Index Sequence (0020,9222) is filled with the following contents:
|
Item |
Attribute |
Value |
|---|---|---|
|
1 |
Dimension Index Pointer |
(0020,9153) |
|
Functional Group Pointer |
(0018,9118) |
|
|
… |
|
|
|
2 |
Dimension Index Pointer |
(0020,0032) |
|
Functional Group Pointer |
(0020,9113) |
|
|
… |
|
The Dimension Index Values (0020,9157) (in the Frame Content Functional Group) for each frame consists of two values:
Index of Cardiac Trigger Delay Time \ Index of Image Position
The SOP Instance creator is responsible for maintaining consistency between the actual value of the Attribute listed as the Dimension Index Pointer (0020,9165) and the corresponding value in the Dimension Index Values (0020,9157) Attribute.
See Figure C.7.6.17-1 for an illustration of this example.
Figure C.7.6.17-1. Example of Dimension Index Sequence and Dimension Index Values Attributes
C.7.6.17.2 Dimension Organization UID
The Dimension Organization UID (0020,9164) value identifies a set of dimensions to which an Item of the Dimension Index Sequence (0020,9222) belongs.
When different SOP Instances share the same Dimension Organization UID (0020,9164) for a particular Item of the Dimension Index Sequence (0020,9222), equivalent indices from the corresponding Dimension Index Values (0020,9157) shall have the same meaning across the SOP Instances.
This mechanism allows an image creator to explicitly specify that indices are intended to convey identical information across SOP Instances.
Dimension Organization Sequence (0020,9221) contains a summary of all the Dimension Organization UID (0020,9164) values used in a SOP Instance.
Note
Figure C.7.6.17-2 illustrates how this is used for a SOP Instance created by a multi-planar reformat application from a SOP Instance containing three Items in the Dimension Index Sequence. The meaning of the indices for Temporal Position Index (0020,9128), and MR Echo Sequence (0018,9114) were preserved in the derived SOP Instance, so it shares the Dimension Organization UID for these Attributes with the original. Since the reformat was performed with a different orientation, the meaning of the In-Stack Position Number (0020,9057) was not preserved. Therefore a new Dimension Organization UID (0020,9164) was created.
Figure C.7.6.17-2. Example of Use of Dimension Organization Module
C.7.6.17.3 Spatial Location and Optical Path of Tiled Images
If Dimension Organization Type (0020,9311) is present with a value of TILED_FULL, then the Per-Frame Functional Group Macros that would otherwise describe the spatial location of each tile explicitly (e.g., the X, Y and Z offsets from the origin in the Slide Coordinate System Plane Position (Slide)), and the optical path or segment, may be omitted.
A value of TILED_FULL indicates that the frames across all Instances of a Concatenation, or a single Instance in the absence of a Concatenation, comprise a non-sparse non-overlapping representation of an entire rectangular region, and are sequentially encoded as successive frames in Pixel Data (7FE0,0010) in an implicit order varying:
-
first along the row direction from left to right, where the row direction is defined in the Slide Coordinate System by the first three values of Image Orientation (Slide) (0048,0102),
-
then along the column direction from top to bottom, where the column direction is defined in the Slide Coordinate System by the second three values of Image Orientation (Slide) (0048,0102),
-
then along the depth direction from the glass slide towards the coverslip, where the depth direction is defined in the Slide Coordinate System from zero to positive,
-
then along optical paths, if applicable, where the direction is defined by successive Items of the Optical Path Sequence (0048,0105) in the order in which they are listed in that Sequence,
-
then along the segments, if applicable, where the direction is defined by ascending numeric values of Segment Number (0062,0004) as defined in the Segment Sequence (0062,0002).
If Dimension Organization Type (0020,9311) is absent or has a value of TILED_SPARSE, then the location of each tile is explicitly encoded using information in the Per-Frame Functional Groups Sequence, and the recipient shall not make any assumption about the spatial position or optical path or segment or order of the encoded frames, but shall rely on the values of the relevant Per-Frame Functional Group Macro.
Note
Images with an Image Type (0008,0008) Value 3 of THUMBNAIL, LABEL or OVERVIEW are single frame and may have a spatial extent that is not the same as the Total Pixel Matrix, so Dimension Organization Type (0020,9311) is not applicable.
The same previously applied to images with an Image Type (0008,0008) Value 3 of LOCALIZER, which has been retired. See PS3.3-2021c.
Section C.7.6.16.2.2.5
C.7.6.16.2.2.5 Frame Label
The Frame Label (0020,9453) Attribute can be used to label frames that need to be handled as a group in application. The Dimension Index Pointer (0020,9165) from the Multi-frame Dimension Module may point to this Attribute if it is the base of a dimension.