# Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC)
[](https://huggingface.co/wdika)
[](docker.io/wdika/atommic)
[](https://opensource.org/licenses/Apache-2.0)
[](https://badge.fury.io/py/atommic)
[](https://pypi.org/project/atommic/)
[](https://github.com/wdika/atommic/issues)
[](https://atommic.readthedocs.io/en/latest/?badge=latest)
[](https://pypi.org/project/atommic/)
[]()
<p align="center" style="margin-top: -40px; margin-bottom: -80px;">
<img src="assets/atommic-logo.png" alt="ATOMMIC-logo" width="600" />
</p>
<div align="center">
<span style="font-size:24px;">
[๐](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=4801289)
[๐ค](https://huggingface.co/wdika)
[๐ณ](docker.io/wdika/atommic)
[๐ฆ](https://pypi.org/project/atommic)
[๐](https://atommic.readthedocs.io/)
</div>
## ๐ Introduction
The [Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC)](https://github.com/wdika/atommic) is a toolbox for applying AI methods for **accelerated MRI reconstruction (REC)**, **MRI segmentation (SEG)**, **quantitative MR imaging (qMRI)**, as well as **multitask learning (MTL)**, i.e., performing multiple tasks simultaneously, such as reconstruction and segmentation. Each task is implemented in a separate collection consisting of data loaders, transformations, models, metrics, and losses. **ATOMMIC** is designed to be modular and extensible on new tasks, models, and datasets. **ATOMMIC** uses [PyTorch Lightning](https://www.pytorchlightning.ai/) for feasible high-performance multi-GPU/multi-node mixed-precision training.
The schematic overview of **ATOMMIC** showcases the main components of the toolbox. First, we need an [MRI Dataset](README.md#mri-datasets) (e.g., **CC359**). Next, we need to define the high-level parameters, such as the [task and the model](https://atommic.readthedocs.io/en/latest/mri/collections.html), the [undersampling](https://atommic.readthedocs.io/en/latest/mri//undersampling.html), the [transforms](https://atommic.readthedocs.io/en/latest/mri//transforms.html), the [optimizer](https://atommic.readthedocs.io/en/latest/core/core.html#optimization), the [scheduler](https://atommic.readthedocs.io/en/latest/core/core.html#learning-rate-schedulers), the [loss](https://atommic.readthedocs.io/en/latest/mri/losses.html), the [trainer parameters](https://atommic.readthedocs.io/en/latest/core/core.html#training), and the [experiment manager](https://atommic.readthedocs.io/en/latest/core/exp_manager.html). All these parameters are defined in a `.yaml` file using [Hydra](https://hydra.cc/) and [OmegaConf](https://omegaconf.readthedocs.io/).
The trained model is an `.atommic` [module](https://atommic.readthedocs.io/en/latest/core/export.html), exported with [ONNX](https://onnx.ai/) and [TorchScript](https://pytorch.org/docs/stable/jit.html) support, which can be used for inference. The `.atommic` module can also be uploaded on [HuggingFace](https://huggingface.co/). Pretrained models are available on our [HF](https://huggingface.co/wdika) account and can be downloaded and used for inference.
## ๐ ๏ธ Installation
**ATOMMIC** is best to be installed in a Conda environment.
### ๐ Conda
```
conda create -n atommic python=3.10
conda activate atommic
```
### ๐ฆ Pip
Use this installation mode if you want the latest released version.
```bash
pip install atommic
```
### From source
Use this installation mode if you are contributing to atommic.
```bash
git clone https://github.com/wdika/atommic
cd atommic
bash ./reinstall.sh
```
### ๐ณ Docker containers
An atommic container is available at dockerhub, you can pull it with:
```bash
docker pull wdika/atommic
```
You can also build an atommic container with:
```bash
DOCKER_BUILDKIT=1 docker build -f Dockerfile -t atommic:latest .
```
You can run the container with:
```bash
docker run --gpus all -it --rm -v /home/user/configs:/config atommic:latest atommic run -c /config/config.yaml
```
where ```/config/config.yaml``` is the path to your local configuration file.
Or you can run it interactively with:
```bash
docker run --gpus all -it --rm -p 8888:8888 atommic:latest /bin/bash -c "./start-jupyter.sh"
```
## ๐ Quick Start Guide
The best way to get started with ATOMMIC is with one of the [tutorials](https://atommic.readthedocs.io/en/latest/starthere/tutorials.html):
- [ATOMMIC Primer](https://github.com/wdika/atommic/blob/main/tutorials/00_ATOMMIC_Primer.ipynb) - demonstrates how to use ATOMMIC.
- [ATOMMIC MRI transforms](https://github.com/wdika/atommic/blob/main/tutorials/01_ATOMMIC_MRI_transforms.ipynb) - demonstrates how to use ATOMMIC to undersample MRI data.
- [ATOMMIC MRI undersampling](https://github.com/wdika/atommic/blob/main/tutorials/02_ATOMMIC_MRI_undersampling.ipynb) - demonstrates how to use ATOMMIC to apply transforms to MRI data.
- [ATOMMIC Upload Model on HuggingFace](https://github.com/wdika/atommic/blob/main/tutorials/03_ATOMMIC_Upload_Model_On_HF.ipynb) - demonstrates how to upload a model on HuggingFace.
You can also check the [projects](https://github.com/wdika/atommic/tree/main/projects) page to see how to use ATOMMIC for specific tasks and public datasets.
Pre-trained models are available on HuggingFace [๐ค](https://huggingface.co/wdika).
### **ATOMMIC paper is fully reproducible. Please check [here](https://github.com/wdika/atommic/tree/main/projects/ATOMMIC_paper/README.md) for more information.**
## ๐ค Training & Testing
Training and testing models in **ATOMMIC** is intuitive and easy. You just need to properly configure a `.yaml` file and run the following command:
```bash
atommic run -c path-to-config-file
```
## โ๏ธ Configuration
1. Choose the **task** and the **model**, according to the [collections](https://atommic.readthedocs.io/en/latest/mri/collections.html).
2. Choose the **dataset** and the **dataset parameters**, according to the [datasets](README.md#mri-datasets) or your own dataset.
3. Choose the [undersampling](https://atommic.readthedocs.io/en/latest/mri/transforms.html).
4. Choose the [transforms](https://atommic.readthedocs.io/en/latest/mri/transforms.html).
5. Choose the [losses](https://atommic.readthedocs.io/en/latest/mri/losses.html).
6. Choose the [optimizer](https://atommic.readthedocs.io/en/latest/core/core.html#optimization).
7. Choose the [scheduler](https://atommic.readthedocs.io/en/latest/core/core.html#learning-rate-schedulers).
8. Choose the [trainer parameters](https://atommic.readthedocs.io/en/latest/core/core.html#training).
9. Choose the [experiment manager](https://atommic.readthedocs.io/en/latest/core/exp_manager.html).
You can also check the [projects](https://github.com/wdika/atommic/tree/main/projects/) page to see how to configure the `.yaml` file for specific tasks.
## ๐๏ธ Collections
**ATOMMIC** is organized into [collections](https://atommic.readthedocs.io/en/latest/mri/collections.html), each of which implements a specific task. The following collections are currently available, implementing various models as listed:
### MultiTask Learning (MTL)
1. End-to-End Recurrent Attention Network (`SERANet`), 2. Image domain Deep Structured Low-Rank Network (`IDSLR`), 3. Image domain Deep Structured Low-Rank UNet (`IDSLRUNet`), 4. Multi-Task Learning for MRI Reconstruction and Segmentation (`MTLRS`), 5. Reconstruction Segmentation method using UNet (`RecSegUNet`), 6. Segmentation Network MRI (`SegNet`).
### Quantitative MR Imaging (qMRI)
1. Quantitative Recurrent Inference Machines (`qRIMBlock`), 2. Quantitative End-to-End Variational Network (`qVarNet`), 3. Quantitative Cascades of Independently Recurrent Inference Machines (`qCIRIM`).
### MRI Reconstruction (REC)
1. Cascades of Independently Recurrent Inference Machines (`CIRIM`), 2. Convolutional Recurrent Neural Networks (`CRNNet`), 3. Deep Cascade of Convolutional Neural Networks (`CascadeNet`), 4. Down-Up Net (`DUNet`), 5. End-to-End Variational Network (`VarNet`), 6. Independently Recurrent Inference Machines (`RIMBlock`), 7. Joint Deep Model-Based MR Image and Coil Sensitivity Reconstruction Network (`JointICNet`), 8. `KIKINet`, 9. Learned Primal-Dual Net (`LPDNet`), 10. Model-based Deep Learning Reconstruction (`MoDL`), 11. `MultiDomainNet`, 12. `ProximalGradient`, 13. Recurrent Inference Machines (`RIMBlock`), 14. Recurrent Variational Network (`RecurrentVarNet`), 15. `UNet`, 16. Variable Splitting Network (`VSNet`), 17. `XPDNet`, 18. Zero-Filled reconstruction (`ZF`).
### MRI Segmentation (SEG)
1. `SegmentationAttentionUNet`, 2. `SegmentationDYNUNet`, 3. `SegmentationLambdaUNet`, 4. `SegmentationUNet`, 5. `Segmentation3DUNet`, 6. `SegmentationUNetR`, 7. `SegmentationVNet`.
## MRI Datasets
**ATOMMIC** supports public datasets, as well as private datasets. The following public datasets are supported natively:
- [AHEAD](https://github.com/wdika/atommic/tree/main/projects/qMRI/AHEAD): Supports the `(qMRI)` and `(REC)` tasks.
- [BraTS 2023 Adult Glioma](https://github.com/wdika/atommic/tree/main/projects/SEG/BraTS2023AdultGlioma): Supports the `(SEG)` task.
- [CC359](https://github.com/wdika/atommic/tree/main/projects/REC/CC359): Supports the `(REC)` task.
- [fastMRI Brains Multicoil](https://github.com/wdika/atommic/tree/main/projects/REC/fastMRIBrainsMulticoil): Supports the `(REC)` task.
- [fastMRI Knees Multicoil](https://github.com/wdika/atommic/tree/main/projects/REC/fastMRIKneesMulticoil): Supports the `(REC)` task.
- [fastMRI Knees Singlecoil](https://github.com/wdika/atommic/tree/main/projects/REC/fastMRIKneesSinglecoil): Supports the `(REC)` task.
- [ISLES 2022 Sub Acute Stroke](https://github.com/wdika/atommic/tree/main/projects/SEG/ISLES2022SubAcuteStroke): Supports the `(SEG)` task.
- [SKM-TEA](https://github.com/wdika/atommic/tree/main/projects/MTL/rs/SKMTEA): Supports the `(REC)`, `(SEG)`, and `(MTL)` tasks.
- [Stanford Knees](https://github.com/wdika/atommic/tree/main/projects/REC/StanfordKnees2019): Supports the `(REC)` task.
## ๐ API Documentation
[](https://atommic.readthedocs.io/en/latest/?badge=latest)
Access the API Documentation [here](https://atommic.readthedocs.io/en/latest/index.html)
## ๐ License
**ATOMMIC** is under [](https://opensource.org/licenses/Apache-2.0)
## ๐ Citation
If you use ATOMMIC in your research, please cite as follows:
```BibTeX
@article{Karkalousos_2024,
title={Atommic: An Advanced Toolbox for Multitask Medical Imaging Consistency to Facilitate Artificial Intelligence Applications from Acquisition to Analysis in Magnetic Resonance Imaging},
url={http://dx.doi.org/10.2139/ssrn.4801289},
DOI={10.2139/ssrn.4801289},
publisher={Elsevier BV},
author={Karkalousos, Dimitrios and Iลกgum, Ivana and Marquering, Henk and Caan, Matthan W.A.},
year={2024}}
```
## ๐ References
ATOMMIC has been used or is referenced in the following papers:
1. Karkalousos, Dimitrios and Iลกgum, Ivana and Marquering, Henk and Caan, Matthan W.A., Atommic: An Advanced Toolbox for Multitask Medical Imaging Consistency to Facilitate Artificial Intelligence Applications from Acquisition to Analysis in Magnetic Resonance Imaging. Available at SSRN: https://ssrn.com/abstract=4801289 or http://dx.doi.org/10.2139/ssrn.4801289
2. Karkalousos, D., Iลกgum, I., Marquering, H. A., & Caan, M. W. A. (2024). ATOMMIC: An Advanced Toolbox for Multitask Medical Imaging Consistency to facilitate Artificial Intelligence applications from acquisition to analysis in Magnetic Resonance Imaging. https://doi.org/10.2139/ssrn.4801289
3. Karkalousos, D., Isgum, I., Marquering, H., & Caan, M. W. A. (2024, April 27). The Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC): A Deep Learning framework to facilitate Magnetic Resonance Imaging. Medical Imaging with Deep Learning. https://openreview.net/forum?id=HxTZr9yA0N
4. Karkalousos, D., Isgum, I., Marquering, H. & Caan, M.W.A.. (2024). MultiTask Learning for accelerated-MRI Reconstruction and Segmentation of Brain Lesions in Multiple Sclerosis. <i>Medical Imaging with Deep Learning</i>, in <i>Proceedings of Machine Learning Research</i> 227:991-1005 Available from https://proceedings.mlr.press/v227/karkalousos24a.html.
5. Zhang, C., Karkalousos, D., Bazin, P. L., Coolen, B. F., Vrenken, H., Sonke, J. J., Forstmann, B. U., Poot, D. H. J., & Caan, M. W. A. (2022). A unified model for reconstruction and R2* mapping of accelerated 7T data using the quantitative recurrent inference machine. NeuroImage, 264. [DOI](https://doi.org/10.1016/j.neuroimage.2022.119680)
6. Karkalousos, D., Noteboom, S., Hulst, H. E., Vos, F. M., & Caan, M. W. A. (2022). Assessment of data consistency through cascades of independently recurrent inference machines for fast and robust accelerated MRI reconstruction. Physics in Medicine & Biology. [DOI](https://doi.org/10.1088/1361-6560/AC6CC2)
## ๐ง Contact
For any questions, please contact Dimitris Karkalousos @ [d.karkalousos@amsterdamumc.nl](mailto:d.karkalousos@amsterdamumc.nl).
## โ ๏ธ๐ Disclaimer & Acknowledgements
> **Note:** ATOMMIC is built on top of [NeMo](https://github.com/NVIDIA/NeMo). NeMo is under Apache 2.0 license, so we are allowed to use it. We also assume that we can use the NeMo documentation basis as long as we cite it and always refer to the baselines everywhere in the code and docs. ATOMMIC also includes implementations of reconstruction methods from [fastMRI](https://github.com/facebookresearch/fastMRI) and [DIRECT](https://github.com/NKI-AI/direct), and segmentation methods from [MONAI](https://github.com/Project-MONAI/MONAI), as well as other codebases which are always cited on the corresponding files. All methods in ATOMMIC are reimplemented and not called from the original libraries, allowing for full reproducibility, support, and easy extension. ATOMMIC is an open-source project under the Apache 2.0 license.
Raw data
{
"_id": null,
"home_page": "https://github.com/wdika/atommic",
"name": "atommic",
"maintainer": "Dimitris Karkalousos",
"docs_url": null,
"requires_python": "<=3.12,>=3.10",
"maintainer_email": "d.karkalousos@amsterdamumc.nl",
"keywords": "deep-learning, medical-imaging, mri, quantitative-imaging, medical-image-processing, medical-image-analysis",
"author": "Dimitris Karkalousos",
"author_email": "d.karkalousos@amsterdamumc.nl",
"download_url": "https://files.pythonhosted.org/packages/30/36/ce3858a7c07589f69fbeda9ad0ac83dfd56b8bdc814eba2a495892ec4341/atommic-1.0.1.tar.gz",
"platform": null,
"description": "# Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC)\n[](https://huggingface.co/wdika)\n[](docker.io/wdika/atommic)\n[](https://opensource.org/licenses/Apache-2.0)\n[](https://badge.fury.io/py/atommic)\n[](https://pypi.org/project/atommic/)\n[](https://github.com/wdika/atommic/issues)\n[](https://atommic.readthedocs.io/en/latest/?badge=latest)\n[](https://pypi.org/project/atommic/)\n[]()\n<p align=\"center\" style=\"margin-top: -40px; margin-bottom: -80px;\">\n <img src=\"assets/atommic-logo.png\" alt=\"ATOMMIC-logo\" width=\"600\" />\n</p>\n\n<div align=\"center\">\n<span style=\"font-size:24px;\">\n\n [\ud83d\udcdc](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=4801289)\n [\ud83e\udd17](https://huggingface.co/wdika)\n [\ud83d\udc33](docker.io/wdika/atommic)\n [\ud83d\udce6](https://pypi.org/project/atommic)\n [\ud83d\udcda](https://atommic.readthedocs.io/)\n\n</div>\n\n## \ud83d\udc4b Introduction\n\nThe [Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC)](https://github.com/wdika/atommic) is a toolbox for applying AI methods for **accelerated MRI reconstruction (REC)**, **MRI segmentation (SEG)**, **quantitative MR imaging (qMRI)**, as well as **multitask learning (MTL)**, i.e., performing multiple tasks simultaneously, such as reconstruction and segmentation. Each task is implemented in a separate collection consisting of data loaders, transformations, models, metrics, and losses. **ATOMMIC** is designed to be modular and extensible on new tasks, models, and datasets. **ATOMMIC** uses [PyTorch Lightning](https://www.pytorchlightning.ai/) for feasible high-performance multi-GPU/multi-node mixed-precision training.\n\n\n\nThe schematic overview of **ATOMMIC** showcases the main components of the toolbox. First, we need an [MRI Dataset](README.md#mri-datasets) (e.g., **CC359**). Next, we need to define the high-level parameters, such as the [task and the model](https://atommic.readthedocs.io/en/latest/mri/collections.html), the [undersampling](https://atommic.readthedocs.io/en/latest/mri//undersampling.html), the [transforms](https://atommic.readthedocs.io/en/latest/mri//transforms.html), the [optimizer](https://atommic.readthedocs.io/en/latest/core/core.html#optimization), the [scheduler](https://atommic.readthedocs.io/en/latest/core/core.html#learning-rate-schedulers), the [loss](https://atommic.readthedocs.io/en/latest/mri/losses.html), the [trainer parameters](https://atommic.readthedocs.io/en/latest/core/core.html#training), and the [experiment manager](https://atommic.readthedocs.io/en/latest/core/exp_manager.html). All these parameters are defined in a `.yaml` file using [Hydra](https://hydra.cc/) and [OmegaConf](https://omegaconf.readthedocs.io/).\n\nThe trained model is an `.atommic` [module](https://atommic.readthedocs.io/en/latest/core/export.html), exported with [ONNX](https://onnx.ai/) and [TorchScript](https://pytorch.org/docs/stable/jit.html) support, which can be used for inference. The `.atommic` module can also be uploaded on [HuggingFace](https://huggingface.co/). Pretrained models are available on our [HF](https://huggingface.co/wdika) account and can be downloaded and used for inference.\n\n## \ud83d\udee0\ufe0f Installation\n\n**ATOMMIC** is best to be installed in a Conda environment.\n\n### \ud83d\udc0d Conda\n```\nconda create -n atommic python=3.10\nconda activate atommic\n```\n\n### \ud83d\udce6 Pip\nUse this installation mode if you want the latest released version.\n\n```bash\npip install atommic\n```\n\n### From source\n\nUse this installation mode if you are contributing to atommic.\n\n```bash\ngit clone https://github.com/wdika/atommic\ncd atommic\nbash ./reinstall.sh\n```\n\n### \ud83d\udc33 Docker containers\n\nAn atommic container is available at dockerhub, you can pull it with:\n```bash\ndocker pull wdika/atommic\n```\n\nYou can also build an atommic container with:\n```bash\nDOCKER_BUILDKIT=1 docker build -f Dockerfile -t atommic:latest .\n```\n\nYou can run the container with:\n```bash\ndocker run --gpus all -it --rm -v /home/user/configs:/config atommic:latest atommic run -c /config/config.yaml\n```\nwhere ```/config/config.yaml``` is the path to your local configuration file.\n\nOr you can run it interactively with:\n```bash\ndocker run --gpus all -it --rm -p 8888:8888 atommic:latest /bin/bash -c \"./start-jupyter.sh\"\n```\n\n## \ud83d\ude80 Quick Start Guide\n\nThe best way to get started with ATOMMIC is with one of the [tutorials](https://atommic.readthedocs.io/en/latest/starthere/tutorials.html):\n\n- [ATOMMIC Primer](https://github.com/wdika/atommic/blob/main/tutorials/00_ATOMMIC_Primer.ipynb) - demonstrates how to use ATOMMIC.\n- [ATOMMIC MRI transforms](https://github.com/wdika/atommic/blob/main/tutorials/01_ATOMMIC_MRI_transforms.ipynb) - demonstrates how to use ATOMMIC to undersample MRI data.\n- [ATOMMIC MRI undersampling](https://github.com/wdika/atommic/blob/main/tutorials/02_ATOMMIC_MRI_undersampling.ipynb) - demonstrates how to use ATOMMIC to apply transforms to MRI data.\n- [ATOMMIC Upload Model on HuggingFace](https://github.com/wdika/atommic/blob/main/tutorials/03_ATOMMIC_Upload_Model_On_HF.ipynb) - demonstrates how to upload a model on HuggingFace.\n\nYou can also check the [projects](https://github.com/wdika/atommic/tree/main/projects) page to see how to use ATOMMIC for specific tasks and public datasets.\n\nPre-trained models are available on HuggingFace [\ud83e\udd17](https://huggingface.co/wdika).\n\n### **ATOMMIC paper is fully reproducible. Please check [here](https://github.com/wdika/atommic/tree/main/projects/ATOMMIC_paper/README.md) for more information.**\n\n## \ud83e\udd16 Training & Testing\n\nTraining and testing models in **ATOMMIC** is intuitive and easy. You just need to properly configure a `.yaml` file and run the following command:\n\n```bash\natommic run -c path-to-config-file\n```\n\n## \u2699\ufe0f Configuration\n\n1. Choose the **task** and the **model**, according to the [collections](https://atommic.readthedocs.io/en/latest/mri/collections.html).\n\n2. Choose the **dataset** and the **dataset parameters**, according to the [datasets](README.md#mri-datasets) or your own dataset.\n\n3. Choose the [undersampling](https://atommic.readthedocs.io/en/latest/mri/transforms.html).\n\n4. Choose the [transforms](https://atommic.readthedocs.io/en/latest/mri/transforms.html).\n\n5. Choose the [losses](https://atommic.readthedocs.io/en/latest/mri/losses.html).\n\n6. Choose the [optimizer](https://atommic.readthedocs.io/en/latest/core/core.html#optimization).\n\n7. Choose the [scheduler](https://atommic.readthedocs.io/en/latest/core/core.html#learning-rate-schedulers).\n\n8. Choose the [trainer parameters](https://atommic.readthedocs.io/en/latest/core/core.html#training).\n\n9. Choose the [experiment manager](https://atommic.readthedocs.io/en/latest/core/exp_manager.html).\n\nYou can also check the [projects](https://github.com/wdika/atommic/tree/main/projects/) page to see how to configure the `.yaml` file for specific tasks.\n\n## \ud83d\uddc2\ufe0f Collections\n\n**ATOMMIC** is organized into [collections](https://atommic.readthedocs.io/en/latest/mri/collections.html), each of which implements a specific task. The following collections are currently available, implementing various models as listed:\n\n### MultiTask Learning (MTL)\n1. End-to-End Recurrent Attention Network (`SERANet`), 2. Image domain Deep Structured Low-Rank Network (`IDSLR`), 3. Image domain Deep Structured Low-Rank UNet (`IDSLRUNet`), 4. Multi-Task Learning for MRI Reconstruction and Segmentation (`MTLRS`), 5. Reconstruction Segmentation method using UNet (`RecSegUNet`), 6. Segmentation Network MRI (`SegNet`).\n\n### Quantitative MR Imaging (qMRI)\n1. Quantitative Recurrent Inference Machines (`qRIMBlock`), 2. Quantitative End-to-End Variational Network (`qVarNet`), 3. Quantitative Cascades of Independently Recurrent Inference Machines (`qCIRIM`).\n\n### MRI Reconstruction (REC)\n1. Cascades of Independently Recurrent Inference Machines (`CIRIM`), 2. Convolutional Recurrent Neural Networks (`CRNNet`), 3. Deep Cascade of Convolutional Neural Networks (`CascadeNet`), 4. Down-Up Net (`DUNet`), 5. End-to-End Variational Network (`VarNet`), 6. Independently Recurrent Inference Machines (`RIMBlock`), 7. Joint Deep Model-Based MR Image and Coil Sensitivity Reconstruction Network (`JointICNet`), 8. `KIKINet`, 9. Learned Primal-Dual Net (`LPDNet`), 10. Model-based Deep Learning Reconstruction (`MoDL`), 11. `MultiDomainNet`, 12. `ProximalGradient`, 13. Recurrent Inference Machines (`RIMBlock`), 14. Recurrent Variational Network (`RecurrentVarNet`), 15. `UNet`, 16. Variable Splitting Network (`VSNet`), 17. `XPDNet`, 18. Zero-Filled reconstruction (`ZF`).\n\n### MRI Segmentation (SEG)\n1. `SegmentationAttentionUNet`, 2. `SegmentationDYNUNet`, 3. `SegmentationLambdaUNet`, 4. `SegmentationUNet`, 5. `Segmentation3DUNet`, 6. `SegmentationUNetR`, 7. `SegmentationVNet`.\n\n## MRI Datasets\n\n**ATOMMIC** supports public datasets, as well as private datasets. The following public datasets are supported natively:\n\n- [AHEAD](https://github.com/wdika/atommic/tree/main/projects/qMRI/AHEAD): Supports the `(qMRI)` and `(REC)` tasks.\n- [BraTS 2023 Adult Glioma](https://github.com/wdika/atommic/tree/main/projects/SEG/BraTS2023AdultGlioma): Supports the `(SEG)` task.\n- [CC359](https://github.com/wdika/atommic/tree/main/projects/REC/CC359): Supports the `(REC)` task.\n- [fastMRI Brains Multicoil](https://github.com/wdika/atommic/tree/main/projects/REC/fastMRIBrainsMulticoil): Supports the `(REC)` task.\n- [fastMRI Knees Multicoil](https://github.com/wdika/atommic/tree/main/projects/REC/fastMRIKneesMulticoil): Supports the `(REC)` task.\n- [fastMRI Knees Singlecoil](https://github.com/wdika/atommic/tree/main/projects/REC/fastMRIKneesSinglecoil): Supports the `(REC)` task.\n- [ISLES 2022 Sub Acute Stroke](https://github.com/wdika/atommic/tree/main/projects/SEG/ISLES2022SubAcuteStroke): Supports the `(SEG)` task.\n- [SKM-TEA](https://github.com/wdika/atommic/tree/main/projects/MTL/rs/SKMTEA): Supports the `(REC)`, `(SEG)`, and `(MTL)` tasks.\n- [Stanford Knees](https://github.com/wdika/atommic/tree/main/projects/REC/StanfordKnees2019): Supports the `(REC)` task.\n\n## \ud83d\udcda API Documentation\n\n[](https://atommic.readthedocs.io/en/latest/?badge=latest)\n\nAccess the API Documentation [here](https://atommic.readthedocs.io/en/latest/index.html)\n\n## \ud83d\udcc4 License\n\n**ATOMMIC** is under [](https://opensource.org/licenses/Apache-2.0)\n\n## \ud83d\udcd6 Citation\n\nIf you use ATOMMIC in your research, please cite as follows:\n\n```BibTeX\n@article{Karkalousos_2024,\n title={Atommic: An Advanced Toolbox for Multitask Medical Imaging Consistency to Facilitate Artificial Intelligence Applications from Acquisition to Analysis in Magnetic Resonance Imaging},\n url={http://dx.doi.org/10.2139/ssrn.4801289},\n DOI={10.2139/ssrn.4801289},\n publisher={Elsevier BV},\n author={Karkalousos, Dimitrios and I\u0161gum, Ivana and Marquering, Henk and Caan, Matthan W.A.},\n year={2024}}\n```\n\n## \ud83d\udd17 References\n\nATOMMIC has been used or is referenced in the following papers:\n\n1. Karkalousos, Dimitrios and I\u0161gum, Ivana and Marquering, Henk and Caan, Matthan W.A., Atommic: An Advanced Toolbox for Multitask Medical Imaging Consistency to Facilitate Artificial Intelligence Applications from Acquisition to Analysis in Magnetic Resonance Imaging. Available at SSRN: https://ssrn.com/abstract=4801289 or http://dx.doi.org/10.2139/ssrn.4801289\n\n2. Karkalousos, D., I\u0161gum, I., Marquering, H. A., & Caan, M. W. A. (2024). ATOMMIC: An Advanced Toolbox for Multitask Medical Imaging Consistency to facilitate Artificial Intelligence applications from acquisition to analysis in Magnetic Resonance Imaging. https://doi.org/10.2139/ssrn.4801289\n\n3. Karkalousos, D., Isgum, I., Marquering, H., & Caan, M. W. A. (2024, April 27). The Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC): A Deep Learning framework to facilitate Magnetic Resonance Imaging. Medical Imaging with Deep Learning. https://openreview.net/forum?id=HxTZr9yA0N\n\n4. Karkalousos, D., Isgum, I., Marquering, H. & Caan, M.W.A.. (2024). MultiTask Learning for accelerated-MRI Reconstruction and Segmentation of Brain Lesions in Multiple Sclerosis. <i>Medical Imaging with Deep Learning</i>, in <i>Proceedings of Machine Learning Research</i> 227:991-1005 Available from https://proceedings.mlr.press/v227/karkalousos24a.html.\n\n5. Zhang, C., Karkalousos, D., Bazin, P. L., Coolen, B. F., Vrenken, H., Sonke, J. J., Forstmann, B. U., Poot, D. H. J., & Caan, M. W. A. (2022). A unified model for reconstruction and R2* mapping of accelerated 7T data using the quantitative recurrent inference machine. NeuroImage, 264. [DOI](https://doi.org/10.1016/j.neuroimage.2022.119680)\n\n6. Karkalousos, D., Noteboom, S., Hulst, H. E., Vos, F. M., & Caan, M. W. A. (2022). Assessment of data consistency through cascades of independently recurrent inference machines for fast and robust accelerated MRI reconstruction. Physics in Medicine & Biology. [DOI](https://doi.org/10.1088/1361-6560/AC6CC2)\n\n## \ud83d\udce7 Contact\n\nFor any questions, please contact Dimitris Karkalousos @ [d.karkalousos@amsterdamumc.nl](mailto:d.karkalousos@amsterdamumc.nl).\n\n## \u26a0\ufe0f\ud83d\ude4f Disclaimer & Acknowledgements\n\n> **Note:** ATOMMIC is built on top of [NeMo](https://github.com/NVIDIA/NeMo). NeMo is under Apache 2.0 license, so we are allowed to use it. We also assume that we can use the NeMo documentation basis as long as we cite it and always refer to the baselines everywhere in the code and docs. ATOMMIC also includes implementations of reconstruction methods from [fastMRI](https://github.com/facebookresearch/fastMRI) and [DIRECT](https://github.com/NKI-AI/direct), and segmentation methods from [MONAI](https://github.com/Project-MONAI/MONAI), as well as other codebases which are always cited on the corresponding files. All methods in ATOMMIC are reimplemented and not called from the original libraries, allowing for full reproducibility, support, and easy extension. ATOMMIC is an open-source project under the Apache 2.0 license.\n",
"bugtrack_url": null,
"license": "Apache-2.0 License",
"summary": "Advanced Toolbox for Multitask Medical Imaging Consistency (ATOMMIC)",
"version": "1.0.1",
"project_urls": {
"Download": "https://github.com/wdika/atommic/releases",
"Homepage": "https://github.com/wdika/atommic"
},
"split_keywords": [
"deep-learning",
" medical-imaging",
" mri",
" quantitative-imaging",
" medical-image-processing",
" medical-image-analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "090950da488ae351476b85223a6443b800975c7d6eca863559659f74c59d40ff",
"md5": "2bf39b8d705406985128999b90a4b97a",
"sha256": "8c8b0f9b3b960e32a0ab0ab52446a4f1b3adaefa11a588cde7709b7957d9ca42"
},
"downloads": -1,
"filename": "atommic-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2bf39b8d705406985128999b90a4b97a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<=3.12,>=3.10",
"size": 512705,
"upload_time": "2024-05-02T09:02:47",
"upload_time_iso_8601": "2024-05-02T09:02:47.160030Z",
"url": "https://files.pythonhosted.org/packages/09/09/50da488ae351476b85223a6443b800975c7d6eca863559659f74c59d40ff/atommic-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3036ce3858a7c07589f69fbeda9ad0ac83dfd56b8bdc814eba2a495892ec4341",
"md5": "c46a64a15205f93aa9ee3438dce0a6d4",
"sha256": "f73e4ee287008010cbbe240fd4fe5044becc0c84b09d0bc45c41b233c64c623e"
},
"downloads": -1,
"filename": "atommic-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "c46a64a15205f93aa9ee3438dce0a6d4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<=3.12,>=3.10",
"size": 402038,
"upload_time": "2024-05-02T09:02:48",
"upload_time_iso_8601": "2024-05-02T09:02:48.787844Z",
"url": "https://files.pythonhosted.org/packages/30/36/ce3858a7c07589f69fbeda9ad0ac83dfd56b8bdc814eba2a495892ec4341/atommic-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-02 09:02:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wdika",
"github_project": "atommic",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "atommic"
}
JSON
