DICOM support for AWS HealthImaging - AWS HealthImaging
Supported SOP classesMetadata normalizationSupported transfer syntaxesDICOM element constraintsDICOM metadata constraints

DICOM support for AWS HealthImaging

AWS HealthImaging supports specific DICOM elements and transfer syntaxes. Familiarize yourself with the supported Patient, Study, and Series level DICOM data elements, as HealthImaging metadata keys are based on them. Before you start an import, verify that your medical imaging data is compliant with HealthImaging's supported transfer syntaxes and DICOM element constraints.

Note

AWS HealthImaging does not currently support Binary Segmentation Images or Icon Image Sequence pixel data.

Supported SOP classes

With AWS HealthImaging, you can import DICOM P10 Service-Object Pair (SOP) instances encoded with any SOP class UID, including retired and private. All private attributes are preserved, as well.

Metadata normalization

When you import your DICOM P10 data into AWS HealthImaging, it is transformed into image sets that are comprised of metadata and image frames (pixel data). During the transformation process, HealthImaging metadata keys are generated based on a specific version of the DICOM standard. HealthImaging currently generates and supports metadata keys based on the DICOM PS3.6 2022b Data Dictionary.

AWS HealthImaging supports the following DICOM data elements at the Patient, Study, and Series levels.

Note

For a detailed description of each Patient level element, see the Registry of DICOM Data Elements.

AWS HealthImaging supports the following Patient level elements:

Patient Module Elements

  (0010,0010) - Patient's Name
  (0010,0020) - Patient ID

Issuer of Patient ID Macro Elements

  (0010,0021) - Issuer of Patient ID
  (0010,0024) - Issuer of Patient ID Qualifiers Sequence
  (0010,0022) - Type of Patient ID
  (0010,0030) - Patient's Birth Date
  (0010,0033) - Patient's Birth Date in Alternative Calendar
  (0010,0034) - Patient's Death Date in Alternative Calendar
  (0010,0035) - Patient's Alternative Calendar Attribute
  (0010,0040) - Patient's Sex
  (0010,1100) - Referenced Patient Photo Sequence
  (0010,0200) - Quality Control Subject
  (0008,1120) - Referenced Patient Sequence
  (0010,0032) - Patient's Birth Time
  (0010,1002) - Other Patient IDs Sequence
  (0010,1001) - Other Patient Names
  (0010,2160) - Ethnic Group
  (0010,4000) - Patient Comments
  (0010,2201) - Patient Species Description
  (0010,2202) - Patient Species Code Sequence Attribute
  (0010,2292) - Patient Breed Description
  (0010,2293) - Patient Breed Code Sequence
  (0010,2294) - Breed Registration Sequence Attribute
  (0010,0212) - Strain Description
  (0010,0213) - Strain Nomenclature Attribute
  (0010,0219) - Strain Code Sequence
  (0010,0218) - Strain Additional Information Attribute
  (0010,0216) - Strain Stock Sequence
  (0010,0221) - Genetic Modifications Sequence Attribute
  (0010,2297) - Responsible Person
  (0010,2298) - Responsible Person Role Attribute
  (0010,2299) - Responsible Organization
  (0012,0062) - Patient Identity Removed
  (0012,0063) - De-identification Method
  (0012,0064) - De-identification Method Code Sequence

Patient Group Macro Elements

  (0010,0026) - Source Patient Group Identification Sequence
  (0010,0027) - Group of Patients Identification Sequence

Clinical Trial Subject Module

  (0012,0010) - Clinical Trial Sponsor Name
  (0012,0020) - Clinical Trial Protocol ID
  (0012,0021) - Clinical Trial Protocol Name Attribute
  (0012,0030) - Clinical Trial Site ID
  (0012,0031) - Clinical Trial Site Name
  (0012,0040) - Clinical Trial Subject ID
  (0012,0042) - Clinical Trial Subject Reading ID
  (0012,0081) - Clinical Trial Protocol Ethics Committee Name
  (0012,0082) - Clinical Trial Protocol Ethics Committee Approval Number
Note

For a detailed description of each Study level element, see the Registry of DICOM Data Elements.

AWS HealthImaging supports the following Study level elements:

