View a markdown version of this page

Ricerca di dati DICOM in HealthImaging - AWS HealthImaging
API di ricerca DICOMWeb per HealthImagingTipi di query DICOMWeb supportati per HealthImagingUtilizzo IncludeField nelle QIDO-RS interrogazioni

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à.

Ricerca di dati DICOM in HealthImaging

AWS HealthImaging offre rappresentazioni delle QIDO-RS API DICOMWeb per cercare studi, serie e istanze in base all'ID del paziente e ricevere i relativi identificatori univoci per un ulteriore utilizzo. HealthImagingle QIDO-RS API DICOMWeb offrono flessibilità nel modo in cui cerchi i dati archiviati e forniscono l'interoperabilità con le applicazioni legacy. HealthImaging

Importante

HealthImagingle API DICOMWeb possono essere utilizzate per restituire informazioni sul set di immagini con. QIDO-RS HealthImaging Le API DICOMWeb fanno riferimento solo ai set di immagini primari, salvo diversa indicazione. Utilizza le azioni native del HealthImaging cloud o il parametro opzionale del set di immagini delle azioni DICOMWeb per recuperare set di immagini non primari. HealthImagingle API DICOMWeb possono essere utilizzate per restituire informazioni sul set di immagini con risposte. DICOMweb-conformant

HealthImaging QIDO-RS Le azioni DICOMWeb possono restituire un massimo di 10.000 record. Nel caso in cui esistano più di 10.000 risorse, queste non saranno recuperabili tramite QIDO-RS le azioni, ma possono essere recuperate tramite azioni WADO-RS DICOMWeb o azioni native del cloud.

Le API elencate in questa sezione sono integrate in conformità allo standard DICOMWeb () per l'imaging medico basato sul web. QIDO-RS Non sono offerte tramite SDK. AWS CLI AWS

API di ricerca DICOMWeb per HealthImaging

La tabella seguente descrive tutte le HealthImaging rappresentazioni delle QIDO-RS API DICOMWeb disponibili per la ricerca di dati. HealthImaging

HealthImaging rappresentazioni delle API DICOMWeb QIDO-RS
Nome Description
SearchDICOMStudies Cerca gli studi DICOM in specificando gli elementi della query HealthImaging di ricerca utilizzando una richiesta GET. I risultati della ricerca degli studi vengono restituiti in formato JSON, ordinati per ultimo aggiornamento, data decrescente (dalla più recente alla più vecchia). Per informazioni, consulta Cerca studi.
SearchDICOMSeries Cerca le serie DICOM in HealthImaging specificando gli elementi della query di ricerca utilizzando una richiesta GET. I risultati della ricerca delle serie vengono restituiti in formato JSON, ordinati Series Number (0020, 0011) in ordine crescente (dalla più vecchia alla più recente). Per informazioni, consulta Cerca serie.
SearchDICOMInstances Cerca le istanze DICOM in HealthImaging specificando gli elementi della query di ricerca utilizzando una richiesta GET. I risultati della ricerca delle istanze vengono restituiti in formato JSON, ordinati Instance Number (0020, 0013) in ordine crescente (dalla più vecchia alla più recente). Per informazioni, consulta Cerca istanze.

Tipi di query DICOMWeb supportati per HealthImaging

HealthImaging supporta interrogazioni QIDO-RS gerarchiche sulle risorse a livello di studio, serie e istanza SOP. Quando si utilizza QIDO-RS la ricerca gerarchica per: HealthImaging

  • La ricerca di studi restituisce un elenco di studi

  • La ricerca di una serie di studi richiede una serie nota StudyInstanceUID e restituisce un elenco di serie

  • La ricerca in un elenco di istanze richiede un nome noto StudyInstanceUID e SeriesInstanceUID

La tabella seguente descrive i tipi di query QIDO-RS gerarchiche supportati per la ricerca di dati. HealthImaging

HealthImaging tipi di query supportati QIDO-RS
Tipo di query Esempio
interrogazioni sui valori degli attributi

Cerca tutte le serie in uno studio dovemodality=CT.

.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT

Cerca in tutti gli studi in cui l'ID del paziente e la data dello studio corrispondono rispettivamente a questi valori.

…/studies?PatientID=11235813&StudyDate=20130509
Interrogazioni con parole chiave

Cerca tutte le serie utilizzando la SeriesInstanceUID parola chiave.

.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868
Interrogazioni di tag

Cerca i tag utilizzando i parametri di interrogazione passati nel group/element modulo.

{group} {element} come 0020000D
Interrogazioni sull'intervallo

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
Paginazione dei risultati con e limit offset

.../studies?limit=1&offset=0&00080020=20000101

