Skip to content
DICOM sorting utility
Python Makefile
Branch: master
Clone or download
suever Merge pull request #78 from suever/js_metadata
Make website and repository URLs constants
Latest commit cc49d36 Feb 7, 2020


CircleCI Maintainability Test Coverage PyPi version

DICOM Sort is a utility that takes a series of DICOM images stored within an arbitrary directory structure and sorts them into a directory tree based upon the value of selected DICOM fields.


Binary Installers

Binary distributions for Windows and Mac OS are available at the project website.

Installation via pip

DICOM Sort is available as dicomsort on the Python Package Index (pypi) and can therefore easily be installed with pip.

pip install dicomsort

After installation, DICOM Sort can be launched with simply the dicomsort command line script:


Installation via setuptools

To install from source, first clone the git repository

git clone

Install the dicomsort script using the project's file. This will automatically install all project dependencies

cd dicomsort
python install


For running tests, you will want to install the required development dependencies using the provided requirements.txt file:

pip install -r requirements.txt

For running tests, we use pytest. These can be run reproducibly using the provided Makefile

make test


If you have any questions or would like to request a feature, feel free to provide feedback via the Github Issues page.


This software is licensed under the MIT License Copyright (C) 2011 - 2020 Jonathan Suever

You can’t perform that action at this time.