Ottenere frame di istanze DICOM da HealthImaging - AWS HealthImaging

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ottenere frame di istanze DICOM da HealthImaging

Usa l'GetDICOMInstanceFramesazione per recuperare frame di immagini singoli o in batch (multipartrichiesta) da un'istanza DICOM in un HealthImaging data store specificando l'UID della serie, l'UID dello studio, l'istanza e i numeri di frame associati a una UIDs risorsa. È possibile specificare il set di immagini da cui recuperare i frame dell'istanza fornendo l'ID del set di immagini come parametro di interrogazione. L'API restituirà solo frame di istanza dai set di immagini primari, a meno che non venga fornito il parametro opzionale del set di immagini. È possibile recuperare qualsiasi frame di istanza (da set di immagini primari o non primari) nel data store specificandolo imageSetId come parametro di query.

I dati DICOM possono essere recuperati nella sintassi di trasferimento memorizzata o in formato non compresso (ELE).

Per ottenere i frame delle istanze DICOM () multipart

  1. Raccogli HealthImaging datastoreId e imageSetId parametra i valori.

  2. Utilizzate l'GetImageSetMetadataazione con i valori imageSetId dei parametri datastoreId e per recuperare i valori dei metadati associati per studyInstanceUIDseriesInstanceUID, e. sopInstanceUID Per ulteriori informazioni, consulta Ottenere i metadati del set di immagini.

  3. Determinate i fotogrammi dell'immagine da recuperare dai metadati associati per formare il parametro. frameList Il frameList parametro è un elenco separato da virgole di uno o più numeri di frame non duplicati, in qualsiasi ordine. Ad esempio, il primo frame dell'immagine nei metadati sarà il frame 1.

    • Richiesta a frame singolo: /frames/1

    • Richiesta multi-frame: /frames/1,2,3,4

  4. Costruisci un URL per la richiesta utilizzando i valori perdatastoreId,,studyInstanceUID, seriesInstanceUID sopInstanceUIDimageSetId, e. frameList Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante Copia. L'URL ha il seguente formato:

    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. Prepara e invia la tua richiesta. GetDICOMInstanceFramesutilizza una richiesta HTTP GET con protocollo di AWS firma Signature Version 4. Il seguente esempio di codice utilizza lo strumento da riga di curl comando per ottenere frame di immagini in una multipart risposta da 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'
    Nota

    L'transfer-syntaxUID è facoltativo e il valore predefinito è Explicit VR Little Endian se non è incluso. Se la transcodifica in ELE non è possibile (a causa dell'importazione con avviso), i pixel verranno restituiti senza transcodifica. Le sintassi di trasferimento supportate includono:

    • Explicit VR Little Endian (ELE) - 1.2.840.10008.1.2.1 (impostazione predefinita per fotogrammi di immagini senza perdita di dati)

    • In transfer-syntax=* tal caso, i fotogrammi dell'immagine verranno restituiti nella sintassi di trasferimento memorizzata.

    • JPEG 2000 ad alta produttività con RPCL Options Image Compression (solo senza perdita di dati) - 1.2.840.10008.1.2.4.202 - se l'istanza è archiviata in HealthImaging 1.2.840.10008.1.2.4.202

    • JPEG 2000 Lossless - 1.2.840.10008.1.2.4.90 - se l'istanza è archiviata come lossless. HealthImaging

    • JPEG Baseline (Process 1): sintassi di trasferimento predefinita per la compressione di immagini JPEG a 8 bit con perdita di dati - 1.2.840.10008.1.2.4.50 - se l'istanza è memorizzata in HealthImaging 1.2.840.10008.1.2.4.50

    • Compressione delle immagini JPEG 2000 - 1.2.840.10008.1.2.4.91 - se l'istanza è archiviata in HealthImaging 1.2.840.10008.1.2.4.91

    • Compressione delle immagini JPEG 2000 ad alta produttività - 1.2.840.10008.1.2.4.203 - se l'istanza è archiviata in HealthImaging 1.2.840.10008.1.2.4.203

    • Compressione dell'immagine JPEG XL - 1.2.840.10008.1.2.4.112 - se l'istanza è archiviata in HealthImaging 1.2.840.10008.1.2.4.112

    • Le istanze HealthImaging archiviate in uno o più frame di immagine codificati nella famiglia di sintassi di trasferimento MPEG (che include MPEG2 MPEG-4 AVC/H.264 and HEVC/H .265) possono essere recuperate con il corrispondente UID della sintassi di trasferimento. Ad esempio, se l'istanza è archiviata come Main Profile Main Level. 1.2.840.10008.1.2.4.100 MPEG2

    • È possibile ricevere un 406 NotAcceptableException se la sintassi di trasferimento richiesta non può essere restituita in base alla sintassi di trasferimento memorizzata o se sono presenti avvisi di elaborazione specifici per l'istanza. In tal caso, riprova la chiamata con. transfer-syntax=*

    Per ulteriori informazioni, consultare Sintassi di trasferimento supportate e Librerie di decodifica di frame di immagini per AWS HealthImaging.