View a markdown version of this page

Mencari data DICOM di HealthImaging - AWS HealthImaging
API pencarian DicomWeb untuk HealthImagingJenis kueri DicomWeb yang didukung untuk HealthImagingMenggunakan IncludeField dalam QIDO-RS kueri

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mencari data DICOM di HealthImaging

AWS HealthImaging menawarkan representasi QIDO-RS API DicomWeb untuk mencari studi, seri, dan instance berdasarkan ID Pasien, dan menerima pengenal uniknya untuk penggunaan lebih lanjut. HealthImaging QIDO-RS API DicomWeb menawarkan fleksibilitas dalam cara Anda mencari data yang disimpan HealthImaging dan menyediakan interoperabilitas dengan aplikasi lama.

Penting:

HealthImagingAPI DicomWeb dapat digunakan untuk mengembalikan informasi kumpulan gambar dengan. QIDO-RS HealthImaging API DicomWeb hanya mereferensikan kumpulan gambar utama kecuali dinyatakan lain. Gunakan tindakan bawaan HealthImaging cloud, atau parameter kumpulan gambar opsional dari tindakan DicomWeb untuk mengambil kumpulan gambar non-primer. HealthImagingAPI DicomWeb dapat digunakan untuk mengembalikan informasi kumpulan gambar dengan DICOMweb-conformant tanggapan.

HealthImaging QIDO-RS Tindakan DicomWeb dapat mengembalikan maksimal 10.000 catatan. Jika ada lebih dari 10.000 sumber daya, mereka tidak akan dapat diambil melalui QIDO-RS tindakan, tetapi dapat diambil melalui tindakan DicomWeb atau WADO-RS tindakan asli cloud.

API yang tercantum di bagian ini dibangun sesuai dengan standar DicomWeb (QIDO-RS) untuk pencitraan medis berbasis web. Mereka tidak ditawarkan melalui AWS CLI dan AWS SDK.

API pencarian DicomWeb untuk HealthImaging

Tabel berikut menjelaskan semua HealthImaging representasi QIDO-RS API DicomWeb yang tersedia untuk mencari data di. HealthImaging

HealthImaging representasi API DicomWeb QIDO-RS
Nama Deskripsi
SearchDICOMStudies Cari studi DICOM HealthImaging dengan menentukan elemen kueri pencarian menggunakan permintaan GET. Hasil pencarian studi dikembalikan dalam format JSON, diurutkan berdasarkan pembaruan terakhir, tanggal turun (terbaru ke terlama). Lihat Cari studi.
SearchDICOMSeries Cari seri DICOM HealthImaging dengan menentukan elemen kueri penelusuran menggunakan permintaan GET. Hasil pencarian seri dikembalikan dalam format JSON, diurutkan berdasarkan Series Number (0020, 0011) urutan menaik (tertua hingga terbaru). Lihat Cari seri.
SearchDICOMInstances Cari instance DICOM HealthImaging dengan menentukan elemen kueri penelusuran menggunakan permintaan GET. Hasil pencarian instance dikembalikan dalam format JSON, diurutkan berdasarkan Instance Number (0020, 0013) urutan menaik (tertua hingga terbaru). Lihat Cari contoh.

Jenis kueri DicomWeb yang didukung untuk HealthImaging

HealthImaging mendukung kueri sumber daya QIDO-RS hierarkis di tingkat Study, Series, dan SOP Instance. Saat menggunakan pencarian QIDO-RS hierarkis untuk HealthImaging:

  • Mencari studi mengembalikan daftar Studi

  • Mencari Seri Studi membutuhkan yang diketahui StudyInstanceUID dan mengembalikan daftar Seri

  • Mencari daftar Instans membutuhkan yang diketahui StudyInstanceUID dan SeriesInstanceUID

Tabel berikut menjelaskan jenis kueri QIDO-RS hierarkis yang didukung untuk mencari data di HealthImaging.

HealthImaging jenis QIDO-RS kueri yang didukung
Jenis kueri Contoh
Kueri nilai atribut

Cari semua seri dalam Studi di manamodality=CT.

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

Cari semua studi di mana ID pasien dan tanggal studi adalah nilai-nilai ini, masing-masing.

…/studies?PatientID=11235813&StudyDate=20130509
Kueri kata kunci

Cari semua seri menggunakan SeriesInstanceUID kata kunci.

.../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
Kueri tag

Cari tag menggunakan parameter kueri yang diteruskan dalam group/element formulir.

{group} {element} seperti 0020000D
Rentang kueri

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
Hasil paging dengan limit dan offset

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

