Options mirroring the fields MATLAB reads off the options struct. More...

#include <line/api/da/da_fpi.h>

Public Attributes
std::size_t	iter_max = 10000
double	iter_tol = 1e-8
double	damping = 1.0
	omega; 1 means no damping
std::size_t	miniter = 1
	iterations before the stopping test applies
bool	nanstop = false
	stop when the increment norm is not finite
bool	relative_norm = false
	config.da_norm, the increment norm.
double	relative_eps = 0.0

Detailed Description

Options mirroring the fields MATLAB reads off the options struct.

Definition at line 50 of file da_fpi.h.

Member Data Documentation

◆ damping

double line::da::FpiOptions::damping = 1.0

omega; 1 means no damping

Definition at line 53 of file da_fpi.h.

◆ iter_max

std::size_t line::da::FpiOptions::iter_max = 10000

Definition at line 51 of file da_fpi.h.

Referenced by line::da::da_cacheqn(), line::da::da_cacheqn_retrieval(), line::mam::solver_mam_basic_mmap_inner(), line::mam::solver_mam_decmmap(), line::mam::solver_mna_closed(), line::mam::solver_mna_open(), and line::mva::solver_qna().

◆ iter_tol

double line::da::FpiOptions::iter_tol = 1e-8

Definition at line 52 of file da_fpi.h.

Referenced by line::da::da_cacheqn(), line::da::da_cacheqn_retrieval(), line::mam::solver_mam_basic_mmap_inner(), line::mam::solver_mam_decmmap(), line::mam::solver_mna_closed(), line::mam::solver_mna_open(), and line::mva::solver_qna().

◆ miniter

std::size_t line::da::FpiOptions::miniter = 1

iterations before the stopping test applies

Definition at line 54 of file da_fpi.h.

Referenced by line::mam::solver_mam_basic_mmap_inner(), and line::mam::solver_mam_decmmap().

◆ nanstop

bool line::da::FpiOptions::nanstop = false

stop when the increment norm is not finite

Definition at line 55 of file da_fpi.h.

Referenced by line::mam::solver_mna_closed(), line::mam::solver_mna_open(), line::nc::solver_nc_lossn_analyzer(), and line::mva::solver_qna().

◆ relative_eps

double line::da::FpiOptions::relative_eps = 0.0

Definition at line 72 of file da_fpi.h.

Referenced by line::mam::solver_mam_basic_mmap_inner().

◆ relative_norm

bool line::da::FpiOptions::relative_norm = false

config.da_norm, the increment norm.

MATLAB passes a function handle; the two handles the reference actually installs are both RELATIVE – max(|xn-xr|./xr) in solver_mam.m and max(|xn-xr|./(xr+FineTol)) in solver_mam_basic_mmap_inner.m – so they are expressed here as a flag and the denominator's offset rather than as a std::function, which would have to be templated on T and would change the type of every existing caller's options object.

FALSE keeps the default absolute max-norm. TRUE with relative_eps = 0 reproduces the first handle, including its division by a zero reference (the reference divides by xr unguarded, and an all-zero start therefore yields NaN on the first sweep; miniter is what keeps that from stopping the loop, exactly as in MATLAB).

Definition at line 71 of file da_fpi.h.