View a markdown version of this page

在 HealthImaging 中搜尋 DICOM 資料 - AWS HealthImaging
HealthImaging 的 DICOMweb 搜尋 API APIsHealthImaging 支援的 DICOMweb 查詢類型在 QIDO-RS 查詢中使用 IncludeField

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 HealthImaging 中搜尋 DICOM 資料

AWS HealthImaging 提供 DICOMweb QIDO-RS APIs 的表示法，以依病患 ID 搜尋研究、序列和執行個體，並接收其唯一識別符以供進一步使用。HealthImaging 的 DICOMweb QIDO-RS APIs 可讓您靈活地搜尋存放在 HealthImaging 中的資料，並提供與舊版應用程式的互通性。

Important (重要)

HealthImaging 的 DICOMweb APIs 可用來傳回 QIDO-RS 的影像集資訊。除非另有說明，否則 HealthImaging DICOMweb APIs僅參考主要影像集。使用 HealthImaging 雲端原生動作，或 DICOMweb 動作的選用影像集參數來擷取非主要影像集。HealthImaging 的 DICOMweb APIs 可用來傳回具有 DICOMweb 合規回應的影像集資訊。

HealthImaging DICOMweb QIDO-RS 動作最多可傳回 10，000 筆記錄。如果存在超過 10，000 個資源，則無法透過 QIDO-RS 動作擷取，但可以透過 DICOMweb WADO-RS 動作或雲端原生動作擷取。

本節中列出的 APIs 是根據 Web 型醫療影像的 DICOMweb (QIDO-RS) 標準建置。它們不會透過 AWS CLI AWS SDKs提供。

HealthImaging 的 DICOMweb 搜尋 API APIs

下表說明可用於在 HealthImaging 中搜尋資料之 DICOMweb QIDO-RS APIs 的所有 HealthImaging 表示法。

HealthImaging 表示 DICOMweb QIDO-RS APIs
名稱 描述
SearchDICOMStudies 使用 GET 請求指定搜尋查詢元素，在 HealthImaging 中搜尋 DICOM 檢查。研究搜尋結果會以 JSON 格式傳回，依上次更新、日期遞減 （最晚到最舊） 排序。請參閱 搜尋研究。
SearchDICOMSeries 使用 GET 請求指定搜尋查詢元素，在 HealthImaging 中搜尋 DICOM 系列。系列搜尋結果會以 JSON 格式傳回，依遞增順序排序 Series Number (0020, 0011) （最舊到最新）。請參閱 搜尋系列。
SearchDICOMInstances 使用 GET 請求指定搜尋查詢元素，在 HealthImaging 中搜尋 DICOM 執行個體。執行個體搜尋結果會以 JSON 格式傳回，依遞增順序 Instance Number (0020, 0013) （最舊到最新） 排序。請參閱 搜尋執行個體。

HealthImaging 支援的 DICOMweb 查詢類型

HealthImaging 支援研究、系列和 SOP 執行個體層級的 QIDO-RS 階層資源查詢。使用 HealthImaging 的 QIDO-RS 階層搜尋時：

  • 搜尋研究會傳回研究清單

  • 搜尋檢查的序列需要已知的 ，StudyInstanceUID並傳回序列清單

  • 搜尋執行個體清單需要已知 StudyInstanceUID和 SeriesInstanceUID

下表說明在 HealthImaging 中搜尋資料的支援 QIDO-RS 階層式查詢類型。

HealthImaging 支援的 QIDO-RS 查詢類型
查詢類型 範例
屬性值查詢

搜尋 檢查中的所有序列，其中 modality=CT。

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

搜尋病患 ID 和檢查日期分別是這些值的所有檢查。

…/studies?PatientID=11235813&StudyDate=20130509
關鍵字查詢

使用 SeriesInstanceUID關鍵字搜尋所有序列。

.../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
標籤查詢

使用以群組/元素形式傳遞的查詢參數來搜尋標籤。

