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.
Topics
Supported SOP classes
With AWS HealthImaging, you can import DICOM P10 Service-Object Pair (SOP) instances encoded with any SOP class UID,
including retired
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 | PatientName | (0010,0010) | min: 0, max: 256 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMPatientId | PatientID | (0010,0020) | min: 0, max: 256 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMPatientBirthDate | PatientBirthDate | (0010,0030) | min: 0, max: 18 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMPatientSex | PatientSex | (0010,0040) | min: 0, max: 16 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMStudyInstanceUID | StudyInstanceUID | (0020,000D) | min: 0, max: 256 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMStudyId | StudyID | (0020,0010) | min: 0, max: 16 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMStudyDescription | StudyDescription | (0008,1030) | min: 0, max: 64 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMNumberOfStudy RelatedSeries | NumberOfStudyRelatedSeries | (0020,1206) | min: 0, max: 1,000,000 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DICOMNumberOfStudy RelatedInstances | NumberOfStudyRelated Instances | (0020,1208) | min: 0, max: 10,000 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
andremovableAttributes
-
Cannot update the following AWS HealthImaging generated attributes:
SchemaVersion
,DatastoreID
,ImageSetID
,PixelData
,Checksum
,Width
,Height
,MinPixelValue
,MaxPixelValue
,FrameSizeInBytes
-
Cannot update the following DICOM attributes unless the
force
flag is set:Tag.PixelData
,Tag.StudyInstanceUID
,Tag.SeriesInstanceUID
,Tag.SOPInstanceUID
,Tag.StudyID
-
Cannot update attributes with VR type SQ (nested attributes) unless the
force
flag is set -
Cannot update multivalued attributes unless the
force
flag is set -
Cannot update attributes with values that are not compatible with the attribute VR type unless the
force
flag is set -
Cannot update attributes which are not considered valid attributes according to the DICOM standard unless the
force
flag is set -
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 aseriesInstanceUID
if the Series withseriesInstanceUID
is not present in existing image set metadata.