View a markdown version of this page

DICOM-Daten durchsuchen in HealthImaging - AWS HealthImaging
DICOMWeb-Such-APIs für HealthImagingUnterstützte DICOMWeb-Abfragetypen für HealthImagingVerwendung IncludeField in QIDO-RS Abfragen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

DICOM-Daten durchsuchen in HealthImaging

AWS HealthImaging bietet Darstellungen von QIDO-RSDICOMWeb-APIs, um anhand der Patienten-ID nach Studien, Serien und Instanzen zu suchen und deren eindeutige Identifikatoren für die weitere Verwendung zu erhalten. HealthImagingDie QIDO-RS DICOMWeb-APIs bieten Flexibilität bei der Suche nach in älteren Anwendungen gespeicherten Daten HealthImaging und sorgen für Interoperabilität mit älteren Anwendungen.

Wichtig

HealthImagingDie DICOMWeb-APIs können verwendet werden, um Bilddatensatzinformationen mit zurückzugeben. QIDO-RS HealthImaging DICOMWeb-APIs verweisen nur auf primäre Bilddatensätze, sofern nicht anders angegeben. Verwenden Sie HealthImaging Cloud-native Aktionen oder den optionalen Imageset-Parameter von DICOMWeb-Aktionen, um Bilddatensätze abzurufen, die nicht primär sind. HealthImagingDie DICOMWeb-APIs können verwendet werden, um Bilddatensatzinformationen mit Antworten zurückzugeben. DICOMweb-conformant

HealthImaging QIDO-RS DICOMWeb-Aktionen können maximal 10.000 Datensätze zurückgeben. Falls mehr als 10.000 Ressourcen vorhanden sind, können sie nicht über die Aktionen abgerufen werden, sondern können über QIDO-RS WADO-RS DICOMWeb-Aktionen oder Cloud-native Aktionen abgerufen werden.

Die in diesem Abschnitt aufgeführten APIs entsprechen dem DICOMWeb () QIDO-RS -Standard für webbasierte medizinische Bildgebung. Sie werden nicht über SDKs AWS CLI angeboten. AWS

DICOMWeb-Such-APIs für HealthImaging

In der folgenden Tabelle werden alle HealthImaging Darstellungen der QIDO-RS DICOMWeb-APIs beschrieben, in denen Daten gesucht werden können. HealthImaging

HealthImaging Repräsentationen von DICOMWeb-APIs QIDO-RS
Name Description
SearchDICOMStudies Suchen Sie nach DICOM-Studien, HealthImaging indem Sie Suchabfrageelemente mithilfe einer GET-Anfrage angeben. Die Ergebnisse der Studiensuche werden im JSON-Format zurückgegeben, sortiert nach letzter Aktualisierung und absteigendem Datum (vom letzten zum ältesten). Siehe Suchen Sie nach Studien.
SearchDICOMSeries Suchen Sie nach DICOM-Serien in, HealthImaging indem Sie Suchabfrageelemente mithilfe einer GET-Anfrage angeben. Die Suchergebnisse für Serien werden im JSON-Format zurückgegeben, sortiert nach Series Number (0020, 0011) aufsteigender Reihenfolge (vom ältesten zum neuesten). Siehe Suchen Sie nach Serien.
SearchDICOMInstances Suchen Sie nach DICOM-Instanzen, HealthImaging indem Sie Suchabfrageelemente mithilfe einer GET-Anforderung angeben. Die Ergebnisse der Instanzsuche werden im JSON-Format zurückgegeben, sortiert nach Instance Number (0020, 0013) aufsteigender Reihenfolge (vom ältesten zum neuesten). Siehe Suchen Sie nach Instanzen.

Unterstützte DICOMWeb-Abfragetypen für HealthImaging

