# Welcome to Dosepy
[Documentation](https://dosepy.readthedocs.io/en/latest/intro.html)
Dosepy allows to easily perform film dosimetry and 2D gamma analysis.
The software uses tif images for film dosimetry. A DICOM file exported from a treatment planning system can be used to perform gamma index comparison.
## Installation
Install via pip:
```bash
pip install Dosepy
```
## Film dosimetry
Dosepy has a graphical user interface to perform film dosimetry. Once a tif file is loaded, scanned films are automatically detected. Multiple scans of the same film can be loaded and averaged automatically for noise reduction.
## Gamma index
Dose distributions comparison can be performed using the 2-dimensional gamma index test according to Low's definition [Daniel_Low_gamma_1998](https://doi.org/10.1118/1.598248), as well as some AAPM TG-218 [Miften_TG218_2018](https://doi.org/10.1002/mp.12810) recommendations:
* The acceptance criteria for dose difference can be selected in absolute mode (in Gy) or relative mode (in %).
* In relative mode, the percentage could be interpreted with respect to the maximum dose (global normalization), or with respect to the local dose (local normalization); according to user selection.
* Dose threshold can be adjusted by the user.
* The reference distribution can be selected by the user.
* It is possible to define a search radius as an optimization process for calculation.
* By default, percentile 99 from dose distribution is used as maximum dose. This is used to avoid the possible inclusion of artifacts or user markers.
* Interpolation is not yet supported.
```{warning}
To use a software as a [medical device](https://www.imdrf.org/documents/software-medical-device-samd-key-definitions), it is required to demonstrate its safety and efficacy through a [risk categorization structure](https://www.imdrf.org/documents/software-medical-device-possible-framework-risk-categorization-and-corresponding-considerations), a [quality management system](https://www.imdrf.org/documents/software-medical-device-samd-application-quality-management-system) and a [clinical evaluation](https://www.imdrf.org/documents/software-medical-device-samd-clinical-evaluation); as described in the International Forum of Medical Device Regulators working group guidelines (IMDRF).
Dosepy is currently **under development** to meet quality standards. To achieve this in Mexico the regulatory mechanism is through NOM-241-SSA1-2021, in addition to the IMDRF guidelines.
```
## Discussion
Have questions? Ask them on the Dosepy [discussion forum](https://groups.google.com/g/dosepy).
Raw data
{
"_id": null,
"home_page": null,
"name": "Dosepy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "Radiotherapy, Dose distribution, gamma index, python",
"author": null,
"author_email": "Luis Alfonso Olivares Jimenez <alfonso.cucei.udg@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d9/20/1ab7dca84344a29046110a9c841c5633b2f100b91ee15bf262b0f8c817a9/Dosepy-0.6.1.tar.gz",
"platform": null,
"description": "# Welcome to Dosepy\n\n[Documentation](https://dosepy.readthedocs.io/en/latest/intro.html)\n\nDosepy allows to easily perform film dosimetry and 2D gamma analysis.\n\nThe software uses tif images for film dosimetry. A DICOM file exported from a treatment planning system can be used to perform gamma index comparison.\n\n## Installation\n\nInstall via pip:\n\n```bash\npip install Dosepy\n```\n\n## Film dosimetry\n\nDosepy has a graphical user interface to perform film dosimetry. Once a tif file is loaded, scanned films are automatically detected. Multiple scans of the same film can be loaded and averaged automatically for noise reduction.\n\n## Gamma index\n\n Dose distributions comparison can be performed using the 2-dimensional gamma index test according to Low's definition [Daniel_Low_gamma_1998](https://doi.org/10.1118/1.598248), as well as some AAPM TG-218 [Miften_TG218_2018](https://doi.org/10.1002/mp.12810) recommendations:\n\n* The acceptance criteria for dose difference can be selected in absolute mode (in Gy) or relative mode (in %).\n * In relative mode, the percentage could be interpreted with respect to the maximum dose (global normalization), or with respect to the local dose (local normalization); according to user selection.\n* Dose threshold can be adjusted by the user.\n* The reference distribution can be selected by the user.\n* It is possible to define a search radius as an optimization process for calculation.\n* By default, percentile 99 from dose distribution is used as maximum dose. This is used to avoid the possible inclusion of artifacts or user markers.\n* Interpolation is not yet supported.\n\n```{warning}\nTo use a software as a [medical device](https://www.imdrf.org/documents/software-medical-device-samd-key-definitions), it is required to demonstrate its safety and efficacy through a [risk categorization structure](https://www.imdrf.org/documents/software-medical-device-possible-framework-risk-categorization-and-corresponding-considerations), a [quality management system](https://www.imdrf.org/documents/software-medical-device-samd-application-quality-management-system) and a [clinical evaluation](https://www.imdrf.org/documents/software-medical-device-samd-clinical-evaluation); as described in the International Forum of Medical Device Regulators working group guidelines (IMDRF).\n\nDosepy is currently **under development** to meet quality standards. To achieve this in Mexico the regulatory mechanism is through NOM-241-SSA1-2021, in addition to the IMDRF guidelines.\n```\n\n## Discussion\nHave questions? Ask them on the Dosepy [discussion forum](https://groups.google.com/g/dosepy).\n",
"bugtrack_url": null,
"license": null,
"summary": "Film dosimetry and gamma analysis for dose distributions in radiotherapy",
"version": "0.6.1",
"project_urls": {
"Bug-Tracker": "https://github.com/LuisOlivaresJ/Dosepy",
"homepage": "https://dosepy.readthedocs.io/en/latest/intro.html",
"repository": "https://pypi.org/project/Dosepy/"
},
"split_keywords": [
"radiotherapy",
" dose distribution",
" gamma index",
" python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "958501159bf7979f23ec0cf98879b5ad02e12fd92d0be0dbfc486df2ce6545e7",
"md5": "c2e181e7d25f628931f150ac10c2be96",
"sha256": "ccd285c7ca0786f48a736fdf8f5e4ed63388241ec2dc56a5c97881e940037cba"
},
"downloads": -1,
"filename": "Dosepy-0.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c2e181e7d25f628931f150ac10c2be96",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 779000,
"upload_time": "2024-04-01T22:30:08",
"upload_time_iso_8601": "2024-04-01T22:30:08.491507Z",
"url": "https://files.pythonhosted.org/packages/95/85/01159bf7979f23ec0cf98879b5ad02e12fd92d0be0dbfc486df2ce6545e7/Dosepy-0.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d9201ab7dca84344a29046110a9c841c5633b2f100b91ee15bf262b0f8c817a9",
"md5": "83e5eed5ddd9a98a32ee6b8ea47293e3",
"sha256": "8c26a688f10a5f6d108331fbfec5c63491b44b3ee4d0d4e5fccffb8a39678bfe"
},
"downloads": -1,
"filename": "Dosepy-0.6.1.tar.gz",
"has_sig": false,
"md5_digest": "83e5eed5ddd9a98a32ee6b8ea47293e3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 765160,
"upload_time": "2024-04-01T22:30:11",
"upload_time_iso_8601": "2024-04-01T22:30:11.714549Z",
"url": "https://files.pythonhosted.org/packages/d9/20/1ab7dca84344a29046110a9c841c5633b2f100b91ee15bf262b0f8c817a9/Dosepy-0.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-01 22:30:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "LuisOlivaresJ",
"github_project": "Dosepy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dosepy"
}