semvec/pypi-packages huggingface dataset:
pydicomsorter 0.15.0
A Quick Tool For Sorting Dicom Files
Requires Python: >=3.10
Keywords: package, pixi, pydicomsorter, python

# pydicomsorter

[![codecov](https://codecov.io/gh/jjjermiah/PyDicomSorter/graph/badge.svg?token=tCcajRIGz9)](https://codecov.io/gh/jjjermiah/PyDicomSorter)
[![CI-CD](https://github.com/jjjermiah/PyDicomSorter/actions/workflows/main.yaml/badge.svg)](https://github.com/jjjermiah/PyDicomSorter/actions/workflows/main.yaml)
[![CodeFactor](https://www.codefactor.io/repository/github/jjjermiah/pydicomsorter/badge)](https://www.codefactor.io/repository/github/jjjermiah/pydicomsorter)

[![pixi-badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json&style=flat-square)](https://github.com/prefix-dev/pixi)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&style=flat-square)](https://github.com/pre-commit/pre-commit)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square)](https://github.com/astral-sh/ruff)
[![Built with Material for MkDocs](https://img.shields.io/badge/mkdocs--material-gray?logo=materialformkdocs&style=flat-square)](https://github.com/squidfunk/mkdocs-material)


[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pydicomsorter)](https://pypi.org/project/pydicomsorter/)
[![PyPI - Version](https://img.shields.io/pypi/v/PyDicomSorter)](https://pypi.org/project/pydicomsorter/)
[![PyPI - Format](https://img.shields.io/pypi/format/PyDicomSorter)](https://pypi.org/project/pydicomsorter/)
[![Downloads](https://static.pepy.tech/badge/pydicomsorter)](https://pepy.tech/project/pydicomsorter)


PyDicomSorter is a python package that sorts dicom files into a structured directory based on the dicom tags.

It can be used as a command line tool or as a python package.

## Installation

```bash
pip install PyDicomSorter
```


Testing the pydicom library to sort dicom files by patient name and study date.

> [!NOTE] none of this works yet

Designing should look like:

![Command output](./assets/help.png)

# DICOM data model

A Patient has one or more Studies, a Study has one or more Series, and a Series has one or more Instances.

```mermaid
graph TD
    A[Patient] --> B(Study)
    B --> C(Series)
    C --> D(Instance)

```

<!-- [![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats)

[![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=jjjermiah)](https://github.com/jjjermiah/github-readme-stats) -->

<!-- [![GitHub Trends SVG](https://api.githubtrends.io/user/svg/jjjermiah/langs)](https://githubtrends.io) -->