View a markdown version of this page

Pesquisando dados DICOM em HealthImaging - AWS HealthImaging
APIs de pesquisa DICOMWeb para HealthImagingTipos de consulta DICOMWeb suportados para HealthImagingUsando IncludeField em QIDO-RS consultas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Pesquisando dados DICOM em HealthImaging

HealthImaging A AWS oferece representações das QIDO-RS APIs DICOMWeb para pesquisar estudos, séries e instâncias por ID do paciente e receber seus identificadores exclusivos para uso posterior. HealthImagingAs QIDO-RS APIs DICOMWeb da oferecem flexibilidade na forma como você pesquisa dados armazenados HealthImaging e fornecem interoperabilidade com aplicativos legados.

Importante

HealthImagingAs APIs DICOMWeb da podem ser usadas para retornar informações do conjunto de imagens com. QIDO-RS HealthImaging As APIs DICOMWeb fazem referência somente a conjuntos de imagens primárias, salvo indicação em contrário. Use ações nativas da HealthImaging nuvem ou o parâmetro opcional de conjunto de imagens das ações DICOMWeb para recuperar conjuntos de imagens não primárias. HealthImagingAs APIs DICOMWeb da podem ser usadas para retornar informações do conjunto de imagens com respostas. DICOMweb-conformant

HealthImaging QIDO-RS As ações do DICOMWeb podem retornar no máximo 10.000 registros. Caso existam mais de 10.000 recursos, eles não serão recuperáveis por meio das QIDO-RS ações, mas poderão ser recuperados por meio de ações DICOMWeb ou WADO-RS ações nativas da nuvem.

As APIs listadas nesta seção são criadas em conformidade com o padrão DICOMWeb (QIDO-RS) para imagens médicas baseadas na web. Eles não são oferecidos por meio de AWS CLI AWS SDKs.

APIs de pesquisa DICOMWeb para HealthImaging

A tabela a seguir descreve todas as HealthImaging representações das QIDO-RS APIs DICOMWeb disponíveis para pesquisar dados em. HealthImaging

HealthImaging representações de APIs DICOMWeb QIDO-RS
Name (Nome) Description
SearchDICOMStudies Pesquise estudos DICOM HealthImaging especificando elementos de consulta de pesquisa usando uma solicitação GET. Os resultados da pesquisa do estudo são retornados no formato JSON, ordenados pela última atualização, com data decrescente (da mais recente para a mais antiga). Consulte Pesquise estudos.
SearchDICOMSeries Pesquise a série DICOM HealthImaging especificando os elementos da consulta de pesquisa usando uma solicitação GET. Os resultados da pesquisa em série são retornados no formato JSON, ordenados por Series Number (0020, 0011) ordem crescente (do mais antigo para o mais recente). Consulte Pesquisar séries.
SearchDICOMInstances Pesquise instâncias DICOM HealthImaging especificando elementos de consulta de pesquisa usando uma solicitação GET. Os resultados da pesquisa de instâncias são retornados no formato JSON, ordenados por Instance Number (0020, 0013) ordem crescente (do mais antigo para o mais recente). Consulte Pesquisar instâncias.

Tipos de consulta DICOMWeb suportados para HealthImaging

HealthImaging suporta consultas QIDO-RS hierárquicas de recursos nos níveis de estudo, série e instância SOP. Ao usar a pesquisa QIDO-RS hierárquica para: HealthImaging

  • A busca por estudos retorna uma lista de estudos

  • Pesquisar uma série de estudos requer uma série conhecida StudyInstanceUID e retorna uma lista de séries

  • Pesquisar uma lista de instâncias requer uma informação conhecida StudyInstanceUID e SeriesInstanceUID

A tabela a seguir descreve os tipos de consulta QIDO-RS hierárquica compatíveis para pesquisar dados em. HealthImaging

HealthImaging tipos de QIDO-RS consulta suportados
Tipo da consulta Exemplo
Consultas de valores de atributos

Pesquise todas as séries em um estudo ondemodality=CT.

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

Pesquise todos os estudos em que o ID do paciente e a data do estudo sejam esses valores, respectivamente.

…/studies?PatientID=11235813&StudyDate=20130509
Consultas de palavras-chave

Pesquise todas as séries usando a SeriesInstanceUID palavra-chave.

.../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
Consultas de tags

Pesquise tags usando parâmetros de consulta passados no group/element formulário.

{group} {element} como 0020000D
Intervalo de consultas

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
Paginação de resultados com e limit offset

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

