Default solver module

OpenSEFA.DefaultSolverModule — Module

Default solution strategy used when calling solve without specifying a solver.

The strategy runs three sequential stages:

  1. Presolve — simplify the problem via structural reductions (see PresolveModule).
  2. Starting values — solve the reduced unmeasured-only system with a nonlinear least-squares solver to obtain a good initial point for the optimizer.
  3. Optimization — solve the full weighted least-squares problem with a nonlinear programming solver (default: Ipopt via JuMPSolver).

The DefaultSolver struct bundles the starting-values solver, the optimization solver, and a PresolveConfig. The DefaultPipeline and DefaultPipelineAfterPresolve types track intermediate state across the stages.

source
OpenSEFA.DefaultSolverModule.StartingValuesStageResult — Type

Collects the outputs of the starting values stage.

The starting values problem is the presolved problem (PresolveStageResult.presolve_data.pre) with measured variables substituted by their mean values. Only unmeasured variables remain, and they are solved using a nonlinear least squares solver.

source
OpenSEFA.DefaultSolverModule.run_optimizer_stage — Method

Run the optimizer stage.

Calls the nonlinear programming solver, with an optional retry using starting values. Returns the updated variables_value, unobservable_variables, and status.

variables_value_base must contain the presolve replacements so that evaluate_score can be computed against the full initial problem.

source