KSLCore/ksl.app.optimization.results/IterationHistoryCsvWriter

IterationHistoryCsvWriter

object IterationHistoryCsvWriter(source)

Wide-format CSV of the full iteration history.

Column order:

Fixed metric columns: iteration, oracle_calls, replications, est_obj, pen_obj
One column per decision variable, in OptimizationProblemSpec.inputs declaration order
One column per solverSpecificState key, alphabetical (union of keys seen across all snapshots; missing values render as blank cells)

Suitable for loading directly into pandas, R, or Excel. The format does not change across runs of the same problem so cross-run scripts can rely on a stable header shape.

Substrate-level API — usable by any UI shell.

Functions

encode

fun encode(history: List<SolverStateSnapshot>, problem: OptimizationProblemSpec): String

Build the CSV content as a String — pure function so callers can inspect rows without filesystem access.

write

fun write(history: List<SolverStateSnapshot>, problem: OptimizationProblemSpec, path: Path): Boolean

Encode and write to path. Best-effort — returns true on success, false if the write threw.