Anda dapat menggunakan parameter limit dan offset untuk membuat paginasi respons pencarian. Nilai default limit adalah 1000, dan lihat HealthImaging Titik akhir dan kuota AWS untuk nilai maksimum.

Batas maks = 1000, Max offset = 9000
Kueri wildcard

Kueri wildcard memberikan lebih banyak fleksibilitas pada pencarian menggunakan “*” dan “?”. “*” cocok dengan urutan karakter apa pun (termasuk nilai panjang nol) dan “?” cocok dengan karakter tunggal apa pun.

Cari semua studi di datastore yang StudyDescription berisi “Nuklir”:

.../studies?StudyDescription=*Nuclear*

Cari semua studi yang StudyDescription diakhiri dengan “Nuklir”:

.../studies?StudyDescription=*Nuclear

Cari semua studi di mana StudyDescription dimulai dengan “Nuklir”:

.../studies?StudyDescription=Nuclear*

Cari semua studi di mana PatientID memiliki persis 3 karakter setelah 200965981:

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

Aktifkan pencocokan fuzzy pada atribut DICOM nama ((0010.0010), PatientName ReferringPhysicianName (0008.0090)) dengan menambahkan parameter kueri opsional fuzzymatching:

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

Kueri ini melakukan pencocokan kata awalan case-insensitive pada bagian mana pun dari nilai. PatientName Ia mengembalikan hasil dengan PatientName nilai-nilai seperti “thomas”, “Albert”, “Thomas Albert”, “Thomas^Albert”, tetapi tidak “hom” atau “ber”.
IncludeField kueri

Gunakan parameter includefield kueri untuk meminta atribut DICOM tambahan di luar set respons default.

Kembalikan atribut tertentu dengan tag:

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

Kembalikan semua atribut yang tersedia:

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

Sub-atribut urutan kembali (SQ) menggunakan notasi putus-putus:

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

Kembalikan elemen data pribadi:

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

Menggunakan IncludeField dalam QIDO-RS kueri

Parameter includefield kueri memungkinkan Anda meminta atribut DICOM tambahan di luar respons default yang ditetapkan dalam HealthImaging QIDO-RS kueri. Anda dapat menggunakan includefield di tingkat studi, seri, dan contoh.

Sintaksis

Gunakan format permintaan GET berikut untuk menyertakan bidang tambahan dalam QIDO-RS kueri Anda:

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>

Anda dapat menentukan beberapa includefield parameter dalam satu permintaan:

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

Nilai yang didukung untuk includefield

Tabel berikut menjelaskan nilai yang didukung untuk includefield parameter.

Nilai includefield yang didukung
Tipe nilai Deskripsi Contoh
Tag DICOM (8 karakter hex) Minta atribut DICOM tertentu dengan tagnya dalam format GGGGEEEE. includefield=00081030
all Minta semua atribut DICOM yang tersedia untuk tingkat sumber daya. includefield=all
Jalur SQ bertitik <parent_tag>Minta sub-atribut tertentu dalam atribut Sequence (SQ) menggunakan notasi titik:. <child_tag>. includefield=00080096.00080100
Tag elemen data pribadi Minta tag pribadi (elemen grup ganjil). Membutuhkan privateCreatorElement parameter. includefield=00191001
Atribut DICOM standar termasuk bulkdata Minta atribut tunggal atau beberapa tertentu dengan tag atau kata kunci. includefield=00102201

Perilaku dan aturan

Aturan berikut berlaku untuk includefield kueri:

  • Respons default - Tanpaincludefield, QIDO-RS respons hanya mengembalikan set atribut standar.

  • includefield=all — Mengembalikan semua atribut yang tersedia pada tingkat yang diminta. Ketika all dikombinasikan dengan includefield nilai-nilai lain, all mengambil prioritas.

  • Tag maksimum — Permintaan dapat mencakup hingga 50 includefield parameter.

  • Tag duplikat - includefield Nilai duplikat di-deduplikasi dan diperlakukan sebagai permintaan tunggal.

  • Tag tidak valid atau hilang — Jika tag yang diminta tidak ada dalam data DICOM atau tidak valid, tag tersebut akan dihilangkan secara diam-diam dari respons. includefieldAtribut valid lainnya masih dikembalikan.

Atribut urutan (SQ)

Gunakan notasi titik untuk meminta atribut bersarang dalam atribut Sequence (SQ):

includefield=<parent_SQ_tag>.<child_tag>

Misalnya, untuk mengambil CodeValue (0008.0100) dalam ReferringPhysicianIdentificationSequence (0008.0096):

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

