Config¶
-
class
moba_muscod.muscod_config.
Config
¶ Object oriented representation of MUSCOD’s configuration (.dat) file.
-
acc
¶ Termination accuracy. Maximum acceptable KKT tolerance.
-
ftol
¶ Final integration tolerance. Should be lower than termination accuracy.
-
itmax
¶ Maximum number of SQP iterations.
-
itol
¶ Initial integration tolerance.
-
levmar
¶ Levenberg-Maquardt regularization factor for the Hessian.
-
libcond
¶ Condensing algorithm for the condensing of the block sparse QP.
Possible choices are:
- ‘cond_std’: Standard condensing algorithm. Condenses state and control discretization (default).
- ‘cond_min’: Minimal condensing algorithm. Only condenses control discretization. Usefull for sparse QP solvers.
-
libhessian
¶ Hessian approximation method.
Possible choices are:
- ‘hess_update’: BFGS update (default)
- ‘hess_finitediff’: exact computation with finite differences
- ‘hess_const’: constant Hessian
- ‘hess_gaussnewton’: Gauss Newton Approximation (only for LSQ)
- ‘hess_gaussnewton_up’
- ‘hess_limitedmemoryupdate’: limited memory BFGS update
-
libmodel
¶ Name of compiled model (.dll)
-
libmssqp
¶ Multiple shooting SQP algorithm.
-
libqps
¶ QP (Quadratic Programming) solver module.
-
libsolve
¶ Globalization strategy for the SQP algorithm.
Possible choices are:
- ‘solve_slse’: Standard line search (default)
- ‘solve_fullstep’: Disable globalization and always perform the full SQP step
- ‘solve_tbox’: Boxstep trust region technique.
- ‘solve_alf’: Schittkowski augmented line search
- ‘solve_vmcwd’: Line search with a watchdog technique.
- ‘solve_wdog’: Watchdog technique using Powell’s penalty function.
-
libtchk
¶ Termination check module for the SQP algorithm.
-
nhtopy
¶ Allows to employ a homotopy strategy.
Beginning with a lower initial integration tolerance (and thus faster SQP iterations) set via options_itol, the current integration tolerance ctol is tightened until – after nhtopy steps – ftol (set via options_ftol) is attained. The steps in ctol interpolate logarithmically between itol and ftol. A homotopy step is performed during the SQP iterations whenever the current accuracy cacc is attained. It is determined as cacc= ctol * acc / ftol.
-
np
¶ Number of global parameters.
-
of_scale
¶ Objective scale.
-
plbound
¶ Lower bounds of global parameters.
-
plevel_screen
¶ Print level for printout to the screen or console.
-
pname
¶ Names of global parameters.
-
pscale
¶ Scale values of global parameters.
-
pstart
¶ Start values of global parameters.
-
pubound
¶ Upper bounds of global parameters.
-
qp_featol
¶ Feasibility tolerance of the QP solver.
-
qp_itmax
¶ Maximum number of iteration of the QP solver per SQP iteration.
-
qp_relax
¶ Constraint relaxation factor for infeasible QPs.
When an infeasible QP is detected, all infeasible constraints are shifted by qp_relax times the amount of infeasibility, to make the next QP guaranteedly feasible. Useful values are greater than 1.0.
-
rfac
¶ Regularization factor.
To make some non unique problems solvable. If the original problem has a flat minimum this option may be useful, as it adds a tiny quadratic term of all problem variables to the objective function to define the minimum uniquely.
-
s_spec
¶ Specification mode for state variable start values.
-