View a markdown version of this page

HealthImaging에서 DICOM 데이터 검색 - AWS HealthImaging
HealthImaging용 DICOMweb 검색 APIsHealthImaging에 지원되는 DICOMweb 쿼리 유형QIDO-RS 쿼리에서 IncludeField 사용

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

HealthImaging에서 DICOM 데이터 검색

AWS HealthImaging은 DICOMweb QIDO-RS APIs를 표현하여 환자 ID별로 연구, 시리즈 및 인스턴스를 검색하고 추가 사용을 위해 고유 식별자를 수신합니다. HealthImaging의 DICOMweb QIDO-RS APIs HealthImaging에 저장된 데이터를 검색하고 레거시 애플리케이션과의 상호 운용성을 제공하는 방법에 유연성을 제공합니다.

중요

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는 웹 기반 의료 영상에 대한 DICOMweb(QIDO-RS) 표준을 준수하도록 구축되었습니다. AWS CLI 및 AWS SDKs 통해 제공되지 않습니다.

HealthImaging용 DICOMweb 검색 APIs

다음 표에서는 HealthImaging에서 데이터를 검색하는 데 사용할 수 있는 DICOMweb QIDO-RS APIs의 모든 HealthImaging 표현을 설명합니다.

DICOMweb QIDO-RS APIs의 HealthImaging 표현
이름 설명
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
쿼리 태그 지정

그룹/요소 양식에 전달된 쿼리 파라미터를 사용하여 태그를 검색합니다.

0020000D와 같은 {group}{element}
범위 쿼리

...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY
limit 및를 사용한 결과 페이징 offset

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

제한 및 오프셋 파라미터를 사용하여 검색 응답을 페이지 매김할 수 있습니다. 제한의 기본값은 1000이며 최대값은 섹션을 참조AWS HealthImaging 엔드포인트 및 할당량하세요.

최대 한도 = 1000, 최대 오프셋 = 9000
와일드카드 쿼리

와일드카드 쿼리는 "*" 및 "?"를 사용하여 보다 유연하게 검색할 수 있습니다. "*"는 모든 문자 시퀀스(길이가 0인 값 포함) 및 "?"와 일치합니다. 는 모든 단일 문자와 일치합니다.

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))에서 fuzzy 일치를 활성화합니다.

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

QIDO-RS 쿼리에서 IncludeField 사용

includefield 쿼리 파라미터를 사용하면 HealthImaging QIDO-RS 쿼리의 기본 응답 세트 외에 추가 DICOM 속성을 요청할 수 있습니다. 연구, 시리즈 및 인스턴스 수준에서 includefield를 사용할 수 있습니다.

구문

QIDO-RS 쿼리에 추가 필드를 포함하려면 다음 GET 요청 형식을 사용합니다.

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 파라미터에 대해 지원되는 값을 설명합니다.

지원되는 includefield 값
값 유형 설명 예제
DICOM 태그(816진수 문자) 태그별로 GGGGEE 형식의 특정 DICOM 속성을 요청합니다. includefield=00081030
all 리소스 수준에서 사용 가능한 모든 DICOM 속성을 요청합니다. includefield=all
점선 SQ 경로 점 표기법: <parent_tag>.<child_tag>를 사용하여 시퀀스(SQ) 속성 내에서 특정 하위 속성을 요청합니다. includefield=00080096.00080100
프라이빗 데이터 요소 태그 프라이빗 태그(odd-group 요소)를 요청합니다. privateCreatorElement 파라미터가 필요합니다. includefield=00191001
bulkdata를 포함한 표준 DICOM 속성 태그 또는 키워드별로 특정 단일 또는 다중 속성을 요청합니다. includefield=00102201

동작 및 규칙

includefield 쿼리에는 다음 규칙이 적용됩니다.

  • 기본 응답 -이 없으면 includefieldQIDO-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 데이터 요소(홀수 그룹 태그)는 모든 리소스 수준에서 지원됩니다. 프라이빗 태그를 요청하려면 privateCreatorElement 쿼리 파라미터를 포함합니다.

다음 구문을 사용합니다.

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

예제:

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

프라이빗 태그에는 다음 규칙이 적용됩니다.

  • 프라이빗 privateCreatorElement 태그가 요청된 경우 태그와 생성자 이름을 일치 파라미터로 제공해야 합니다.

  • 지정된 privateCreatorElement를 찾을 수 없는 경우 프라이빗 태그는 자동으로 생략됩니다.

  • 프라이빗 데이터 요소가 없는 privateCreatorElement 태그만 요청하면 생성자 요소 이름과 값만 반환됩니다. 해당 생성자의 블록에 속하는 모든 태그를 반환하지는 않습니다.

대량 데이터 태그

의 일부로 요청된 이진 값이 1MB보다 큰 bulkdata VRs(OB, OD, OF, OL, UN, OW, OV)이 있는 DICOM 속성includefield은 원시 이진 값 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
00100028SubjectRelativePositionInImageUS
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
001021C0PregnancyStatusUS
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
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
00540081NumberOfSlicesUS
00540101NumberOfTimeSlicesUS
00541000SeriesTypeCS

인스턴스 수준(includefield=all)

인스턴스 수준에서는 전체 인스턴스 수준 DICOM 메타데이터를 includefield=all 반환합니다. 여기에는 HealthImaging 스토리지의 인스턴스 메타데이터에 저장된 모든 속성이 포함됩니다. 픽셀 데이터 속성을 제외하고 해당 인스턴스의 원본 DICOM 파일에 있는 모든 DICOM 태그가 반환됩니다.

주제