Multi-level bersarang didukung. Contoh:

includefield=00081115.00081199.00081150

Tag pribadi

Elemen data DICOM pribadi (tag grup ganjil) didukung di semua tingkat sumber daya. Untuk meminta tag pribadi, sertakan parameter privateCreatorElement kueri.

Gunakan sintaks berikut:

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

Contoh:

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

Aturan berikut berlaku untuk tag pribadi:

  • privateCreatorElementTag dan nama pembuat harus disediakan sebagai parameter kecocokan jika tag pribadi diminta.

  • Jika yang privateCreatorElement ditentukan tidak ditemukan, tag pribadi dihilangkan secara diam-diam.

  • Meminta hanya privateCreatorElement tag tanpa elemen data pribadi mengembalikan nama elemen pencipta dan nilai saja. Itu tidak mengembalikan semua tag milik blok pembuat itu.

Tag Bulkdata

Atribut DICOM dengan bulkdata VR (OB, OD, OF, OL, UN, OW, OV) dengan nilai biner lebih besar dari 1 MB yang diminta sebagai bagian dari dikembalikan sebagai bulkdataURI pengganti nilai biner mentah. includefield Untuk informasi selengkapnya tentang mengambil bulkdata, lihat Mengambil bulkdata DICOM di. HealthImaging

Apa yang dikembalikan includefield=all di setiap level?

Kapan includefield=all ditentukan, respons mencakup semua atribut pada tingkat sumber daya tertentu.

Tingkat studi (includefield=all)

Tabel berikut mencantumkan semua atribut yang dikembalikan pada tingkat studi ketika includefield=all ditentukan.

Atribut tingkat studi untuk includefield=all
Tag Nama VR
00080005SpecificCharacterSetCS
00080020StudyDateDA
00080030StudyTimeTM
00080050AccessionNumberSH
00080051IssuerOfAccessionNumberSequencePERSEGI
00080056InstanceAvailabilityCS
00080061ModalitiesInStudyCS
00080062SOPClassesInStudyUI
00080090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00080201TimezoneOffsetFromUTCSH
00081030StudyDescriptionLIHATLAH
00081048PhysiciansOfRecordPN
00081060NameOfPhysiciansReadingStudyPN
00081080AdmittingDiagnosesDescriptionLIHATLAH
00081190RetrieveUrlUR
00100010PatientNamePN
00100020PatientIDLIHATLAH
00100021IssuerOfPatientIDLIHATLAH
00100022TypeOfPatientIDCS
00100026SourcePatientGroupIdentificationSequencePERSEGI
00100027GroupOfPatientsIdentificationSequencePERSEGI
00100028SubjectRelativePositionInImageAS
00100030PatientBirthDateDA
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendarLIHATLAH
00100034PatientDeathDateInAlternativeCalendarLIHATLAH
00100035PatientAlternativeCalendarCS
00100040PatientSexCS
00100050PatientInsurancePlanCodeSequencePERSEGI
00100101PatientPrimaryLanguageCodeSequencePERSEGI
00100102PatientPrimaryLanguageModifierCodeSequencePERSEGI
00100200QualityControlSubjectCS
00100201QualityControlSubjectTypeCodeSequencePERSEGI
00100213StrainNomenclatureLIHATLAH
00100214StrainStockNumberLIHATLAH
00100215StrainSourceRegistryCodeSequencePERSEGI
00100217StrainSourceLIHATLAH
00100219StrainCodeSequencePERSEGI
00100223GeneticModificationsNomenclatureLIHATLAH
00100229GeneticModificationsCodeSequencePERSEGI
00101001OtherPatientNamesPN
00101005PatientBirthNamePN
00101010PatientAgeAS
00101020PatientSizeDS
00101021PatientSizeCodeSequencePERSEGI
00101022PatientBodyMassIndexDS
00101023MeasuredapDimensionDS
00101024MeasuredLateralDimensionDS
00101030PatientWeightDS
00101040PatientAddressLIHATLAH
00101060PatientMotherBirthNamePN
00101080MilitaryRankLIHATLAH
00101081BranchOfServiceLIHATLAH
00102000MedicalAlertsLIHATLAH
00102110AlergiLIHATLAH
00102150CountryOfResidenceLIHATLAH
00102152RegionOfResidenceLIHATLAH
00102154PatientTelephoneNumbersSH
00102160EthnicGroupSH
00102180PekerjaanSH
001021A0SmokingStatusCS
001021C0PregnancyStatusAS
001021D0LastMenstrualDateDA
001021F0PatientReligiousPreferenceLIHATLAH
00102201PatientSpeciesDescriptionLIHATLAH
00102202PatientSpeciesCodeSequencePERSEGI
00102203PatientSexNeuteredCS
00102210AnatomicalOrientationTypeCS
00102292PatientBreedDescriptionLIHATLAH
00102293PatientBreedCodeSequencePERSEGI
00102295BreedRegistrationNumberLIHATLAH
00102296BreedRegistryCodeSequencePERSEGI
00102297ResponsiblePersonPN
00102298ResponsiblePersonRoleCS
00102299ResponsibleOrganizationLIHATLAH
00109431ExaminedBodyThicknessFL
0020000DStudyInstanceUIDUI
00200010StudyIDSH
00201206NumberOfStudyRelatedSeriesADALAH
00201208NumberOfStudyRelatedInstancesADALAH
00321032RequestingPhysicianPN
00321033RequestingServiceLIHATLAH
00321060RequestedProcedureDescriptionLIHATLAH
00321070RequestedContrastAgentLIHATLAH
00380010ID Penerimaan/AdmissionIdLIHATLAH
00380016RouteOfAdmissionsLIHATLAH
00380020AdmittingDateDA
00380021AdmittingTimeTM
00380050SpecialNeedsLIHATLAH
00380060ServiceEpisodeIDLIHATLAH
00380062ServiceEpisodeDescriptionLIHATLAH
00380300CurrentPatientLocationLIHATLAH
00380400PatientInstitutionResidenceLIHATLAH
00380500PatientStateLIHATLAH
00400244PerformedProcedureStepStartDateDA
00400245PerformedProcedureStepStartTimeTM
00400250PerformedProcedureStepEndDateDA
00400251PerformedProcedureStepEndTimeTM
00400253PerformedProcedureStepIDSH
00081032ProcedureCodeSequenceSQ
00100024IssuerOfPatientIDQualifiersSequenceSQ
00321034RequestingServiceCodeSequenceSQ
00321064RequestedProcedureCodeSequenceSQ
00401012ReasonForPerformedProcedureCodeSequenceSQ