HealthImaging unterstützt QIDO-RS hierarchische Ressourcenabfragen auf den Ebenen Study, Series und SOP Instance. Bei Verwendung der QIDO-RS hierarchischen Suche nach: HealthImaging

  • Bei der Suche nach Studien wird eine Liste von Studien zurückgegeben

  • Die Suche nach einer Reihe einer Studie erfordert eine bekannte Datenreihe StudyInstanceUID und gibt eine Liste von Reihen zurück

  • Für die Suche in einer Liste von Instanzen ist ein bekanntes StudyInstanceUID und SeriesInstanceUID

In der folgenden Tabelle werden unterstützte QIDO-RS hierarchische Abfragetypen für die Suche nach Daten beschrieben HealthImaging.

HealthImaging unterstützte QIDO-RS Abfragetypen
Abfragetyp Beispiel
Abfragen von Attributwerten

Suchen Sie in einer Studie nach allen Serien, womodality=CT.

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

Durchsucht alle Studien, bei denen die Patienten-ID und das Studiendatum diesen Werten entsprechen.

…/studies?PatientID=11235813&StudyDate=20130509
Abfragen nach Schlüsselwörtern

Durchsuchen Sie alle Serien mit dem SeriesInstanceUID Schlüsselwort.

.../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
Tag-Abfragen

Suchen Sie mithilfe von im group/element Formular übergebenen Abfrageparametern nach Tags.

{Gruppe} {Element} wie 0020000D
Bereichsabfragen

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
Pagieren von Ergebnissen mit und limit offset

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

Sie können die Parameter Limit und Offset verwenden, um Suchantworten zu paginieren. Der Standardwert für Limit ist 1000. Den Maximalwert HealthImaging AWS-Endpunkte und Kontingente finden Sie unter.

Maximaler Grenzwert = 1000, maximaler Offset = 9000
Abfragen mit Platzhaltern

Platzhalterabfragen bieten mehr Flexibilität bei der Suche mit „*“ und „?“. „*“ entspricht einer beliebigen Zeichenfolge (einschließlich eines Längenwerts von Null) und „?“ entspricht einem beliebigen einzelnen Zeichen.

Sucht nach allen Studien in einem Datenspeicher, der „Nuclear“ StudyDescription enthält:

.../studies?StudyDescription=*Nuclear*

Suche nach allen Studien, die mit „Nuclear“ StudyDescription enden:

.../studies?StudyDescription=*Nuclear

Suche nach allen Studien, die mit „Nuclear“ StudyDescription beginnen:

.../studies?StudyDescription=Nuclear*

Suchen Sie nach allen Studien, in denen PatientID genau 3 beliebige Zeichen nach 200965981 enthält:

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

Aktivieren Sie den Fuzzy-Matching für Namens-DICOM-Attribute ((0010,0010), PatientName ReferringPhysicianName (0008,0090)), indem Sie den optionalen Abfrageparameter Fuzzymatching hinzufügen:

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

Bei dieser Abfrage wird für jeden Teil des Werts ein Präfixabgleich ohne Berücksichtigung der Groß- und Kleinschreibung durchgeführt. PatientName Sie gibt Ergebnisse mit PatientName Werten wie „Thomas“, „Albert“, „Thomas Albert“, „Thomas^Albert“ zurück, aber nicht mit „hom“ oder „ber“.
IncludeField Abfragen

Verwenden Sie den includefield Abfrageparameter, um zusätzliche DICOM-Attribute anzufordern, die über den Standardantwortsatz hinausgehen.

Gibt bestimmte Attribute nach Tag zurück:

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

Gibt alle verfügbaren Attribute zurück:

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

Gibt die Unterattribute der Sequenz (SQ) in gepunkteter Notation zurück:

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

Private Datenelemente zurückgeben:

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

Verwendung IncludeField in QIDO-RS Abfragen

Mit dem includefield Abfrageparameter können Sie zusätzliche DICOM-Attribute anfordern, die über die Standardantwortmenge in HealthImaging QIDO-RS Abfragen hinausgehen. Sie können ihn includefield auf Studien-, Serien- und Instanzebene verwenden.

