View a markdown version of this page

Búsqueda de datos DICOM en HealthImaging - AWS HealthImaging
API de búsqueda de DicomWeb para HealthImagingTipos de consulta DicomWeb compatibles para HealthImagingUso IncludeField en QIDO-RS consultas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Búsqueda de datos DICOM en HealthImaging

AWS HealthImaging ofrece representaciones de QIDO-RS las API de DicomWeb para buscar estudios, series e instancias por ID de paciente y recibir sus identificadores únicos para su uso posterior. HealthImaging QIDO-RS Las API de DicomWeb ofrecen flexibilidad a la hora de buscar los datos almacenados HealthImaging y proporcionan interoperabilidad con las aplicaciones antiguas.

Importante

HealthImagingLas API de DicomWeb se pueden utilizar para devolver información sobre conjuntos de imágenes. QIDO-RS HealthImaging Las API de DicomWeb solo hacen referencia a los conjuntos de imágenes principales, a menos que se indique lo contrario. Utilice las acciones nativas de la HealthImaging nube o el parámetro de conjunto de imágenes opcional de las acciones de DicomWeb para recuperar conjuntos de imágenes no principales. HealthImagingLas API de DicomWeb se pueden utilizar para devolver información sobre el conjunto de imágenes con las respuestas. DICOMweb-conformant

HealthImaging QIDO-RS Las acciones de DicomWeb pueden devolver un máximo de 10 000 registros. En el caso de que existan más de 10 000 recursos, no se podrán recuperar mediante QIDO-RS las acciones, pero se podrán recuperar mediante las acciones de DicomWeb WADO-RS o las acciones nativas de la nube.

Las API enumeradas en esta sección están diseñadas de conformidad con el estándar DicomWeb () QIDO-RS para imágenes médicas basadas en la web. No se ofrecen a través AWS CLI de ningún SDK. AWS

API de búsqueda de DicomWeb para HealthImaging

En la siguiente tabla se describen todas las HealthImaging representaciones de las QIDO-RS API de DicomWeb disponibles para buscar datos. HealthImaging

HealthImaging representaciones de las API de DicomWeb QIDO-RS
Name Description (Descripción)
SearchDICOMStudies Busque estudios DICOM especificando los elementos de HealthImaging la consulta de búsqueda mediante una solicitud GET. Los resultados de la búsqueda de estudios se muestran en formato JSON, ordenados por última actualización y por fecha descendente (de la más reciente a la más antigua). Consulte Busque estudios.
SearchDICOMSeries Busque series DICOM HealthImaging especificando los elementos de la consulta de búsqueda mediante una solicitud GET. Los resultados de la búsqueda de series se muestran en formato JSON, ordenados Series Number (0020, 0011) en orden ascendente (del más antiguo al más reciente). Consulte Busque series.
SearchDICOMInstances Busque instancias DICOM HealthImaging especificando los elementos de la consulta de búsqueda mediante una solicitud GET. Los resultados de la búsqueda de instancias se muestran en formato JSON, ordenados Instance Number (0020, 0013) en orden ascendente (del más antiguo al más reciente). Consulte Busque instancias.

Tipos de consulta DicomWeb compatibles para HealthImaging

HealthImaging admite consultas QIDO-RS jerárquicas de recursos en los niveles de estudio, serie e instancia SOP. Cuando se utiliza la búsqueda QIDO-RS jerárquica para: HealthImaging

  • La búsqueda de estudios devuelve una lista de estudios

  • La búsqueda de una serie de estudios requiere una serie conocida StudyInstanceUID y devuelve una lista de series

  • La búsqueda en una lista de instancias requiere un dato conocido StudyInstanceUID y SeriesInstanceUID

En la siguiente tabla se describen los tipos de consultas QIDO-RS jerárquicas compatibles para buscar datos en HealthImaging.

HealthImaging tipos de QIDO-RS consultas compatibles
Tipo de consulta Ejemplo
Consultas de valores de atributos

Busque todas las series de un estudio dondemodality=CT.

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

Busque todos los estudios en los que la identificación del paciente y la fecha del estudio sean estos valores, respectivamente.

…/studies?PatientID=11235813&StudyDate=20130509
Consultas de palabras clave

Busque en todas las series con la SeriesInstanceUID palabra clave.

.../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
Etiquetas: consultas

Busque etiquetas mediante los parámetros de consulta introducidos en el group/element formulario.

{grupo} {elemento} como 0020000D
Consultas de rango

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
Paginación de resultados con y limit offset

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

