src.imagedata.apps package

Subpackages

Submodules

src.imagedata.apps.diffusion module

Extract diffusion MRI parameters.

src.imagedata.apps.diffusion.get_b_value(img: Series) float[source]

Get diffusion b value

Extracting diffusion b value has been tested on MRI data from some major vendors.

Parameters:

img (imagedata.Series) – Series object.

Returns:

b value. Returns NaN when no b value is present in dataset.

Return type:

float

src.imagedata.apps.diffusion.get_ds_b_value(ds: Dataset) float[source]

Get diffusion b value from Dataset

Setting diffusion b value has been tested on MRI data from some major vendors.

Parameters:

ds – Input dataset

Returns:

b value

src.imagedata.apps.diffusion.get_ds_b_vectors(ds: Dataset) ndarray[source]

Get diffusion b vector from Dataset

Getting diffusion b vector has been tested on MRI data from some major vendors.

Parameters:

ds – Input dataset

Returns:

b vector

src.imagedata.apps.diffusion.get_g_vectors(img)[source]

Get diffusion gradient vectors

Extracting diffusion gradient vectors has been tested on MRI data from some major vendors.

Parameters:

img (imagedata.Series) – Series object.

Returns:

Diffusion gradient vectors, columns b, z, y, x.

Return type:

pd.DataFrame

Raises:

IndexError – when no gradient vector is present in dataset.

Examples

>>> from imagedata import Series
>>> from imagedata.apps.diffusion import get_g_vectors
>>> im = Series('data', 'b', opts={'accept_duplicate_tag': 'True'})
>>> g = get_g_vectors(im)
>>> print(g)
           b         z         y         x
    0      0       NaN       NaN       NaN
    1    500 -0.706399  0.000000  0.707814
    2    500 -0.706399  0.000000 -0.707814
    3    500 -0.706399 -0.707814  0.000000
    4    500  0.707814 -0.706399  0.000000
    5    500  0.000000 -0.707107  0.707107
    6    500  0.000000 -0.707107 -0.707107
    7   1000 -0.706752  0.000000  0.707461
    8   1000 -0.706752  0.000000 -0.707461
    9   1000 -0.706753 -0.707460  0.000000
    10  1000  0.707460 -0.706754  0.000000
    11  1000  0.001414 -0.707106  0.707106
    12  1000  0.001414 -0.707106 -0.707106
    13  2500 -0.706824  0.000000  0.707390
src.imagedata.apps.diffusion.set_ds_b_value(ds: Dataset, value: type[SupportsFloat])[source]

Set diffusion b value

Setting diffusion b value has been tested on MRI data from some major vendors.

Parameters:
  • ds (pydicom.Dataset) – Dataset

  • value – b value

src.imagedata.apps.diffusion.set_ds_b_vector(ds: Dataset, value: Sequence[type[SupportsFloat]])[source]

Set diffusion b vector

Setting diffusion b vector has been tested on MRI data from some major vendors.

Parameters:
  • ds (pydicom.Dataset) – Dataset

  • value – b vector

Module contents