DICOM PS3.3 2019b - Information Object Definitions

10.25 Attribute Value Constraint Macro

Table 10.25-1 allows an Attribute to be identified and to have constraints placed on acceptable values for that Attribute. An Attribute being constrained is refered to in the Macro as a Selector Attribute.

Note

  1. This Macro does not handle mutual constraints between multiple Attributes. For example constraining the ratio between two Attributes to a specific value is not possible unless there is a third Attribute that encodes that ratio so the third Attribute could then be constrained.

  2. The SOP Instance containing this Macro defines the purpose of the constraints, which may include constraining Attribute values in other SOP Instances.

Table 10.25-1. Attribute Value Constraint Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Include Table 10-20a “Extended Selector Attribute Macro Attributes”

Constraint Type

(0082,0032)

1

Describes how the value(s) specified in the Constraint Value Sequence (0082,0034) shall be used to determine the acceptability of a given value for the Attribute identified by Selector Attribute (0072,0026)

See Section 10.25.1.

Enumerated Values:

RANGE_INCL

RANGE_EXCL

GREATER_OR_EQUAL

LESS_OR_EQUAL

GREATER_THAN

LESS_THAN

EQUAL

MEMBER_OF

NOT_MEMBER_OF

MEMBER_OF_CID

UNCONSTRAINED

Constraint Violation Significance

(0082,0036)

3

Level of significance of a Selector Attribute value exceeding this constraint.

See Section 10.25.2.

Enumerated Values:

FAILURE

WARNING

INFORMATIVE

Constraint Violation Condition

(0082,0037)

1C

Conditionality of the constraint violation significance. If the condition is not met, the violation has no significance.

The condition may be expressed as a mathematical expression, a human readable text or other form.

Required if Constraint Violation Significance (0082,0036) is only significant under certain conditions.

Constraint Value Sequence

(0082,0034)

1C

Value(s) used to constrain the contents of the Attribute referenced by the Selector Attribute (0072,0026).

Required if Constraint Type (0082,0032) is not UNCONSTRAINED.

If the Constraint Type (0082,0032) is GREATER_OR_EQUAL, LESS_OR_EQUAL, GREATER_THAN, LESS_THAN, EQUAL or MEMBER_OF_CID only a single Item shall be included in this Sequence.

If the Constraint Type (0082,0032) is RANGE_INCL or RANGE_EXCL, exactly two Items shall be included in this Sequence, the first of which is less than or equal to the second.

If the Constraint Type (0082,0032) is MEMBER_OF or NOT_MEMBER_OF, one or more Items shall be included in this Sequence.

>Include Table 10.26-1 “Attribute Value Macro Attributes”

Any sub-Sequences in the Constraint Value Sequence (0082,0034) shall only contain one Item.

Any Attribute in the Sequence Item(s) shall contain a single value.

If Constraint Type (0082,0032) is MEMBER_OF_CID, this shall be a Selector UI Value (0072,007F), despite the Selector Attribute VR (0072,0050) being SQ.

See Section 10.25.1.1

Recommended Default Value Sequence

(0082,0035)

3

Contains a default value for the contents of the Selector Attribute (0072,0026).

Only a single Item is permitted in this Sequence.

>Include Table 10.26-1 “Attribute Value Macro Attributes”

Measurement Units Code Sequence

(0040,08EA)

3

Units of measurement for the values in the Item(s) in the Constraint Value Sequence (0082,0034) and the Recommended Default Value Sequence (0082,0035).

Only a single Item is permitted in this Sequence.

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

BCID 82 “Units of Measurement”.

Specification Selection Guidance

(0082,0033)

3

Brief guidance that a human operator may consider when selecting an appropriate value for the Selector Attribute (0072,0026) within the constraints defined.


10.25.1 Constraint Type

The use of the specified value(s) in the Constraint Value Sequence (0082,0034) to constrain the value of the Attribute referenced by the Selector Attribute (0072,0026) shall depend on the value of Constraint Type (0082,0032) as follows:

RANGE_EXCL

the value is constrained to lie outside (i.e., not between) the specified values

GREATER_OR_EQUAL

the value is constrained to be greater than or equal to the specified value

LESS_OR_EQUAL

the value is constrained to be less than or equal to the specified value

GREATER_THAN

the value is constrained to be greater than the specified value

LESS_THAN

the value is constrained to be less than the specified value

EQUAL

the value is constrained to be equal to the specified value

MEMBER_OF

the value is constrained to be equal to one of the specified values

NOT_MEMBER_OF

the value is constrained to be not equal to any of the specified values

MEMBER_OF_CID

the value is constrained to be equal to a member of the specified CID

UNCONSTRAINED

the value of the Selector Attribute (0072,0026) is not constrained

For MEMBER_OF_CID, Constraint Value Sequence (0082,0034) shall contain a single Selector UI Value (0072,007F) , containing a Context Group UID (see PS 3.6, Table A-3. Context Group UID Values).

RANGE_INCL, RANGE_EXCL, GREATER_OR_EQUAL, LESS_OR_EQUAL, GREATER_THAN or LESS_THAN shall only be specified if the Selector Attribute (0072,0026) is AS, DA, DS, DT, FD, FL, IS, SL, SS, TM, UL or US.

See Section C.2.2.2 in PS3.4 for further guidance on value comparison.

Note

MEMBER_OF with a single Item in the Constraint Value Sequence (0082,0034) is valid and is equivalent to EQUAL.

10.25.1.1 Multi-valued Attribute Constraints

If the Attribute referenced by the Selector Attribute (0072,0026) has a value multiplicity of greater than 1 and the value of Selector Value Number (0072,0028) is 0, all values in the selected Attribute shall be compared to the single specified value. The constraint is violated if any of the multiple values do not satisfy the comparison.

DICOM PS3.3 2019b - Information Object Definitions