Você pode usar os parâmetros de limite e deslocamento para paginar as respostas da pesquisa. O valor padrão do limite é 1000 e veja HealthImaging Endpoints e cotas da AWS o valor máximo.

Limite máximo = 1000, deslocamento máximo = 9000
Consultas curingas

As consultas curinga oferecem mais flexibilidade na pesquisa usando “*” e “?”. “*” corresponde a qualquer sequência de caracteres (incluindo um valor de comprimento zero) e “?” corresponde a qualquer caractere único.

Pesquise todos os estudos em um armazenamento de dados que StudyDescription contenha “Nuclear”:

.../studies?StudyDescription=*Nuclear*

Pesquise todos os estudos que StudyDescription terminam com “Nuclear”:

.../studies?StudyDescription=*Nuclear

Pesquise todos os estudos que StudyDescription começam com “Nuclear”:

.../studies?StudyDescription=Nuclear*

Pesquise todos os estudos em que o PatientID tenha exatamente 3 caracteres após 200965981:

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

Ative a correspondência difusa nos atributos DICOM do nome ((0010.0010), PatientName ReferringPhysicianName (0008.0090)) adicionando o parâmetro de consulta opcional fuzzymatching:

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

Essa consulta realiza a correspondência de palavras de prefixo sem distinção entre maiúsculas e minúsculas em qualquer parte do valor. PatientName Ele retorna resultados com PatientName valores como “thomas”, “Albert”, “Thomas Albert”, “Thomas^Albert”, mas não “hom” ou “ber”.
IncludeField consultas

Use o parâmetro de includefield consulta para solicitar atributos DICOM adicionais além do conjunto de respostas padrão.

Retorne atributos específicos por tag:

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

Retorne todos os atributos disponíveis:

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

Subatributos da sequência de retorno (SQ) usando notação pontilhada:

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

Retorne elementos de dados privados:

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

Usando IncludeField em QIDO-RS consultas

O parâmetro de includefield consulta permite que você solicite atributos DICOM adicionais além da resposta padrão definida nas HealthImaging QIDO-RS consultas. Você pode usar includefield nos níveis de estudo, série e instância.

Sintaxe

Use o seguinte formato de solicitação GET para incluir campos adicionais em suas 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>

Você pode especificar vários includefield parâmetros em uma única solicitação:

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

Valores suportados para includefield

A tabela a seguir descreve os valores compatíveis com o includefield parâmetro.

Valores de campo de inclusão suportados
Tipo de valor Description Exemplo
Etiqueta DICOM (8 caracteres hexadecimais) Solicite um atributo DICOM específico por meio de sua tag no formato GGGGEEEE. includefield=00081030
all Solicite todos os atributos DICOM disponíveis para o nível do recurso. includefield=all
Caminho SQL pontilhado <parent_tag>Solicite um subatributo específico dentro de um atributo Sequence (SQ) usando a notação de pontos:. <child_tag>. includefield=00080096.00080100
Tag de elemento de dados privado Solicite uma tag privada (elemento de grupo ímpar). Requer o privateCreatorElement parâmetro. includefield=00191001
Atributos DICOM padrão, incluindo dados em massa Solicite atributos únicos ou múltiplos específicos por tag ou palavra-chave. includefield=00102201

Comportamento e regras

As regras a seguir se aplicam às includefield consultas:

  • Resposta padrão — Sem includefield ela, a QIDO-RS resposta retorna somente o conjunto padrão de atributos.

  • includefield=all — Retorna todos os atributos disponíveis no nível solicitado. Quando all é combinado com outros includefield valores, all tem prioridade.

  • Máximo de tags — Uma solicitação pode incluir até 50 includefield parâmetros.

  • Tags duplicadas — includefield os valores duplicados são desduplicados e tratados como uma única solicitação.

  • Tags inválidas ou ausentes — Se uma tag solicitada não existir nos dados DICOM ou for inválida, ela será silenciosamente omitida da resposta. Outros includefield atributos válidos ainda são retornados.

Atributos de sequência (SQ)

Use a notação de pontos para solicitar atributos aninhados em um atributo Sequence (SQ):

includefield=<parent_SQ_tag>.<child_tag>

Por exemplo, para recuperar CodeValue (0008.0100) dentro ReferringPhysicianIdentificationSequence de (0008.0096):

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

Multi-level o aninhamento é suportado. Por exemplo:

includefield=00081115.00081199.00081150

Etiquetas privadas

