F.2.2 DICOM JSON Model Object Structure

F.2.2 DICOM JSON Model Object Structure (Current)
Prev	F.2 DICOM JSON Model	Next

The DICOM JSON Model object is a representation of a DICOM Data Set.

The internal structure of the DICOM JSON Model object is a sequence of objects representing attributes within the DICOM Data Set.

Attribute objects within a DICOM JSON Model object shall be ordered by their property name in ascending lexicographic (alphabetic) order.

Group Length (gggg,0000) attributes shall not be included in a DICOM JSON Model object.

The name of each attribute object is:

Each attribute object contains the following named child objects:

vr: A string encoding the DICOM Value Representation. The mapping between DICOM Value Representations and JSON Value Representations is described in Section F.2.3.
At most one of:
- Value: An array containing one of:
  - The Value Field elements of a DICOM attribute with a VR other than PN, SQ, OB, OD, OF, OL, OV, OW, or UN (described in Section F.2.4)
    
    The encoding of empty Value Field elements is described in Section F.2.5
  - The Value Field elements of a DICOM attribute with a VR of PN. The non-empty name components of each element are encoded as a JSON strings with the following names:
    
    Alphabetic
    
    Ideographic
    
    Phonetic
  - JSON DICOM Model objects corresponding to the sequence items of an attribute with a VR of SQ
    
    Empty sequence items are represented by empty objects
- BulkDataURI: A string encoding the WADO-RS URL of a Bulk Data Value describing the Value Field of an enclosing Attribute with a VR of DS, FL, FD, IS, LT, OB, OD, OF, OL, OV, OW, SL, SS, ST, SV, UC, UL, UN, US, UT or UV (described in Section F.2.6)
- InlineBinary: A base64 string encoding the Value Field of an enclosing Attribute with a VR of OB, OD, OF, OL, OV, OW, or UN (described in Section F.2.7)

For Private Data Elements, the group and element numbers will follow the rules specified in Section 7.8.1 in PS3.5
The person name representation is more closely aligned with the DICOM Data Element representation than the DICOM PS3.19 XML representation.
The attribute Specific Character Set (0008,0005), if present, reflects the character encoding of the source DICOM dataset and does not indicate the character encoding of the JSON representation, which is UTF-8 per [RFC8259]. This attribute is preserved as Metadata and may be used to reconstruct the source binary DICOM encoding. See Section C.12.1.1.2 in PS3.3 for further details.
When translating BulkData with character set dependent VRs (SH, LO, ST, PN, LT, UC or UT) to JSON representation, the encoding will be UTF-8, as specified in [RFC8259]. For InlineBinary and BulkData with VR of UN, the source byte encoding is preserved without character set translation.
If InlineBinary or BulkData with VR of UN is interpreted as containing character string content, the Specific Character Set (0008,0005) of the source DICOM dataset is used to determine the character encoding.