View a markdown version of this page

在中搜索 DICOM 数据 HealthImaging - AWS HealthImaging
适用于 dicomWeb 的搜索 API HealthImaging支持的 DicomWeb 查询类型 HealthImagingIncludeField 在 QIDO-RS 查询中使用

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在中搜索 DICOM 数据 HealthImaging

AWS HealthImaging 提供 DicomWeb QIDO-RS API 的表示形式，用于按患者 ID 搜索研究、系列和实例，并接收其唯一标识符以供进一步使用。 HealthImaging的 DicomWeb QIDO-RS API 可以灵活地搜索存储在中的数据， HealthImaging 并提供与传统应用程序的互操作性。

重要提示

HealthImaging的 dicomWeb API 可用于返回图像集信息。 QIDO-RS HealthImaging 除非另有说明，否则 DicomWeb API 仅引用主图像集。使用 HealthImaging云原生操作或 DicomWeb 操作的可选图像集参数来检索非主图像集。 HealthImaging的 dicomWeb API 可用于返回带有 DICOMweb-conformant 响应的图像集信息。

HealthImaging DicomWeb QIDO-RS 操作最多可以返回 10,000 条记录。如果存在超过 10,000 个资源，则无法通过操作检索它们，但可以通过 DicomWeb QIDO-RS 操作或云原生 WADO-RS 操作进行检索。

本节中列出的 API 符合基于 Web 的医学成像的 dicomWeb (QIDO-RS) 标准。它们不是通过 AWS CLI 和 AWS SDK 提供的。

适用于 dicomWeb 的搜索 API HealthImaging

下表描述了可用于在中搜索数据的 DicomWeb QIDO-RS API 的所有 HealthImaging 表示形式。 HealthImaging

HealthImaging dicomWeb API QIDO-RS 的表示形式
Name 说明
SearchDICOMStudies 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 研究。研究搜索结果以 JSON 格式返回，按上次更新排序，日期降序（从最新到最旧）。请参阅搜索研究。
SearchDICOMSeries 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 系列。系列搜索结果以 JSON 格式返回，按Series Number (0020, 0011)升序排序（从最旧到最新）。请参阅搜索系列。
SearchDICOMInstances 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 实例。实例搜索结果以 JSON 格式返回，按Instance Number (0020, 0013)升序排序（从最旧到最新）。请参阅搜索实例。

支持的 DicomWeb 查询类型 HealthImaging

HealthImaging 支持研究、系列和 SOP 实例级别的 QIDO-RS 分层资源查询。使用 QIDO-RS 分层搜索时 HealthImaging：

  • 搜索研究会返回研究列表

  • 搜索研究系列需要已知序列StudyInstanceUID并返回系列列表

  • 搜索实例列表需要已知StudyInstanceUID和 SeriesInstanceUID

下表描述了支持在中搜索数据的 QIDO-RS 分层查询类型 HealthImaging。

HealthImaging 支持的 QIDO-RS 查询类型
查询类型 示例
属性值查询

在 “研究” 中搜索所有系列，其中modality=CT.

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

搜索所有分别以患者身份和研究日期为这些值的研究。

…/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 表单中传递的查询参数搜索标签。