Puede utilizar los parámetros de límite y desplazamiento para paginar las respuestas de búsqueda. El valor predeterminado del límite es 1000 y consulte HealthImaging Puntos de enlace y cuotas de AWS para obtener el valor máximo.

Límite máximo = 1000, desfase máximo = 9000
Consultas comodín

Las consultas con caracteres comodín proporcionan más flexibilidad en la búsqueda mediante «*» y «?». «*» coincide con cualquier secuencia de caracteres (incluido un valor de longitud cero) y «?» coincide con cualquier carácter individual.

Busque todos los estudios en un almacén de datos que StudyDescription contenga «Nuclear»:

.../studies?StudyDescription=*Nuclear*

Busque todos los estudios que StudyDescription terminen en «Nuclear»:

.../studies?StudyDescription=*Nuclear

Busque todos los estudios que StudyDescription comiencen por «Nuclear»:

.../studies?StudyDescription=Nuclear*

Busque todos los estudios en los que el identificador de paciente tenga exactamente 3 caracteres cualquiera después de 200965981:

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

Habilite la coincidencia parcial en los atributos DICOM de los nombres (PatientName (0010,0010), ReferringPhysicianName (0008,0090)) añadiendo el parámetro de consulta opcional fuzzymatching:

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

Esta consulta realiza coincidencias de palabras de prefijo que no distingan mayúsculas de minúsculas en cualquier parte del valor. PatientName Devuelve resultados con PatientName valores como «thomas», «Albert», «Thomas Albert», «Thomas^Albert», pero no «hom» ni «ber».
IncludeField consultas

Utilice el parámetro de includefield consulta para solicitar atributos DICOM adicionales al conjunto de respuestas predeterminado.

Devuelve atributos específicos por etiqueta:

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

Devuelve todos los atributos disponibles:

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

Devuelve los subatributos de la secuencia (SQ) mediante la notación punteada:

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

Devuelve los elementos de datos privados:

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

Uso IncludeField en QIDO-RS consultas

El parámetro de includefield consulta permite solicitar atributos DICOM adicionales al conjunto de respuestas predeterminado en HealthImaging QIDO-RS las consultas. Puede utilizarlos includefield en los niveles de estudio, serie e instancia.

Sintaxis

Usa el siguiente formato de solicitud GET para incluir campos adicionales en tus QIDO-RS consultas:

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>

Puede especificar varios includefield parámetros en una sola solicitud:

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

Valores admitidos para includefield

En la siguiente tabla se describen los valores admitidos para el includefield parámetro.

Los valores de campo de inclusión admitidos
Tipo de valor Description (Descripción) Ejemplo
Etiqueta DICOM (8 caracteres hexadecimales) Solicita un atributo DICOM específico por su etiqueta en formato GGGGEEEE. includefield=00081030
all Solicita todos los atributos DICOM disponibles para el nivel de recurso. includefield=all
Ruta SQ punteada <parent_tag>Solicite un subatributo específico dentro de un atributo de secuencia (SQ) mediante la notación de puntos:. <child_tag>. includefield=00080096.00080100
Etiqueta de elemento de datos privados Solicita una etiqueta privada (elemento de grupo impar). Requiere el parámetro. privateCreatorElement includefield=00191001
Atributos DICOM estándar, incluidos los datos masivos Solicite atributos específicos únicos o múltiples por etiqueta o palabra clave. includefield=00102201

Comportamiento y reglas

Las siguientes reglas se aplican a includefield las consultas:

  • Respuesta predeterminada: sin includefield ella, la QIDO-RS respuesta devuelve solo el conjunto estándar de atributos.

  • includefield=all: devuelve todos los atributos disponibles en el nivel solicitado. Cuando all se combina con otros includefield valores, tiene prioridad. all

  • Número máximo de etiquetas: una solicitud puede incluir hasta 50 includefield parámetros.

  • Etiquetas duplicadas: includefield los valores duplicados se deduplican y se tratan como una sola solicitud.

  • Etiquetas no válidas o ausentes: si una etiqueta solicitada no existe en los datos de DICOM o no es válida, se omite silenciosamente de la respuesta. Se siguen devolviendo otros includefield atributos válidos.

Atributos de secuencia (SQ)

Utilice la notación de puntos para solicitar atributos anidados dentro de un atributo de secuencia (SQ):

includefield=<parent_SQ_tag>.<child_tag>

