DICOM PS3.18 2019b - 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.
{/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.

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

DICOM PS3.18 2019b - Web Services