DICOM Writer

The DICOM Writer is a post-processor that converts MHD files into DICOM files.

Each MHD file should be named after the Series Instance UID associated with its original DICOM series (e.g. 1.2.826.0.1.3680043.2.1125.1.30521143073416610365663301213782755.mhd). Each MHD file is converted into a series of DICOM files which are output to a specified directory. Each DICOM file is named with an auto-generated UID. The output directory is subsequently consumed by the Clara DICOM Adapter.


Before running the container, use docker pull to ensure an up-to-date image is installed. Once the pull is complete, you can run the container image as part of a workflow.

Run DICOM Writer with the following steps:

  1. In the Tags section, locate the container image release that you want to run.

  2. In the PULL TAG column in the table, click the icon to copy the docker pull command.

#. Open a command prompt and paste the pull command. The pulling of the container image begins. Ensure the pull completes successfully before proceeding to the next step. #.

Create dicom, mhd and output folders for mounting the container with the following command:


mkdir -p DICOM mhd output

  1. Copy DICOM files to the dicom folder and mhd files to the mhd folder with the following commands:


    # Copy DICOM files to the DICOM folder cp -r /path/to/dicom/files dicom # Copy mhd files to the mhd folder cp -r /path/to/mhd/files mhd

    The DICOM Writer converts mhd files in the mhd folder to DICOM files in the output folder using headers from the DICOM files in the dicom folder.

  2. Run the DICOM Writer with the dicom, mhd and output directories with the following command:


    docker run -it -d \ -e NVIDIA_CLARA_RUNSIMPLE=TRUE \ -e NVIDIA_CLARA_JOBID="692f5d9e-2c97-4e4b-87e8-7dc9bfacf5b2" \ -e NVIDIA_CLARA_JOBNAME="test-dicom-write" -e NVIDIA_CLARA_STAGENAME="io" -e NVIDIA_CLARA_APPDIR="/app" -e NVIDIA_CLARA_INPUTS="payload/dicom;payload/mhd" -e NVIDIA_CLARA_OUTPUTS="payload/output" -v `pwd`/dicom:/app/payload/dicom \ -v `pwd`/mhd:/app/payload/mhd \ -v `pwd`/output:/app/payload/output \ dicom-writer:latest Note: The above image tag is set to ``latest``. Replace ``latest`` with the image tag used in step 1.

The license to this container is available. It can be pulled as part of the procedure described above or available in the Clara Deploy SDK. By pulling and using the container, you accept the terms and conditions of these licenses.

Release Notes and the Getting Started Guide are available at the NVIDIA Developer forum (https://developer.nvidia.com/clara).

Use the NVIDIA Devtalk forum for questions about this release (https://devtalk.nvidia.com/default/board/362/clara-sdk/).

© Copyright 2018-2019, NVIDIA Corporation. All rights reserved. Last updated on Feb 1, 2023.