Skip to main content

Image registration routines for Imagedata

Project description

Documentation Status Build Status Coverage PyPI Version

Helper modules to do image registration for Imagedata Series objects.

Available modules

NPreg

NPreg by Erlend Hodneland is implemented in Python, and available as a self-supported PyPi package. There are three implementations of NPreg:

  • Pure Python/NumPy code. Source code will run on any Python platform.

  • Cython code. Binary code compiled for supported platforms.

  • CuPy/CUDA code. Source code which will run on platforms with a working CuPy and CUDA Toolkit.

FSL

FSL (https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/FSL) has several methods for image registration. Using FSL image registration from Python requires the FSL interface from nipype, as well as a the FSL executables. Each FSL method may have different requirements. The common factor is that FSL methods will read and write NIfTI image files.

A function register_fsl is provided here. This function will register a moving Series to a fixed Series. The default registration method is fsl.MCFLIRT. The function will accept other registration methods.

ITK Elastix

The popular Elastix GUI is based on the C++ ITK image registration routines. Like the FSL methods, there are numerous Elastix methods available, all with different requirements. The SimpleElastix (https://simpleelastix.readthedocs.io/index.html) Python library is one particular interface to the Elastix/ITK routines.

Prerequisites

NPreg on CUDA GPU

imagedata-registration will benefit from a CUDA GPU. If this is available, install CuPy (https://docs.cupy.dev).

FSL

The imagedata-registration FSL module is a wrapper around the official FSL tools. A native FSL installation is required on the host computer.

SimpleElastix

SimpleElastix must be installed separately:

pip install SimpleITK-SimpleElastix

Installation

pip install imagedata-registration

Examples

NPreg examples

FSL examples

SimpleElastix examples

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

imagedata_registration-0.2.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

imagedata_registration-0.2.4-cp312-cp312-macosx_10_9_x86_64.whl (276.0 kB view hashes)

Uploaded CPython 3.12 macOS 10.9+ x86-64

imagedata_registration-0.2.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

imagedata_registration-0.2.4-cp311-cp311-macosx_10_9_x86_64.whl (283.8 kB view hashes)

Uploaded CPython 3.11 macOS 10.9+ x86-64

imagedata_registration-0.2.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

imagedata_registration-0.2.4-cp310-cp310-macosx_10_9_x86_64.whl (285.1 kB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

imagedata_registration-0.2.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

imagedata_registration-0.2.4-cp39-cp39-macosx_10_9_x86_64.whl (285.8 kB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

imagedata_registration-0.2.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

imagedata_registration-0.2.4-cp38-cp38-macosx_10_9_x86_64.whl (285.4 kB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page