{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 结尾的研究：

.../studies?StudyDescription=*Nuclear

搜索所有以 “核” StudyDescription 开头的研究：

.../studies?StudyDescription=Nuclear*

搜索所有在 200965981 之后的 patienTid 完全包含任意 3 个字符的研究：

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

通过添加模糊匹配可选查询参数，启用名称 DICOM 属性（PatientName (0010,0010)、 ReferringPhysicianName (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

IncludeField 在 QIDO-RS 查询中使用

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参数支持的值。

支持的包含字段值
值类型 说明 示例
DICOM 标签（8 个十六进制字符） 通过 GGGGEEEE 格式的标签请求特定的 DICOM 属性。 includefield=00081030
all 请求资源级别的所有可用的 DICOM 属性。 includefield=all
虚线 SQ 路径 <parent_tag>使用点表示法请求序列 (SQ) 属性中的特定子属性：。 <child_tag>。 includefield=00080096.00080100
私有数据元素标签 请求私有标签（奇数组元素）。需要privateCreatorElement参数。 includefield=00191001
标准 DICOM 属性，包括批量数据 按标签或关键字请求特定的单个或多个属性。 includefield=00102201

行为和规则

以下规则适用于includefield查询：

  • 默认响应-如果没有includefield，则 QIDO-RS 响应仅返回标准的属性集。

  • includefield=al l — 返回请求级别的所有可用属性。与其他allincludefield值组合使用时，all优先考虑。

  • 最大标签数-一个请求最多可以包含 50 个includefield参数。

  • 重复标记-重复includefield值会被删除并视为单个请求。

  • 标签无效或缺失-如果请求的标签在 DICOM 数据中不存在或无效，则会在响应中默默省略该标签。其他有效includefield属性仍会返回。

序列 (SQ) 属性

使用点表示法请求序列 (SQ) 属性中的嵌套属性：

includefield=<parent_SQ_tag>.<child_tag>

例如，要在 (0008,0096) 范围内检索 CodeValue (0008,0100)，请执行以下 ReferringPhysicianIdentificationSequence 操作：

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

Multi-level 支持嵌套。例如：

includefield=00081115.00081199.00081150

私有标签

所有资源级别都支持私有 DICOM 数据元素（奇数组标签）。要请求私有标签，请添加privateCreatorElement查询参数。

使用以下语法：

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

例如：

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

以下规则适用于私有标签：

  • 如果请求私有privateCreatorElement标签，则必须将标签和创建者姓名作为匹配参数提供。

  • 如果未找到指定privateCreatorElement的，则会默默省略私有标签。

  • 仅请求没有私有数据元素的privateCreatorElement标签只会返回创建者元素的名称和值。它不会返回属于该创建者区块的所有标签。

批量数据标签

请求的二进制值大于 1 MB 的批量数据 VR（OB、OD、OF、OL、UN、OW、OV）的 DICOM 属性将includefield作为原始二进制值bulkdataURI而不是原始二进制值返回。有关检索批量数据的更多信息，请参阅中的检索 DICOM 批量数据。 HealthImaging

includefield=all 在每个级别返回什么？

指定后includefield=all，响应将包括特定资源级别的所有属性。

学习等级（包括字段=全部）

下表列出了指定时includefield=all在研究级别返回的所有属性。

includefield=all 的研究级别属性
Tag Name VR
00080005SpecificCharacterSetCS
00080020StudyDateDA
00080030StudyTimeTM
00080050AccessionNumberSH
00080051IssuerOfAccessionNumberSequence平方米
00080056InstanceAvailabilityCS
00080061ModalitiesInStudyCS
00080062SOPClassesInStudyUI
00080090ReferringPhysicianNamePN
0008009CConsultingPhysicianNamePN
00080201TimezoneOffsetFromUTCSH
00081030StudyDescription哈哈
00081048PhysiciansOfRecordPN
00081060NameOfPhysiciansReadingStudyPN
00081080AdmittingDiagnosesDescription哈哈
00081190检索网址你的
00100010PatientNamePN
00100020patienTid哈哈
00100021IssuerOfPatientID哈哈
00100022TypeOfPatientIDCS
00100026SourcePatientGroupIdentificationSequence平方米
00100027GroupOfPatientsIdentificationSequence平方米
00100028SubjectRelativePositionInImage美国
00100030PatientBirthDateDA
00100032PatientBirthTimeTM
00100033PatientBirthDateInAlternativeCalendar哈哈
00100034PatientDeathDateInAlternativeCalendar哈哈
00100035PatientAlternativeCalendarCS
00100040PatientSexCS
00100050PatientInsurancePlanCodeSequence平方米
00100101PatientPrimaryLanguageCodeSequence平方米
00100102PatientPrimaryLanguageModifierCodeSequence平方米
00100200QualityControlSubjectCS
00100201QualityControlSubjectTypeCodeSequence平方米
00100213StrainNomenclature哈哈
00100214StrainStockNumber哈哈
00100215StrainSourceRegistryCodeSequence平方米
00100217StrainSource哈哈
00100219StrainCodeSequence平方米
00100223GeneticModificationsNomenclature哈哈
00100229GeneticModificationsCodeSequence平方米
00101001OtherPatientNamesPN
00101005PatientBirthNamePN
00101010PatientAgeAS
00101020PatientSizeDS
00101021PatientSizeCodeSequence平方米
00101022PatientBodyMassIndexDS
00101023测量的 dap 维度DS
00101024MeasuredLateralDimensionDS
00101030PatientWeightDS
00101040PatientAddress哈哈
00101060PatientMotherBirthNamePN
00101080MilitaryRank哈哈
00101081BranchOfService哈哈
00102000MedicalAlerts哈哈
00102110过敏哈哈
00102150CountryOfResidence哈哈
00102152RegionOfResidence哈哈
00102154PatientTelephoneNumbersSH
00102160EthnicGroupSH
00102180职业SH
001021A0SmokingStatusCS
001021C0PregnancyStatus美国
001021D0LastMenstrualDateDA
001021F0PatientReligiousPreference哈哈
00102201PatientSpeciesDescription哈哈
00102202PatientSpeciesCodeSequence平方米
00102203PatientSexNeuteredCS
00102210AnatomicalOrientationTypeCS
00102292PatientBreedDescription哈哈
00102293PatientBreedCodeSequence平方米
00102295BreedRegistrationNumber哈哈
00102296BreedRegistryCodeSequence平方米
00102297ResponsiblePersonPN
00102298ResponsiblePersonRoleCS
001022999ResponsibleOrganization哈哈
00109431ExaminedBodyThicknessFL
0020000DStudyInstanceUIDUI
00200010StudyIDSH
00201206NumberOfStudyRelatedSeriesIS
00201208NumberOfStudyRelatedInstancesIS
00321032RequestingPhysicianPN
00321033RequestingService哈哈
00321060RequestedProcedureDescription哈哈
00321070RequestedContrastAgent哈哈
00380010入学证件哈哈
00380016RouteOfAdmissions哈哈
00380020AdmittingDateDA
00380021AdmittingTimeTM
00380050SpecialNeeds哈哈
00380060ServiceEpisode身份证哈哈
00380062ServiceEpisodeDescription哈哈
00380300CurrentPatientLocation哈哈
00380400PatientInstitutionResidence哈哈
00380500PatientState哈哈
00400244PerformedProcedureStepStartDateDA
00400245PerformedProcedureStepStartTimeTM
00400250PerformedProcedureStepEndDateDA
00400251PerformedProcedureStepEndTimeTM
00400253PerformedProcedureStepIDSH
00081032ProcedureCodeSequence平方米
00100024IssuerOfPatientIDQualifiersSequence平方米
00321034RequestingServiceCodeSequence平方米
00321064RequestedProcedureCodeSequence平方米
00401012ReasonForPerformedProcedureCodeSequence平方米

系列级别（包含字段=全部）

下表列出了指定时includefield=all返回的系列级属性。系列级别还会返回上表中列出的所有学习级别属性。

includefield=all 的系列级别属性
Tag Name VR
00080021SeriesDateDA
00080031SeriesTimeTM
00080060模式CS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070Manufacturer哈哈
00080080InstitutionName哈哈
00080082InstitutionCodeSequence平方米
00081010StationNameSH
0008103ESeriesDescription哈哈
0008103FSeriesDescriptionCodeSequence平方米
00081040InstitutionalDepartmentName哈哈
00081041InstitutionalDepartmentTypeCodeSequence平方米
00081050PerformingPhysicianNamePN
00081070OperatorsNamePN
00081090ManufacturerModelName哈哈
00180010ContrastBolusAgent哈哈
00180015BodyPartExaminedCS
00180050SliceThicknessDS
00180088SpacingBetweenSlicesDS
00181000DeviceSerialNumber哈哈
00181016SecondaryCaptureDeviceManufacturer哈哈
00181018SecondaryCaptureDeviceManufacturerModelName哈哈
00181019SecondaryCaptureDeviceSoftwareVersions哈哈
00181020SoftwareVersions哈哈
00181030ProtocolName哈哈
00181050SpatialResolutionDS
00181200DateOfLastCalibrationDA
00181201TimeOfLastCalibrationTM
00185100PatientPositionCS
0020000DStudyInstanceUIDUI
0020000ESeriesInstanceUIDUI
00200011SeriesNumberIS
00200052FrameOfReferenceUIDUI
00200060横向性CS
00201209NumberOfSeriesRelatedInstancesIS
00540081NumberOfSlices美国
00540101NumberOfTimeSlices美国
00541000SeriesTypeCS

实例级别（包含字段=全部）

在实例级别，includefield=all返回完整的实例级 DICOM 元数据。这包括存储在实例元数据中的 HealthImaging所有属性。返回该实例的原始 DICOM 文件中存在的每个 DICOM 标签，但像素数据属性除外。

主题