mrpro.operators.models.WASABI

class mrpro.operators.models.WASABI[source]

Bases: SignalModel[Tensor, Tensor, Tensor, Tensor]

WASABI signal model.

__init__(offsets: Tensor, rf_duration: float | Tensor = 0.005, b1_nominal: float | Tensor = 3.70e-6, gamma: float = GYROMAGNETIC_RATIO_PROTON) → None[source]

Initialize WASABI signal model for mapping of B0 and B1 [SCHU2016].

Parameters:

  • offsets (Tensor) – frequency offsets [Hz] with shape (offsets, ...)

  • rf_duration (float | Tensor, default: 0.005) – RF pulse duration [s]

  • b1_nominal (float | Tensor, default: 3.70e-6) – nominal B1 amplitude [T]

  • gamma (float, default: GYROMAGNETIC_RATIO_PROTON) – gyromagnetic ratio [Hz/T]

References

[SCHU2016]

Schuenke P, Zaiss M (2016) Simultaneous mapping of water shift and B1(WASABI)—Application to field-Inhomogeneity correction of CEST MRI data. MRM 77(2). https://doi.org/10.1002/mrm.26133

__call__(*args: Unpack) → Tout[source]

Apply the forward operator.

For more information, see forward.

Note

Prefer using operator_instance(*parameters), i.e. using __call__ over using forward.

forward(b0_shift: Tensor, relative_b1: Tensor, c: Tensor, d: Tensor) → tuple[Tensor][source]

Apply WASABI signal model.

Parameters:

  • b0_shift (Tensor) – B0 shift [Hz] with shape (*other, coils, z, y, x)

  • relative_b1 (Tensor) – relative B1 amplitude with shape (*other, coils, z, y, x)

  • c (Tensor) – additional fit parameter for the signal model with shape (*other, coils, z, y, x)

  • d (Tensor) – additional fit parameter for the signal model with shape (*other, coils, z, y, x)

Returns:

signal with shape (offsets, *other, coils, z, y, x)

__add__(other: Operator[Unpack, Tout]) → Operator[Unpack, Tout][source]
__add__(other: Tensor) → Operator[Unpack, tuple[Unpack]]

Operator addition.

Returns lambda x: self(x) + other(x) if other is a operator, lambda x: self(x) + other*x if other is a tensor

__matmul__(other: Operator[Unpack, tuple[Unpack]]) → Operator[Unpack, Tout][source]

Operator composition.

Returns lambda x: self(other(x))

__mul__(other: Tensor | complex) → Operator[Unpack, Tout][source]

Operator multiplication with tensor.

Returns lambda x: self(x*other)

__radd__(other: Tensor) → Operator[Unpack, tuple[Unpack]][source]

Operator right addition.

Returns lambda x: other*x + self(x)

__rmul__(other: Tensor | complex) → Operator[Unpack, Tout][source]

Operator multiplication with tensor.

Returns lambda x: other*self(x)