Skip to main content

Model-based estimation and correction of head motion and eddy current distortions in 4D neuroimaging.

NiFreeze is a flexible framework for volume-to-volume motion estimation and correction in d/fMRI and PET, and eddy-current-derived distortion estimation in dMRI.

License Latest Version Testing Examples Documentation Python package Contribution checks Benchmarks Code format

Diffusion and functional MRI (d/fMRI) generally employ echo-planar imaging (EPI) for fast whole-brain acquisition. Despite the rapid collection of volumes, typical repetition times are long enough for head motion to occur, which has been proven detrimental to both diffusion [1] and functional [2] MRI. In the case of dMRI, additional volume-wise, low-order spatial distortions are caused by eddy currents (EC), which appear as a result of quickly switching diffusion gradients. Unaccounted for EC distortion can result in incorrect local model fitting and poor downstream tractography results [3], [4]. FSL’s eddy [5] is the most popular tool for EC distortion correction, and implements a leave-one-volume-out approach to estimate EC distortions. However, FSL has commercial restrictions that hinder application within open-source initiatives such as NiPreps [6]. In addition, FSL’s development model discourages the implementation of alternative data-modeling approaches to broaden the scope of application (e.g., modalities beyond dMRI). NiFreeze is an open-source implementation of eddy’s approach to estimate artifacts that permits alternative models that apply to, for instance, head motion estimation in fMRI and positron-emission tomography (PET) data.

The nifreeze flowchart

Metadata

Release files for nifreeze 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nifreeze 0.1.0
File Size Uploaded
nifreeze-0.1.0.tar.gz 9.2 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nifreeze 0.1.0
File Interpreter ABI Platform
nifreeze-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.3 MB

Release files / nifreeze-0.1.0.tar.gz

Download URL nifreeze-0.1.0.tar.gz
Size 9.2 MB
Tags Source
SHA-256 checksum
How to use checksums
96f4ae7a9cf5f165702fd3cbc912cca14c011782d1987c91319ba7fa3824ac94
BLAKE2b-256 checksum
How to use checksums
1142d480abd39ea1e753fff1d1bfeb401abba5b34330ba1c770cf8d63c501810
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 6, 2026.

Transparency log

Release files / nifreeze-0.1.0-py3-none-any.whl

Download URL nifreeze-0.1.0-py3-none-any.whl
Size 112.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fa544fdbca5049498acc814c111afc0f76bb7aca606a5b1d56f0d707db79716b
BLAKE2b-256 checksum
How to use checksums
109e3e9cd1235104d57f8650077f9c68065d323ae4d22848228e396103e5c4a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 6, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page