dicomtrolley

Name	dicomtrolley JSON
Version	3.3.0 JSON
	download
home_page	None
Summary	Retrieve medical images via WADO-URI, WADO-RS, QIDO-RS, MINT, RAD69 and DICOM-QR
upload_time	2025-09-18 12:30:33
maintainer	None
docs_url	None
author	None
requires_python	>=3.10
license	None
keywords	dicom dicom-web qido wado mint rad69 download
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage

            # dicomtrolley

[![CI](https://github.com/sjoerdk/dicomtrolley/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/sjoerdk/dicomtrolley/actions/workflows/build.yml?query=branch%3Amain)
[![PyPI](https://img.shields.io/pypi/v/dicomtrolley)](https://pypi.org/project/dicomtrolley/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dicomtrolley)](https://pypi.org/project/dicomtrolley/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)

Retrieve medical images via WADO-URI, WADO-RS, QIDO-RS, MINT, RAD69 and DICOM-QR

* Uses `pydicom` and `pynetdicom`. Images and query results are `pydicom.Dataset` instances
* Query and download DICOM Studies, Series and Instances
* Integrated search and download - automatic queries for missing series and instance info

![A trolley](docs/resources/trolley.png)

[dicomtrolley docs on readthedocs.io](https://dicomtrolley.readthedocs.io)

## Installation
```
pip install dicomtrolley
```

## Basic usage
```python
# Create a http session
session = requests.Session()

# Use this session to create a trolley using MINT and WADO
trolley = Trolley(searcher=Mint(session, "https://server/mint"),
                  downloader=WadoURI(session, "https://server/wado_uri"))

# find some studies (using MINT)
studies = trolley.find_studies(Query(PatientName='B*'))

# download the fist one (using WADO)
trolley.download(studies[0], output_dir='/tmp/trolley')
```

## Documentation
see [dicomtrolley docs on readthedocs.io](https://dicomtrolley.readthedocs.io)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "dicomtrolley",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "DICOM, DICOM-web, QIDO, WADO, MINT, RAD69, Download",
    "author": null,
    "author_email": "Sjoerd Kerkstra <sjoerd.kerkstra@radboudumc.nl>",
    "download_url": "https://files.pythonhosted.org/packages/ce/bc/bd46e875123500cc622183a23ca362ae25f13ffde6fd9bb081bebf3ed4e1/dicomtrolley-3.3.0.tar.gz",
    "platform": null,
    "description": "# dicomtrolley\n\n[![CI](https://github.com/sjoerdk/dicomtrolley/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/sjoerdk/dicomtrolley/actions/workflows/build.yml?query=branch%3Amain)\n[![PyPI](https://img.shields.io/pypi/v/dicomtrolley)](https://pypi.org/project/dicomtrolley/)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dicomtrolley)](https://pypi.org/project/dicomtrolley/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)\n\nRetrieve medical images via WADO-URI, WADO-RS, QIDO-RS, MINT, RAD69 and DICOM-QR\n\n* Uses `pydicom` and `pynetdicom`. Images and query results are `pydicom.Dataset` instances\n* Query and download DICOM Studies, Series and Instances\n* Integrated search and download - automatic queries for missing series and instance info\n\n![A trolley](docs/resources/trolley.png)\n\n[dicomtrolley docs on readthedocs.io](https://dicomtrolley.readthedocs.io)\n\n## Installation\n```\npip install dicomtrolley\n```\n\n## Basic usage\n```python\n# Create a http session\nsession = requests.Session()\n\n# Use this session to create a trolley using MINT and WADO\ntrolley = Trolley(searcher=Mint(session, \"https://server/mint\"),\n                  downloader=WadoURI(session, \"https://server/wado_uri\"))\n\n# find some studies (using MINT)\nstudies = trolley.find_studies(Query(PatientName='B*'))\n\n# download the fist one (using WADO)\ntrolley.download(studies[0], output_dir='/tmp/trolley')\n```\n\n## Documentation\nsee [dicomtrolley docs on readthedocs.io](https://dicomtrolley.readthedocs.io)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Retrieve medical images via WADO-URI, WADO-RS, QIDO-RS, MINT, RAD69 and DICOM-QR",
    "version": "3.3.0",
    "project_urls": {
        "Changelog": "https://github.com/sjoerdk/dicomtrolley/blob/main/HISTORY.md",
        "Repository": "https://github.com/sjoerdk/dicomtrolley"
    },
    "split_keywords": [
        "dicom",
        " dicom-web",
        " qido",
        " wado",
        " mint",
        " rad69",
        " download"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5c91111846e376737ff70362ea37525d86f769018b3ef4fd67e1db605f31d5da",
                "md5": "c74520b6e17c8742957c625c81cd143d",
                "sha256": "5c387bf3580ba909a5f2282ba6249553b91d3b57b9a7b037146f1722ce7fd150"
            },
            "downloads": -1,
            "filename": "dicomtrolley-3.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c74520b6e17c8742957c625c81cd143d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 54651,
            "upload_time": "2025-09-18T12:30:32",
            "upload_time_iso_8601": "2025-09-18T12:30:32.572330Z",
            "url": "https://files.pythonhosted.org/packages/5c/91/111846e376737ff70362ea37525d86f769018b3ef4fd67e1db605f31d5da/dicomtrolley-3.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cebcbd46e875123500cc622183a23ca362ae25f13ffde6fd9bb081bebf3ed4e1",
                "md5": "902b83f92cba2db545efd2be4d6c2cc7",
                "sha256": "ada17cfb865aa0e4082458201863fd1988fe47afe9f59e2c6ed83609780011cb"
            },
            "downloads": -1,
            "filename": "dicomtrolley-3.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "902b83f92cba2db545efd2be4d6c2cc7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 65089,
            "upload_time": "2025-09-18T12:30:33",
            "upload_time_iso_8601": "2025-09-18T12:30:33.515959Z",
            "url": "https://files.pythonhosted.org/packages/ce/bc/bd46e875123500cc622183a23ca362ae25f13ffde6fd9bb081bebf3ed4e1/dicomtrolley-3.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-18 12:30:33",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "sjoerdk",
    "github_project": "dicomtrolley",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "dicomtrolley"
}