{group}{element}，例如 0020000D
範圍查詢

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
使用 limit和 的結果分頁 offset

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

您可以使用限制和位移參數來分頁搜尋回應。限制的預設值為 1000，最大值AWS HealthImaging 端點和配額請參閱 。

最大限制 = 1000，最大位移 = 9000
萬用字元查詢

萬用字元查詢可在使用 "*" 和 "？" 進行搜尋時提供更多彈性。"*" 符合任何字元序列 （包括零長度值） 和 "？" 符合任何單一字元。

在資料存放區中搜尋所有研究，其中 StudyDescription 包含「Nuclear」：

.../studies?StudyDescription=*Nuclear*

搜尋 StudyDescription 以「Nuclear」結尾的所有研究：

.../studies?StudyDescription=*Nuclear

搜尋所有 StudyDescription 開頭為「Nuclear」的檢查：

.../studies?StudyDescription=Nuclear*

在 200965981 之後，搜尋 PatientID 完全有任何 3 個字元的所有研究：

.../studies?PatientID=200965981???
FuzzyMatching 查詢

透過新增模糊比對選用查詢參數，在名稱 DICOM 屬性上啟用模糊比對 (PatientNamesReferringPhysicianName(0008，0090))：

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

此查詢會對 PatientName 值的任何部分執行不區分大小寫的字首。它會傳回具有 PatientName 值的結果，例如 "thomas"、"Albert"、"Thomas Albert"、"Thomas^Albert"，但不傳回 "hom" 或 "ber"。
IncludeField 查詢

使用includefield查詢參數請求預設回應集以外的其他 DICOM 屬性。

依標籤傳回特定屬性：

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

傳回所有可用的屬性：

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

使用虛線表示法傳回序列 (SQ) 子屬性：

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

傳回私有資料元素：

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

在 QIDO-RS 查詢中使用 IncludeField

includefield 查詢參數可讓您請求 HealthImaging QIDO-RS 查詢中預設回應集以外的其他 DICOM 屬性。您可以在研究、序列和執行個體層級使用 includefield 。

語法

使用下列 GET 請求格式，在您的 QIDO-RS 查詢中包含其他欄位：

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>

您可以在單一請求中指定多個includefield參數：

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

支援 includefield 的值

下表說明 includefield 參數支援的值。

