Initiate Computation (for CTs)

Learn how to initiate computation(processing) for uploaded DICOMs with the /compute API.

Related Guides: For CTs

Overview

You can use the /compute API to initiate computation for the uploaded DICOMs. Append the SeriesInstanceUID in the request URL.

API Format

GET /compute/<SeriesInstanceUID>

Request Formats

cURL

curl -X GET \\
-L 'Base_URL/compute/<SeriesInstanceUID>' \\
-H 'Authorization: Token <PASTE_YOUR_TOKEN>' \\
-H 'Source: <PASTE_YOUR_SOURCE>' \\
-H 'User-Agent: <YOUR_USER_AGENT>'

Python

import requests
import pydicom

# To fetch SeriesInstanceUID using pydicom 

series_instance_uid = pydicom.read_file('<path/to/your/dicom_file.dcm>').SeriesInstanceUID

url = f"Base_URL/compute/{series_instance_uid}"

# Headers, including the Authorization token and Source
headers = {
    'Authorization': 'Token <PASTE_YOUR_TOKEN>',
    'Source': '<PASTE_YOUR_SOURCE>',
    'User-Agent': '<YOUR_USER_AGENT>'
}

# Perform the GET request
response = requests.get(url, headers=headers)

# Print the response text
print(response.text)

Initiate Computation.

GETBASE_URL/compute/{SeriesInstanceUID}

Path parameters

SeriesInstanceUID*string

The unique identifier for the series to initiate computation on.

Body

application/json

recomputeboolean

Response

200304401403404

Computation initiated successfully

Body

application/json

messagestring

A message that validates the request based on the response status code.

Example: "series_instance_uid successfully pushed for computation!"

successboolean

Example: true

Request

cURLPython

curl -X GET \\
-L 'Base_URL/compute/<SeriesInstanceUID>' \\
-H 'Authorization: Token <PASTE_YOUR_TOKEN>' \\
-H 'Source: <PASTE_YOUR_SOURCE>'

Response

200304401403404

{
  "message": "series_instance_uid successfully pushed for computation!",
  "success": true
}