Elementos de dados DICOM privados (tags de grupos ímpares) são suportados em todos os níveis de recursos. Para solicitar tags privadas, inclua o parâmetro de privateCreatorElement consulta.

Use a seguinte sintaxe:

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

Por exemplo:

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

As regras a seguir se aplicam às tags privadas:

  • A privateCreatorElement tag e o nome do criador devem ser fornecidos como um parâmetro de correspondência se a tag privada for solicitada.

  • Se o especificado não privateCreatorElement for encontrado, a tag privada será omitida silenciosamente.

  • Solicitar somente uma privateCreatorElement tag sem um elemento de dados privado retorna somente o nome e o valor do elemento criador. Ele não retorna todas as tags pertencentes ao bloco do criador.

Tags de dados em massa

Os atributos DICOM com VRs de dados em massa (OB, OD, OF, OL, UN, OW, OV) com valor binário maior que 1 MB solicitado como parte do includefield são retornados bulkdataURI em vez do valor binário bruto. Para obter mais informações sobre como recuperar dados em massa, consulte Recuperando dados em massa DICOM em. HealthImaging

O que includefield=all retorna em cada nível?

Quando includefield=all é especificada, a resposta inclui todos os atributos no nível de recurso específico.

Nível de estudo (includefield=all)

A tabela a seguir lista todos os atributos retornados no nível do estudo quando includefield=all especificado.

Atributos do nível de estudo para includefield=all
Tag Nome RV
00080005SpecificCharacterSetCS
00:08 020StudyDateDA
00:08:30StudyTimeTM
00:08:0:050AccessionNumberSH
00:08 051IssuerOfAccessionNumberSequenceSQ
00:08:0:056InstanceAvailabilityCS
00:08 061ModalitiesInStudyCS
00:08 062SOPClassesInStudyInterface do usuário
00:08 090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00:08 0201TimezoneOffsetFromUTCSH
00:08:1030StudyDescriptionLO
00:08:1048PhysiciansOfRecordPN
00:08:1060NameOfPhysiciansReadingStudyPN
00:08:1080AdmittingDiagnosesDescriptionLO
00:08 1190Recuperar URLNOSSO
00100010PatientNamePN
00100020ID do pacienteLO
00100021IssuerOfPatientIDLO
00100022TypeOfPatientIDCS
00:100026SourcePatientGroupIdentificationSequenceSQ
00:100027GroupOfPatientsIdentificationSequenceSQ
00:100028SubjectRelativePositionInImageEUA
00:100030PatientBirthDateDA
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendarLO
00100034PatientDeathDateInAlternativeCalendarLO
00100035PatientAlternativeCalendarCS
00:100040PatientSexCS
00100050PatientInsurancePlanCodeSequenceSQ
00:10:0101PatientPrimaryLanguageCodeSequenceSQ
00:100:102PatientPrimaryLanguageModifierCodeSequenceSQ
00:100:200QualityControlSubjectCS
00:100:201QualityControlSubjectTypeCodeSequenceSQ
00:10:0213StrainNomenclatureLO
00:10:0214StrainStockNumberLO
00:10:0215StrainSourceRegistryCodeSequenceSQ
00:10:0217StrainSourceLO
00:10:0219StrainCodeSequenceSQ
00:10:223GeneticModificationsNomenclatureLO
00:10:229GeneticModificationsCodeSequenceSQ
00:10:1001OtherPatientNamesPN
00:1010:05PatientBirthNamePN
00:10:1010PatientAgeAS
00:10:10.20PatientSizeDS
00:10:021PatientSizeCodeSequenceSQ
00:10:022PatientBodyMassIndexDS
00:10:023Dimensão PAD medidaDS
00:10:1024MeasuredLateralDimensionDS
00:10:0,130PatientWeightDS
00:10:1040PatientAddressLO
00:10:1060PatientMotherBirthNamePN
00:10:1080MilitaryRankLO
00:10:081BranchOfServiceLO
00:10:2000MedicalAlertsLO
00:10:2110AlergiasLO
00:10:2150CountryOfResidenceLO
00:10:2152RegionOfResidenceLO
00:10:2154PatientTelephoneNumbersSH
00:10:2160EthnicGroupSH
00:10:2180OcupaçãoSH
001021A0SmokingStatusCS
001021C0PregnancyStatusEUA
001021D0LastMenstrualDateDA
001021F0PatientReligiousPreferenceLO
00:10:2201PatientSpeciesDescriptionLO
00:10:2202PatientSpeciesCodeSequenceSQ
00:10:2203PatientSexNeuteredCS
00:10:2210AnatomicalOrientationTypeCS
00:10:2292PatientBreedDescriptionLO
00:10:2293PatientBreedCodeSequenceSQ
00:10:2295BreedRegistrationNumberLO
00:10:2296BreedRegistryCodeSequenceSQ
00:10:2297ResponsiblePersonPN
00:10:2298ResponsiblePersonRoleCS
00:10:2299ResponsibleOrganizationLO
00:10:94.31ExaminedBodyThicknessFL
0020000DStudyInstanceUIDInterface do usuário
00200010ID do estudoSH
00:20:206NumberOfStudyRelatedSeriesIS
00:20:208NumberOfStudyRelatedInstancesIS
00:32:1032RequestingPhysicianPN
00:32.1033RequestingServiceLO
00:32:10.60RequestedProcedureDescriptionLO
00:32:10,70RequestedContrastAgentLO
00:38:0010ID de admissãoLO
00:380:016RouteOfAdmissionsLO
00:38:0020AdmittingDateDA
00:38:0021AdmittingTimeTM
00:38:0050SpecialNeedsLO
00:38:0060ServiceEpisodeIDLO
00:38:0062ServiceEpisodeDescriptionLO
00:380:300CurrentPatientLocationLO
00:380:400PatientInstitutionResidenceLO
00:380:500PatientStateLO
00:400 244PerformedProcedureStepStartDateDA
00:40:245PerformedProcedureStepStartTimeTM
00:400:250PerformedProcedureStepEndDateDA
00:40:0251PerformedProcedureStepEndTimeTM
00:40:253PerformedProcedureStepIDSH
00:081032ProcedureCodeSequenceSQ
00100024IssuerOfPatientIDQualifiersSequenceSQ
00:32:10,34RequestingServiceCodeSequenceSQ
00:32:10,64RequestedProcedureCodeSequenceSQ
00:40:10.12ReasonForPerformedProcedureCodeSequenceSQ

