KSLDatabaseComparisonSource

Database-backed adapter exposing the experiments stored in a KSLDatabase as a ComparisonDataSourceIfc — the third member of the comparison-source family alongside InMemoryComparisonSource (test fixture / programmatic use) and BatchCompletedComparisonSource (live scenario-sweep result).

Each experiment found in tblExperiment becomes one ExperimentRow. The experiment's response set is the union of every response stat present in tblWithinRepStat and every counter stat present in tblWithinRepCounterStat for that experiment, in first-encountered order. Response-vs-time-weighted discrimination uses the class_name field on the joined tblModelElement row; this is information the batch and in-memory adapters cannot supply but the database always carries.

observations returns per-replication values in rep-id order, drawn from KSLDatabase.replicationDataArraysByExperimentAndResponse: for response statistics the average field, for counters the last_value field. Missing-rep NaN entries (filled in by the underlying cross-experiment view) are dropped before the array is returned, so consumers see a clean, length-matched observation vector.

The adapter takes an eager snapshot of the database in its constructor — the per-experiment row metadata and the cross-experiment observation map are both materialised once and reused thereafter. The database is treated as frozen for the lifetime of the adapter, matching the behaviour of the in-memory and batch sources. Construct a new adapter if the underlying DB has been written to and you need to see the new state.