Tingkat seri (includefield=all)

Tabel berikut mencantumkan atribut tingkat seri yang dikembalikan saat includefield=all ditentukan. Tingkat seri juga mengembalikan semua atribut tingkat studi yang tercantum dalam tabel sebelumnya.

Atribut tingkat seri untuk includefield=all
Tag Nama VR
00080021SeriesDateDA
00080031SeriesTimeTM
00080060ModalitasCS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070PabrikanLIHATLAH
00080080InstitutionNameLIHATLAH
00080082InstitutionCodeSequenceSQ
00081010StationNameSH
0008103ESeriesDescriptionLIHATLAH
0008103FSeriesDescriptionCodeSequenceSQ
00081040InstitutionalDepartmentNameLIHATLAH
00081041InstitutionalDepartmentTypeCodeSequenceSQ
00081050PerformingPhysicianNamePN
00081070OperatorsNamePN
00081090ManufacturerModelNameLIHATLAH
00180010ContrastBolusAgentLIHATLAH
00180015BodyPartExaminedCS
00180050SliceThicknessDS
00180088SpacingBetweenSlicesDS
00181000DeviceSerialNumberLIHATLAH
00181016SecondaryCaptureDeviceManufacturerLIHATLAH
00181018SecondaryCaptureDeviceManufacturerModelNameLIHATLAH
00181019SecondaryCaptureDeviceSoftwareVersionsLIHATLAH
00181020SoftwareVersionsLIHATLAH
00181030ProtocolNameLIHATLAH
00181050SpatialResolutionDS
00181200DateOfLastCalibrationDA
00181201TimeOfLastCalibrationTM
00185100PatientPositionCS
0020000DStudyInstanceUIDUI
0020000ESeriesInstanceUIDUI
00200011SeriesNumberADALAH
00200052FrameOfReferenceUIDUI
00200060LateralitasCS
00201209NumberOfSeriesRelatedInstancesADALAH
00540081NumberOfSlicesAS
00540101NumberOfTimeSlicesAS
00541000SeriesTypeCS

Tingkat instans (includefield=all)

Pada tingkat instance, includefield=all mengembalikan metadata DICOM tingkat instance penuh. Ini termasuk semua atribut yang disimpan dalam metadata instance dalam HealthImaging penyimpanan. Setiap tag DICOM yang ada dalam file DICOM asli untuk instance itu dikembalikan, kecuali atribut data piksel.

Topik