Solver State Snapshot
An immutable representation of a solver's state at a specific point in time during the optimization process.
This class is designed to be emitted or recorded at the end of algorithmic iterations (or macro-steps). Because it is strictly an immutable snapshot, it can be safely stored in historical lists or passed across threads without risking the "live reference" mutation problem.
Parameters
The current algorithmic iteration or step at which this snapshot was taken.
The cumulative total number of times the simulation oracle has been invoked by the solver up to this point.
The cumulative total number of individual simulation replications requested across all oracle calls up to this point.
The best Solution discovered by the solver up to this iteration.
The objective function value associated with the bestSolutionSoFar.
The penalized objective function value associated with the bestSolutionSoFar.
The latest solution found. It may not be the best due to algorithm trajectories.
An optional map containing algorithm-specific metrics that do not apply generally to all solvers (e.g., mapOf("temperature" to 50.0) for Simulated Annealing, or "splineCalls" for R-SPLINE). Defaults to null.