DICOM PS3.3 2024e - Information Object Definitions

C.38.2.2 Stored File Access Macro

Table C.38.2-2 specifies the Attributes of the Stored File Access Macro, which describe non-DICOM protocol access to a stored SOP Instance in the DICOM File Format, possibly contained in a container file.

Table C.38.2-2. Stored File Access Macro Attributes

Attribute Name

Tag

Type

Attribute Description

File Access URI

(0008,0409)

1C

Access URI for a file containing the SOP Instance. See Section C.38.2.2.1.1.

Required if the referenced SOP Instance is in the DICOM File Format, and is accessible through a non-DICOM protocol (see Annex P).

Container File Type

(0008,040A)

1C

Type of container file. See Section C.38.1.2.8 for Defined Terms.

Required if File Access URI (0008,0409) is present.

Filename in Container

(0008,040B)

1C

Filename within a container file of the file containing the SOP Instance. See Section C.38.2.2.1.2.

Required if Container File Type (0008,040A) is ZIP, TAR, or TARGZIP.

File Offset in Container

(0008,040C)

1C

Byte offset (zero-based) within a container file for the start of the SOP Instance file. See Section C.38.2.2.1.2.

Required if Container File Type (0008,040A) is BLOB. May be present otherwise.

File Length in Container

(0008,040D)

1C

Length in bytes of the SOP Instance file within a container file. See Section C.38.2.2.1.2.

Required if Container File Type (0008,040A) is BLOB. May be present otherwise.

Stored Instance Transfer Syntax UID

(0008,040E)

1C

Transfer Syntax of the SOP Instance encoded in DICOM File Format. Equal to Transfer Syntax UID (0002,0010) in File Meta Information header of the stored Instance.

Required if File Access URI (0008,0409) is present.

Lossy Image Compression Ratio

(0028,2112)

3

Describes the approximate lossy compression ratio(s) that have been applied to this image.

See Section C.7.6.1.1.5.2.

MAC Algorithm

(0400,0015)

1C

The algorithm used for generating a Message Authentication Code. See Table C.12.1.1.3.1.2-1 for Defined Terms.

Required if MAC (0400,0404) is present.

MAC

(0400,0404)

3

Message Authentication Code computed across the stored instance file for verification of file integrity. See Section C.38.2.2.1.3.


C.38.2.2.1 Stored File Access Macro Attribute Descriptions
C.38.2.2.1.1 File Access URI

File Access URI (0008,0409) provides the URI for accessing a file containing the SOP Instance in the DICOM File Format. The file may contain a single SOP Instance, or it may be a container file in which one or more SOP Instance files are included.

File Access URI (0008,0409) may be a relative path reference beginning with the single-dot-segment "./" (see Section P.2.1). In this case, the value is merged with a Stored Instance Base URI (0008,0407) specified for the context of this Attribute in accordance with Section P.2.1.

Note

The merge of a relative path File Access URI (0008,0409) with a Stored Instance Base URI (0008,0407) involves only two Attribute values. For example, a relative path specified at the Instance level is not merged with any Study or Series level relative path values, but only with a base URI. This contrasts with the web-based Studies Service of PS3.18, which might require constructing a URI from a base URI in the Retrieve URL (0008,1190), DICOM-defined strings, a Study Instance UID (0020,000D), a Series Instance UID (0020,000E), and a Referenced SOP Instance UID (0008,1155).

C.38.2.2.1.2 Filename in Container, File Offset in Container, and File Length in Container

If the stored SOP Instance is included in a ZIP, TAR, or TARGZIP container file as specified in Section P.1.2, Filename in Container (0008,040B) is the filename within that container file of the file containing the SOP Instance.

If the stored SOP Instance is included in a BLOB container file, and optionally for other container formats, File Offset in Container (0008,040C) is the byte offset for the start of the file for the SOP Instance, and File Length in Container (0008,040D) is the file length. For TARGZIP container files, this is the offset within the TAR container file after extraction from the GZIP container file.

Note

Locating a file by filename within a container file may require parsing the entire container file (TAR) or look up in the index (ZIP). The File Offset in Container (0008,040C) and File Length in Container (0008,040D), if provided by the SCP, allows the SCU to directly access a specific file.

C.38.2.2.1.3 MAC

The integrity of a stored SOP Instance file may be verified by a Message Authentication Code (also known as a message digest, hash, or cryptographic checksum) computed across the SOP Instance file. The MAC (0400,0404) value is computed across the entire file as a byte stream, including the Preamble, Prefix, Meta-Information Header, and Data Set Trailing Padding (see Section 7 “DICOM File Format” in PS3.10). For files stored in container files, the MAC is computed on the file extracted from the container.

Note

This differs from the MAC for Digital Signatures (see Section C.12.1.1.3), which is computed across an enumerated list of Attributes within the SOP Instance, not across the entire file.

DICOM PS3.3 2024e - Information Object Definitions