Skip to main content

InversionAlgorithm

Enum InversionAlgorithm 

Source
pub enum InversionAlgorithm {
Show 29 variants Tkd, Tsvd, Tikhonov, Tv, Rts, Nltv, Medi, Tfi, Ilsqr, Tgv, Qsmart, Ndi, Fansi, FansiTgv, L1qsm, Whqsm, Hdqsm, AmpPe, Xqsm, Qsmnet, QsmnetPlus, Autoqsm, Qsmgan, Ir2qsm, Lpcnn, ModlQsm, Nextqsm, Iqsm, IqsmPlus,
}
Expand description

Dipole inversion algorithm

Variants§

§

Tkd

§

Tsvd

§

Tikhonov

§

Tv

§

Rts

§

Nltv

§

Medi

§

Tfi

Preconditioned Total Field Inversion (single-step, total field).

§

Ilsqr

§

Tgv

§

Qsmart

§

Ndi

Nonlinear Dipole Inversion (FANSI ndi.m).

§

Fansi

FANSI nonlinear Total Variation (nlTV).

§

FansiTgv

FANSI nonlinear Total Generalized Variation (nlTGV).

§

L1qsm

L1 data-fidelity QSM (FANSI nlL1TV / PI-QSM).

§

Whqsm

Weak-Harmonic QSM (FANSI WH_nlTV).

§

Hdqsm

Hybrid two-stage L1→L2 QSM (HD-QSM).

§

AmpPe

Approximate Message Passing with built-in Parameter Estimation (AMP-PE).

§

Xqsm

xQSM deep-learning dipole inversion (requires the onnx feature and the xqsm model weights; see crate::models).

§

Qsmnet

QSMnet deep-learning dipole inversion (requires the onnx feature and the qsmnet model weights; see crate::models).

§

QsmnetPlus

QSMnet+ deep-learning dipole inversion (susceptibility-scaling augmented; requires the onnx feature and the qsmnet-plus weights).

§

Autoqsm

AutoQSM single-step reconstruction (requires the onnx feature and the autoqsm weights). NOTE: takes the total field — it does its own background removal, so the local_field_ppm argument should be the total field.

§

Qsmgan

QSMGAN deep-learning dipole inversion (local field → χ; onnx + qsmgan weights).

§

Ir2qsm

IR2QSM unrolled deep-learning dipole inversion (local field → χ; onnx + ir2qsm weights).

§

Lpcnn

LPCNN learned-proximal deep-learning dipole inversion (local field → χ; onnx + lpcnn weights).

§

ModlQsm

MoDL-QSM model-based deep-learning dipole inversion (local field → χ33/STI component; onnx + modl-qsm weights).

§

Nextqsm

NeXtQSM single-step reconstruction (requires onnx + the two nextqsm weight files). NOTE: takes the total field — it does its own background removal.

§

Iqsm

iQSM single-step reconstruction from wrapped phase (end-to-end: joint unwrap + background removal + inversion). Not a dipole-inversion-stage option — use super::run_iqsm. Rejected by run_dipole_inversion.

§

IqsmPlus

iQSM+ single-step reconstruction from wrapped phase with orientation-adaptive feature editing (uses the B0 direction). End-to-end; use super::run_iqsm_plus.

Implementations§

Source§

impl InversionAlgorithm

Source

pub fn orientation_support(&self) -> OrientationSupport

How this method behaves when B0 is not along voxel +z.

Every classical inversion builds its dipole kernel from the supplied direction, directly or through the shared ADMM/FANSI spectral setup, so all of them handle oblique data on the acquired grid. The deep-learning methods take no direction at all.

Source§

impl InversionAlgorithm

Source

pub const VARIANTS: &'static [Self]

Source

pub fn dl_model_id(self) -> Option<&'static str>

Model-registry id for deep-learning variants, else None (classical methods).

Trait Implementations§

Source§

impl Clone for InversionAlgorithm

Source§

fn clone(&self) -> InversionAlgorithm

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for InversionAlgorithm

Source§

impl Debug for InversionAlgorithm

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl PartialEq for InversionAlgorithm

Source§

fn eq(&self, other: &InversionAlgorithm) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for InversionAlgorithm

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for InversionAlgorithm

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> CloneAny for T
where T: Any + Clone,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<T> Downcast for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

Converts Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.
§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Converts Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
§

fn as_any(&self) -> &(dyn Any + 'static)

Converts &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Converts &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
§

impl<T> DowncastSend for T
where T: Any + Send,

§

fn into_any_send(self: Box<T>) -> Box<dyn Any + Send>

Converts Box<Trait> (where Trait: DowncastSend) to Box<dyn Any + Send>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.
§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

§

fn into_any_sync(self: Box<T>) -> Box<dyn Any + Send + Sync>

Converts Box<Trait> (where Trait: DowncastSync) to Box<dyn Any + Send + Sync>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.
§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Converts Arc<Trait> (where Trait: DowncastSync) to Arc<Any>, which can then be downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> DynClone for T
where T: Clone,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> Serialize for T
where T: Serialize + ?Sized,

Source§

fn erased_serialize(&self, serializer: &mut dyn Serializer) -> Result<(), Error>

Source§

fn do_erased_serialize( &self, serializer: &mut dyn Serializer, ) -> Result<(), ErrorImpl>

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.