tensorflow-mri 0.6.1

A collection of TensorFlow add-ons for computational MRI.

TensorFlow MRI (TFMR) is a Python library for MR image reconstruction and processing. TFMR provides:

• A selection of differentiable operators for accelerated image reconstruction, Cartesian and non-Cartesian k-space sampling, and many other common MR image and signal processing tasks.

• Keras objects such as metrics and losses for the creation, fitting and evaluation of machine learning models.

TFMR is aimed for scientists and researchers working with MRI data, whether they intend to use machine learning or not.

TFMR enables prototyping and deployment of computational MRI solutions easily and within a single language.

Thanks to the use of a TensorFlow backend, TFMR integrates seamlessly in machine learning projects. TFMR also inherits other benefits of TensorFlow, including high performance computation and GPU acceleration.

Installation

You can install TensorFlow MRI with pip:

$ pip install tensorflow-mri

Note that only Linux is currently supported.

TensorFlow Compatibility

Each TensorFlow MRI release is compiled against a specific version of TensorFlow. Please see the compatibility table below to see what versions of each package you can expect to work together.

TensorFlow MRI	TensorFlow
v0.4	v2.6
v0.5	v2.6
v0.6	v2.6

Documentation

Visit the docs for the API reference and examples of usage.

Contributions

If you use this package and something does not work as you expected, please file an issue describing your problem. We will do our best to help.

Contributions are very welcome. Please create a pull request if you would like to make a contribution.

Citation

If you find this software useful in your work, please cite us.

FAQ

When trying to install TensorFlow MRI, I get an error about OpenEXR which includes: ``OpenEXR.cpp:36:10: fatal error: ImathBox.h: No such file or directory``. What do I do?

OpenEXR is needed by TensorFlow Graphics, which is a dependency of TensorFlow MRI. This issue can be fixed by installing the OpenEXR library. On Debian/Ubuntu:

$ apt install libopenexr-dev