È possibile utilizzare i parametri limit e offset per impaginare le risposte di ricerca. Il valore predefinito del limite è 1000 e vedi il HealthImaging Endpoint e quote AWS valore massimo.

Limite massimo = 1000, offset massimo = 9000
Interrogazioni con Wildcard

Le interrogazioni Wildcard offrono una maggiore flessibilità nella ricerca utilizzando «*» e «?». «*» corrisponde a qualsiasi sequenza di caratteri (incluso un valore di lunghezza zero) e «?» corrisponde a qualsiasi carattere singolo.

Cerca tutti gli studi in un datastore che StudyDescription contiene «Nuclear»:

.../studies?StudyDescription=*Nuclear*

Cerca tutti gli studi che StudyDescription terminano con «Nucleare»:

.../studies?StudyDescription=*Nuclear

Cerca tutti gli studi che StudyDescription iniziano con «Nucleare»:

.../studies?StudyDescription=Nuclear*

Cerca tutti gli studi in cui PatientID ha esattamente 3 caratteri qualsiasi dopo 200965981:

.../studies?PatientID=200965981???
FuzzyMatching domande

Abilita la corrispondenza fuzzy sugli attributi DICOM del nome ((0010,0010), PatientName ReferringPhysicianName (0008,0090)) aggiungendo il parametro di query opzionale fuzzymatching:

.../studies?fuzzymatching=true&PatientName="Thomas^Albert"

Questa query esegue la corrispondenza delle parole del prefisso senza distinzione tra maiuscole e minuscole su qualsiasi parte del valore. PatientName Restituisce risultati con PatientName valori come «thomas», «Albert», «Thomas Albert», «Thomas^Albert», ma non «hom» o «ber».
IncludeField interrogazioni

Utilizzate il parametro includefield query per richiedere attributi DICOM aggiuntivi oltre al set di risposte predefinito.

Restituisce attributi specifici per tag:

.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight

Restituisce tutti gli attributi disponibili:

.../studies?PatientID=11235813&includefield=all

Restituisce gli attributi secondari della sequenza (SQ) utilizzando la notazione punteggiata:

.../studies?PatientID=11235813&includefield=00080096.00080100

Restituisce elementi di dati privati:

.../instances?includefield=00191001&00190010=Philips

Utilizzo IncludeField nelle QIDO-RS interrogazioni

Il parametro includefield query consente di richiedere attributi DICOM aggiuntivi oltre alla risposta predefinita impostata nelle HealthImaging QIDO-RS query. È possibile utilizzarlo includefield a livello di studio, di serie e di istanza.

Sintassi

Utilizza il seguente formato di richiesta GET per includere campi aggiuntivi nelle tue QIDO-RS query:

GET .../studies?<query_params>&includefield=<tag_or_keyword>
GET .../studies/<StudyInstanceUID>/series?<query_params>&includefield=<tag_or_keyword>
GET .../studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances?<query_params>&includefield=<tag_or_keyword>

È possibile specificare più includefield parametri in un'unica richiesta:

GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010

Valori supportati per includefield

La tabella seguente descrive i valori supportati per il includefield parametro.

Valori includefield supportati
Value type (Tipo di valore) Description Esempio
Tag DICOM (8 caratteri esadecimali) Richiedi un attributo DICOM specifico tramite il relativo tag in formato GGGGEEEE. includefield=00081030
all Richiedi tutti gli attributi DICOM disponibili per il livello di risorsa. includefield=all
Percorso SQL punteggiato <parent_tag>Richiedi un attributo secondario specifico all'interno di un attributo Sequence (SQ) utilizzando la notazione a punti:. <child_tag>. includefield=00080096.00080100
Tag con elemento di dati privato Richiedi un tag privato (elemento di gruppo dispari). Richiede il parametro. privateCreatorElement includefield=00191001
Attributi DICOM standard, inclusi bulkdata Richiedi attributi singoli o multipli specifici per tag o parola chiave. includefield=00102201

Comportamento e regole

Le seguenti regole si applicano alle includefield interrogazioni:

  • Risposta predefinita: senzaincludefield, la QIDO-RS risposta restituisce solo il set di attributi standard.

  • includefield=all — Restituisce tutti gli attributi disponibili al livello richiesto. Se combinato con altri all includefield valori, ha la priorità. all

  • Numero massimo di tag: una richiesta può includere fino a 50 includefield parametri.

  • Tag duplicati: includefield i valori duplicati vengono deduplicati e trattati come una singola richiesta.

  • Tag non validi o mancanti: se un tag richiesto non esiste nei dati DICOM o non è valido, viene omesso silenziosamente dalla risposta. Vengono comunque restituiti altri attributi validiincludefield.

Attributi di sequenza (SQ)