支援的包含欄位值
值類型 說明 範例
DICOM 標籤 (8 個十六進位字元） 依 GGGGEEEE 格式的標籤請求特定 DICOM 屬性。 includefield=00081030
all 請求資源層級的所有可用 DICOM 屬性。 includefield=all
虛線 SQ 路徑 使用點表示法請求序列 (SQ) 屬性中的特定子屬性：<parent_tag>.<child_tag>。 includefield=00080096.00080100
私有資料元素標籤 請求私有標籤 (odd-group 元素）。需要 privateCreatorElement 參數。 includefield=00191001
標準 DICOM 屬性，包括大量資料 依標籤或關鍵字請求特定的單一或多個屬性。 includefield=00102201

行為和規則

下列規則適用於includefield查詢：

  • 預設回應 – 如果沒有 includefield，QIDO-RS 回應只會傳回標準屬性集。

  • includefield=all – 傳回請求層級的所有可用屬性。當 all 與其他includefield值結合時， all 會優先。

  • 標籤上限 – 請求最多可包含 50 個includefield參數。

  • 重複標籤 – 重複includefield值會刪除並視為單一請求。

  • 無效或遺失標籤 – 如果請求的標籤不存在於 DICOM 資料中或無效，則會從回應中無提示地省略該標籤。仍會傳回其他有效的includefield屬性。

序列 (SQ) 屬性

使用點表示法請求序列 (SQ) 屬性中的巢狀屬性：

includefield=<parent_SQ_tag>.<child_tag>

例如，若要在 ReferringPhysicianIdentificationSequence (0008，0096) 中擷取 CodeValue (0008，0100)：

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

支援多層級巢狀。例如：

includefield=00081115.00081199.00081150

私有標籤

所有資源層級都支援私有 DICOM 資料元素 (odd-group 標籤）。若要請求私有標籤，請包含privateCreatorElement查詢參數。

使用下列語法：

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

例如：

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

下列規則適用於私有標籤：

  • 如果請求私有privateCreatorElement標籤，則必須提供標籤和建立者名稱做為比對參數。

  • 如果privateCreatorElement找不到指定的 ，則會以無提示方式省略私有標籤。

  • 僅請求沒有私有資料元素的privateCreatorElement標籤，只會傳回建立者元素名稱和值。它不會傳回屬於該建立者區塊的所有標籤。

大量資料標籤

請求的二進位值大於 1 MB 且具有大量資料 VRs (OB、OD、 OF、OL、UN、OW、OV) 的 DICOM 屬性includefield會傳回為原始二進位值，bulkdataURI而非原始二進位值。如需擷取大量資料的詳細資訊，請參閱在 HealthImaging 中擷取 DICOM 大量資料。

每個層級的 includefield= all return 是什麼？

指定 includefield=all 時，回應會包含特定資源層級的所有屬性。

研究層級 (includefield=all)

下表列出includefield=all指定 時，在研究層級傳回的所有屬性。

includefield=all 的試驗層級屬性
Tag 名稱 虛擬實境
00080005SpecificCharacterSetCS
00080020StudyDateDA
00080030StudyTimeTM
00080050AccessionNumberSH
00080051IssuerOfAccessionNumberSequenceSQ
00080056InstanceAvailabilityCS
00080061ModalitiesInStudyCS
00080062SOPClassesInStudyUI
00080090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00080201TimezoneOffsetFromUTCSH
00081030StudyDescriptionLO
00081048PhysiciansOfRecordPN
00081060NameOfPhysiciansReadingStudyPN
00081080AdmittingDiagnosesDescriptionLO
00081190RetrieveURLUR
00100010PatientNamePN
00100020PatientIDLO
00100021IssuerOfPatientIDLO
00100022TypeOfPatientIDCS
00100026SourcePatientGroupIdentificationSequenceSQ
00100027GroupOfPatientsIdentificationSequenceSQ
00100028SubjectRelativePositionInImage美國
00100030PatientBirthDateDA
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendarLO
00100034PatientDeathDateInAlternativeCalendarLO
00100035PatientAlternativeCalendarCS
00100040PatientSexCS
00100050PatientInsurancePlanCodeSequenceSQ
00100101PatientPrimaryLanguageCodeSequenceSQ
00100102PatientPrimaryLanguageModifierCodeSequenceSQ
00100200QualityControlSubjectCS
00100201QualityControlSubjectTypeCodeSequenceSQ
00100213StrainNomenclatureLO
00100214StrainStockNumberLO
00100215StrainSourceRegistryCodeSequenceSQ
00100217StrainSourceLO
00100219StrainCodeSequenceSQ
00100223GeneticModificationsNomenclatureLO
00100229GeneticModificationsCodeSequenceSQ
00101001OtherPatientNamesPN
00101005PatientBirthNamePN
00101010PatientAgeAS
00101020PatientSizeDS
00101021PatientSizeCodeSequenceSQ
00101022PatientBodyMassIndexDS
00101023MeasuredAPDimensionDS
00101024MeasuredLateralDimensionDS
00101030PatientWeightDS
00101040PatientAddressLO
00101060PatientMotherBirthNamePN
00101080MilitaryRankLO
00101081BranchOfServiceLO
00102000MedicalAlertsLO
00102110敏感LO
00102150CountryOfResidenceLO
00102152RegionOfResidenceLO
00102154PatientTelephoneNumbersSH
00102160EthnicGroupSH
00102180職業SH
001021A0SmokingStatusCS
001021C0PregnancyStatus美國
001021D0LastMenstrualDateDA
001021F0PatientReligiousPreferenceLO
00102201PatientSpeciesDescriptionLO
00102202PatientSpeciesCodeSequenceSQ
00102203PatientSexNeuteredCS
00102210AnatomicalOrientationTypeCS
00102292PatientBreedDescriptionLO
00102293PatientBreedCodeSequenceSQ
00102295BreedRegistrationNumberLO
00102296BreedRegistryCodeSequenceSQ
00102297ResponsiblePersonPN
00102298ResponsiblePersonRoleCS
00102299ResponsibleOrganizationLO
00109431ExaminedBodyThickness佛羅里達州
0020000DStudyInstanceUIDUI
00200010StudyIDSH
00201206NumberOfStudyRelatedSeriesIS
00201208NumberOfStudyRelatedInstancesIS
00321032RequestingPhysicianPN
00321033RequestingServiceLO
00321060RequestedProcedureDescriptionLO
00321070RequestedContrastAgentLO
00380010AdmissionIDLO
00380016RouteOfAdmissionsLO
00380020AdmittingDateDA
00380021AdmittingTimeTM
00380050SpecialNeedsLO
00380060ServiceEpisodeIDLO
00380062ServiceEpisodeDescriptionLO
00380300CurrentPatientLocationLO
00380400PatientInstitutionResidenceLO
00380500PatientStateLO
00400244PerformedProcedureStepStartDateDA
00400245PerformedProcedureStepStartTimeTM
00400250PerformedProcedureStepEndDateDA
00400251PerformedProcedureStepEndTimeTM
00400253PerformedProcedureStepIDSH
00081032ProcedureCodeSequenceSQ
00100024IssuerOfPatientIDQualifiersSequenceSQ
00321034RequestingServiceCodeSequenceSQ
00321064RequestedProcedureCodeSequenceSQ
00401012ReasonForPerformedProcedureCodeSequenceSQ

系列層級 (includefield=all)

下表列出指定 時傳回includefield=all的序列層級屬性。序列層級也會傳回上表中列出的所有研究層級屬性。

includefield=all 的序列層級屬性
Tag 名稱 虛擬實境
00080021SeriesDateDA
00080031SeriesTimeTM
00080060模態CS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070製造商LO
00080080InstitutionNameLO
00080082InstitutionCodeSequenceSQ
00081010StationNameSH
0008103ESeriesDescriptionLO
0008103FSeriesDescriptionCodeSequenceSQ
00081040InstitutionalDepartmentNameLO
00081041InstitutionalDepartmentTypeCodeSequenceSQ
00081050PerformingPhysicianNamePN
00081070OperatorsNamePN
00081090ManufacturerModelNameLO
00180010ContrastBolusAgentLO
00180015BodyPartExaminedCS
00180050SliceThicknessDS
00180088SpacingBetweenSlicesDS
00181000DeviceSerialNumberLO
00181016SecondaryCaptureDeviceManufacturerLO
00181018SecondaryCaptureDeviceManufacturerModelNameLO
00181019SecondaryCaptureDeviceSoftwareVersionsLO
00181020SoftwareVersionsLO
00181030ProtocolNameLO
00181050SpatialResolutionDS
00181200DateOfLastCalibrationDA
00181201TimeOfLastCalibrationTM
00185100PatientPositionCS
0020000DStudyInstanceUIDUI
0020000ESeriesInstanceUIDUI
00200011SeriesNumberIS
00200052FrameOfReferenceUIDUI
00200060側位CS
00201209NumberOfSeriesRelatedInstancesIS
00540081NumberOfSlices美國
00540101NumberOfTimeSlices美國
00541000SeriesTypeCS

執行個體層級 (includefield=all)

在執行個體層級， includefield=all會傳回完整的執行個體層級 DICOM 中繼資料。這包括存放在 HealthImaging 儲存體中執行個體中繼資料中的所有屬性。傳回該執行個體原始 DICOM 檔案中存在的每個 DICOM 標籤，像素資料屬性除外。

主題