Syntax

Verwenden Sie das folgende GET-Anforderungsformat, um zusätzliche Felder in Ihre QIDO-RS Abfragen aufzunehmen:

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>

Sie können mehrere includefield Parameter in einer einzigen Anfrage angeben:

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

Unterstützte Werte für includefield

In der folgenden Tabelle werden die unterstützten Werte für den includefield Parameter beschrieben.

Unterstützte Include-Feldwerte
Werttyp Description Beispiel
DICOM-Tag (8 Hex-Zeichen) Fordert ein bestimmtes DICOM-Attribut anhand seines Tags im GGGGEEEE-Format an. includefield=00081030
all Fordert alle verfügbaren DICOM-Attribute für die Ressourcenebene an. includefield=all
Punktierter SQ-Pfad <parent_tag>Fordert ein bestimmtes Unterattribut innerhalb eines Sequence (SQ) -Attributs mithilfe der Punktnotation an:. <child_tag>. includefield=00080096.00080100
Tag für private Datenelemente Fordern Sie ein privates Tag an (Element mit einer ungeraden Gruppe). Erfordert den ParameterprivateCreatorElement. includefield=00191001
Standard-DICOM-Attribute, einschließlich Bulkdata Fordern Sie bestimmte einzelne oder mehrere Attribute nach Tag oder Schlüsselwort an. includefield=00102201

Verhalten und Regeln

Die folgenden Regeln gelten für includefield Abfragen:

  • Standardantwort — Ohne includefield Angabe gibt die QIDO-RS Antwort nur die Standardattribute zurück.

  • includefield=all — Gibt alle verfügbaren Attribute auf der angeforderten Ebene zurück. Wenn mit anderen includefield Werten kombiniert all wird, hat Vorrang. all

  • Maximale Anzahl von Tags — Eine Anfrage kann bis zu 50 includefield Parameter enthalten.

  • Doppelte Tags — Doppelte includefield Werte werden dedupliziert und als eine einzige Anfrage behandelt.

  • Ungültige oder fehlende Tags — Wenn ein angefordertes Tag in den DICOM-Daten nicht vorhanden oder ungültig ist, wird es stillschweigend in der Antwort weggelassen. Andere gültige includefield Attribute werden weiterhin zurückgegeben.

Sequenzattribute (SQ)

Verwenden Sie die Punktnotation, um verschachtelte Attribute innerhalb eines Sequence-Attributs (SQ) anzufordern:

includefield=<parent_SQ_tag>.<child_tag>

Um beispielsweise CodeValue (0008.0100) innerhalb ReferringPhysicianIdentificationSequence von (0008.0096) abzurufen:

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

Multi-level Verschachtelung wird unterstützt. Beispiel:

includefield=00081115.00081199.00081150

Private Stichwörter

Private DICOM-Datenelemente (ODD-Group-Tags) werden auf allen Ressourcenebenen unterstützt. Um private Tags anzufordern, geben Sie den Abfrageparameter anprivateCreatorElement.

Verwenden Sie die folgende Syntax:

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

Beispiel:

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

Die folgenden Regeln gelten für private Tags:

  • Das privateCreatorElement Tag und der Name des Erstellers müssen als Vergleichsparameter angegeben werden, wenn das private Tag angefordert wird.

  • Wenn das angegebene Tag nicht gefunden privateCreatorElement wird, wird das private Tag stillschweigend weggelassen.

  • Wenn nur ein privateCreatorElement Tag ohne ein privates Datenelement angefordert wird, werden nur der Name und der Wert des Erstellerelements zurückgegeben. Es werden nicht alle Tags zurückgegeben, die zum Block dieses Erstellers gehören.

Massendaten-Tags