Usa la notazione a punti per richiedere attributi annidati all'interno di un attributo Sequence (SQ):

includefield=<parent_SQ_tag>.<child_tag>

Ad esempio, per recuperare CodeValue (0008,0100) all'interno di (0008,0096): ReferringPhysicianIdentificationSequence 

GET .../studies?PatientID=11235813&includefield=00080096.00080100

Multi-level la nidificazione è supportata. Esempio:

includefield=00081115.00081199.00081150

Tag privati

Gli elementi di dati DICOM privati (tag con gruppi dispari) sono supportati a tutti i livelli di risorse. Per richiedere tag privati, includi il privateCreatorElement parametro di query.

Utilizzare la seguente sintassi:

GET .../instances?includefield=<private_tag>&<creator_tag>=<creator_name>

Esempio:

GET .../instances?includefield=00191001&00190010=Philips

Le seguenti regole si applicano ai tag privati:

  • Il privateCreatorElement tag e il nome del creatore devono essere forniti come parametro di corrispondenza se viene richiesto il tag privato.

  • Se il valore specificato non privateCreatorElement viene trovato, il tag privato viene omesso silenziosamente.

  • La richiesta di un solo privateCreatorElement tag senza un elemento di dati privato restituisce solo il nome e il valore dell'elemento creatore. Non restituisce tutti i tag appartenenti al blocco di quel creatore.

Tag Bulkdata

Gli attributi DICOM con VR bulkdata (OB, OD, OF, OL, UN, OW, OV) con valore binario superiore a 1 MB richiesti come parte di includefield vengono restituiti bulkdataURI al posto del valore binario non elaborato. Per ulteriori informazioni sul recupero di bulkdata, vedere Recupero di bulkdata DICOM in. HealthImaging

Cosa restituisce includefield=all a ogni livello?

Quando includefield=all viene specificata, la risposta include tutti gli attributi a livello di risorsa specifico.

Livello di studio (includefield=all)

La tabella seguente elenca tutti gli attributi restituiti a livello di studio quando specificato. includefield=all

Attributi a livello di studio per includefield=all
Tag Nome Realtà virtuale
00080005SpecificCharacterSetCS
00080020StudyDateGIORNO
00080030StudyTimeTM
00080050AccessionNumberSH
00080051IssuerOfAccessionNumberSequenceQUADRATO
00080056InstanceAvailabilityCS
00080061ModalitiesInStudyCS
00080062SOPClassesInStudyInterfaccia utente
00080090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00080201TimezoneOffsetFromUTCSH
00081030StudyDescriptionLOTO
00081048PhysiciansOfRecordPN
00081060NameOfPhysiciansReadingStudyPN
00081080AdmittingDiagnosesDescriptionLOTO
00081190Recupera URLNUR
00100010PatientNamePN
00100020ID del pazienteLOTO
0010021IssuerOfPatientIDLOTO
0010022TypeOfPatientIDCS
00100026SourcePatientGroupIdentificationSequenceQUADRATO
00100027GroupOfPatientsIdentificationSequenceQUADRATO
00100028SubjectRelativePositionInImageUS
00100030PatientBirthDateGIORNO
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendarLOTO
0010034PatientDeathDateInAlternativeCalendarLOTO
0010035PatientAlternativeCalendarCS
00100040PatientSexCS
00100050PatientInsurancePlanCodeSequenceQUADRATO
00100101PatientPrimaryLanguageCodeSequenceQUADRATO
00100102PatientPrimaryLanguageModifierCodeSequenceQUADRATO
00100200QualityControlSubjectCS
00100201QualityControlSubjectTypeCodeSequenceQUADRATO
00100213StrainNomenclatureLOTO
00100214StrainStockNumberLO
00100215StrainSourceRegistryCodeSequenceQUADRATO
00100217StrainSourceLOTO
00100219StrainCodeSequenceQUADRATO
00100223GeneticModificationsNomenclatureLOTO
00100229GeneticModificationsCodeSequenceQUADRATO
00101001OtherPatientNamesPN
00101005PatientBirthNamePN
00101010PatientAgeAS
00101020PatientSizeANNUNCI
00101021PatientSizeCodeSequenceQUADRATO
00101022PatientBodyMassIndexANNUNCI
00101023Misura la dimensione del DAPANNUNCI
00101024MeasuredLateralDimensionANNUNCI
00101030PatientWeightANNUNCI
00101040PatientAddressLOTO
00101060PatientMotherBirthNamePN
00101080MilitaryRankLOTO
00101081BranchOfServiceLOTO
00102000MedicalAlertsLOTO
00102110AllergieLO
00102150CountryOfResidenceLO
00102152RegionOfResidenceLOTO
00102154PatientTelephoneNumbersSH
00102160EthnicGroupSH
00102180OccupazioneSH
001021A0SmokingStatusCS
001021C0PregnancyStatusUS
001021D0LastMenstrualDateDADO
001021F0PatientReligiousPreferenceLOTO
00102201PatientSpeciesDescriptionLO
00102202PatientSpeciesCodeSequenceQUADRATO
00102203PatientSexNeuteredCS
00102210AnatomicalOrientationTypeCS
00102292PatientBreedDescriptionLOTO
00102293PatientBreedCodeSequenceQUADRATO
00102295BreedRegistrationNumberLOTO
00102296BreedRegistryCodeSequenceQUADRATO
00102297ResponsiblePersonPN
00102298ResponsiblePersonRoleCS
00102299ResponsibleOrganizationLOTO
00109431ExaminedBodyThicknessFLOLA
0020.000 DStudyInstanceUIDInterfaccia utente
00200010ID dello studioSH
00201206NumberOfStudyRelatedSeriesIS
00201208NumberOfStudyRelatedInstancesIS
00321032RequestingPhysicianPN
00321033RequestingServiceLOTO
00321060RequestedProcedureDescriptionLOTO
0032 1070RequestedContrastAgentLOTO
00380010ID di ammissioneLOTO
00380016RouteOfAdmissionsLOTO
00380020AdmittingDateGIORNO
00380021AdmittingTimeTM
00380050SpecialNeedsLOTO
00380060ServiceEpisodeIDENTITÀLO
00380062ServiceEpisodeDescriptionLOTO
00380300CurrentPatientLocationLOTO
0038 0400PatientInstitutionResidenceLOTO
00380500PatientStateLOTO
00400244PerformedProcedureStepStartDateGIORNO
00400245PerformedProcedureStepStartTimeTM
00400250PerformedProcedureStepEndDateGIORNO
00400251PerformedProcedureStepEndTimeTM
00400253PerformedProcedureStepIDSH
00081032ProcedureCodeSequenceQUADRATO
00100024IssuerOfPatientIDQualifiersSequenceQUADRATO
00321034RequestingServiceCodeSequenceQUADRATO
00321064RequestedProcedureCodeSequenceQUADRATO
00401012ReasonForPerformedProcedureCodeSequenceQUADRATO

