Obtenir une instance DICOM depuis HealthImaging - AWS HealthImaging

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Obtenir une instance DICOM depuis HealthImaging

Utilisez cette GetDICOMInstance action pour récupérer une instance DICOM (.dcmfichier) d'un magasin de HealthImaging données en spécifiant la série, l'étude et l'instance UIDs associées à la ressource. L'API ne renvoie que les instances des ensembles d'images principaux, sauf si le paramètre optionnel d'ensemble d'images est fourni. Vous pouvez récupérer n'importe quelle instance (à partir d'ensembles d'images principaux ou non principaux) dans le magasin de données en spécifiant le imageSetId comme paramètre de requête. Les données DICOM peuvent être récupérées soit dans leur syntaxe de transfert enregistrée, soit au format non compressé (ELE).

Pour obtenir une instance DICOM () .dcm

  1. Collectez HealthImaging datastoreId et imageSetId paramétrez les valeurs.

  2. Utilisez l'GetImageSetMetadataaction avec les valeurs datastoreId des imageSetId paramètres et pour récupérer les valeurs de métadonnées associées pour studyInstanceUIDseriesInstanceUID, etsopInstanceUID. Pour de plus amples informations, veuillez consulter Obtenir les métadonnées d'un ensemble d'images.

  3. Créez une URL pour la demande en utilisant les valeurs pour datastoreIdstudyInstanceUID,seriesInstanceUID,sopInstanceUID, etimageSetId. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier. L'URL est de la forme suivante :

    GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid?imageSetId=image-set-id

  4. Préparez et envoyez votre demande. GetDICOMInstanceutilise une requête HTTP GET avec le protocole de AWS signature Signature Version 4. L'exemple de code suivant utilise l'outil de ligne de curl commande pour obtenir une instance DICOM (.dcmfichier) à partir de HealthImaging.

    Shell
    curl --request GET \
  'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457?imageSetId=459e50687f121185f747b67bb60d1bc8' \
  --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/dicom; transfer-syntax=1.2.840.10008.1.2.1' \
  --output 'dicom-instance.dcm'
    Note

    L'transfer-syntaxUID est facultatif et est défini par défaut sur Explicit VR Little Endian s'il n'est pas inclus. Les syntaxes de transfert prises en charge incluent :

    • Explicit VR Little Endian (ELE) - 1.2.840.10008.1.2.1 (par défaut pour les images sans perte)

    • JPEG 2000 à haut débit avec options RPCL Compression d'image (sans perte uniquement) - 1.2.840.10008.1.2.4.202 - si l'instance est stockée sous HealthImaging 1.2.840.10008.1.2.4.202

    • JPEG 2000 Lossless - 1.2.840.10008.1.2.4.90 - si l'instance est stockée HealthImaging sous forme sans perte.

    • Base de référence JPEG (processus 1) : syntaxe de transfert par défaut pour la compression d'image JPEG 8 bits avec perte - 1.2.840.10008.1.2.4.50 - si l'instance est stockée sous HealthImaging 1.2.840.10008.1.2.4.50

    • Compression d'image JPEG 2000 1.2.840.10008.1.2.4.91 - - si l'instance est stockée HealthImaging sous 1.2.840.10008.1.2.4.91

    • Compression d'image JPEG 2000 à haut débit - 1.2.840.10008.1.2.4.203 - si l'instance est stockée sous HealthImaging 1.2.840.10008.1.2.4.203

    • Les instances stockées HealthImaging avec une ou plusieurs trames d'image codées dans la famille de syntaxes de transfert MPEG (qui inclut MPEG2 le MPEG-4 AVC/H.264 and HEVC/H .265) peuvent être récupérées avec l'UID de syntaxe de transfert correspondant. Par exemple, 1.2.840.10008.1.2.4.100 si l'instance est stockée en tant que niveau MPEG2 principal du profil principal.

    Pour plus d'informations, consultez Syntaxes de transfert prises en charge et HTJ2bibliothèques de décodage K pour AWS HealthImaging.