Nível da série (includefield=all)

A tabela a seguir lista os atributos de nível de série retornados quando includefield=all é especificado. O nível da série também retorna todos os atributos do nível de estudo listados na tabela anterior.

Atributos de nível de série para includefield=all
Tag Nome RV
00:08 021SeriesDateDA
00:08 031SeriesTimeTM
00:08:060ModalidadeCS
00:08 064ConversionTypeCS
00:08 068PresentationIntentTypeCS
00:08 070FabricanteLO
00:08 080InstitutionNameLO
00:08 082InstitutionCodeSequenceSQ
00:08:1010StationNameSH
0008103ESeriesDescriptionLO
0008103FSeriesDescriptionCodeSequenceSQ
00:08:1040InstitutionalDepartmentNameLO
00:08:1041InstitutionalDepartmentTypeCodeSequenceSQ
00:08:1050PerformingPhysicianNamePN
00:08:1070OperatorsNamePN
00:08:1090ManufacturerModelNameLO
00:18:0010ContrastBolusAgentLO
00:18:0015BodyPartExaminedCS
00:18:0050SliceThicknessDS
00:18:0088SpacingBetweenSlicesDS
00:18:1000DeviceSerialNumberLO
00:18:10.16SecondaryCaptureDeviceManufacturerLO
00:18:1018SecondaryCaptureDeviceManufacturerModelNameLO
00:18:1019SecondaryCaptureDeviceSoftwareVersionsLO
00:18:10.20SoftwareVersionsLO
00:18:10.30ProtocolNameLO
00:18:10.50SpatialResolutionDS
00:18:1200DateOfLastCalibrationDA
00:18:1201TimeOfLastCalibrationTM
00:18:5100PatientPositionCS
0020000DStudyInstanceUIDInterface do usuário
0020000ESeriesInstanceUIDInterface do usuário
00200011SeriesNumberIS
0020:052FrameOfReferenceUIDInterface do usuário
00:20:060LateralidadeCS
00:20:209NumberOfSeriesRelatedInstancesIS
00540081NumberOfSlicesEUA
00540101NumberOfTimeSlicesEUA
00:54.1000SeriesTypeCS

Nível da instância (includefield=all)

No nível da instância, includefield=all retorna os metadados DICOM completos no nível da instância. Isso inclui todos os atributos armazenados nos metadados da instância armazenados HealthImaging. Cada tag DICOM presente no arquivo DICOM original dessa instância é retornada, exceto o atributo de dados de pixel.

Tópicos