Skip to main content

No project description provided

Project description

SUPER IVIM-DC

Intra-voxel incoherent motion (IVIM) analysis of fetal lungs Diffusion-Weighted MRI (DWI) data shows potential in providing quantitative imaging bio-markers that reflect, indirectly, diffusion and pseudo-diffusion for non-invasive fetal lung maturation assessment. However, long acquisition times, due to the large number of different 'b-value' images required for IVIM analysis, precluded clinical feasibility.

We introduce SUPER-IVIM-DC a deep-neural-networks (DNN) approach which couples supervised loss with a data-consistency term to enable IVIM analysis of DWI data acquired with a limited number of b-values.

We demonstrated the added-value of SUPER-IVIM-DC over both classical and recent DNN approaches for IVIM analysis through numerical simulations, healthy volunteer study, and IVIM analysis of fetal lung maturation from fetal DWI data.

Our numerical simulations and healthy volunteer study show that SUPER-IVIM-DC estimates of the IVIM model parameters from limited DWI data had lower normalized root mean-squared error compared to previous DNN-based approaches. Further, SUPER-IVIM-DC estimates of the pseudo-diffusion fraction parameter from limited DWI data of fetal lungs correlate better with gestational age compared to both to classical and DNN-based approaches (0.555 vs. 0.463 and 0.310).

SUPER-IVIM-DC has the potential to reduce the long acquisition times associated with IVIM analysis of DWI data and to provide clinically feasible bio-markers for non-invasive fetal lung maturity assessment.

Usage

Install the package using pip install super-ivim-dc

In order to use the function fit_least_squares_BOBYQA, the package nlopt is required, which requires libnlopt-dev.

sudo apt install libnlopt-dev
pip install "super-ivim-dc[BOBYQA]"

We also have a sample notebook on Google Colab.

Run training, generate .pt files

from super_ivim_dc.train import train

import numpy as np
working_dir: str = './working_dir'
super_ivim_dc_filename: str = 'super_ivim_dc'  # do not include .pt
ivimnet_filename: str = 'ivimnet'  # do not include .pt

bvalues = np.array([0,15,30,45,60,75,90,105,120,135,150,175,200,400,600,800])
snr = 10
sample_size = 100

train(
    SNR=snr, 
    bvalues=bvalues, 
    super_ivim_dc=True,
    ivimnet=True,
    work_dir=working_dir,
    super_ivim_dc_filename=super_ivim_dc_filename,
    ivimnet_filename=ivimnet_filename,
    verbose=False
)

This will create the following files:

  • ivimnet_init.json, super_ivim_dc_init.json - contains the initial values used in the training
  • ivimnet.pt, super_ivim_dc.pt - the pytorch models

Generate a random signal and test the generated model

from super_ivim_dc.infer import test_infer

test_infer(
    SNR=snr,
    bvalues=bvalues,
    work_dir=working_dir,
    super_ivim_dc_filename=super_ivim_dc_filename,
    ivimnet_filename=ivimnet_filename,
    save_figure_to=None,  # if set to None, the figure will be shown in the notebook
    sample_size=sample_size,
)

Generate signal

from super_ivim_dc.IVIMNET import simulations

IVIM_signal_noisy, Dt, f, Dp = simulations.sim_signal(
    SNR=snr, 
    bvalues=bvalues, 
    sims=sample_size
)

Dt, f, Dp = np.squeeze(Dt), np.squeeze(f), np.squeeze(Dp)

Run inference on the generated signal

from super_ivim_dc.infer import infer_from_signal

Dp_ivimnet, Dt_ivimnet, Fp_ivimnet, S0_ivimnet = infer_from_signal(
    signal=IVIM_signal_noisy, 
    bvalues=bvalues,
    model_path=f"{working_dir}/{ivimnet_filename}.pt",
)

Dp_superivimdc, Dt_superivimdc, Fp_superivimdc, S0_superivimdc = infer_from_signal(
    signal=IVIM_signal_noisy, 
    bvalues=bvalues,
    model_path=f"{working_dir}/{super_ivim_dc_filename}.pt",
)

Citation

If you find this code useful in your research, please consider citing:

@inproceedings{korngut2022super,
  title={SUPER-IVIM-DC: Intra-voxel incoherent motion based Fetal lung maturity assessment from limited DWI data using supervised learning coupled with data-consistency},
  author={Korngut, Noam and Rotman, Elad and Afacan, Onur and Kurugol, Sila and Zaffrani-Reznikov, Yael and Nemirovsky-Rotman, Shira and Warfield, Simon and Freiman, Moti},
  booktitle={International Conference on Medical Image Computing and Computer-Assisted Intervention},
  pages={743--752},
  year={2022},
  organization={Springer}
}

The paper is also available on ArXiv.

Project details


Download files

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

Source Distribution

super_ivim_dc-1.1.3.tar.gz (84.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

super_ivim_dc-1.1.3-py3-none-any.whl (78.4 kB view details)

Uploaded Python 3

File details

Details for the file super_ivim_dc-1.1.3.tar.gz.

File metadata

  • Download URL: super_ivim_dc-1.1.3.tar.gz
  • Upload date:
  • Size: 84.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for super_ivim_dc-1.1.3.tar.gz
Algorithm Hash digest
SHA256 c3a53a69d8a098a45abd05586b8348f6d9a657d1613ba2695fc9ba0597c222cd
MD5 f9965a1497b92628919935a542cbeca0
BLAKE2b-256 478949288070ada2c04ae8d622884b19a32f7aca0d2b326d195905ea2af0d483

See more details on using hashes here.

Provenance

The following attestation bundles were made for super_ivim_dc-1.1.3.tar.gz:

Publisher: pypi.yml on TechnionComputationalMRILab/SUPER-IVIM-DC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file super_ivim_dc-1.1.3-py3-none-any.whl.

File metadata

  • Download URL: super_ivim_dc-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 78.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for super_ivim_dc-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0c385ebee67470f990ee631cd8ca3fa035ffb590536ed22fc29fc8d0271defd1
MD5 895e85f44972acb3c4b2bab7ca10c2fa
BLAKE2b-256 b13a88d257ab452a9dbc03fb5ec67f35bb2190834df9c740358eaf1516a2037e

See more details on using hashes here.

Provenance

The following attestation bundles were made for super_ivim_dc-1.1.3-py3-none-any.whl:

Publisher: pypi.yml on TechnionComputationalMRILab/SUPER-IVIM-DC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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