General Study Module

  (0020,000D) - Study Instance UID
  (0008,0020) - Study Date
  (0008,0030) - Study Time
  (0008,0090) - Referring Physician's Name
  (0008,0096) - Referring Physician Identification Sequence
  (0008,009C) - Consulting Physician's Name
  (0008,009D) - Consulting Physician Identification Sequence
  (0020,0010) - Study ID
  (0008,0050) - Accession Number
  (0008,0051) - Issuer of Accession Number Sequence
  (0008,1030) - Study Description
  (0008,1048) - Physician(s) of Record
  (0008,1049) - Physician(s) of Record Identification Sequence
  (0008,1060) - Name of Physician(s) Reading Study
  (0008,1062) - Physician(s) Reading Study Identification Sequence
  (0032,1033) - Requesting Service
  (0032,1034) - Requesting Service Code Sequence
  (0008,1110) - Referenced Study Sequence
  (0008,1032) - Procedure Code Sequence
  (0040,1012) - Reason For Performed Procedure Code Sequence

Patient Study Module

  (0008,1080) - Admitting Diagnoses Description
  (0008,1084) - Admitting Diagnoses Code Sequence
  (0010,1010) - Patient's Age
  (0010,1020) - Patient's Size
  (0010,1030) - Patient's Weight
  (0010,1022) - Patient's Body Mass Index
  (0010,1023) - Measured AP Dimension
  (0010,1024) - Measured Lateral Dimension
  (0010,1021) - Patient's Size Code Sequence
  (0010,2000) - Medical Alerts
  (0010,2110) - Allergies
  (0010,21A0) - Smoking Status
  (0010,21C0) - Pregnancy Status
  (0010,21D0) - Last Menstrual Date
  (0038,0500) - Patient State
  (0010,2180) - Occupation
  (0010,21B0) - Additional Patient History
  (0038,0010) - Admission ID
  (0038,0014) - Issuer of Admission ID Sequence
  (0032,1066) - Reason for Visit
  (0032,1067) - Reason for Visit Code Sequence
  (0038,0060) - Service Episode ID
  (0038,0064) - Issuer of Service Episode ID Sequence
  (0038,0062) - Service Episode Description
  (0010,2203) - Patient's Sex Neutered

Clinical Trial Study Module

  (0012,0050) - Clinical Trial Time Point ID
  (0012,0051) - Clinical Trial Time Point Description
  (0012,0052) - Longitudinal Temporal Offset from Event
  (0012,0053) - Longitudinal Temporal Event Type
  (0012,0083) - Consent for Clinical Trial Use Sequence
Note

For a detailed description of each Series level element, see the Registry of DICOM Data Elements.

AWS HealthImaging supports the following Series level elements:

General Series Module

  (0008,0060) - Modality
  (0020,000E) - Series Instance UID
  (0020,0011) - Series Number
  (0020,0060) - Laterality
  (0008,0021) - Series Date
  (0008,0031) - Series Time
  (0008,1050) - Performing Physician's Name
  (0008,1052) - Performing Physician Identification Sequence
  (0018,1030) - Protocol Name
  (0008,103E) - Series Description
  (0008,103F) - Series Description Code Sequence
  (0008,1070) - Operators' Name
  (0008,1072) - Operator Identification Sequence
  (0008,1111) - Referenced Performed Procedure Step Sequence
  (0008,1250) - Related Series Sequence
  (0018,0015) - Body Part Examined
  (0018,5100) - Patient Position
  (0028,0108) - Smallest Pixel Value in Series
  (0028,0109) - Largest Pixel Value in Series
  (0040,0275) - Request Attributes Sequence
  (0010,2210) - Anatomical Orientation Type
  (300A,0700) - Treatment Session UID

Clinical Trial Series Module

  (0012,0060) - Clinical Trial Coordinating Center Name
  (0012,0071) - Clinical Trial Series ID
  (0012,0072) - Clinical Trial Series Description

General Equipment Module

  (0008,0070) - Manufacturer
  (0008,0080) - Institution Name
  (0008,0081) - Institution Address
  (0008,1010) - Station Name
  (0008,1040) - Institutional Department Name
  (0008,1041) - Institutional Department Type Code Sequence
  (0008,1090) - Manufacturer's Model Name
  (0018,100B) - Manufacturer's Device Class UID
  (0018,1000) - Device Serial Number
  (0018,1020) - Software Versions
  (0018,1008) - Gantry ID
  (0018,100A) - UDI Sequence
  (0018,1002) - Device UID
  (0018,1050) - Spatial Resolution
  (0018,1200) - Date of Last Calibration
  (0018,1201) - Time of Last Calibration
  (0028,0120) - Pixel Padding Value

Frame of Reference Module

  (0020,0052) - Frame of Reference UID
  (0020,1040) - Position Reference Indicator

Supported transfer syntaxes

AWS HealthImaging imports DICOM P10 SOP instances encoded with the transfer syntaxes located in the following table. In addition to storage of the SOP instance, HealthImaging transcodes image frames (pixel data) to HTJ2K for SOP instances encoded with the following transfer syntaxes:

