10.2 Content Item Macro

10.2 Content Item Macro
Prev	10 Miscellaneous Macros	Next

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

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.
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

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.
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.
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 Description

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
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”			Baseline CID 82 “Units of Measurement”.
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.
>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.