base

base

Base class for ASL signal models.

All ASL models (single-PLD quantification and multi-PLD ATT estimation) inherit from BaseASLModel, which extends BaseSignalModel with ASL-specific properties: labeling_type and quantify().

References

.. [1] OSIPI ASL Lexicon, https://osipi.github.io/ASL-Lexicon/

BaseASLModel

Bases: BaseSignalModel

Abstract base class for ASL signal models.

Unifies single-PLD quantification models and multi-PLD ATT estimation models under BaseSignalModel. Each model implements:

• parameters, parameter_units, get_bounds() — from BaseSignalModel
• labeling_type — ASL-specific ('pcasl', 'pasl', 'casl')
• quantify() — optional analytical inverse (closed-form CBF)

Models that support analytical quantification override quantify() to compute CBF directly from delta-M and M0. Multi-PLD models that require iterative fitting leave quantify() as None and use the BoundASLModel + fitter pathway instead.

References

.. [1] OSIPI ASL Lexicon, https://osipi.github.io/ASL-Lexicon/ .. [2] Suzuki Y et al. MRM 2024;91(5):1743-1760. doi:10.1002/mrm.29815

labeling_type abstractmethod property

labeling_type

Return labeling type (e.g., 'pcasl', 'pasl', 'casl').

quantify

quantify(delta_m, m0, params)

Analytical quantification shortcut.

Override for models with closed-form CBF equations (single-PLD). Returns None if this model requires iterative fitting.

PARAMETER	DESCRIPTION
delta_m	Control-label difference signal. TYPE: NDArray
m0	M0 calibration values. TYPE: NDArray
params	Quantification parameters. TYPE: Any

RETURNS	DESCRIPTION
NDArray | None	CBF values in mL/100g/min, or None if iterative fitting required.