| Name | WORC JSON |
| Version |
3.7.0
JSON |
| download |
| home_page | None |
| Summary | Workflow for Optimal Radiomics Classification. |
| upload_time | 2025-08-13 09:48:07 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | None |
| keywords |
bioinformatics
radiomics
features
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
WORC: Workflow for Optimal Radiomics Classification (v3.7.0)
============================================================
Information
-----------
+-------------------+------------------+------------------+-------------+
| Unit test | Documentation | PyPi | Citing WORC |
+===================+==================+==================+=============+
| |image1| | |image2| | |image3| | |image4| |
+-------------------+------------------+------------------+-------------+
Introduction
============
**WORC** (Workflow for Optimal Radiomics Classification) is an open-source Python package that provides an end-to-end pipeline for fully automatic optimization of radiomics models, facilitating easy and systematic data probing for radiomics signatures by automatically comparing and combining thousand radiomics methods.
🔍 Key Features
---------------
- ✅ **End-to-End Pipeline**: Everythong from imaging data and segmentations to performance evaluation.
- 🧪 **Modular Design**: Easily integrate custom classifiers, feature selectors, or workflows.
- 🏥 **Domain Focused**: Designed and tested on 30+ multicenter medical datasets.
- 📁 **Multi-modal Input**: Supports multiple image modalities, regions, custom features, and clinical data.
- 📊 **Explainability Tools**: Built-in feature ranking and visualization utilities.
- 🔁 **Robust Optimization**: Nested cross-validation and sample size0based confidence interval estimation.
- 🧬 **Radiomics-Ready**: Includes PyRadiomics-based feature extraction and harmonization.
--------------
📦 Installation
---------------
WORC is tested on Python 3.11.5 on Ubuntu, Windows, and Mac. For detailed installation instructions, please check `the ReadTheDocs installation guidelines <https://worc.readthedocs.io/en/latest/static/quick_start.html#installation>`__.
The package can be installed through pip:
::
pip install WORC
Or directly from the repository for development:
::
git clone https://github.com/MStarmans91/WORC.git
cd WORC
pip install .
📚 Tutorial, documentation and dataset
--------------------------------------
The WORC tutorial is hosted at https://github.com/MStarmans91/WORCTutorial. For your first use, we recommend to start with the SimpleWORC tutorial.
The official documentation can be found at https://worc.readthedocs.io.
The publicly released WORC database is described in the following paper:
.. code:: bibtex
@article {Starmans2021WORCDatabase,
author = {Starmans, Martijn P.A. and Timbergen, Milea J.M. and Vos, Melissa and Padmos, Guillaume A. and Gr{\"u}nhagen, Dirk J. and Verhoef, Cornelis and Sleijfer, Stefan and van Leenders, Geert J.L.H. and Buisman, Florian E. and Willemssen, Francois E.J.A. and Koerkamp, Bas Groot and Angus, Lindsay and van der Veldt, Astrid A.M. and Rajicic, Ana and Odink, Arlette E. and Renckens, Michel and Doukas, Michail and de Man, Rob A. and IJzermans, Jan N.M. and Miclea, Razvan L. and Vermeulen, Peter B. and Thomeer, Maarten G. and Visser, Jacob J. and Niessen, Wiro J. and Klein, Stefan},
title = {The WORC database: MRI and CT scans, segmentations, and clinical labels for 930 patients from six radiomics studies},
elocation-id = {2021.08.19.21262238},
year = {2021},
doi = {10.1101/2021.08.19.21262238},
URL = {https://www.medrxiv.org/content/early/2021/08/25/2021.08.19.21262238},
eprint = {https://www.medrxiv.org/content/early/2021/08/25/2021.08.19.21262238.full.pdf},
journal = {medRxiv}
}
The code to download the WORC database and reproduce our experiments can be found at https://github.com/MStarmans91/WORCDatabase.
📄 License
----------
This package is covered by the open source `APACHE 2.0 License <APACHE-LICENSE-2.0>`__.
When using WORC, please cite this repository and the paper describing WORC as follows:
.. code:: bibtex
@article{starmans2021reproducible,
title = {Reproducible radiomics through automated machine learning validated on twelve clinical applications},
author = {Martijn P. A. Starmans and Sebastian R. van der Voort and Thomas Phil and Milea J. M. Timbergen and Melissa Vos and Guillaume A. Padmos and Wouter Kessels and David Hanff and Dirk J. Grunhagen and Cornelis Verhoef and Stefan Sleijfer and Martin J. van den Bent and Marion Smits and Roy S. Dwarkasing and Christopher J. Els and Federico Fiduzi and Geert J. L. H. van Leenders and Anela Blazevic and Johannes Hofland and Tessa Brabander and Renza A. H. van Gils and Gaston J. H. Franssen and Richard A. Feelders and Wouter W. de Herder and Florian E. Buisman and Francois E. J. A. Willemssen and Bas Groot Koerkamp and Lindsay Angus and Astrid A. M. van der Veldt and Ana Rajicic and Arlette E. Odink and Mitchell Deen and Jose M. Castillo T. and Jifke Veenland and Ivo Schoots and Michel Renckens and Michail Doukas and Rob A. de Man and Jan N. M. IJzermans and Razvan L. Miclea and Peter B. Vermeulen and Esther E. Bron and Maarten G. Thomeer and Jacob J. Visser and Wiro J. Niessen and Stefan Klein},
year = {2021},
eprint = {2108.08618},
archivePrefix = {arXiv},
primaryClass = {eess.IV}
}
@software{starmans2018worc,
author = {Martijn P. A. Starmans and Thomas Phil and Sebastian R. van der Voort and Stefan Klein},
title = {Workflow for Optimal Radiomics Classification (WORC)},
year = {2018},
publisher = {Zenodo},
doi = {10.5281/zenodo.3840534},
url = {https://github.com/MStarmans91/WORC}
}
For the DOI, visit |image5|.
Contact
-------
We are happy to help you with any questions. Please sent us a mail or place an issue on the Github.
Optional extra packages and software
------------------------------------
Besides the default installation, there are several optional packages you could install to support WORC.
Graphviz
~~~~~~~~
WORC can draw the network and save it as a SVG image using `graphviz <https://www.graphviz.org/>`__. In order to do so, please make sure you install graphviz. On Ubuntu, simply run
::
apt install graphiv
On Windows, follow the installation instructions provided on the graphviz website. Make sure you add the executable to the PATH when prompted.
Elastix
~~~~~~~
Image registration is included in WORC through `elastix and transformix <http://elastix.isi.uu.nl/>`__. In order to use elastix, please download the binaries and place them in your ``fastr.config.mounts['apps']`` path. Check the elastix tool description for the correct subdirectory structure. For example, on Linux, the binaries and libraries should be in ``"../apps/elastix/4.8/install/"`` and ``"../apps/elastix/4.8/install/lib"`` respectively.
Note: optionally, you can tell WORC to copy the metadata from the image file to the segmentation file before applying the deformation field. This requires ITK and ITKTools: see `the ITKTools github <https://github.com/ITKTools/ITKTools>`__ for installation instructions.
XNAT
~~~~
We use the XNATpy package to connect the toolbox to the XNAT online database platforms. You will only need this when you use the example dataset we provided, or if you want to download or upload data from or to XNAT. We advise you to specify your account settings in a .netrc file when using this feature for your own datasets, such that you do not need to input them on every request.
.. |image1| image:: https://github.com/MStarmans91/WORC/workflows/Unit%20test/badge.svg
:target: https://github.com/MStarmans91/WORC/actions?query=workflow%3A%22Unit+test%22
.. |image2| image:: https://readthedocs.org/projects/worc/badge/?version=latest
:target: https://worc.readthedocs.io/en/latest/?badge=latest
.. |image3| image:: https://badge.fury.io/py/WORC.svg
:target: https://badge.fury.io/py/WORC
.. |image4| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3840534.svg
:target: https://zenodo.org/badge/latestdoi/92295542
.. |image5| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3840534.svg
:target: https://zenodo.org/badge/latestdoi/92295542
Raw data
{
"_id": null,
"home_page": null,
"name": "WORC",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "bioinformatics, radiomics, features",
"author": null,
"author_email": "\"Martijn P. A. Starmans\" <m.starmans@erasmusmc.nl>",
"download_url": "https://files.pythonhosted.org/packages/5f/27/34a209b32dc02893c26d6a91dc2117cf1a13f94d93275aaf297c6a4e318a/worc-3.7.0.tar.gz",
"platform": null,
"description": "WORC: Workflow for Optimal Radiomics Classification (v3.7.0)\r\n============================================================\r\n\r\nInformation\r\n-----------\r\n\r\n+-------------------+------------------+------------------+-------------+\r\n| Unit test | Documentation | PyPi | Citing WORC |\r\n+===================+==================+==================+=============+\r\n| |image1| | |image2| | |image3| | |image4| |\r\n+-------------------+------------------+------------------+-------------+\r\n\r\nIntroduction\r\n============\r\n\r\n**WORC** (Workflow for Optimal Radiomics Classification) is an open-source Python package that provides an end-to-end pipeline for fully automatic optimization of radiomics models, facilitating easy and systematic data probing for radiomics signatures by automatically comparing and combining thousand radiomics methods.\r\n\r\n\ud83d\udd0d Key Features\r\n---------------\r\n\r\n- \u2705 **End-to-End Pipeline**: Everythong from imaging data and segmentations to performance evaluation.\r\n- \ud83e\uddea **Modular Design**: Easily integrate custom classifiers, feature selectors, or workflows.\r\n- \ud83c\udfe5 **Domain Focused**: Designed and tested on 30+ multicenter medical datasets.\r\n- \ud83d\udcc1 **Multi-modal Input**: Supports multiple image modalities, regions, custom features, and clinical data.\r\n- \ud83d\udcca **Explainability Tools**: Built-in feature ranking and visualization utilities.\r\n- \ud83d\udd01 **Robust Optimization**: Nested cross-validation and sample size0based confidence interval estimation.\r\n- \ud83e\uddec **Radiomics-Ready**: Includes PyRadiomics-based feature extraction and harmonization.\r\n\r\n--------------\r\n\r\n\ud83d\udce6 Installation\r\n---------------\r\n\r\nWORC is tested on Python 3.11.5 on Ubuntu, Windows, and Mac. For detailed installation instructions, please check `the ReadTheDocs installation guidelines <https://worc.readthedocs.io/en/latest/static/quick_start.html#installation>`__.\r\n\r\nThe package can be installed through pip:\r\n\r\n::\r\n\r\n pip install WORC\r\n\r\nOr directly from the repository for development:\r\n\r\n::\r\n\r\n git clone https://github.com/MStarmans91/WORC.git\r\n cd WORC\r\n pip install .\r\n\r\n\ud83d\udcda Tutorial, documentation and dataset\r\n--------------------------------------\r\n\r\nThe WORC tutorial is hosted at https://github.com/MStarmans91/WORCTutorial. For your first use, we recommend to start with the SimpleWORC tutorial.\r\n\r\nThe official documentation can be found at https://worc.readthedocs.io.\r\n\r\nThe publicly released WORC database is described in the following paper:\r\n\r\n.. code:: bibtex\r\n\r\n @article {Starmans2021WORCDatabase,\r\n author = {Starmans, Martijn P.A. and Timbergen, Milea J.M. and Vos, Melissa and Padmos, Guillaume A. and Gr{\\\"u}nhagen, Dirk J. and Verhoef, Cornelis and Sleijfer, Stefan and van Leenders, Geert J.L.H. and Buisman, Florian E. and Willemssen, Francois E.J.A. and Koerkamp, Bas Groot and Angus, Lindsay and van der Veldt, Astrid A.M. and Rajicic, Ana and Odink, Arlette E. and Renckens, Michel and Doukas, Michail and de Man, Rob A. and IJzermans, Jan N.M. and Miclea, Razvan L. and Vermeulen, Peter B. and Thomeer, Maarten G. and Visser, Jacob J. and Niessen, Wiro J. and Klein, Stefan},\r\n title = {The WORC database: MRI and CT scans, segmentations, and clinical labels for 930 patients from six radiomics studies},\r\n elocation-id = {2021.08.19.21262238},\r\n year = {2021},\r\n doi = {10.1101/2021.08.19.21262238},\r\n URL = {https://www.medrxiv.org/content/early/2021/08/25/2021.08.19.21262238},\r\n eprint = {https://www.medrxiv.org/content/early/2021/08/25/2021.08.19.21262238.full.pdf},\r\n journal = {medRxiv}\r\n }\r\n\r\nThe code to download the WORC database and reproduce our experiments can be found at https://github.com/MStarmans91/WORCDatabase.\r\n\r\n\ud83d\udcc4 License\r\n----------\r\n\r\nThis package is covered by the open source `APACHE 2.0 License <APACHE-LICENSE-2.0>`__.\r\n\r\nWhen using WORC, please cite this repository and the paper describing WORC as follows:\r\n\r\n.. code:: bibtex\r\n\r\n @article{starmans2021reproducible,\r\n title = {Reproducible radiomics through automated machine learning validated on twelve clinical applications},\r\n author = {Martijn P. A. Starmans and Sebastian R. van der Voort and Thomas Phil and Milea J. M. Timbergen and Melissa Vos and Guillaume A. Padmos and Wouter Kessels and David Hanff and Dirk J. Grunhagen and Cornelis Verhoef and Stefan Sleijfer and Martin J. van den Bent and Marion Smits and Roy S. Dwarkasing and Christopher J. Els and Federico Fiduzi and Geert J. L. H. van Leenders and Anela Blazevic and Johannes Hofland and Tessa Brabander and Renza A. H. van Gils and Gaston J. H. Franssen and Richard A. Feelders and Wouter W. de Herder and Florian E. Buisman and Francois E. J. A. Willemssen and Bas Groot Koerkamp and Lindsay Angus and Astrid A. M. van der Veldt and Ana Rajicic and Arlette E. Odink and Mitchell Deen and Jose M. Castillo T. and Jifke Veenland and Ivo Schoots and Michel Renckens and Michail Doukas and Rob A. de Man and Jan N. M. IJzermans and Razvan L. Miclea and Peter B. Vermeulen and Esther E. Bron and Maarten G. Thomeer and Jacob J. Visser and Wiro J. Niessen and Stefan Klein},\r\n year = {2021},\r\n eprint = {2108.08618},\r\n archivePrefix = {arXiv},\r\n primaryClass = {eess.IV}\r\n }\r\n\r\n @software{starmans2018worc,\r\n author = {Martijn P. A. Starmans and Thomas Phil and Sebastian R. van der Voort and Stefan Klein},\r\n title = {Workflow for Optimal Radiomics Classification (WORC)},\r\n year = {2018},\r\n publisher = {Zenodo},\r\n doi = {10.5281/zenodo.3840534},\r\n url = {https://github.com/MStarmans91/WORC}\r\n }\r\n\r\nFor the DOI, visit |image5|.\r\n\r\nContact\r\n-------\r\n\r\nWe are happy to help you with any questions. Please sent us a mail or place an issue on the Github.\r\n\r\nOptional extra packages and software\r\n------------------------------------\r\n\r\nBesides the default installation, there are several optional packages you could install to support WORC.\r\n\r\nGraphviz\r\n~~~~~~~~\r\n\r\nWORC can draw the network and save it as a SVG image using `graphviz <https://www.graphviz.org/>`__. In order to do so, please make sure you install graphviz. On Ubuntu, simply run\r\n\r\n::\r\n\r\n apt install graphiv\r\n\r\nOn Windows, follow the installation instructions provided on the graphviz website. Make sure you add the executable to the PATH when prompted.\r\n\r\nElastix\r\n~~~~~~~\r\n\r\nImage registration is included in WORC through `elastix and transformix <http://elastix.isi.uu.nl/>`__. In order to use elastix, please download the binaries and place them in your ``fastr.config.mounts['apps']`` path. Check the elastix tool description for the correct subdirectory structure. For example, on Linux, the binaries and libraries should be in ``\"../apps/elastix/4.8/install/\"`` and ``\"../apps/elastix/4.8/install/lib\"`` respectively.\r\n\r\nNote: optionally, you can tell WORC to copy the metadata from the image file to the segmentation file before applying the deformation field. This requires ITK and ITKTools: see `the ITKTools github <https://github.com/ITKTools/ITKTools>`__ for installation instructions.\r\n\r\nXNAT\r\n~~~~\r\n\r\nWe use the XNATpy package to connect the toolbox to the XNAT online database platforms. You will only need this when you use the example dataset we provided, or if you want to download or upload data from or to XNAT. We advise you to specify your account settings in a .netrc file when using this feature for your own datasets, such that you do not need to input them on every request.\r\n\r\n.. |image1| image:: https://github.com/MStarmans91/WORC/workflows/Unit%20test/badge.svg\r\n :target: https://github.com/MStarmans91/WORC/actions?query=workflow%3A%22Unit+test%22\r\n.. |image2| image:: https://readthedocs.org/projects/worc/badge/?version=latest\r\n :target: https://worc.readthedocs.io/en/latest/?badge=latest\r\n.. |image3| image:: https://badge.fury.io/py/WORC.svg\r\n :target: https://badge.fury.io/py/WORC\r\n.. |image4| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3840534.svg\r\n :target: https://zenodo.org/badge/latestdoi/92295542\r\n.. |image5| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3840534.svg\r\n :target: https://zenodo.org/badge/latestdoi/92295542\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Workflow for Optimal Radiomics Classification.",
"version": "3.7.0",
"project_urls": null,
"split_keywords": [
"bioinformatics",
" radiomics",
" features"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ea5ca26b73f612c0842e8b18a9f5f86030a4e9ff3e99e341fa074141a782b646",
"md5": "dadaf9844b3a1debe96647aa56df4503",
"sha256": "5e71bdb27cd4f86ddc8cb35e3acb7a028a681cca60eb3f371c692f5460238a80"
},
"downloads": -1,
"filename": "worc-3.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dadaf9844b3a1debe96647aa56df4503",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 17762473,
"upload_time": "2025-08-13T09:48:05",
"upload_time_iso_8601": "2025-08-13T09:48:05.128723Z",
"url": "https://files.pythonhosted.org/packages/ea/5c/a26b73f612c0842e8b18a9f5f86030a4e9ff3e99e341fa074141a782b646/worc-3.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5f2734a209b32dc02893c26d6a91dc2117cf1a13f94d93275aaf297c6a4e318a",
"md5": "8b8cfd59ac6624c2b300a8534a51c1af",
"sha256": "d4f71cce3555696adcd721dd10b48ef4aa3308880349b646f1b64b8d9cf628d3"
},
"downloads": -1,
"filename": "worc-3.7.0.tar.gz",
"has_sig": false,
"md5_digest": "8b8cfd59ac6624c2b300a8534a51c1af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 16888262,
"upload_time": "2025-08-13T09:48:07",
"upload_time_iso_8601": "2025-08-13T09:48:07.377030Z",
"url": "https://files.pythonhosted.org/packages/5f/27/34a209b32dc02893c26d6a91dc2117cf1a13f94d93275aaf297c6a4e318a/worc-3.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 09:48:07",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "worc"
}
