DICOM PS3.3 2019c - Information Object Definitions

10.17 Selector Attribute Macro

Table 10-20 specifies the Attributes that identify either a particular value of an Attribute, all values of an Attribute, a specific Item in a Sequence, or all Items in a Sequence. The Attribute or Item may be nested within one or more Sequences, and/or a Private Attribute.

The invocation of the Selector Attribute Macro may define additional semantics. E.g., if the Selector Attribute Macro is used to select "all" values of an Attribute and then test that set of value against some condition, then an invocation might define whether it is required that at least one value in the set meet the condition or whether all values in the set must meet the condition.

Table 10-20a extends the Selector Attribute Macro with additional Attribute descriptors.

Table 10-20. Selector Attribute Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Selector Attribute

(0072,0026)

1C

Data Element Tag of the Attribute to be referenced.

Required if the selected content is not a Sequence Item.

Selector Value Number

(0072,0028)

1C

Non-negative integer identifying which value of a multi-valued Attribute identified by Selector Attribute (0072,0026) is to be referenced. The value 1 identifies the first value. The value 0 identifies all values.

When the Value Multiplicity of the Selector Attribute (0072,0026) is 1 then the value of this Attribute shall be 1.

Required if the selected content is a single Attribute of any VR other than SQ.

Selector Sequence Pointer

(0072,0052)

1C

Contains the Data Element Tags of the path to the Sequence that contains the Attribute that is identified by Selector Attribute (0072,0026) or to the Item(s) to be selected in Selector Sequence Pointer Items (0074,1057).

This Attribute shall have the same number of values as the level of nesting of Selector Attribute (0072,0026) or the selected Item(s).

Required if Selector Attribute (0072,0026) is nested in one or more Sequences or is absent.

See Section 10.17.1.1.

Selector Sequence Pointer Private Creator

(0072,0054)

1C

Identification of the creator of a group of Private Data Elements used to encode Attributes in the Selector Sequence Pointer (0072,0052).

This Attribute shall have the same number of values as Selector Sequence Pointer (0072,0052).

For values of the Selector Sequence Pointer (0072,0052) that are not the Data Element Tag of a Private Attribute, the corresponding value in Selector Sequence Pointer Private Creator (0072,0054) shall be empty.

Required if Selector Sequence Pointer (0072,0052) is present and one or more of the values of Selector Sequence Pointer (0072,0052) is the Data Element Tag of a Private Attribute.

See Section 10.17.1.2.

Selector Sequence Pointer Items

(0074,1057)

1C

Identification of the Item indices in the Selector Sequence Pointer (0072,0052).

This Attribute shall have the same number of values as the Selector Sequence Pointer (0072,0052).

The value 1 identifies the first Item of the corresponding Sequence. The value 0 identifies all Items of the corresponding Sequence.

Required if Selector Sequence Pointer (0072,0052) is present.

See Section 10.17.1.1.

Selector Attribute Private Creator

(0072,0056)

1C

Identification of the creator of a group of Private Data Elements.

Required if the Selector Attribute (0072,0026) value is the Data Element Tag of a Private Attribute.

See Section 10.17.1.2.


Table 10-20a. Extended Selector Attribute Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Selector Attribute Name

(0082,0018)

1

Name of the Selector Attribute (0072,0026).

For Standard Data Elements, this shall be the value in the Name column of Table 6-1 in PS3.6.

Selector Attribute Keyword

(0082,0019)

3

Keyword of the Selector Attribute (0072,0026).

For Standard Data Elements, this shall be the value in the Keyword column of Table 6-1 in PS3.6.

Selector Attribute VR

(0072,0050)

1

Value Representation of the Selector Attribute (0072,0026).

For Standard Data Elements, this shall be the value in the VR column of Table 6-1 in PS3.6.

Include Table 10-20 “Selector Attribute Macro Attributes”


10.17.1 Selector Attribute Macro Attribute Descriptions

10.17.1.1 Referencing Nested Elements

Examples of use are shown in Table 10-21.

The examples include the selection of a top level Attribute, a nested Attribute, one Item in a top level Sequence, all Items in a nested Sequence or a specific Item in all Items of a parent Sequence.

Table 10-21. Selector Attribute Macro Example

Example

Selector Attribute (0072,0026)

Selector Value Number (0072,0028)

Selector Sequence Pointer (0072,0052)

Selector Sequence Pointer Items (0074,1057)

Patient's Name (0010,0010)

(0010,0010)

1

absent

absent

Second value (e.g., PRIMARY or SECONDARY) in Image Type (0008,0008)

(0008,0008)

2

absent

absent

RT Beam Limiting Device Type (300A,00B8) for the second jaw in Beam Limiting Device Sequence (300A,00B6) specified for the first Beam in the Beam Sequence (300A,00B0) of an RT Plan

(300A,00B8)

1

(300A,00B0)\(300A,00B6)

1\2

Code Value (0008,0100) for the first Item in View Code Sequence (0054,0220)

(0008,0100)

1

(0054,0220)

1

The second Item in the Patient Setup Sequence (300A,0180) in the top level Data Set

absent

absent

(300A,0180)

2

The second Item in the Beam Limiting Device Sequence (300A,00B6) in third Item in the Beam Sequence (300A,00B0) of an RT Plan

absent

absent

(300A,00B0)\(300A,00B6)

3\2

All Items in the Beam Limiting Device Sequence (300A,00B6) in third Item in the Beam Sequence (300A,00B0) of an RT Plan

absent

absent

(300A,00B0)\(300A,00B6)

3\0

The second Item in the Beam Limiting Device Sequence (300A,00B6) in all Items in the Beam Sequence (300A,00B0) of an RT Plan

absent

absent

(300A,00B0)\(300A,00B6)

0\2


10.17.1.2 Private Attribute References

The Selector Sequence Pointer Private Creator (0072,0054) and the Selector Attribute Private Creator (0072,0056) each have a value that corresponds to the Private Creator Data Element numbers (gggg,00pp), where gggg is odd and pp ranges from 10 to FF. These identify a block of Private Data Elements within the block (gggg,ppxx). When Selector Attribute (0072,0026) or Selector Sequence Pointer (0072,0052) points to a Private Data Element (gggg,ppxx), it shall have the value (gggg,00xx).

DICOM PS3.3 2019c - Information Object Definitions