ImplicitUpdate#

Source: models/common/ImplicitUpdate.py

Update an implicit model by solving the underlying nonlinear system of equations.

Other options#

equation_system — str · required: The nonlinear system of equations to solve
solver — str · required: Solver used to solve the nonlinear system of equations
input_sensitivity_solver — str: Linear solver for the input-sensitivity (implicit-function-theorem) solve du/dg = -A^{-1} B when differentiating outputs w.r.t. inputs. Defaults to the Newton’s linear_solver; set a direct solver (e.g. DenseLU) here to keep input derivatives exact under an iterative forward solve.
param_sensitivity_solver — str: Linear solver for the parameter-sensitivity solve du/dtheta = -A^{-1} dr/dtheta when differentiating outputs w.r.t. (promoted) parameters. Defaults to the Newton’s linear_solver; set a direct solver (e.g. DenseLU) here for exact parameter derivatives under an iterative forward solve.
predictor — str: An optional predictor to provide an initial guess for the nonlinear solve.
max_substepping_level — int · default 0: Adaptive sub-incrementation depth cap, applied by the COMPILED AOTI routes only (neml2-compile). 0 (default) disables substepping. Level L lets the compiled solve recursively bisect a failing increment down to depth L (up to 2^L sub-steps), per-element, interpolating paired forces and chaining state; a sub-step still failing at depth L raises a recoverable ConvergenceError so an outer time-stepper can cut the step. The eager runtime does NOT sub-increment: evaluating an ImplicitUpdate eagerly with this set > 0 raises (substepping is an AOTI-only feature).
incremental_variables — list: Names of driving-force inputs the substep driver ramps across each sub-step – interpolating the force from its previous-step value to its current value rather than applying the full increment at once. List a total-form force here (e.g. the deformation gradient) to sub-increment it; its previous-step value is supplied automatically. A force that already has a ~1 counterpart is ramped without being listed. Applied by the compiled AOTI routes only; not used by the eager runtime.