DICOM PS3.3 2024d - Information Object Definitions

10.2 Content Item Macro

A Content Item is a flexible means of encoding attribute identifiers and attribute values using the Code Sequence Macro (see Section 8) for coded terminology defined by a coding scheme. The Content Item provides a name-value pair, i.e., a Concept Name, encoded as a Code Sequence, and a Concept Value. The Concept Value may be encoded by any of a set of generic Attributes, as specified by a Value Type, including text, personal name, numeric, and coded concept (Code Sequence) values.

Note

  1. Comparing a Content Item to a native DICOM Data Element, the Concept Name Code Sequence corresponds to the Data Element Tag and Attribute Name, the Value Type to the Value Representation, and the Concept Value to the Data Element Value Field. See PS3.5.

  2. The IMAGE Value Type of this Macro does not include the Type 3 Attributes of the IMAGE Value Type defined in Section C.17.3, as they are not required for Acquisition Context or Protocol Context Content Items.

Specific uses of the Content Item may invoke the Content Item Macro defined in this Section, the Document Content Macro of Section C.17.3, or another similar construct. An invocation of the Content Item Macro may constrain the allowed values of Value Type (0040,A040).

Note

  1. The NUMERIC Value Type of this Macro differs from the NUM Value Type defined in Section C.17.3, since the encoding of the Concept Value is different.

  2. The Value Type uses Enumerated Values so as to assure that non-standard Value Types are not used, and to prevent the nefarious use, for example, of a CONTAINER Value Type in an SR-like manner to create nested content, which is not the intent.

  3. Some invocations of this Macro may use the Content Item Modifier Sequence (0040,0441) to achieve a single level of "nesting". That Attribute is not included in this Macro itself, to prevent recursive inclusion.

See Section 5.4 for the meaning of the Type column in this Macro when applied to Normalized IODs.

Table 10-2. Content Item Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Value Type

(0040,A040)

1

The type of the value encoded in this name-value Item.

Enumerated Values:

DATE

TIME

DATETIME

PNAME

UIDREF

TEXT

CODE

NUMERIC

COMPOSITE

IMAGE

WAVEFORM

Observation DateTime

(0040,A032)

3

The date and time on which this Item was completed. For the purpose of recording measurements or logging events, completion time is defined as the ending time of data acquisition of the measurement, or the ending time of occurrence of the event.

Observation Start DateTime

(0040,A033)

3

The date and time on which this Item was started. For the purpose of recording measurements or logging events, start time is defined as the ending time of data acquisition of the measurement, or the start time of occurrence of the event.

Concept Name Code Sequence

(0040,A043)

1

Coded concept name of this name-value Item.

Only a single Item shall be included in this Sequence.

>Include Table 8.8-1 “Code Sequence Macro Attributes”

No Baseline CID is defined.

DateTime

(0040,A120)

1C

DateTime value for this name-value Item.

Required if Value Type (0040,A040) is DATETIME.

Date

(0040,A121)

1C

Date value for this name-value Item.

Required if Value Type (0040,A040) is DATE.

Time

(0040,A122)

1C

Time value for this name-value Item.

Required if Value Type (0040,A040) is TIME.

Person Name

(0040,A123)

1C

Person name value for this name-value Item.

Required if Value Type (0040,A040) is PNAME.

UID

(0040,A124)

1C

UID value for this name-value Item.

Required if Value Type (0040,A040) is UIDREF.

Text Value

(0040,A160)

1C

Text value for this name-value Item.

Required if Value Type (0040,A040) is TEXT.

Concept Code Sequence

(0040,A168)

1C

Coded concept value of this name-value Item.

Only a single Item shall be included in this Sequence.

Required if Value Type (0040,A040) is CODE.

>Include Table 8.8-1 “Code Sequence Macro Attributes”

No Baseline CID is defined.

Numeric Value

(0040,A30A)

1C

Numeric value for this name-value Item. Only a single value shall be present.

Required if Value Type (0040,A040) is NUMERIC.

Floating Point Value

(0040,A161)

1C

The floating point representation of Numeric Value (0040,A30A). The same number of values as Numeric Value (0040,A30A) shall be present.

Required if Numeric Value (0040,A30A) has insufficient precision to represent the value as a string. May be present otherwise.

Rational Numerator Value

(0040,A162)

1C

The integer numerator of a rational representation of Numeric Value (0040,A30A), encoded as a signed integer value. The same number of values as Numeric Value (0040,A30A) shall be present.

Required if Numeric Value (0040,A30A) has insufficient precision to represent a rational value as a string. May be present otherwise.

Rational Denominator Value

(0040,A163)

1C

The integer denominator of a rational representation of Numeric Value (0040,A30A), encoded as a non-zero unsigned integer value. The same number of values as Numeric Value (0040,A30A) shall be present.

Required if Rational Numerator Value (0040,A162) is present.

Measurement Units Code Sequence

(0040,08EA)

1C

Units of measurement for a numeric value in this name-value Item.

Only a single Item shall be included in this Sequence.

Required if Value Type (0040,A040) is NUMERIC.

>Include Table 8.8-1 “Code Sequence Macro Attributes”

BCID 82 “Measurement Unit”.

Referenced SOP Sequence

(0008,1199)

1C

Composite SOP Instance Reference value for this name-value Item.

Only a single Item shall be included in this Sequence.

Required if Value Type (0040,A040) is COMPOSITE or IMAGE or WAVEFORM.

>Include Table 10-11 “SOP Instance Reference Macro Attributes”

>Referenced Frame Number

(0008,1160)

1C

Identifies the frame numbers within the Referenced SOP Instance to which the reference applies. The first frame shall be denoted as frame number 1.

Note

This Attribute may be multi-valued.

Required if the Referenced SOP Instance is a multi-frame image and the reference does not apply to all frames, and Referenced Segment Number (0062,000B) is not present.

>Referenced Segment Number

(0062,000B)

1C

Identifies the segments to which the reference applies identified by Segment Number (0062,0004).

Required if the Referenced SOP Instance is a Segmentation or Surface Segmentation and the reference does not apply to all segments and Referenced Frame Number (0008,1160) is not present.

>Referenced Waveform Channels

(0040,A0B0)

1C

List of channels in Waveform to which the reference applies. See Section C.18.5.1.1.

Required if the Referenced SOP Instance is a Waveform that contains multiple Channels and the reference does not apply to all Channels of all Multiplex Groups.


10.2.1 Content Item With Modifiers Macro

Content Item with Modifiers is a means of describing structured content which needs a Content Item with single optional level of modifiers, i.e. a two-level structure of Content Items. An invocation of the Content Item with Modifiers Macro will usually specify the allowed values using a Protocol Context Template in PS3.16, which allows a single Nesting Level (see in Section 6.1.2 “Nesting Level (NL)” in PS3.16 ). Constraints on the use of this Macro may be specified in PS3.16 Annex C, which may be invoked in IODs in PS3.3.

Table 10.2.1-1. Content Item with Modifiers Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Include Table 10-2 “Content Item Macro Attributes”

No Baseline TID is defined.

Content Item Modifier Sequence

(0040,0441)

3

Specifies modifiers for the Content Item.

One or more Items are permitted in this Sequence.

>Include Table 10-2 “Content Item Macro Attributes”

No Baseline TID is defined.


DICOM PS3.3 2024d - Information Object Definitions