Transfer syntax UID Transfer syntax name
1.2.840.10008.1.2 Implicit VR Endian: Default Transfer Syntax for DICOM
1.2.840.10008.1.2.1 Explicit VR Little Endian
1.2.840.10008.1.2.1.99 Deflated Explicit VR Little Endian
1.2.840.10008.1.2.2 Explicit VR Big Endian
1.2.840.10008.1.2.4.50 JPEG Baseline (Process 1): Default Transfer Syntax for Lossy JPEG 8-bit Image Compression
1.2.840.10008.1.2.4.51 JPEG Baseline (Processes 2 & 4): Default Transfer Syntax for Lossy JPEG 12-bit Image Compression (Process 4 only)
1.2.840.10008.1.2.4.57 JPEG Lossless Non-Hierarchical (Process 14)
1.2.840.10008.1.2.4.70 JPEG Lossless, Nonhierarchical, First- Order Prediction (Processes 14 [Selection Value 1]): Default Transfer Syntax for Lossless JPEG Image Compression
1.2.840.10008.1.2.4.80 JPEG-LS Lossless Image Compression
1.2.840.10008.1.2.4.81 JPEG-LS Lossy (Near-Lossless) Image Compression
1.2.840.10008.1.2.4.90 JPEG 2000 Image Compression (Lossless Only)
1.2.840.10008.1.2.4.91 JPEG 2000 Image Compression
1.2.840.10008.1.2.4.201 High-Throughput JPEG 2000 Image Compression (Lossless Only)
1.2.840.10008.1.2.4.202 High-Throughput JPEG 2000 with RPCL Options Image Compression (Lossless Only)
1.2.840.10008.1.2.4.203 High-Throughput JPEG 2000 Image Compression
1.2.840.10008.1.2.5 RLE Lossless

DICOM element constraints

When importing your medical imaging data into AWS HealthImaging, max length constraints are applied to the following DICOM elements. To achieve a successful import, ensure that your data does not exceed the max length constraints.

DICOM element constraints during import
HealthImaging keyword DICOM keyword DICOM key Length limit
DICOMPatientName Patient​Name (0010,0010) min: 0, max: 256
DICOMPatient​Id Patient​ID (0010,0020) min: 0, max: 256
DICOMPatientBirthDate Patient​BirthDate (0010,0030) min: 0, max: 18
DICOMPatientSex PatientSex (0010,0040) min: 0, max: 16
DICOMStudyInstanceUID StudyInstanceUID (0020,000D) min: 0, max: 64
DICOMStudyId StudyID (0020,0010) min: 0, max: 16
DICOMStudyDescription StudyDescription (0008,1030) min: 0, max: 64
DICOMNumberOfStudy RelatedSeries Number​Of​Study​Related​Series (0020,1206) min: 0, max: 10000
DICOMNumberOfStudy RelatedInstances NumberOfStudyRelated Instances (0020,1208) min: 0, max: 10000
DICOMAccessionNumber AccessionNumber (0008,0050) min: 0, max: 256
DICOMStudyDate StudyDate (0008,0020) min: 0, max: 18
DICOMStudyTime StudyTime (0008,0030) min: 0, max: 28

DICOM metadata constraints

When you use UpdateImageSetMetadata to update HealthImaging metadata attributes, the following DICOM constraints are applied.

  • Cannot update or remove private attributes on Patient/Study/Series/Instance level attributes unless the update constraint applies to both updatableAttributes and removableAttributes

  • Cannot update the following AWS HealthImaging generated attributes: SchemaVersion, DatastoreID, ImageSetID, PixelData, Checksum, Width, Height, MinPixelValue, MaxPixelValue, FrameSizeInBytes

  • Cannot update the following DICOM attributes: Tag.PixelData, Tag.StudyInstanceUID, Tag.SeriesInstanceUID, Tag.SOPInstanceUID, Tag.StudyID

  • Cannot update attributes with VR type SQ (nested attributes)

  • Cannot update multivalued attributes

  • Cannot update attributes with values that are not compatible with the attribute VR type

  • Cannot update attributes which are not considered valid attributes according to the DICOM standard

  • Cannot update attributes across modules. For example, if a Patient level attribute is given at the Study level in customer payload request, the request can be invalidated.

  • Cannot update attributes if the associated attribute module is not present in existing ImageSetMetadata. For example, you are not allowed to update attributes for a seriesInstanceUID if the Series with seriesInstanceUID is not present in existing image set metadata.