tools.ncalib

tools.ncalib#

bartorch.tools.ncalib()#

Estimate coil sensitivities using ENLIVE calibration.

Runs bart ncalib.

Parameters:
  • kspace (torch.Tensor) – Input array.

  • g (bool, default=False) – use gpu (-g)

  • t (torch.Tensor | None, default=None) – kspace trajectory (-t)

  • p (torch.Tensor | None, default=None) – kspace pattern (-p)

  • B (torch.Tensor | None, default=None) – subspace basis (-B)

  • r (tuple[int, int, int] | None, default=None) – Limits the size of the calibration region. (-r)

  • i (int | None, default=None) – Number of Newton steps (-i)

  • cgiter (int | None, default=None) – (iterations for linearized problem) (--cgiter)

  • cgtol (float | None, default=None) – (tolerance for linearized problem) (--cgtol)

  • alpha (float | None, default=None) – (alpha in first iteration) (--alpha)

  • M (float | None, default=None) – (minimum for regularization) (-M)

  • a (float | None, default=None) – (a in 1 + a * Laplace^-b/2) (-a)

  • b (float | None, default=None) – (b in 1 + a * Laplace^-b/2) (-b)

  • c (float | None, default=None) – (c in 1 + a * Laplace^-b/2) (-c)

  • w (float | None, default=None) – (inverse scaling of the data) (-w)

  • o (bool, default=False) – return oversampled coils (-o)

  • sms (bool, default=False) – sms reconstruction (FFT in slice dimension) (--sms)

  • sos (bool, default=False) – sos reconstruction (ucFFT and Sobolev regularization in slice dimension) (--sos)

  • N (bool, default=False) – Normalize coil sensitivities (-N)

  • m (int | None, default=None) – Number of ENLIVE maps to use in reconstruction (-m)

  • dims (tuple[int, int, int] | None, default=None) – Explicitly specify sens dimensions (-x)

  • sens_os (float | None, default=None) – (over-sampling factor for sensitivities) (--sens-os)

  • shared_img_dims (int | tuple[int, ...] | None, default=None) – Axes the image is shared along. (--shared-img-dims)

  • shared_col_dims (int | tuple[int, ...] | None, default=None) – Axes the coil sensitivities are shared along. (--shared-col-dims)

  • scale_loop_dims (int | tuple[int, ...] | None, default=None) – Scale the parameters as if ncalib were looped over these axes. (--scale-loop-dims)

  • phase_pole (int | None, default=None) – Use phase pole detection after d iterations (0 for every iteration) (--phase-pole)

  • nufft_conf (str | None, default=None) – configure nufft (--nufft-conf)

  • **extra (Any) – Further BART flags, passed through by name.

Returns:

sensitivities

Return type:

torch.Tensor

Examples using ncalib#

Coil sensitivity calibration

Coil sensitivity calibration

Radial SENSE reconstruction

Radial SENSE reconstruction