DICOM-Attribute mit Bulkdata-VRs (OB, OD, OF, OL, UN, OW, OV), deren Binärwert größer als 1 MB ist, als Teil von angefordert wurden, includefield werden bulkdataURI anstelle des rohen Binärwerts als zurückgegeben. Weitere Informationen zum Abrufen von Massendaten finden Sie unter DICOM-Massendaten abrufen in. HealthImaging

Was gibt includefield=all auf jeder Ebene zurück?

Wenn includefield=all angegeben, umfasst die Antwort alle Attribute auf der jeweiligen Ressourcenebene.

Studienebene (includefield=all)

In der folgenden Tabelle sind alle Attribute aufgeführt, die auf der Studienebene zurückgegeben wurden, sofern diese angegeben wurde. includefield=all

Attribute auf Studienebene für includefield=all
Markierung Name VR
00080005SpecificCharacterSetCS
00080020StudyDateTAG
00080030StudyTimeTM
00080050AccessionNumberSH
00080051IssuerOfAccessionNumberSequenceQ
00080056InstanceAvailabilityCS
00080061ModalitiesInStudyCS
00080062SOPClassesInStudyBenutzeroberfläche
00080090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00080201TimezoneOffsetFromUTCSH
00081030StudyDescriptionVIEL
00081048PhysiciansOfRecordPN
00081060NameOfPhysiciansReadingStudyPN
00081080AdmittingDiagnosesDescriptionVIEL
00081190URL abrufenUR
00100010PatientNamePN
00100020ID des PatientenLO
00100021IssuerOfPatientIDNIEDRIG
00100022TypeOfPatientIDCS
00100026SourcePatientGroupIdentificationSequenceQ
00100027GroupOfPatientsIdentificationSequenceQ
00100028SubjectRelativePositionInImageUS
00100030PatientBirthDateTAG
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendarNIEDRIG
00100034PatientDeathDateInAlternativeCalendarNIEDRIG
00100035PatientAlternativeCalendarCS
00100040PatientSexCS
00100050PatientInsurancePlanCodeSequenceQ
00100101PatientPrimaryLanguageCodeSequenceQ
00100102PatientPrimaryLanguageModifierCodeSequenceQ
00100200QualityControlSubjectCS
00100201QualityControlSubjectTypeCodeSequenceQ
00100213StrainNomenclatureVIEL
00100214StrainStockNumberVIEL
00100215StrainSourceRegistryCodeSequenceQ
00100217StrainSourceVIEL
00100219StrainCodeSequenceQ
00100223GeneticModificationsNomenclatureNIEDRIG
00100229GeneticModificationsCodeSequenceQ
00101001OtherPatientNamesPN
00101005PatientBirthNamePN
00101010PatientAgeAS
00101020PatientSizeDS
00101021PatientSizeCodeSequenceQ
00101022PatientBodyMassIndexDS
00101023Gemessene AP-AbmessungDS
00101024MeasuredLateralDimensionDS
00101030PatientWeightDS
00101040PatientAddressVIEL
00101060PatientMotherBirthNamePN
00101080MilitaryRankVIEL
00101081BranchOfServiceVIEL
00102000MedicalAlertsVIEL
00102110AllergienLO
00102150CountryOfResidenceVIEL
00102152RegionOfResidenceVIEL
00102154PatientTelephoneNumbersSH
00102160EthnicGroupSH
00102180BerufSH
001021A0SmokingStatusCS
001021C0PregnancyStatusUS
001021D0LastMenstrualDateTAG
001021F0PatientReligiousPreferenceVIEL
00102201PatientSpeciesDescriptionVIEL
00102202PatientSpeciesCodeSequenceQ
00102203PatientSexNeuteredCS
00102210AnatomicalOrientationTypeCS
00102292PatientBreedDescriptionVIEL
00102293PatientBreedCodeSequenceQ
00102295BreedRegistrationNumberVIEL
00102296BreedRegistryCodeSequenceQ
00102297ResponsiblePersonPN
00102298ResponsiblePersonRoleCS
00102299ResponsibleOrganizationNIEDRIG
00109431ExaminedBodyThicknessFL
0020000DStudyInstanceUIDBenutzeroberfläche
00200010Studien-IDSH
00201206NumberOfStudyRelatedSeriesIS
00201208NumberOfStudyRelatedInstancesIS
00321032RequestingPhysicianPN
00321033RequestingServiceNIEDRIG
00321060RequestedProcedureDescriptionVIEL
00321070RequestedContrastAgentVIEL
00380010ZulassungsnummerLO
00380016RouteOfAdmissionsVIEL
00380020AdmittingDateTAG
00380021AdmittingTimeTM
00380050SpecialNeedsNIEDRIG
00380060ServiceEpisodeIDLO
00380062ServiceEpisodeDescriptionVIEL
00380300CurrentPatientLocationNIEDRIG
00380400PatientInstitutionResidenceNIEDRIG
00380500PatientStateLO
00400244PerformedProcedureStepStartDateTAG
00400245PerformedProcedureStepStartTimeTM
00400250PerformedProcedureStepEndDateTAG
00400251PerformedProcedureStepEndTimeTM
00400253PerformedProcedureStepIDSH
00081032ProcedureCodeSequenceQ
00100024IssuerOfPatientIDQualifiersSequenceQ
00321034RequestingServiceCodeSequenceQ
00321064RequestedProcedureCodeSequenceQ
00401012ReasonForPerformedProcedureCodeSequenceQ

