Skip to content

TorchIO-project/torchio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,884 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

TorchIO logo

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 PyPI downloads PyPI version Conda version
CI Tests status Documentation status Coverage status
Code Code style Code quality
Tutorials Google Colab
Community YouTube All Contributors

Progressive artifacts

Augmentation


Original Random blur
Original Random blur
Random flip Random noise
Random flip Random noise
Random affine transformation Random elastic transformation
Random affine transformation Random elastic transformation
Random bias field artifact Random motion artifact
Random bias field artifact Random motion artifact
Random spike artifact Random ghosting artifact
Random spike artifact Random ghosting artifact

Queue

(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 our paper:

F. Pรฉrez-Garcรญa, R. Sparks, and S. Ourselin. TorchIO: a Python library for efficient loading, preprocessing, augmentation and patch-based sampling of medical images in deep learning. Computer Methods and Programs in Biomedicine (June 2021), p. 106236. ISSN: 0169-2607.doi:10.1016/j.cmpb.2021.106236.

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},
}

This project was originally supported by the following institutions:

Getting started

See Getting started for installation instructions and a Hello, World! example.

Longer usage examples can be found in the tutorials.

Read the documentation for more information.

Please create an issue if you think something is missing.

Contributors

Thanks goes to all these people (emoji key):

Fernando Pรฉrez-Garcรญa
Fernando Pรฉrez-Garcรญa

๐Ÿ’ป ๐Ÿ“–
valabregue
valabregue

๐Ÿค” ๐Ÿ‘€ ๐Ÿ’ป ๐Ÿ’ฌ ๐Ÿ›
GFabien
GFabien

๐Ÿ’ป ๐Ÿ‘€ ๐Ÿค”
G.Reguig
G.Reguig

๐Ÿ’ป
Niels Schurink
Niels Schurink

๐Ÿ’ป
Ibrahim Hadzic
Ibrahim Hadzic

๐Ÿ›
ReubenDo
ReubenDo

๐Ÿค”
Julian Klug
Julian Klug

๐Ÿค”
David Vรถlgyes
David Vรถlgyes

๐Ÿค” ๐Ÿ’ป
Jean-Christophe Fillion-Robin
Jean-Christophe Fillion-Robin

๐Ÿ“–
Suraj Pai
Suraj Pai

๐Ÿค”
Ben Darwin
Ben Darwin

๐Ÿค”
Oeslle Lucena
Oeslle Lucena

๐Ÿ›
Soumick Chatterjee
Soumick Chatterjee

๐Ÿ’ป
neuronflow
neuronflow

๐Ÿ“–
Jan Witowski
Jan Witowski

๐Ÿ“–
Derk Mus
Derk Mus

๐Ÿ“– ๐Ÿ’ป ๐Ÿ›
Christian Herz
Christian Herz

๐Ÿ›
Cory Efird
Cory Efird

๐Ÿ’ป ๐Ÿ›
Esteban Vaca C.
Esteban Vaca C.

๐Ÿ›
Ray Phan
Ray Phan

๐Ÿ›
Akis Linardos
Akis Linardos

๐Ÿ› ๐Ÿ’ป
Nina Montana-Brown
Nina Montana-Brown

๐Ÿ“– ๐Ÿš‡
fabien-brulport
fabien-brulport

๐Ÿ›
malteekj
malteekj

๐Ÿ›
Andres Diaz-Pinto
Andres Diaz-Pinto

๐Ÿ›
Sarthak Pati
Sarthak Pati

๐Ÿ“ฆ ๐Ÿ“–
GabriellaKamlish
GabriellaKamlish

๐Ÿ›
Tyler Spears
Tyler Spears

๐Ÿ›
DaGuT
DaGuT

๐Ÿ“–
Xiangyu Zhao
Xiangyu Zhao

๐Ÿ›
siahuat0727
siahuat0727

๐Ÿ“– ๐Ÿ›
Svdvoort
Svdvoort

๐Ÿ’ป
Albans98
Albans98

๐Ÿ’ป
Matthew T. Warkentin
Matthew T. Warkentin

๐Ÿ’ป
glupol
glupol

๐Ÿ›
ramonemiliani93
ramonemiliani93

๐Ÿ“– ๐Ÿ› ๐Ÿ’ป
Justus Schock
Justus Schock

๐Ÿ’ป ๐Ÿ› ๐Ÿค” ๐Ÿ‘€
Stefan Milorad Radonjiฤ‡
Stefan Milorad Radonjiฤ‡

๐Ÿ›
Sajan Gohil
Sajan Gohil

