View a markdown version of this page

HealthImaging での DICOM データの検索 - AWS HealthImaging
HealthImaging の DICOMweb 検索 APIsHealthImaging でサポートされている DICOMweb クエリタイプ"DO-RS クエリでの IncludeField の使用

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

HealthImaging での DICOM データの検索

AWS HealthImaging は、DICOMweb の "DO-RS APIs の表現を提供し、患者 ID で検査、シリーズ、インスタンスを検索し、さらに使用するための一意の識別子を受け取ります。HealthImaging の DICOMweb "DO-RS APIsは、HealthImaging に保存されているデータを検索する方法に柔軟性を提供し、レガシーアプリケーションとの相互運用性を提供します。

[重要]

HealthImaging の DICOMweb APIs を使用して、画像セット情報を "DO-RS で返すことができます。HealthImaging DICOMweb APIs、特に明記されていない限り、プライマリイメージセットのみを参照します。HealthImaging クラウドネイティブアクション、または DICOMweb アクションのオプションの画像セットパラメータを使用して、非プライマリ画像セットを取得します。HealthImaging の DICOMweb APIs を使用して、DICOMweb 準拠のレスポンスで画像セット情報を返すことができます。

HealthImaging DICOMweb "DO-RS アクションは、最大 10,000 件のレコードを返すことができます。10,000 を超えるリソースが存在する場合、これらは "DO-RS アクションでは取得できませんが、DICOMweb WADO-RS アクションまたはクラウドネイティブアクションで取得できます。

このセクションに記載されている APIs は、ウェブベースの医療画像用の DICOMweb ("DO-RS) 標準に準拠して構築されています。 AWS CLI および AWS SDKs では提供されません。

HealthImaging の DICOMweb 検索 APIs

次の表は、HealthImaging でデータを検索するために使用できる DICOMweb の "DO-RS APIs のすべての HealthImaging 表現を示しています。

HealthImaging による DICOMweb "DO-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 インスタンスレベルで "DO-RS 階層型リソースクエリをサポートしています。HealthImaging に "DO-RS 階層検索を使用する場合:

  • スタディを検索すると、スタディのリストが返されます。

  • 研究のシリーズを検索するには、既知の が必要StudyInstanceUIDで、シリーズのリストを返します。

  • インスタンスのリストを検索するには、既知の StudyInstanceUIDと SeriesInstanceUID

次の表は、HealthImaging でデータを検索するためにサポートされている "DO-RS 階層クエリタイプを示しています。

HealthImaging でサポートされている "DO-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
タグクエリ

グループ/要素フォームで渡されたクエリパラメータを使用してタグを検索します。

0020000D のような {group}{element}
範囲クエリ

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
limit および を使用した結果のページング offset

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

制限パラメータとオフセットパラメータを使用して、検索レスポンスをページ分割できます。制限のデフォルト値は 1000 です。最大値AWS HealthImagingエンドポイントとクォータについては、「」を参照してください。

最大制限 = 1000、最大オフセット = 9000
ワイルドカードクエリ

ワイルドカードクエリは、「*」と「？」を使用した検索の柔軟性を高めます。「*」は、任意の文字シーケンス (長さがゼロの値を含む) と「？」と一致します。 は任意の 1 文字に一致します。

StudyDescription に「Nuclear」が含まれているデータストア内のすべての研究を検索します。

.../studies?StudyDescription=*Nuclear*

StudyDescription が「Nuclear」で終わるすべての研究を検索します。

.../studies?StudyDescription=*Nuclear

StudyDescription が「Nuclear」で始まるすべての研究を検索します。

.../studies?StudyDescription=Nuclear*

PatientID が 200965981 の後に 3 文字のみを持つすべての検査を検索します。

.../studies?PatientID=200965981???
FuzzyMatching クエリ

fuzzymatching オプションクエリパラメータを追加して、名前 DICOM 属性 (PatientName (0010,0010)、ReferringPhysicianName(0008,0090)) であいまい一致を有効にします。

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

このクエリは、 PatientName 値の任意の部分で大文字と小文字を区別しないプレフィックス単語マッチングを実行します。「thomas」、「Albert」、「Thomas Albert」、「Thomas^Albert」などの PatientName 値の結果を返しますが、「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

"DO-RS クエリでの IncludeField の使用

includefield クエリパラメータを使用すると、HealthImaging の "DO-RS クエリのデフォルトレスポンスセットを超える追加の DICOM 属性をリクエストできます。は、調査includefield、シリーズ、インスタンスレベルで使用できます。

構文

次の GET リクエスト形式を使用して、OktaDO-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>

1 つのリクエストで複数のincludefieldパラメータを指定できます。

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

includefield でサポートされている値

次の表に、 includefieldパラメータでサポートされている値を示します。

サポートされているインクルードフィールド値
値の型 説明 例
DICOM タグ (8 進数文字) GGGGEEEE 形式のタグで特定の DICOM 属性をリクエストします。 includefield=00081030
all リソースレベルで使用可能なすべての DICOM 属性をリクエストします。 includefield=all
ドット付き SQ パス ドット表記: <parent_tag>.<child_tag> を使用して Sequence (SQ) 属性内の特定のサブ属性をリクエストします。 includefield=00080096.00080100
プライベートデータ要素タグ プライベートタグ (odd-group 要素) をリクエストします。privateCreatorElement パラメータが必要です。 includefield=00191001
bulkdata を含む標準 DICOM 属性 タグまたはキーワードで特定の単一または複数の属性をリクエストします。 includefield=00102201

動作とルール

includefield クエリには、次のルールが適用されます。

  • デフォルトのレスポンス – がない場合includefield、 の "DO-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は、raw バイナリ値bulkdataURIの代わりに として返されます。バルクデータの取得の詳細については、HealthImaging での DICOM バルクデータの取得」を参照してください。

includefield=all は各レベルで何を返しますか?

includefield=all を指定すると、レスポンスには特定のリソースレベルのすべての属性が含まれます。

研究レベル (includefield=all)

次の表は、 が指定されているときに治験レベルで返されるすべての属性の一覧includefield=allです。

includefield=all の治験レベルの属性
タグ 名前 VR
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
00109431ExaminedBodyThicknessFL
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 のシリーズレベルの属性
タグ 名前 VR
00080021SeriesDateDA
00080031SeriesTimeTM
00080060モダリティCS
00080064ConversionTypeCS
00080068PresentationIntentTypeCS
00080070ManufacturerLO
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)

インスタンスレベルでは、 はインスタンスレベルの DICOM メタデータ全体includefield=allを返します。これには、HealthImaging ストレージのインスタンスメタデータに保存されているすべての属性が含まれます。ピクセルデータ属性を除く、そのインスタンスの元の DICOM ファイルに存在するすべての DICOM タグが返されます。

トピック