# DICOM data model

DICOM defines its own model to map relevant entities from the real world. That model, as [defined in Part 3 of the standard](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/chapter_7.html), is shown in the figure below.

{% hint style="warning" %}
The DICOM data model is implicit, and is not defined in a machine-readable structured form by the standard!
{% endhint %}

![DICOM model of the real world](/files/-MFfFpSnvYc78nwjs7-v)

DICOM data model entities do not always map to DICOM objects! In fact, every DICOM object you will ever encounter in IDC will contain attributes describing various properties of the entries at different levels of the real world data model. Such objects are called *Composite* Information Objects. The [information model](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/chapter_A.html) of the Composite Information Object Definitions is shown below, and covers all of the composite objects defined by the standard.

![DICOM Composite Instance IOD Information Model](/files/-MFflAlswuIUkMF-CiEU)

As can be observed from this diagram, *"each Composite Instance IOD \[Entity-Relationship] Model requires that all Composite Instances that are part of a specific Study shall share the same context. That is, all Composite Instances within a specific Patient Study share the same Patient and Study information; all Composite Instances within the same Series share the same Series information; etc."* ([ref](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/chapter_A.html)).

Each of the boxes in the diagram above corresponds to *Information Entities (IEs)*, which in turn are composed from *Information Modules*. Information Modules group attributes that are related. As an example, [Patient IE included in the MR object](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.4.3.html) will include [Patient Information Module](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_C.7.html#sect_C.7.1.1), which in turn will include such attributes as PatientID, PatientName, and PatientSex.

{% hint style="info" %}
To recap, individual files in IDC buckets are *instances* of DICOM composite objects. The specific type of object is defined by the`SOPClassUID.`Metadata included in a given object is captured by the *Information Object Definition* as a list of *Information Entities*. Object definition also contains the list of specific Information Modules for the individual IEs. Note that modules included in a given IE are object-specific, while list of attributes included in a given *Information Module* is fixed!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.canceridc.dev/dicom/data-model.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