Por ejemplo, para recuperar CodeValue (0008,0100) dentro ReferringPhysicianIdentificationSequence de (0008,0096):

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

Multi-level Se admite el anidamiento. Por ejemplo:

includefield=00081115.00081199.00081150

Etiquetas privadas

Los elementos de datos DICOM privados (etiquetas de grupos impares) se admiten en todos los niveles de recursos. Para solicitar etiquetas privadas, incluya el privateCreatorElement parámetro de consulta.

Utilice la siguiente sintaxis:

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

Por ejemplo:

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

Las siguientes reglas se aplican a las etiquetas privadas:

  • La privateCreatorElement etiqueta y el nombre del creador deben proporcionarse como parámetros de coincidencia si se solicita la etiqueta privada.

  • Si no se encuentra privateCreatorElement lo especificado, la etiqueta privada se omite silenciosamente.

  • Al solicitar solo una privateCreatorElement etiqueta sin un elemento de datos privado, solo se devuelve el nombre y el valor del elemento creador. No devuelve todas las etiquetas que pertenecen al bloque de ese creador.

Etiquetas de datos masivos

Los atributos DICOM con VR de datos masivos (OB, OD, OF, OL, UN, OW, OV) con un valor binario superior a 1 MB solicitados como parte del mismo includefield se devuelven como, bulkdataURI en lugar del valor binario sin procesar. Para obtener más información sobre la recuperación de datos masivos, consulte Recuperación de datos masivos de DICOM en. HealthImaging

¿Qué devuelve includefield=all en cada nivel?

Cuando includefield=all se especifica, la respuesta incluye todos los atributos del nivel de recurso específico.

Nivel de estudio (includefield=all)

La siguiente tabla muestra todos los atributos devueltos en el nivel de estudio cuando se especifica. includefield=all

Atributos de nivel de estudio para includefield=all
Tag Name VR
00080005SpecificCharacterSetCS
00080020StudyDatePAPÁ
00080030StudyTimeTM
00080050AccessionNumberSH
00080051IssuerOfAccessionNumberSequenceM2
00080056InstanceAvailabilityCS
00080061ModalitiesInStudyCS
00080062SOPClassesInStudyIU
00080090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00080201TimezoneOffsetFromUTCSH
00081030StudyDescriptionMUCHO
00081048PhysiciansOfRecordPN
00081060NameOfPhysiciansReadingStudyPN
00081080AdmittingDiagnosesDescriptionMUCHO
00081190Recuperar la URLNUESTRA
00100010PatientNamePN
00100020ID del pacienteLO
00100021IssuerOfPatientIDMUCHO
00100022TypeOfPatientIDCS
00100026SourcePatientGroupIdentificationSequenceM2
00100027GroupOfPatientsIdentificationSequenceM2
00100028SubjectRelativePositionInImageEE. UU.
00100030PatientBirthDatePAPÁ
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendarMUCHO
00100034PatientDeathDateInAlternativeCalendarMUCHO
00100035PatientAlternativeCalendarCS
00100040PatientSexCS
00100050PatientInsurancePlanCodeSequenceM2
00100101PatientPrimaryLanguageCodeSequenceM2
00100102PatientPrimaryLanguageModifierCodeSequenceM2
00100200QualityControlSubjectCS
00100201QualityControlSubjectTypeCodeSequenceM2
00100213StrainNomenclatureMUCHO
00100214StrainStockNumberMUCHO
00100215StrainSourceRegistryCodeSequenceM2
00100217StrainSourceMUCHO
00100219StrainCodeSequenceM2
00100223GeneticModificationsNomenclatureMUCHO
00100229GeneticModificationsCodeSequenceM2
00101001OtherPatientNamesPN
00101005PatientBirthNamePN
00101010PatientAgeAS
00101020PatientSizeDS
00101021PatientSizeCodeSequenceM2
00101022PatientBodyMassIndexDS
00101023Dimensión AP medidaDS
00101024MeasuredLateralDimensionDS
00101030PatientWeightDS
00101040PatientAddressMUCHO
00101060PatientMotherBirthNamePN
00101080MilitaryRankMUCHO
00101081BranchOfServiceMUCHO
00102000MedicalAlertsMUCHO
00102110AlergiasMUCHO
00102150CountryOfResidenceMUCHO
00102152RegionOfResidenceMUCHO
00102154PatientTelephoneNumbersSH
00102160EthnicGroupSH
00102180OcupaciónSH
001021A0SmokingStatusCS
001021C0PregnancyStatusEE. UU.
001021D0LastMenstrualDatePAPÁ
001021F0PatientReligiousPreferenceMUCHO
00102201PatientSpeciesDescriptionMUCHO
00102202PatientSpeciesCodeSequenceM2
00102203PatientSexNeuteredCS
00102210AnatomicalOrientationTypeCS
00102292PatientBreedDescriptionMUCHO
00102293PatientBreedCodeSequenceM2
00102295BreedRegistrationNumberMUCHO
00102296BreedRegistryCodeSequenceM2
00102297ResponsiblePersonPN
00102298ResponsiblePersonRoleCS
00102299ResponsibleOrganizationMUCHO
00109431ExaminedBodyThicknessFL
0020000DStudyInstanceUIDIU
00200010StudyIDSH
00201206NumberOfStudyRelatedSeriesIS
00201208NumberOfStudyRelatedInstancesIS
00321032RequestingPhysicianPN
00321033RequestingServiceMUCHO
00321060RequestedProcedureDescriptionMUCHO
00321070RequestedContrastAgentMUCHO
00380010ID de admisiónLO
00380016RouteOfAdmissionsMUCHO
00380020AdmittingDatePAPÁ
00380021AdmittingTimeTM
00380050SpecialNeedsMUCHO
00380060ServiceEpisodeCARNÉLO
00380062ServiceEpisodeDescriptionMUCHO
00380300CurrentPatientLocationMUCHO
00380400PatientInstitutionResidenceMUCHO
00380500PatientStateMUCHO
00400244PerformedProcedureStepStartDatePAPÁ
00400245PerformedProcedureStepStartTimeTM
00400250PerformedProcedureStepEndDatePAPÁ
00400251PerformedProcedureStepEndTimeTM
00400253PerformedProcedureStepIDSH
00081032ProcedureCodeSequenceM2
00100024IssuerOfPatientIDQualifiersSequenceM2
00321034RequestingServiceCodeSequenceM2
00321064RequestedProcedureCodeSequenceM2
00401012ReasonForPerformedProcedureCodeSequenceM2

