DICOM PS3.18 2020b - Web Services

10 Studies Service and Resources

10.1 Overview

The Studies Resource enables a user agent to store, retrieve, update, and search an origin server for DICOM Studies, Series, and Instances, along with their /metadata, /rendered, and /thumbnail variants; as well as Frames and Bulkdata.

The Retrieve transaction of this Service is also known as WADO-RS. The Store transaction of this Service is also known as STOW-RS. The Search transaction of this Service is also known as QIDO-RS. See Section 10.3.

10.1.1 Resource Descriptions

The Studies Service manages a collection of DICOM Study resources. Each Study is organized in a hierarchy of sub-resources that correspond to the DICOM Information Model. See Section 7 “DICOM Model of the Real World” in PS3.3.

There are three top level resources:

/studies

references all Studies managed by the service.

/series

references all Series managed by the service.

/instances

references all Instances managed by the service.

The following URI Template variables are used in resource definitions in this Section.

{study}

the Study Instance UID of a Study managed by the Studies Service.

{series}

the Series Instance UID of a Series contained within a Study resource.

{instance}

the SOP Instance UID of an Instance contained within a Series resource.

{frames}

a comma-separated list of frame numbers, in ascending order, contained within an Instance.

{/bulkdata}

an opaque URI that references a Bulkdata Value.

The Studies Service defines the following resources:

Table 10.1-1. Resources and Descriptions

Resource

Description

Studies Service

The Base URI of the Studies Service.

All Studies

The All Studies resource references the entire collection of Studies contained in the Studies Service.

Study

The Study resource references a single Study.

Study Metadata

The Study Metadata resource references the Metadata of a single Study.

Rendered Study

The Rendered Study resource references a Study to be rendered.

Study Thumbnail

The Study Thumbnail resource references a thumbnail image of a Study.

Study's Series

The Study's Series resource references the collection of all Series contained in a Study.

Study's Instances

The Study's Instances resource references the collection of all Instances in a single Study.

All Series

The All Series resource references the collection of all Series in all Studies contained in the Studies Service.

Series

The Series resource references a single Series.

Series Metadata

The Series Metadata resource contains the Metadata of a single Series in a Study.

Rendered Series

The Rendered Series resource references a Series to be rendered.

Series Thumbnail

The Series Thumbnail resource references a thumbnail image of a Series.

Series' Instances

The Series' Instances resource references the collection of all Instances in a single Series.

All Instances

The All Instances resource references the collection of all Instances in all Series in all Studies contained in the Studies Service.

Instance

The Instance resource references a single Instance.

Instance Metadata

The Instance Metadata resource contains the Metadata of a single Instance.

Rendered Instance

The Rendered Instance resource references an Instance to be rendered.

Instance Thumbnail

The Instance Thumbnail resource references a thumbnail image of an Instance.

Frames

The Frames resource references an ordered collection of frames in a single multi-frame Instance.

Rendered Frames

The Rendered Frames resource references an ordered collection of frames of a single multi-frame Instance, to be rendered.

Frame Thumbnail

The Frame Thumbnail resource references a thumbnail image for frames within an Instance.

Bulkdata

The Bulkdata resource contains one or more Bulkdata Values.


10.1.2 Common Query Parameters

The origin server shall support Query Parameters as required in Table 10.1.2-1.

The user agent shall supply in the request Query Parameters as required in Table 10.1.2-1.

Table 10.1.2-1. Common Query Parameters

Name

Value

Usage

Section

User Agent

Origin Server

Accept

media-type

O

M

Section 8.3.3.1

Accept-Charset

charset

O

M

Section 8.3.3.2


10.1.3 Common Media Types

The origin server media type requirements are defined in each Transaction of this Service.

The origin server shall support the Transfer Syntax and Character Set media type parameters. See Section 8.7.3.5.2 and Section 8.7.3.5.3.

DICOM PS3.18 2020b - Web Services