DICOM PS3.18 2021d - Web Services

10 Studies Service and Resources (Current)
Prev |  | Next

# 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.
{bulkdataURI} | 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 Study.
Study Bulkdata | The Study Bulkdata resource references the Bulkdata of a Study.
Study Pixel Data | The Study Pixel Data resource references the Pixel Data of a 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 Series in a Study.
Series Bulkdata | The Series Bulkdata resource references the Bulkdata of a Series.
Series Pixel Data | The Series Pixel Data resource references the Pixel Data of a Series.
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 an Instance.
Instance Bulkdata | The Instance Bulkdata resource references the Bulkdata of a Instance.
Instance Pixel Data | The Instance Pixel Data resource references the Pixel Data of a 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 a Bulkdata Value.

### Note

There is no Frame Bulkdata or Frame Pixel Data resource because they would be equivalent to the Frames resource.

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

Prev |  | Next
9.5.3.3 Response Payload | Home | 10.2 Conformance

DICOM PS3.18 2021d - Web Services