Tools for loading, augmenting and writing 3D medical images on PyTorch.
Project description
Tools like TorchIO are a symptom of the maturation of medical AI research using deep learning techniques.
Jack Clark, Policy Director at OpenAI (link).
| Package |
|
| CI |
|
| Code |
|
| Notebooks |
|
| Social |
|
(Queue for patch-based training)
TorchIO is a Python package containing a set of tools to efficiently read, preprocess, sample, augment, and write 3D medical images in deep learning applications written in PyTorch, including intensity and spatial transforms for data augmentation and preprocessing. Transforms include typical computer vision operations such as random affine transformations and also domain-specific ones such as simulation of intensity artifacts due to MRI magnetic field inhomogeneity or k-space motion artifacts.
This package has been greatly inspired by NiftyNet, which is not actively maintained anymore.
Credits
If you like this repository, please click on Star!
If you use this package for your research, please cite the paper:
BibTeX entry:
@article{perez-garcia_torchio_2021,
title = {TorchIO: a Python library for efficient loading, preprocessing, augmentation and patch-based sampling of medical images in deep learning},
journal = {Computer Methods and Programs in Biomedicine},
pages = {106236},
year = {2021},
issn = {0169-2607},
doi = {https://doi.org/10.1016/j.cmpb.2021.106236},
url = {https://www.sciencedirect.com/science/article/pii/S0169260721003102},
author = {P{\'e}rez-Garc{\'i}a, Fernando and Sparks, Rachel and Ourselin, S{\'e}bastien},
keywords = {Medical image computing, Deep learning, Data augmentation, Preprocessing},
}
This project is supported by the following institutions:
- Engineering and Physical Sciences Research Council (EPSRC) & UK Research and Innovation (UKRI)
- EPSRC Centre for Doctoral Training in Intelligent, Integrated Imaging In Healthcare (i4health) (University College London)
- Wellcome / EPSRC Centre for Interventional and Surgical Sciences (WEISS) (University College London)
- School of Biomedical Engineering & Imaging Sciences (BMEIS) (King's College London)
Getting started
See Getting started for installation instructions and a Hello, World! example.
Longer usage examples can be found in the notebooks.
All the documentation is hosted on Read the Docs.
Please open a new issue if you think something is missing.
Contributors
Thanks goes to all these people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
History
0.18.0 (29-11-2020)
- Add
FPGdataset - Optimize cropping in samplers
- Optimize implementation of
UniformSamplerandWeightedSampler - Fix non integer labels in Colin 27 version 2008 (#223)
- Add
RandomAnisotropytransform - Add
RandomGammatransform - Add
ScalarImageandLabelMapclasses - Add
RandomLabelsToImagetransform - Add support for more input types in
Transform - Add support for 4D images
- Add ICBM dataset
- Add support to specify axes as anatomical labels
- Add
SpatialTransformandIntensityTransform - Replace
ImagesDatasetwithSubjectsDataset - Add support to pass multiple paths to
Image - Refactor reproducibility features
- Add deterministic versions of all random transforms
- Add support to invert transforms
- Add support for SimpleITK > 1
- Add
pre-committo help contributions and improve coda quality - Add DICOM data for testing
- Add some visualization support (
Subject.plot,Image.plot) - Add support to pass parameters per axis, e.g. for
RandomAffine(#346) - Remove deprecated transforms
ResampleandCenterCropOrPad
0.17.0 (23-06-2020)
- Add transforms history to
Subjectattributes to improve traceability - Add support to use an initial transformation in
Resample - Add support to use an image file as target in
Resample - Add
meanargument toRandomNoise - Add tensor support for transforms
- Add support to use strings as interpolation argument
- Add support for 2D images
- Add attribute access to
SubjectandImage - Add MNI and 3D Slicer datasets
- Add
intensityargument toRandomGhosting - Add
translationargument toRandomAffine - Add shape, spacing and orientation attributes to
ImageandSubject - Refactor samplers
- Refactor inference classes
- Add 3D Slicer extension
- Add ITK-SNAP datasets
- Add support to take NumPy arrays as transforms input
- Optimize cropping using PyTorch
- Optimizing transforms by reducing number of tensor copying
- Improve representation (
repr()) ofImage - Use lazy loading in
Image
0.16.0 (21-04-2020)
- Add advanced padding options for
RandomAffine - Add reference space options in
Resample - Add probability argument to all transforms
- Add
OneOfandComposetransforms to improve composability
0.15.0 (07-04-2020)
- Refactor
RandomElasticDeformationtransform - Make
Subjectinherit fromdict
0.14.0 (31-03-2020)
- Add
datasetsmodule - Add support for DICOM files
- Add documentation
- Add
CropOrPadtransform
0.13.0 (24-02-2020)
- Add
Subjectclass - Add random blur transform
- Add lambda transform
- Add random patches swapping transform
- Add MRI k-space ghosting artefact augmentation
0.12.0 (21-01-2020)
- Add ToCanonical transform
- Add CenterCropOrPad transform
0.11.0 (15-01-2020)
- Add Resample transform
0.10.0 (15-01-2020)
- Add Pad transform
- Add Crop transform
0.9.0 (14-01-2020)
- Add CLI tool to transform an image from file
0.8.0 (11-01-2020)
- Add Image class
0.7.0 (02-01-2020)
- Make transforms use PyTorch tensors consistently
0.6.0 (02-01-2020)
- Add support for NRRD
0.5.0 (01-01-2020)
- Add bias field transform
0.4.0 (29-12-2019)
- Add MRI k-space motion artefact augmentation
0.3.0 (21-12-2019)
- Add Rescale transform
- Add support for multimodal data and missing modalities
0.2.0 (2019-12-06)
- First release on PyPI.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file torchio-0.18.47.tar.gz.
File metadata
- Download URL: torchio-0.18.47.tar.gz
- Upload date:
- Size: 37.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.7.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 548b3b452131020134f16ecfc6c3a4f181d3886a5e832df632d7c5b5d594ab1f |
|
| MD5 | d4682b7ef99074c03d8b822cffefcc80 |
|
| BLAKE2b-256 | 605f61a62afb4ec8db9aee38a81e04a84417966ea3d27c829f19b32052c05bbb |
File details
Details for the file torchio-0.18.47-py2.py3-none-any.whl.
File metadata
- Download URL: torchio-0.18.47-py2.py3-none-any.whl
- Upload date:
- Size: 149.1 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.7.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e4070898f980fb6e53f98ba2188e875a1d4b8046cd44a7513c7ff2e6bd5194e0 |
|
| MD5 | 1e867c1bc121ca324a9c04ff18f65712 |
|
| BLAKE2b-256 | 6ec911d5a3245f641e8873e08ebae9b6fe051d8aaf78b03c182b96873f6d0c61 |
