[![PyPI version](https://badge.fury.io/py/dafne.svg)](https://badge.fury.io/py/dafne)
[![PDF Documentation](https://img.shields.io/badge/Docs-pdf-brightgreen)](https://www.dafne.network/files/documentation.pdf)
[![HTML Documentation](https://img.shields.io/badge/Docs-html-brightgreen)](https://www.dafne.network/documentation/)
# Dafne
Deep Anatomical Federated Network is a program for the segmentation of medical images. It relies on a server to provide deep learning models to aid the segmentation, and incremental learning is used to improve the performance. See https://www.dafne.network/ for documentation and user information.
## Windows binary installation
Please install the Visual Studio Redistributable Package under windows: https://aka.ms/vs/16/release/vc_redist.x64.exe
Then, run the provided installer
## Mac binary installation
Install the Dafne App from the downloaded .dmg file as usual. Make sure to download the archive appropriate for your architecture (x86 or arm).
## Linux binary installation
The Linux distribution is a self-contained executable file. Simply download it, make it executable, and run it.
## pip installation
Dafne can also be installed with pip
`pip install dafne`
# Citing
If you are writing a scientific paper, and you used Dafne for your data evaluation, please cite the following paper:
> Santini F, Wasserthal J, Agosti A, et al. *Deep Anatomical Federated Network (Dafne): an open client/server framework for the continuous collaborative improvement of deep-learning-based medical image segmentation*. 2023 doi: [10.48550/arXiv.2302.06352](https://doi.org/10.48550/arXiv.2302.06352).
# Notes for developers
## dafne
Run:
`python dafne.py <path_to_dicom_img>`
## Notes for the DL models
### Apply functions
The input of the apply function is:
```
dict({
'image': np.array (2D image)
'resolution': sequence with two elements (image resolution in mm)
'split_laterality': True/False (indicates whether the ROIs should be split in L/R if applicable)
'classification': str - The classification tag of the image (optional, to identify model variants)
})
```
The output of the classifier is a string.
The output of the segmenters is:
```
dict({
roi_name_1: np.array (2D mask),
roi_name_2: ...
})
```
### Incremental learn functions
The input of the incremental learn functions are:
```
training data: dict({
'resolution': sequence (see above)
'classification': str (see above)
'image_list': list([
- np.array (2D image)
- np.array (2D image)
- ...
])
})
training outputs: list([
- dict({
roi_name_1: np.array (2D mask)
roi_name_2: ...
})
- dict...
```
Every entry in the training outputs list corresponds to an entry in the image_list inside the training data.
So `len(training_data['image_list']) == len(training_outputs)`.
# Acknowledgments
Input/Output is based on [DOSMA](https://github.com/ad12/DOSMA) - GPLv3 license
This software includes the [Segment Anything Model (SAM)](https://github.com/facebookresearch/segment-anything) - Apache 2.0 license
Other packages required for this project are listed in requirements.txt
Raw data
{
"_id": null,
"home_page": "https://github.com/dafne-imaging/dafne",
"name": "dafne",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Francesco Santini",
"author_email": "francesco.santini@unibas.ch",
"download_url": "https://files.pythonhosted.org/packages/2e/9b/5f44e25ef978aea3b93aed73be25f32f986f59417020d2e9062eb7537314/dafne-1.8a4.tar.gz",
"platform": null,
"description": "[![PyPI version](https://badge.fury.io/py/dafne.svg)](https://badge.fury.io/py/dafne)\n[![PDF Documentation](https://img.shields.io/badge/Docs-pdf-brightgreen)](https://www.dafne.network/files/documentation.pdf)\n[![HTML Documentation](https://img.shields.io/badge/Docs-html-brightgreen)](https://www.dafne.network/documentation/)\n\n# Dafne\nDeep Anatomical Federated Network is a program for the segmentation of medical images. It relies on a server to provide deep learning models to aid the segmentation, and incremental learning is used to improve the performance. See https://www.dafne.network/ for documentation and user information.\n\n## Windows binary installation\nPlease install the Visual Studio Redistributable Package under windows: https://aka.ms/vs/16/release/vc_redist.x64.exe\nThen, run the provided installer\n\n## Mac binary installation\nInstall the Dafne App from the downloaded .dmg file as usual. Make sure to download the archive appropriate for your architecture (x86 or arm).\n\n## Linux binary installation\nThe Linux distribution is a self-contained executable file. Simply download it, make it executable, and run it.\n\n## pip installation\nDafne can also be installed with pip\n`pip install dafne`\n\n# Citing\nIf you are writing a scientific paper, and you used Dafne for your data evaluation, please cite the following paper:\n\n> Santini F, Wasserthal J, Agosti A, et al. *Deep Anatomical Federated Network (Dafne): an open client/server framework for the continuous collaborative improvement of deep-learning-based medical image segmentation*. 2023 doi: [10.48550/arXiv.2302.06352](https://doi.org/10.48550/arXiv.2302.06352).\n\n\n# Notes for developers\n\n## dafne\n\nRun: \n`python dafne.py <path_to_dicom_img>`\n\n\n## Notes for the DL models\n\n### Apply functions\nThe input of the apply function is:\n```\ndict({\n 'image': np.array (2D image)\n 'resolution': sequence with two elements (image resolution in mm)\n 'split_laterality': True/False (indicates whether the ROIs should be split in L/R if applicable)\n 'classification': str - The classification tag of the image (optional, to identify model variants)\n})\n```\n\nThe output of the classifier is a string.\nThe output of the segmenters is:\n```\ndict({\n roi_name_1: np.array (2D mask),\n roi_name_2: ...\n})\n``` \n\n### Incremental learn functions\nThe input of the incremental learn functions are:\n```\ntraining data: dict({\n 'resolution': sequence (see above)\n 'classification': str (see above)\n 'image_list': list([\n - np.array (2D image)\n - np.array (2D image)\n - ...\n ])\n})\n\ntraining outputs: list([\n - dict({\n roi_name_1: np.array (2D mask)\n roi_name_2: ...\n })\n - dict...\n```\n\nEvery entry in the training outputs list corresponds to an entry in the image_list inside the training data.\nSo `len(training_data['image_list']) == len(training_outputs)`.\n\n# Acknowledgments\nInput/Output is based on [DOSMA](https://github.com/ad12/DOSMA) - GPLv3 license\n\nThis software includes the [Segment Anything Model (SAM)](https://github.com/facebookresearch/segment-anything) - Apache 2.0 license\n\nOther packages required for this project are listed in requirements.txt\n",
"bugtrack_url": null,
"license": "",
"summary": "Dafne - Deep Anatomical Federated Network",
"version": "1.8a4",
"project_urls": {
"Bug Tracker": "https://github.com/dafne-imaging/dafne/issues",
"Homepage": "https://github.com/dafne-imaging/dafne"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5e272ab43bd48dd03d7c82bd66b9099dafa2e48267a1e6e2e1b03c442cda24c6",
"md5": "e64fee86b7f3e7347b2f8ab16baeb55b",
"sha256": "edfe263bd11eec4a7cade1c85cd0ac7ae66e9862d2e0cf1fa92bf365a98e246a"
},
"downloads": -1,
"filename": "dafne-1.8a4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e64fee86b7f3e7347b2f8ab16baeb55b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 653174,
"upload_time": "2024-02-08T06:42:28",
"upload_time_iso_8601": "2024-02-08T06:42:28.940848Z",
"url": "https://files.pythonhosted.org/packages/5e/27/2ab43bd48dd03d7c82bd66b9099dafa2e48267a1e6e2e1b03c442cda24c6/dafne-1.8a4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2e9b5f44e25ef978aea3b93aed73be25f32f986f59417020d2e9062eb7537314",
"md5": "afcc2b083ce91a88e59768692f0c7375",
"sha256": "822f0ad5dc32889a6a9d9c03da425e997baac290e0093ed324406943a1ed9ea3"
},
"downloads": -1,
"filename": "dafne-1.8a4.tar.gz",
"has_sig": false,
"md5_digest": "afcc2b083ce91a88e59768692f0c7375",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 602100,
"upload_time": "2024-02-08T06:42:32",
"upload_time_iso_8601": "2024-02-08T06:42:32.012315Z",
"url": "https://files.pythonhosted.org/packages/2e/9b/5f44e25ef978aea3b93aed73be25f32f986f59417020d2e9062eb7537314/dafne-1.8a4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-08 06:42:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dafne-imaging",
"github_project": "dafne",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "dafne"
}