LogLossStat
Streaming binary log loss (cross-entropy): paired (probability, outcome) aggregated as the mean of -[y*ln(p) + (1-y)*ln(1-p)].
Predictions are clamped into [1e-15, 1 - 1e-15] before taking logs to avoid ±inf on perfectly confident wrong predictions.
Use cases: classifier evaluation; strictly proper scoring rule that heavily penalises confident-and-wrong predictions. Pair with MseLossStat for the binary Brier score counterpart.
Memory: O(1); backed by a MeanStat.
Update: O(1) per paired observation.
Concurrency: Inherits MeanStat's concurrency model.
Constructors
LogLossStat
Properties
concurrency
Thread-safety mode fixed at construction. See Concurrency for the shared contract and the implementation's KDoc for its cell and lock strategy.
Functions
create
Create an independent accumulator at the configured baseline. A null concurrency preserves this accumulator's mode; a non-null value overrides it. Modality subtypes narrow the return type to preserve the input shape.
merge
Fold a compatible snapshot values into this accumulator at timestampNanos. Implementations document whether the combine is exact or approximate and which state the snapshot omits. The source accumulator is unaffected.
Time-dependent statistics, such as windows, place the snapshot at timestampNanos, which must share the clock the caller uses for updates and reads. Time-independent statistics ignore it.
read
Return the current result evaluated at timestampNanos. Time-independent statistics ignore the timestamp. Reading does not add an observation.
Snapshot consistency depends on the implementation's synchronisation. Locks protect coupled state under Concurrency.Strict and Concurrency.HighWrite; independently updated cells and JVM striped adders can still yield a best-effort snapshot. Concurrency.Relaxed permits drift across coupled cells.
reset
Restore the configured baseline, including any prior seed. Preserves the configuration and concurrency.