KSLCore/ksl.app.session/RunResult/BatchCompleted

BatchCompleted

data class BatchCompleted(val summary: OrchestratorSummary, val snapshots: List<SimulationSnapshot.ExperimentCompleted>, val replicationsByItem: Map<String, List<SimulationSnapshot.ReplicationCompleted>> = emptyMap()) : RunResult(source)

A scenario sweep or designed experiment finished. Every successfully completed scenario or design point contributes one SimulationSnapshot.ExperimentCompleted to snapshots; the list is non-empty on a clean run.

Constructors

BatchCompleted

constructor(summary: OrchestratorSummary, snapshots: List<SimulationSnapshot.ExperimentCompleted>, replicationsByItem: Map<String, List<SimulationSnapshot.ReplicationCompleted>> = emptyMap())

Properties

replicationsByItem

val replicationsByItem: Map<String, List<SimulationSnapshot.ReplicationCompleted>>

Per-item replication-level snapshots in completion order, keyed by the item name — specifically SimulationSnapshot.ExperimentCompleted.experiment.exp_name on the corresponding entry in snapshots. Each value is the list of SimulationSnapshot.ReplicationCompleted snapshots collected during that item's run, in replication order.

snapshots

val snapshots: List<SimulationSnapshot.ExperimentCompleted>

one snapshot per successfully completed scenario or design point, in commit order. Non-empty when OrchestratorSummary.failedItems is zero.

summary

val summary: OrchestratorSummary

orchestrator-level metadata (total items, completed, failed)

Functions

withoutScenario

fun RunResult.BatchCompleted.withoutScenario(scenarioName: String): RunResult.BatchCompleted?

Return a copy of this with the snapshot for scenarioName removed, alongside the matching entry in RunResult.BatchCompleted.replicationsByItem. Returns null when the filter empties RunResult.BatchCompleted.snapshots — callers treat that as "the result is now empty; drop it".