KSLCore/ksl.app.config.optimization/OptimizationOutputConfig

OptimizationOutputConfig

@Serializable

data class OptimizationOutputConfig(val analysisName: String = "Untitled", val outputDirectory: String? = null)(source)

Document-wide output settings for a simulation-optimization run.

Optimization counterpart to ksl.app.config.OutputConfig. Carries only the fields the optimization runtime actually consumes — analysisName (the per-run subdirectory identity) and outputDirectory (the host-resolved absolute path used at submit time).

The Single / Scenario apps' OutputConfig additionally persists database, CSV, and report toggles; none of those apply to optimization runs in v1, so they are intentionally absent from this spec. When the optimization orchestrator gains those sinks, fields grow here rather than overloading the shared OutputConfig.

Lives at document scope on OptimizationRunConfiguration.output so every run produced by a single document shares one output-directory layout under the active workspace.

Constructors

OptimizationOutputConfig

constructor(analysisName: String = "Untitled", outputDirectory: String? = null)

Properties

analysisName

val analysisName: String

user-facing label for this analysis; names the subdirectory under <workspace>/output/<analysisName>/ where every artifact lands. Sanitised at write time via the shared ksl.app.config.sanitizeAnalysisName helper; the stored value is the user-typed form so the UI shows what they typed. Defaults to "Untitled".

outputDirectory

val outputDirectory: String?

absolute filesystem path the runtime uses for the model's outputDirectory. Set at submit time by the hosting app from the workspace plus analysisName; do not edit by hand. null means the framework default (kslOutput under the JVM working directory).