F.2 Basic Directory IOD Overview
Prev | F Basic Directory Information Object Definition (Normative) | Next

## F.2 Basic Directory IOD Overview

The general organization of the Basic Directory IOD is introduced in this Section. A simple example is also provided to illustrate the application of this organization.

### F.2.1 Basic Directory IOD Organization

The Basic Directory IOD organization is based on a hierarchy of Directory Entities. At the origin of this inverted tree is a root Directory Entity. Each Directory Entity includes one or more Directory Records, which in turn may each reference a lower level Directory Entity.

Directory Records serve to reference objects stored in the Files of the File-set. The organization of the Directory is depicted by the Basic Directory IOD entity/relationship model presented in Figure F.2-1.

Each Directory Record, irrespective of the Directory Entity it is included in, contains four types of information:

1. A reference to a lower level Directory Entity or Referenced Directory Entity. This reference may be absent if such a lower level Directory Entity does not exist for an instance of a directory record;

2. A reference to a File of the File-set in which is stored a "Referenced Object" (formally called in DICOM a Referenced SOP Instance). This reference may be absent if no File is referenced. Files may be referenced directly by their File ID;

3. A set of "selection keys," specific to a Referenced Object, which will allow its selection among all the records included in a given Directory Entity;

4. A mechanism to chain the various Directory Records that belong to the same Directory Entity.

This generic content of a Directory Record is further specialized based on its specific type in the context the Basic Directory IOD Information Model specified in Section F.4 (e.g., a Study Record, a Series Record, etc.). A Directory Entity may include Directory Records of different Types. By standardizing a number of specific Directory Records (see Section F.5) in the context of the Basic Directory IOD Information Model, one allows the definition of a variety of directory contents while maintaining a framework for interoperability.

Figure F.2-1. Basic Directory Information Object E-R Model

To facilitate the management and update of the Directory Information a number of rules are defined:

1. Any Lower-Level Directory Entity shall be referenced by at most one higher-level Directory Record. Not allowing multiple higher-level Directory Records to reference the same Lower-Level Directory Entity simplifies the management of the deletion (or inactivation) of Directory Records and Lower-Level Directory Entities and associated Directory Records

2. Any Directory Record shall belong to a single Directory Entity. This rule and the above rule, makes the Basic Directory IOD itself strictly hierarchical

3. All files referenced by a Directory shall be present in the same File-Set to which the directory belongs

4. Non-DICOM files that are not referenced by the Directory may be included in the File-set space. The means of access to such Files and the semantics associated with their absence from the Directory is beyond the scope of the DICOM Standard

5. If a DICOMDIR contains a Directory Information Module, all DICOM Files of the File-set shall be referenced by a Directory Record

6. Any File of the File-set shall be directly referenced by at most one Directory Record of the Directory.

### Note

Referenced Files may contain SOP Instances of SOP Classes that provide the means to reference by UIDs other SOP Instances that may not be stored in files of the same File-set.

### F.2.2 Example of A Directory

The example provided in this Section is only one simple example of a possible directory content and organization. This Section is not normative in nature. Therefore, this example is not meant to specify a conformant directory nor to restrict the range of possible directory organizations supported by this Part of the DICOM Standard.

The overall organization is illustrated at a logical level in Section F.2.2.1. The actual structure of the content is discussed in Section F.2.2.2. Annex A “Example of DICOMDIR File Content (Informative)” in PS3.10 depicts further details of the encoding of the file content.

#### F.2.2.1 Illustration of the Overall Directory Organization

A simple directory content is used as an example of Directory organization. It is depicted by Figure F.2-2. The left hand side part of Figure F.2-2 depicts the various Objects stored in Files of the File-set. The right hand side presents an example of organization of the directory that facilitates access to the Files of the File-set.

This example shows how stored Files are referenced by Directory Records that are grouped into Directory Entities. The two Study Directory Records (Study 1 and Study 2) are part of the Directory Entity relative to the Patient A.

Thin curved lines depict the referencing mechanism based on File IDs that allow reference to Files containing stored objects. Thick curved lines depict the internal referencing mechanisms that support the reference to a lower-level Directory Entity by a Directory Record,.

Keys that are used to select a specific Directory Record from among the Directory Records of a Directory Entity are not shown on Figure F.2-2.

One may note in this example that certain Directory Records such as the Series Directory Records do not reference Files containing stored objects. Other Directory Records such as the Image Directory Records do not reference lower level Directory Entities. However, a number of Directory Records reference both one lower level Directory Entity and one File containing a stored object. This flexibility allows the definition of a variety of directories.

Figure F.2-2. Example of a Directory Organization and Content

#### F.2.2.2 Example of a DICOMDIR File Structure

Based on the example discussed in Section F.2.2.1, the internal data structure used by the Basic Directory IOD is depicted in Figure F.2-3. It shows a set of Directory Records where each Directory Record is linked by three different types of "referencing" mechanisms:

1. The chaining of Directory Records to form a Directory Entity. In particular, this facilitates the addition of new Directory Records at the level of any Directory Entity by placing them at the end of the DICOMDIR File. On Figure F.2-3, this chaining is shown by yellow lines:

   1. #1 shows the chaining of the Directory Records forming the root Directory Entity

   2. #2 shows the chaining of the Directory Records for the Directory Entity related to Patient A

   3. #3 shows the chaining of the Directory Records for the Directory Entity related to Study 1

   4. #4 shows the chaining of the Directory Records for the Directory Entity related to Series 1

2. Green lines depict the reference by a Directory Record to a lower level Directory Entity

3. Blue lines depict the reference by a Directory Record to a stored file containing a SOP Class

This example of a DICOMDIR File structure shows one example of a specific order of the Directory Records. Other orderings of Directory Records could result in a functionally equivalent directory.

Figure F.2-3. Example of Data Structure for the DICOM Directory Information

Prev | Up | Next
F Basic Directory Information Object Definition (Normative) | Home | F.3 Basic Directory IOD