Obtenir des cadres d'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 des cadres d'instance DICOM depuis HealthImaging

Utilisez cette GetDICOMInstanceFrames action pour récupérer des images uniques ou par lots (multipartdemande) à partir d'une instance DICOM dans un magasin de HealthImaging données en spécifiant l'UID de série, l'UID d'étude, l'instance UIDs et les numéros de trame associés à une ressource. Vous pouvez spécifier le jeu d'images à partir duquel les images d'instance doivent être extraites en fournissant l'ID du jeu d'images en tant que paramètre de requête. L'API ne renvoie que les images d'instance provenant des ensembles d'images principaux, sauf si le paramètre optionnel d'ensemble d'images est fourni. Vous pouvez récupérer n'importe quel cadre d'instance (à partir d'ensembles d'images principaux ou non principaux) dans le magasin de données en le spécifiant en imageSetId tant que 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 des cadres d'instance DICOM () multipart

  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. Déterminez les images à récupérer à partir des métadonnées associées pour former le frameList paramètre. Le frameList paramètre se présente sous la forme d'une liste séparée par des virgules d'un ou plusieurs numéros de Images non dupliqués, dans n'importe quel ordre. Par exemple, le premier cadre d'image des métadonnées sera le cadre 1.

    • Demande d'image unique : /frames/1

    • Demande multitrame : /frames/1,2,3,4

  4. Créez une URL pour la demande en utilisant les valeurs pour datastoreIdstudyInstanceUID,seriesInstanceUID,sopInstanceUID,imageSetId, etframeList. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier. L'URL se présente sous la forme :

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

  5. Préparez et envoyez votre demande. GetDICOMInstanceFramesutilise 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 des cadres d'image dans une multipart réponse 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/frames/1?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: multipart/related; type=application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1'
    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 le format HealthImaging 1.2.840.10008.1.2.4.202

    • 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 sous le HealthImaging nom 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 le format 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.