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

Clone and install the package using pip install super-ivim-dc

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.0.tar.gz (83.9 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.0-py3-none-any.whl (78.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: super_ivim_dc-1.1.0.tar.gz
  • Upload date:
  • Size: 83.9 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.0.tar.gz
Algorithm Hash digest
SHA256 505efee189c59aba5cdffe9e0b43f94783f7e4bdeb15d3a73ae8c2326dbd7d0d
MD5 ab3560f02b0b9bbfdbb734626cf68fc5
BLAKE2b-256 0c957a351bd7c12f0168401cd44a238642853fa737f7ebe66d5b6fd0fb5993f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for super_ivim_dc-1.1.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: super_ivim_dc-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 78.1 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4396174ab9062659f8f560bffec967beda8ede4a63a8a344392e4b5878e53b4f
MD5 2d973e7e3e2a2feebff1f70d02701f1f
BLAKE2b-256 51a3790462a6898d25252e81358221f6ffa52bfe2473db9436f14d26a49be2db

See more details on using hashes here.

Provenance

The following attestation bundles were made for super_ivim_dc-1.1.0-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