simulationRun

fun ReportBuilder.simulationRun(run: SimulationRun, confidenceLevel: Double = 0.95, showTimings: Boolean = false, caption: String? = null)(source)

Appends a self-contained section reporting the full contents of run.

Produces (inside a section titled caption or "Simulation Run"):

  1. Run Identity sub-section — DataTable (Parameter | Value): run ID, run name, model identifier, replications executed, execution start time, execution end time, total execution duration; timing fields show "—" when the run has not been executed

  2. Run Error sub-section — paragraph notice and verbatim error text; present only when SimulationRun.runErrorMsg is non-empty

  3. experimentRunParameters sub-section — all 15 configuration fields

  4. Inputs sub-section — DataTable (Input Name | Value) of all control and random-variable parameter inputs sorted alphabetically; a paragraph is shown instead when no inputs are present

  5. Model Configuration sub-section — DataTable (Key | Value) of model configuration entries; omitted when SimulationRun.modelConfiguration is null or empty

  6. Replication Timing sub-section — min, mean, max, and total replication wall-clock time in milliseconds (as recorded by ksl.observers.SimulationTimer), plus an annotation noting that the first replication typically measures higher than subsequent ones due to JVM JIT compilation warm-up and one-time model initialization overhead; present only when showTimings is true and the run has been executed

  7. Response Statistics sub-section — StatTable for all responses collected via SimulationRun.statisticalReporter; omitted when the run has not been executed

Parameters

run

the SimulationRun to report

confidenceLevel

confidence level for the response statistics half-width and CI; defaults to 0.95

showTimings

true includes the Replication Timing sub-section; defaults to false because timing data is diagnostic rather than part of the primary experimental output

caption

optional section title; defaults to "Simulation Run"