DICOM PS3.3 2021c - Information Object Definitions

C.11.19 XA/XRF Presentation State Mask Module (Current)
Prev | C.11 Look Up Tables and Presentation States | Next

### C.11.19 XA/XRF Presentation State Mask Module

Table C.11.19-1 specifies the Attributes that describe mask operations for a XA/XRF Multi-frame image.

Table C.11.19-1. XA/XRF Presentation State Mask Module Attributes

Attribute Name | Tag | Type | Attribute Description
--- | --- | --- | ---
Mask Subtraction Sequence | (0028,6100) | 1 | Defines a Sequence that describes mask subtraction operations for Multi-frame Images. One or more Items shall be included in this Sequence.
>Referenced Image Sequence | (0008,1140) | 1C | A reference to a selected Image. Required if Presentation State Relationship Module references more than one SOP Instance. Only a single Item shall be included in this Sequence.
>>Include Table 10-11 “SOP Instance Reference Macro Attributes” |
>Mask Operation | (0028,6101) | 1 | Defined Term identifying the type of mask operation to be performed. See Section C.7.6.10.1 for further explanation.
>Applicable Frame Range | (0028,6102) | 1C | Each pair of numbers in this multi-valued Attribute specifies a beginning and ending frame number inclusive of a range where this particular mask operation is valid. Discontinuous ranges are represented by multiple pairs of numbers. Frames in a Multi-frame Image are specified by sequentially increasing number values beginning with 1. If this Attribute is missing in this particular Sequence Item, then the mask operation is applicable throughout the entire Multi-frame Image, subject to certain limits as described in Section C.7.6.10.1.1. Each frame shall only be associated with a single Item of this Sequence. Required if Mask Operation (0028,6101) equals REV_TID. May be present otherwise.
>Mask Frame Numbers | (0028,6110) | 1C | Specifies the frame numbers of the pixel data used to generate this mask. Frames in a Multi-frame Image are specified by sequentially increasing number values beginning with 1. Required if the Mask Operation (0028,6101) is AVG_SUB.
>Contrast Frame Averaging | (0028,6112) | 3 | Specifies the number of contrast frames to average together before performing the mask operation. If the Attribute is missing, no averaging is performed.
>TID Offset | (0028,6120) | 2C | If Mask Operation is TID, specifies the offset to be subtracted from the current frame number in order to locate the mask frame in TID mode. If Mask Operation is REV_TID, specifies the initial offset to be subtracted from the first contrast frame number. See Section C.7.6.10.1.1. If zero length, TID Offset defaults to 1. Required if Mask Operation (0028,6101) is TID or REV_TID.
>Pixel Intensity Relationship LUT Sequence | (0028,9422) | 1C | A Sequence of Pixel Intensity Relationship LUTs that specifies a transformation to logarithmic space. One or more Items shall be included in this Sequence. Required if Pixel Intensity Relationship (0028,1040) is not LOG for frames included in this Item of the Mask Subtraction Sequence (0028,6100).
>>LUT Frame Range | (0028,9507) | 1 | Each pair of numbers in this multi-valued Attribute specifies a beginning and ending frame number inclusive of a range where this LUT operation is specified. Discontinuous ranges are represented by multiple pairs of numbers. Frames in a Multi-frame Image are specified by sequentially increasing number values beginning with 1. ### Note The specified frame numbers must be a part of the frames where this mask operation is valid.
>>LUT Descriptor | (0028,3002) | 1 | Specifies the format of the LUT Data in this Sequence. See Section C.11.1.1 and Section C.7.6.16.2.13.1 for further explanation.
>>LUT Data | (0028,3006) | 1 | LUT Data in this Sequence
>>LUT Function | (0028,9474) | 1 | The transformation function this LUT applies to the stored pixel values. Enumerated Values: TO_LOG
>Pixel Shift Sequence | (0028,9501) | 1 | Sequence containing the pixel shift values for the masks of the specified frame range(s) in the specified region(s). One or more Items shall be included in this Sequence.
>>Pixel Shift Frame Range | (0028,9506) | 1 | Each pair of numbers in this multi-valued Attribute specify a beginning and ending contrast frame number inclusive of a range where this pixel shift is specified. Discontinuous ranges are represented by multiple pairs of numbers. Frames in a Multi-frame Image are specified by sequentially increasing number values beginning with 1. Overlapping frame ranges are not permitted. ### Note The specified frame numbers must be a part of the frames where this mask operation is valid.
>>Region Pixel Shift Sequence | (0028,9502) | 1 | Sequence containing the pixel shifts for this frame(s). Only one sub region of this frame(s) shall be specified when the pixel shift is applicable for the full size or a single region of the frame(s). More than one sub region of this frame(s) may be specified when pixel shift is different in different regions. The order of Items in this Sequence is significant, see Section C.11.19.1.2. One or more Items shall be included in this Sequence.
>>>Mask Sub-pixel Shift | (0028,6114) | 1 | A pair of floating point numbers specifying the fractional vertical [adjacent row spacing] and horizontal [adjacent column spacing] pixel shift applied to the mask before subtracting it from the region of the frame numbers specified by Pixel Shift Frame Range (0028,9506) of this Pixel Shift Sequence (0028,9501) Item. The region is specified by the polygon defined by the Vertices of the Region (0028,9503) Attribute. The pixels on the line of the polygon belong to the region. ### Note If no pixel shift has to be applied a pair of zero Attribute values (0.0\0.0) should be specified. See Section C.11.19.1.1.
>>>Vertices of the Region | (0028,9503) | 1C | Multiple Values where the first set of two values are: row of the origin vertexcolumn of the origin vertex Two or more pairs of values follow and are the row and column coordinates of the other vertices of the polygon region. Each polygon region is implicitly closed from the last vertex to the origin vertex and all edges shall be non-intersecting except at the vertices. See Section C.11.19.1.2. The upper left pixel of the image has the coordinate 1\1. Required if the pixel shift does not apply to the entire set of pixels of the frames.

