look_locker

look_locker ¶

Look-Locker T1 mapping (OSIPI: P.NR2.004).

This module implements T1 mapping from Look-Locker inversion recovery acquisitions.

Estimates native longitudinal relaxation rate R1 (OSIPI: Q.EL1.001) via multi-delay inversion recovery (OSIPI: P.NR2.004).

GPU/CPU agnostic using the xp array module pattern. Nonlinear fitting uses the shared LevenbergMarquardtFitter.

References

.. [1] OSIPI CAPLEX, https://osipi.github.io/OSIPI_CAPLEX/ .. [2] Look DC, Locker DR. Rev Sci Instrum 1970;41:250-251. .. [3] Deichmann R, Haase A. J Magn Reson 1992;96:608-612.

compute_t1_look_locker ¶

compute_t1_look_locker(dataset, ti_times=None)

Compute T1 map from Look-Locker data (OSIPI: P.NR2.004).

Estimates native R1 (OSIPI: Q.EL1.001) via multi-delay inversion recovery (OSIPI: P.NR2.004).

GPU/CPU agnostic - operates on same device as dataset data.

PARAMETER	DESCRIPTION
`dataset`	Dataset with images acquired at multiple inversion times. TYPE: `PerfusionDataset`
`ti_times`	Inversion times in milliseconds. If None, attempts to extract from dataset.time_points. TYPE: `NDArray \| None` DEFAULT: `None`

RETURNS	DESCRIPTION
`T1MappingResult`	Result containing T1 map and quality mask.

RAISES	DESCRIPTION
`DataValidationError`	If dataset is not suitable for Look-Locker T1 mapping.

References

.. [1] OSIPI CAPLEX, https://osipi.github.io/OSIPI_CAPLEX/ .. [2] Look DC, Locker DR. Rev Sci Instrum 1970;41:250-251.

Examples:

>>> from osipy.dce.t1_mapping.look_locker import compute_t1_look_locker
>>> result = compute_t1_look_locker(dataset, ti_times=ti_array)