aslprep.utils.asl module

Functions for working with ASL data.

determine_multi_pld(metadata)

Determine if a run is multi-delay or not.

Parameters:

metadata (dict) – Dictionary of metadata from the ASL file.

Returns:

True if the data are multi-delay/TI. Fale if not.

Return type:

bool

estimate_labeling_efficiency(metadata)

Estimate labeling efficiency based on the available metadata.

Parameters:

metadata (dict) – Dictionary of metadata from the ASL file.

Returns:

labeleff – Labeling efficiency.

Return type:

float

Notes

If LabelingEfficiency is defined in the metadata, then this value will be used. Otherwise, efficiency will be estimated based on the ASL type and number of background suppression pulses (if any). PCASL and PASL values come from Alsop et al.[1]. The CASL value comes from Wang et al.[2]. The adjustment based on number of background suppression pulses is not described in any papers, as far as we know, but is apparently widely used.

References

[1]

David C. Alsop, John A. Detre, Xavier Golay, Matthias Günther, Jeroen Hendrikse, Luis Hernandez-Garcia, Hanzhang Lu, Bradley J. MacIntosh, Laura M. Parkes, Marion Smits, Matthias J. P. van Osch, Danny JJ Wang, Eric C. Wong, and Greg Zaharchuk. Recommended Implementation of Arterial Spin Labeled Perfusion MRI for Clinical Applications: A consensus of the ISMRM Perfusion Study Group and the European Consortium for ASL in Dementia. Magnetic resonance in medicine, 73(1):102–116, January 2015. URL: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4190138/ (visited on 2020-04-13), doi:10.1002/mrm.25197.

[2]

Jiongjiong Wang, Yan Zhang, Ronald L Wolf, Anne C Roc, David C Alsop, and John A Detre. Amplitude-modulated continuous arterial spin-labeling 3.0-t perfusion mr imaging with a single coil: feasibility study. Radiology, 235(1):218–228, 2005. URL: https://doi.org/10.1148/radiol.2351031663, doi:10.1148/radiol.2351031663.

get_bolus_duration(metadata: dict[str, Any], is_casl: bool) → float

Determine the appropriate bolus duration for BASIL.

For PASL data, the bolus cutoff delay is the first BolusCutOffDelayTime. For (P)CASL data, it is the labeling duration.

Parameters:

• metadata (dict) – Dictionary of metadata associated with ASL file.

• is_casl (bool) – True if the data are (P)CASL. False if the data are PASL.

Returns:

bolus – The bolus value.

Return type:

float

get_inflow_times(metadata: dict[str, Any], is_casl: bool) → list

Determine the appropriate inflow times for BASIL.

For PASL data, the inflow time (TI) is just the post-labeling delay (PLD). For (P)CASL data, TI is PLD plus the labeling duration.

Parameters:

• metadata (dict) – Dictionary of metadata associated with ASL file.

• is_casl (bool) – True if the data are (P)CASL. False if the data are PASL.

Returns:

1D array of PostLabelingDelay values.

Return type:

numpy.ndarray

pcasl_or_pasl(metadata)

Determine if metadata indicates a PCASL or ASL scan.

reduce_metadata_lists(metadata, n_volumes, keep_idx)

Reduce any volume-wise metadata fields to only contain values for selected volumes.

select_processing_target(aslcontext)

Determine how to handle ASL and M0 data based on dataset configuration.