Livello di serie (includefield=all)

La tabella seguente elenca gli attributi a livello di serie restituiti quando viene specificato. includefield=all Il livello di serie restituisce anche tutti gli attributi a livello di studio elencati nella tabella precedente.

Attributi a livello di serie per includefield=all
Tag Nome Realtà virtuale
00080021SeriesDateGIORNO
00080031SeriesTimeTM
00080060ModalitàCS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070ProduttoreLOTO
00080080InstitutionNameLOTO
00080082InstitutionCodeSequenceQUADRATO
00081010StationNameSH
0008103ESeriesDescriptionLOTO
0008103FSeriesDescriptionCodeSequenceQUADRATO
00081040InstitutionalDepartmentNameLOTO
00081041InstitutionalDepartmentTypeCodeSequenceQUADRATO
00081050PerformingPhysicianNamePN
00081070OperatorsNamePN
00081090ManufacturerModelNameLOTO
00180010ContrastBolusAgentLOTO
0018 0015BodyPartExaminedCS
00180050SliceThicknessANNUNCI
00180088SpacingBetweenSlicesANNUNCI
00181000DeviceSerialNumberLOTO
0018 1016SecondaryCaptureDeviceManufacturerLOTO
0018 1018SecondaryCaptureDeviceManufacturerModelNameLO
0018 1019SecondaryCaptureDeviceSoftwareVersionsLOTO
0018 1020SoftwareVersionsLO
0018 1030ProtocolNameLO
0018 1050SpatialResolutionANNUNCI
00181200DateOfLastCalibrationGIORNO
00181201TimeOfLastCalibrationTM
00185100PatientPositionCS
0020000 DStudyInstanceUIDInterfaccia utente
0020000ESeriesInstanceUIDInterfaccia utente
00200011SeriesNumberIS
00200052FrameOfReferenceUIDInterfaccia utente
00200060LateralitàCS
00201209NumberOfSeriesRelatedInstancesIS
00540081NumberOfSlicesUS
00540101NumberOfTimeSlicesUS
00541000SeriesTypeCS

Livello di istanza (includefield=all)

A livello di istanza, includefield=all restituisce i metadati DICOM completi a livello di istanza. Ciò include tutti gli attributi memorizzati nei metadati dell'istanza in storage. HealthImaging Viene restituito ogni tag DICOM presente nel file DICOM originale per quell'istanza, ad eccezione dell'attributo pixel data.

Argomenti