dicom-wsi


Namedicom-wsi JSON
Version 1.0.5 PyPI version JSON
download
home_pagehttps://github.com/Steven-N-Hart/dicom_wsi
SummaryPackage for converting whole slide image files to dicom.
upload_time2025-10-09 13:44:39
maintainerNone
docs_urlNone
authorSteven N. Hart
requires_python>=3
licenseMIT license
keywords dicom_wsi
VCS
bugtrack_url
requirements pyvips pydicom PyYAML numpy Pillow tifffile tiffile datetime openslide-python cython pylibjpeg pylibjpeg-libjpeg pylibjpeg-openjpeg pytest
Travis-CI
coveralls test coverage No coveralls.
            =========
dicom_wsi
=========


.. image:: https://img.shields.io/pypi/v/dicom_wsi.svg
        :target: https://pypi.python.org/pypi/dicom_wsi

.. image:: https://img.shields.io/travis/Steven-N-Hart/dicom_wsi.svg
        :target: https://travis-ci.com/Steven-N-Hart/dicom_wsi

.. image:: https://readthedocs.org/projects/dicom-wsi/badge/?version=latest
        :target: https://dicom-wsi.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

----------

Package for converting whole slide image files to DICOM.

* Free software: MIT license
* Documentation: https://dicom-wsi.readthedocs.io.

=====
Usage
=====

First, you need to install dicom_wsi and its dependencies. See this link_ for details.

.. _link: https://dicom-wsi.readthedocs.io/en/latest/installation.html

To use dicom-wsi:
.. code-block:: console

    python dicom_wsi.cli -w <WSI File path> -o <OutputDirectory> -p <output file prefix> -y yaml/base.yaml

or

.. code-block:: python

    import dicom_wsi
    dicom_wsi.dicom_wsi.create_dicom(cfg, pools=n_pools)


That's it! Most of the time you wan't need to change anything. But if you do, please see the example yaml_ file.

.. _yaml: https://github.com/Steven-N-Hart/dicom_wsi/blob/master/dicom_wsi/yaml/base.yaml

Features
--------
* Validate DICOM elements using pydicom_
* Output format DICOM formatted files (vetted with dciodvfy_)

TODO
--------
* Find out how to determine what `FileMetaInformationGroupLength` should be


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _dciodvfy: https://www.dclunie.com/dicom3tools/dciodvfy.html
.. _`file type`: https://openslide.org/
.. _pydicom: https://pydicom.github.io/


=======
History
=======

1.0.5 (2025-10-09)
------------------

* Fixed AttributeError in cli.py by updating __init__.py.

1.0.4 (2023-10-27)
------------------

* Decreased dependencies for install
* Added tryCatch for Aperio data without expected metadata



0.1.0 (2021-1-22)
------------------