Serienebene (includefield=all)

In der folgenden Tabelle sind die Attribute auf Serienebene aufgeführt, die zurückgegeben werden, wenn sie angegeben ist. includefield=all Die Datenreihenebene gibt auch alle in der vorherigen Tabelle aufgeführten Attribute auf Studienebene zurück.

Attribute auf Reihenebene für includefield=all
Markierung Name VR
00080021SeriesDateDA
00080031SeriesTimeTM
00080060ModalitätCS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070HerstellerLO
00080080InstitutionNameLO
00080082InstitutionCodeSequenceQ
00081010StationNameSH
0008103ESeriesDescriptionVIEL
0008103FSeriesDescriptionCodeSequenceQ
00081040InstitutionalDepartmentNameNIEDRIG
00081041InstitutionalDepartmentTypeCodeSequenceQ
00081050PerformingPhysicianNamePN
00081070OperatorsNamePN
00081090ManufacturerModelNameNIEDRIG
00180010ContrastBolusAgentVIEL
00180015BodyPartExaminedCS
00180050SliceThicknessDS
00180088SpacingBetweenSlicesDS
00181000DeviceSerialNumberNIEDRIG
00181016SecondaryCaptureDeviceManufacturerVIEL
00181018SecondaryCaptureDeviceManufacturerModelNameVIEL
00181019SecondaryCaptureDeviceSoftwareVersionsVIEL
00181020SoftwareVersionsVIEL
00181030ProtocolNameVIEL
00181050SpatialResolutionDS
00181200DateOfLastCalibrationTAG
00181201TimeOfLastCalibrationTM
00185100PatientPositionCS
0020000DStudyInstanceUIDBenutzeroberfläche
0020000ESeriesInstanceUIDBenutzeroberfläche
00200011SeriesNumberIS
00200052FrameOfReferenceUIDBenutzeroberfläche
00200060LateralitätCS
00201209NumberOfSeriesRelatedInstancesIS
00540081NumberOfSlicesUS
00540101NumberOfTimeSlicesUS
00541000SeriesTypeCS

Instanzebene (includefield=all)

Gibt auf Instanzebene die vollständigen DICOM-Metadaten auf Instanzebene includefield=all zurück. Dies schließt alle Attribute ein, die in den Instanzmetadaten im Speicher gespeichert sind. HealthImaging Jedes DICOM-Tag, das in der ursprünglichen DICOM-Datei für diese Instanz vorhanden ist, wird zurückgegeben, mit Ausnahme des Pixeldatenattributs.

Themen