๐Ÿ›
Ikko Ashimine
Ikko Ashimine

๐Ÿ“–
laynr
laynr

๐Ÿ“–
Omar U. Espejel
Omar U. Espejel

๐Ÿ”Š
James Butler
James Butler

๐Ÿ›
res191
res191

๐Ÿ”
nengwp
nengwp

๐Ÿ› ๐Ÿ“–
susanveraclarke
susanveraclarke

๐ŸŽจ
nepersica
nepersica

๐Ÿ›
Sebastian Penhouet
Sebastian Penhouet

๐Ÿค”
Bigsealion
Bigsealion

๐Ÿ›
Dลพenan Zukiฤ‡
Dลพenan Zukiฤ‡

๐Ÿ‘€
vasl12
vasl12

โœ… ๐Ÿ›
Franรงois Rousseau
Franรงois Rousseau

๐Ÿ›
snavalm
snavalm

๐Ÿ’ป
Jacob Reinhold
Jacob Reinhold

๐Ÿ’ป
Hsu
Hsu

๐Ÿ›
snipdome
snipdome

๐Ÿ›
SmallY
SmallY

๐Ÿ›
guigautier
guigautier

๐Ÿค”
AyedSamy
AyedSamy

๐Ÿ›
J. Miguel Valverde
J. Miguel Valverde

๐Ÿค” ๐Ÿ’ป ๐Ÿ›
Josรฉ Guilherme Almeida
Josรฉ Guilherme Almeida

๐Ÿค”
Asim Usman
Asim Usman

๐Ÿ›
cbri92
cbri92

๐Ÿ›
Markus J. Ankenbrand
Markus J. Ankenbrand

๐Ÿ›
Ziv Yaniv
Ziv Yaniv

๐Ÿ“–
Luca Lumetti
Luca Lumetti

๐Ÿ’ป ๐Ÿ“–
chagelo
chagelo

๐Ÿ›
mueller-franzes
mueller-franzes

๐Ÿ’ป ๐Ÿ›
Abdelwahab Kawafi
Abdelwahab Kawafi

๐Ÿ›
Arthur Masson
Arthur Masson

๐Ÿ› ๐Ÿ“–
์–‘ํ˜„์‹
์–‘ํ˜„์‹

๐Ÿ’ป
nicoloesch
nicoloesch

๐Ÿ’ป ๐Ÿ› ๐ŸŽจ ๐Ÿšง ๐Ÿ’ฌ ๐Ÿ‘€
Amund Vedal
Amund Vedal

๐Ÿ“–
Alabamagan
Alabamagan

๐Ÿ›
sbdoherty
sbdoherty

๐Ÿ“–
Zhack47
Zhack47

๐Ÿ›
Blake Dewey
Blake Dewey

๐Ÿ“–
Doyeon Kim
Doyeon Kim

๐Ÿ›
KonoMaxi
KonoMaxi

๐Ÿ›
Laurent Chauvin
Laurent Chauvin

๐Ÿ›
Christian Hinge
Christian Hinge

๐Ÿ›
zzz123xyz
zzz123xyz

๐Ÿ›
Amin Alam
Amin Alam

๐Ÿ“–
marius-sm
marius-sm

๐Ÿค”
haarisr
haarisr

๐Ÿ’ป
Chris Winder
Chris Winder

๐Ÿ›
Ricky Walsh
Ricky Walsh

๐Ÿ’ป
Keerthi Sravan Ravi
Keerthi Sravan Ravi

๐Ÿ›
Rahul Kurian Jacob
Rahul Kurian Jacob

๐Ÿ“–
Ethan Rooke
Ethan Rooke

๐Ÿ“–
David Kucher
David Kucher

๐Ÿ’ป
StijnvWijn
StijnvWijn

๐Ÿ’ป ๐Ÿ›
Toufiq
Toufiq

๐Ÿ’ป
bcrobo
bcrobo

๐Ÿ›
Emmanuel Ferdman
Emmanuel Ferdman

๐Ÿ›
Anders Dahl Henriksen
Anders Dahl Henriksen

๐Ÿšง
Eike Petersen
Eike Petersen

๐Ÿ›
AlexanderHBerger
AlexanderHBerger

๐Ÿ›
Rhys | Senior DevOps Engineer | 3x AWS Certified | CKA | Terraform Certified
Rhys | Senior DevOps Engineer | 3x AWS Certified | CKA | Terraform Certified

๐Ÿ›

This project follows the all-contributors specification. Contributions of any kind welcome!

โšก