* First release on PyPI.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Steven-N-Hart/dicom_wsi",
    "name": "dicom-wsi",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3",
    "maintainer_email": null,
    "keywords": "dicom_wsi",
    "author": "Steven N. Hart",
    "author_email": "hart.steven@mayo.edu",
    "download_url": "https://files.pythonhosted.org/packages/62/0f/54be12f509d0a1e19ec9494372442338c870b2b0f9b609513978cd9ef7dc/dicom_wsi-1.0.5.tar.gz",
    "platform": null,
    "description": "=========\ndicom_wsi\n=========\n\n\n.. image:: https://img.shields.io/pypi/v/dicom_wsi.svg\n        :target: https://pypi.python.org/pypi/dicom_wsi\n\n.. image:: https://img.shields.io/travis/Steven-N-Hart/dicom_wsi.svg\n        :target: https://travis-ci.com/Steven-N-Hart/dicom_wsi\n\n.. image:: https://readthedocs.org/projects/dicom-wsi/badge/?version=latest\n        :target: https://dicom-wsi.readthedocs.io/en/latest/?badge=latest\n        :alt: Documentation Status\n\n----------\n\nPackage for converting whole slide image files to DICOM.\n\n* Free software: MIT license\n* Documentation: https://dicom-wsi.readthedocs.io.\n\n=====\nUsage\n=====\n\nFirst, you need to install dicom_wsi and its dependencies. See this link_ for details.\n\n.. _link: https://dicom-wsi.readthedocs.io/en/latest/installation.html\n\nTo use dicom-wsi:\n.. code-block:: console\n\n    python dicom_wsi.cli -w <WSI File path> -o <OutputDirectory> -p <output file prefix> -y yaml/base.yaml\n\nor\n\n.. code-block:: python\n\n    import dicom_wsi\n    dicom_wsi.dicom_wsi.create_dicom(cfg, pools=n_pools)\n\n\nThat's it! Most of the time you wan't need to change anything. But if you do, please see the example yaml_ file.\n\n.. _yaml: https://github.com/Steven-N-Hart/dicom_wsi/blob/master/dicom_wsi/yaml/base.yaml\n\nFeatures\n--------\n* Validate DICOM elements using pydicom_\n* Output format DICOM formatted files (vetted with dciodvfy_)\n\nTODO\n--------\n* Find out how to determine what `FileMetaInformationGroupLength` should be\n\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n.. _dciodvfy: https://www.dclunie.com/dicom3tools/dciodvfy.html\n.. _`file type`: https://openslide.org/\n.. _pydicom: https://pydicom.github.io/\n\n\n=======\nHistory\n=======\n\n1.0.5 (2025-10-09)\n------------------\n\n* Fixed AttributeError in cli.py by updating __init__.py.\n\n1.0.4 (2023-10-27)\n------------------\n\n* Decreased dependencies for install\n* Added tryCatch for Aperio data without expected metadata\n\n\n\n0.1.0 (2021-1-22)\n------------------\n\n* First release on PyPI.\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "Package for converting whole slide image files to dicom.",
    "version": "1.0.5",
    "project_urls": {
        "Homepage": "https://github.com/Steven-N-Hart/dicom_wsi"
    },
    "split_keywords": [
        "dicom_wsi"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2e05db1b38e830110cd9e06740b6037006d84aaab19b3e6425a85fe6ee35a43a",
                "md5": "3d8afdd4dacc7d88f3ef01ae5a6f0b95",
                "sha256": "db738f5d532cd125bac95028e79acec33ae2ca8116ef3dfe33fbcbac25c94594"
            },
            "downloads": -1,
            "filename": "dicom_wsi-1.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3d8afdd4dacc7d88f3ef01ae5a6f0b95",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3",
            "size": 48861,
            "upload_time": "2025-10-09T13:44:38",
            "upload_time_iso_8601": "2025-10-09T13:44:38.319668Z",
            "url": "https://files.pythonhosted.org/packages/2e/05/db1b38e830110cd9e06740b6037006d84aaab19b3e6425a85fe6ee35a43a/dicom_wsi-1.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "620f54be12f509d0a1e19ec9494372442338c870b2b0f9b609513978cd9ef7dc",
                "md5": "9c61c03b8f2c53fcb680c480ab988aec",
                "sha256": "add737572fdc0415927932aff43db0e1370747cc3cb4573ab8f00c3b95fa9ec1"
            },
            "downloads": -1,
            "filename": "dicom_wsi-1.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "9c61c03b8f2c53fcb680c480ab988aec",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3",
            "size": 324791,
            "upload_time": "2025-10-09T13:44:39",
            "upload_time_iso_8601": "2025-10-09T13:44:39.659633Z",
            "url": "https://files.pythonhosted.org/packages/62/0f/54be12f509d0a1e19ec9494372442338c870b2b0f9b609513978cd9ef7dc/dicom_wsi-1.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-09 13:44:39",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Steven-N-Hart",
    "github_project": "dicom_wsi",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "pyvips",
            "specs": []
        },
        {
            "name": "pydicom",
            "specs": []
        },
        {
            "name": "PyYAML",
            "specs": []
        },
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "Pillow",
            "specs": []
        },
        {
            "name": "tifffile",
            "specs": []
        },
        {
            "name": "tiffile",
            "specs": []
        },
        {
            "name": "datetime",
            "specs": []
        },
        {
            "name": "openslide-python",
            "specs": []
        },
        {
            "name": "cython",
            "specs": []
        },
        {
            "name": "pylibjpeg",
            "specs": []
        },
        {
            "name": "pylibjpeg-libjpeg",
            "specs": []
        },
        {
            "name": "pylibjpeg-openjpeg",
            "specs": []
        },
        {
            "name": "pytest",
            "specs": []
        }
    ],
    "lcname": "dicom-wsi"
}
        
Elapsed time: 2.48187s