Home

Awesome

<p align="center"> <img src="https://raw.githubusercontent.com/DeepRegNet/DeepReg/main/docs/asset/deepreg_logo_purple.svg" alt="deepreg_logo" title="DeepReg" width="200"/> </p> <table align="center"> <tr> <td> <b>Package</b> </td> <td> <a href="https://opensource.org/licenses/Apache-2.0"> <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"> </a> <a href="https://pypi.python.org/pypi/DeepReg/"> <img src="https://img.shields.io/pypi/v/deepreg.svg" alt="PyPI Version"> </a> <a href="https://pypi.python.org/pypi/DeepReg/"> <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/deepreg"> </a> <a href="https://pepy.tech/project/deepreg"> <img src="https://static.pepy.tech/personalized-badge/deepreg?period=total&units=none&left_color=grey&right_color=orange&left_text=Downloads" alt="PyPI downloads"> </a> </td> </tr> <tr> <td> <b>Documentation</b> </td> <td> <a href="https://deepreg.readthedocs.io/en/latest/?badge=latest"> <img src="https://readthedocs.org/projects/deepreg/badge/?version=latest" alt="Documentation Status"> </a> </td> </tr> <tr> <td> <b>Code</b> </td> <td> <a href="https://github.com/DeepRegNet/DeepReg/actions?query=workflow%3A%22Unit+Test%22"> <img src="https://github.com/deepregnet/deepreg/workflows/Unit%20Test/badge.svg?branch=main" alt="Unit Test"> </a> <a href="https://github.com/DeepRegNet/DeepReg/actions?query=workflow%3A%22Integration+Test%22"> <img src="https://github.com/deepregnet/deepreg/workflows/Integration%20Test/badge.svg?branch=main" alt="Integration Test"> </a> <a href="https://codecov.io/github/DeepRegNet/DeepReg"> <img src="https://codecov.io/gh/DeepRegNet/DeepReg/branch/main/graph/badge.svg" alt="Coverage Status"> </a> <a href="https://github.com/psf/black"> <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style"> </a> <a href="https://scrutinizer-ci.com/g/DeepRegNet/DeepReg/"> <img src="https://scrutinizer-ci.com/g/DeepRegNet/DeepReg/badges/quality-score.png" alt="Code Quality"> </a> <a href="https://codeclimate.com/github/DeepRegNet/DeepReg/maintainability"> <img src="https://api.codeclimate.com/v1/badges/65245e28aa8f2cd7c6b6/maintainability" alt="Code Maintainability"> </a> </td> </tr> <tr> <td> <b>Papers</b> </td> <td> <a href="https://joss.theoj.org/papers/7e6de472bc82a70d7618e23f618960b3"><img src="https://joss.theoj.org/papers/7e6de472bc82a70d7618e23f618960b3/status.svg" alt="JOSS Paper"></a> <a href="https://zenodo.org/badge/latestdoi/269365590"><img src="https://zenodo.org/badge/269365590.svg" alt="DOI"></a> </td> </tr> </table>

DeepReg

DeepReg is a freely available, community-supported open-source toolkit for research and education in medical image registration using deep learning.


Getting Started

Contributing

Get involved, and help make DeepReg better! We want your help - Really.

Being a contributor doesn't just mean writing code. Equally important to the open-source process is writing or proof-reading documentation, suggesting or implementing tests, or giving feedback about the project. You might see the errors and assumptions that have been glossed over. If you can write any code at all, you can contribute code to open-source. We are constantly trying out new skills, making mistakes, and learning from those mistakes. That's how we all improve, and we are happy to help others learn with us.

Code of Conduct

This project is released with a Code of Conduct. By participating in this project, you agree to abide by its terms.

Where Should I Start?

For guidance on making a contribution to DeepReg, see our Contribution Guidelines.

Have a registration application with openly accessible data? Consider contributing a DeepReg Demo.

MICCAI 2020 Educational Challenge

Our MICCAI Educational Challenge submission on DeepReg is an Award Winner!

Check it out here - you can also Open In Colab

Overview Video

Members of the DeepReg dev team presented "The Road to DeepReg" at the Centre for Medical Imaging Computing (CMIC) seminar series at University College London on the 4th of November 2020. You can access the talk here.

Citing DeepReg

DeepReg is research software, made by a team of academic researchers. Citations and use of our software help us justify the effort which has gone into, and will keep going into, maintaining and growing this project.

If you have used DeepReg in your research, please consider citing us:

Fu et al., (2020). DeepReg: a deep learning toolkit for medical image registration. Journal of Open Source Software, 5(55), 2705, https://doi.org/10.21105/joss.02705

Or with BibTex:

@article{Fu2020,
  doi = {10.21105/joss.02705},
  url = {https://doi.org/10.21105/joss.02705},
  year = {2020},
  publisher = {The Open Journal},
  volume = {5},
  number = {55},
  pages = {2705},
  author = {Yunguan Fu and Nina Montaña Brown and Shaheer U. Saeed and Adrià Casamitjana and Zachary M. C. Baum and Rémi Delaunay and Qianye Yang and Alexander Grimwood and Zhe Min and Stefano B. Blumberg and Juan Eugenio Iglesias and Dean C. Barratt and Ester Bonmati and Daniel C. Alexander and Matthew J. Clarkson and Tom Vercauteren and Yipeng Hu},
  title = {DeepReg: a deep learning toolkit for medical image registration},
  journal = {Journal of Open Source Software}
}