#### C.11.19.1 XA/XRF Presentation State Mask Attributes

##### C.11.19.1.1 Mask Sub-pixel Shift

A pair of floating point numbers specifying the fractional vertical [adjacent row spacing] and horizontal [adjacent column spacing] pixel shift applied to the mask before subtracting it from the specified region of the contrast frame. The row offset results in a shift of the pixels along the column axis. The column offset results in a shift of the pixels along the row axis. A positive row offset is a shift toward the pixels of the lower row of the pixel plane. A positive column offset is a shift toward the pixels of the left hand side column of the pixel plane.

##### C.11.19.1.2 Vertices of the Region

Each Item of the Region Pixel Shift Sequence (0028,9502) specifies both a region of the contrast frame and a mask pixel shift to be applied during the subtraction of that region.

When the Region Pixel Shift Sequence (0028,9502) contains more than one Item, each region of the contrast frame is subtracted by applying the corresponding pixel shift specified in that Item.

When an Item of the Sequence does not contain the Attribute Vertices of the Region (0028,9503), the applicable region for that Item is the whole contrast frame.

The union of all the regions defined in the Region Pixel Shift Sequence (0028,9502) does not cover necessarily the whole contrast frame, in which case the pixels outside the union of all the regions shall be subtracted with no pixel shift.

If a set of pixels of the contrast frame is contained in more than one region, the applicable pixel shift is the one of the last Item with the region that contains this set of pixels, as shown in Figure C.11.19-1.

Figure C.11.19-1. Applicable pixel shift in case of multiple pixel shift regions

### Note

For example, the contrast frames 4 to 10 of a SOP Instance "A" are subtracted to the mask frame 1, the subtraction of the frames 4 to 7 being performed with three different values of mask pixel shift on overlapping rectangular regions: The (row,column) coordinates of the top-left and bottom-right vertices of the regions are 1: (1,1) to (30,60), 2: (10,40) to (50,120) and 3: (20,20) to (70,80). The mask pixel shift to be applied to the pixel (25,50) corresponds to the region 3 because this pixel is contained in the intersection of the three regions (see Figure C.11.19-2 and Figure C.11.19-3).

Figure C.11.19-2. Example of Contents of Mask Subtraction Sequence

Figure C.11.19-3. Example of three different pixel shift regions

Prev | Up | Next
C.11.18 Structured Display Annotation Module | Home | C.11.20 XA/XRF Presentation State Shutter Module

DICOM PS3.3 2021c - Information Object Definitions