F.2.3 DICOM JSON Value Representation

F.2.3 DICOM JSON Value Representation (Current)
Prev	F.2 DICOM JSON Model	Next

The DICOM Value Representation (VR) is included in each DICOM JSON Model attribute object and named "vr". For example:

"vr": "CS"

The JSON encoding of an Attribute shall use the JSON Data Type corresponding to the DICOM Value Representations in Table F.2.3-1. The JSON encodings shall conform to the Definition, Character Repertoire (if applicable) and Length of Value specified for that DICOM Value Representation (see Section 6.2 “Value Representation (VR)” in PS3.5 ) with the following exceptions:

Attributes with a Value Representation of AT shall be restricted to eight character uppercase hexadecimal representation of a DICOM Tag

Table F.2.3-1. DICOM VR to JSON Data Type Mapping

VR Name	Type	JSON Data Type
AE	Application Entity	String
AS	Age String	String
AT	Attribute Tag	String
CS	Code String	String
DA	Date	String
DS	Decimal String	Number or String See note.
DT	Date Time	String
FL	Floating Point Single	Number
FD	Floating Point Double	Number
IS	Integer String	Number or String See note.
LO	Long String	String
LT	Long Text	String
OB	Other Byte	Base64 encoded octet-stream
OD	Other Double	Base64 encoded octet-stream
OF	Other Float	Base64 encoded octet-stream
OL	Other Long	Base64 encoded octet-stream
OV	Other 64-bit Very Long	Base64 encoded octet-stream
OW	Other Word	Base64 encoded octet-stream
PN	Person Name	Object containing Person Name component groups as strings (see Section F.2.2)
SH	Short String	String
SL	Signed Long	Number
SQ	Sequence of Items	Array containing DICOM JSON Objects
SS	Signed Short	Number
ST	Short Text	String
SV	Signed 64-bit Very Long	Number or String See Note.
TM	Time	String
UC	Unlimited Characters	String
UI	Unique Identifier (UID)	String
UL	Unsigned Long	Number
UN	Unknown	Base64 encoded octet-stream
UR	Universal Resource Identifier or Universal Resource Locator (URI/URL)	String
US	Unsigned Short	Number
UT	Unlimited Text	String
UV	Unsigned 64-bit Very Long	Number or String. See Note.

Note

For IS, DS, SV and UV, a JSON String representation can be used to preserve the original format during transformation of the representation, or if needed to avoid losing precision of a decimal string.

Although data, such as dates, are represented in the DICOM JSON model as strings, it is expected that they will be treated in the same manner as the original attribute as defined by Chapter 6 in PS3.6 .

Prev	Up	Next
F.2.2 DICOM JSON Model Object Structure	Home	F.2.4 DICOM JSON Value Multiplicity