DICOM PS3.18 2024d - 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.

{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 an alternate media type rendering of a Study.

Rendered MPR Volume Study

The Rendered MPR Volume Study resource references a multiplanar reformat rendering of a Study.

Rendered 3D Volume Study

The Rendered 3D Volume Study resource references a volume rendering of a Study.

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 an alternate media type rendering of a Series.

Rendered MPR Volume Series

The Rendered MPR Volume Series resource references a multiplanar reformat rendering of a Series.

Rendered 3D Volume Series

The Rendered 3D Volume Series resource references a volume rendering of a Series.

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 alternate media type rendering of an Instance.

Rendered MPR Volume Instance

The Rendered MPR Volume Instance resource references a multiplanar reformat rendering of an Instance.

Rendered 3D Volume Instance

The Rendered 3D Volume Instance resource references a volume rendering of an Instance.

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 alternate media type rendering of an ordered collection of frames of a single multi-frame Instance.

Rendered MPR Volume Frames

The Rendered MPR Volume Frames resource references a multiplanar reformat rendering of a collection of frames.

Rendered 3D Volume Frames

The Rendered 3D Volume Frames resource references a volume rendering of a collection of frames.

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.

DICOM PS3.18 2024d - Web Services