Skip to main content

Neurite Exchange Imaging (NEXI) model estimator for gray matter diffusion MRI

PyPI - Version PyPI - Downloads GitHub GitHub top language PyPI - Python Version Code style: black


Table of Contents

Installation

pip install nexi

Usage

Estimate NEXI parameters

To estimate NEXI parameters using the nexi package, you can use the estimate_nexi function. This function takes several parameters that you need to provide in order to perform the estimation accurately.

estimate_nexi(dwi_path, bvals_path, td_path, lowb_noisemap_path, out_path)

dwi_path: The path to the diffusion-weighted image (DWI) data in NIfTI format. This data contains the preprocessed diffusion-weighted volumes acquired from your imaging study.

bvals_path: The path to the b-values file corresponding to the DWI data. B-values specify the strength and timing of diffusion sensitization gradients for each volume in the DWI data.

td_path: The path to the diffusion time (td) file, also known as Δ. This file provides information about the diffusion time for each volume in the DWI data. The diffusion time is the time between the two gradient pulses.

lowb_noisemap_path: The path to the noisemap calculated using only the small b-values (b < 2 ms/µm²) and Marchenko-Pastur principal component analysis (MP-PCA) denoising. This noisemap is used to calculate the signal-to-noise ratio (SNR) of the data.

out_path: The folder where the estimated NEXI parameters will be saved as output.

Prerequisites

Data Acquisition

For accurate NEXI parameter estimation using the nexi package, acquire PGSE EPI (Pulsed Gradient Spin Echo Echo-Planar Imaging) diffusion MRI data with diverse combinations of b values and diffusion times. Ensure reasonable signal-to-noise ratio (SNR) in the data for accurate parameter estimation.

Preprocessing

Before proceeding, make sure to preprocess your data with the following steps:

Additionally, you need to compute another noisemap using only the small b-values (b < 2 ms/µm²) and MP-PCA. This noisemap will be used to calculate the signal-to-noise ratio (SNR) of the data.

Furthermore, you can provide a mask of grey matter tissue if available. This mask can be used to restrict the processing to specific regions of interest. If a mask is not provided, the algorithms will be applied to the entire image, voxel by voxel, as long as there are no NaN values present.

To compute a grey matter mask, one common approach involves using a T1 image, FastSurfer, and performing registration to the diffusion (b = 0 ms/µm²) space. However, you can choose any other method to compute a grey matter mask.

Citation

If you use this package in your research, please consider citing the following papers:

Original NEXI Paper

Ileana O. Jelescu, Alexandre de Skowronski, Françoise Geffroy, Marco Palombo, Dmitry S. Novikov, Neurite Exchange Imaging (NEXI): A minimal model of diffusion in gray matter with inter-compartment water exchange, NeuroImage, 2022.

First application on human gray matter / Development of this package

Quentin Uhl, Tommaso Pavan, Malwina Molendowska, Derek K. Jones, Marco Palombo, Ileana O. Jelescu, Quantifying human gray matter microstructure using NEXI and 300 mT/m gradients, Arxiv, 2023.

License

nexi is distributed under the terms of the Apache License 2.0.

Release files for nexi 1.0.7

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

Source distribution (sdist)

Source distribution for nexi 1.0.7
File Size Uploaded
nexi-1.0.7.tar.gz 32.9 kB Details

Built distribution (wheel)

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

Total release size: 61.7 kB

Release files / nexi-1.0.7.tar.gz

Download URL nexi-1.0.7.tar.gz
Size 32.9 kB
Tags Source
SHA-256 checksum
How to use checksums
bf2e5431e2df4a5b115ab3d3057193e7bad8675c6837cd2f325c4e53f8c918f6
BLAKE2b-256 checksum
How to use checksums
7d2c593a207bf890d1cbbb3ffbc2f263b0779c32505a3ddd167dd95f63acc257
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.24.1

Release files / nexi-1.0.7-py3-none-any.whl

Download URL nexi-1.0.7-py3-none-any.whl
Size 28.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d716cd71c889f0fa539537f44df74db9012ae89ffa1f04149278276bd3aff694
BLAKE2b-256 checksum
How to use checksums
0605f5b765e24f9ab970487b48081a9100fdd867560c18996016e6abdb9e9634
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.24.1

Release history Release notifications | RSS feed

This release

1.0.7 This release

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0

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