Nivel de serie (includefield=all)

La siguiente tabla muestra los atributos de nivel de serie que se devuelven cuando se especifica. includefield=all El nivel de serie también devuelve todos los atributos de nivel de estudio enumerados en la tabla anterior.

Atributos de nivel de serie para includefield=all
Tag Name VR
00080021SeriesDatePAPÁ
00080031SeriesTimeTM
00080060ModalidadCS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070Manufacturer (Fabricante)MUCHO
00080080InstitutionNameMUCHO
00080082InstitutionCodeSequenceM2
00081010StationNameSH
0008103ESeriesDescriptionMUCHO
0008103FSeriesDescriptionCodeSequenceM2
00081040InstitutionalDepartmentNameMUCHO
00081041InstitutionalDepartmentTypeCodeSequenceM2
00081050PerformingPhysicianNamePN
00081070OperatorsNamePN
00081090ManufacturerModelNameMUCHO
00180010ContrastBolusAgentMUCHO
00180015BodyPartExaminedCS
00180050SliceThicknessDS
00180088SpacingBetweenSlicesDS
00181000DeviceSerialNumberMUCHO
00181016SecondaryCaptureDeviceManufacturerMUCHO
00181018SecondaryCaptureDeviceManufacturerModelNameMUCHO
00181019SecondaryCaptureDeviceSoftwareVersionsMUCHO
00181020SoftwareVersionsMUCHO
00181030ProtocolNameMUCHO
00181050SpatialResolutionDS
00181200DateOfLastCalibrationPAPÁ
00181201TimeOfLastCalibrationTM
00185100PatientPositionCS
0020000DStudyInstanceUIDIU
0020000ESeriesInstanceUIDIU
00200011SeriesNumberIS
00200052FrameOfReferenceUIDIU
00200060LateralidadCS
00201209NumberOfSeriesRelatedInstancesIS
00540081NumberOfSlicesEE. UU.
00540101NumberOfTimeSlicesEE. UU.
00541000SeriesTypeCS

Nivel de instancia (includefield=all)

A nivel de instancia, includefield=all devuelve los metadatos DICOM completos a nivel de instancia. Esto incluye todos los atributos almacenados en los metadatos de la instancia almacenados. HealthImaging Se devuelven todas las etiquetas DICOM presentes en el archivo DICOM original de esa instancia, excepto el atributo de datos de píxeles.

Temas