EvolutionRunSummary

Models & Types · AiDotNet.Models.Results

A redacted, serializable account of one finished evolution run.

For Beginners

This is the report card for a search. Read StopReason first — it says whether the run finished because it ran out of budget, ran out of time, reached the quality you asked for, or stopped improving. Then BestQuality for the score of the winner, Elites for the good and genuinely different candidates it collected, and RetainedFailures when the answer is disappointing and you want to know what went wrong.

How It Works

The engine’s own EvolutionRunResult<TGenome> holds live archive snapshots and is generic over the genome type, so it can be neither serialized nor exposed on a non-generic facade. This is its flat projection: why the run stopped, how much work it did, how each island fared, which cells the best candidates occupy, what failed, what the language model cost, and where the run’s files were written. It carries identifiers and coordinates rather than genomes, so it is safe to log or to save inside a model file. The typed result stays reachable through AiModelResult.GetEvolutionRunResult<TGenome>() for callers that want the genomes themselves.

StateHash and CompatibilityHash are the two identity values worth keeping. Two runs with the same seed, options, and components produce the same state hash, which makes it the cheapest possible determinism check. The compatibility hash instead describes the configuration: a checkpoint can only be resumed by a run whose compatibility hash matches, so recording it tells you later whether a saved run can be continued.

Constructors

Constructor Summary
EvolutionRunSummary()

Properties

Property Summary
DateTimeOffset FinishedUtc { get; set; } Gets or sets when the run finished, in UTC.
DateTimeOffset StartedUtc { get; set; } Gets or sets when the run started, in UTC.
EvolutionOptimizationDirection Direction { get; set; } Gets or sets whether higher or lower quality values were better.
EvolutionStopReason StopReason { get; set; } Gets or sets why the run stopped.
IDictionary<string, long> StatusCounts { get; set; } Gets or sets how many evaluations ended in each status, keyed by the status name.
IList<EvolutionEliteSummary> Elites { get; set; } Gets or sets the retained elites, best first and bounded by the configured count.
IList<EvolutionFailureSummary> RetainedFailures { get; set; } Gets or sets the retained failure diagnostics, oldest first.
IList<EvolutionIslandSummary> Islands { get; set; } Gets or sets one summary per island, in island order.
ProgramEvolutionLlmUsage LlmUsage { get; set; } Gets or sets the language-model totals, or null when no model was used.
bool HasBest { get; } Gets whether the run archived at least one candidate.
double? BestQuality { get; set; } Gets or sets the best quality found across every island, or null when nothing was scored.
int ArchiveCount { get; set; } Gets or sets how many archive cells were filled across every island.
int IslandCount { get; set; } Gets or sets how many islands the run used.
long AbandonedEvaluations { get; set; } Gets or sets how many evaluator calls were abandoned after outrunning their grace period.
long CompletedEvaluations { get; set; } Gets or sets how many evaluations completed and were committed.
long EvaluationAttempts { get; set; } Gets or sets how many evaluator attempts were made, retries included.
long Proposals { get; set; } Gets or sets how many candidates were proposed, duplicates and rejections included.
long TraceRecordCount { get; set; } Gets or sets how many records were written to the trace.
string BestGenomeId { get; set; } Gets or sets the identifier of the best candidate, or null when nothing was archived.
string CheckpointPath { get; set; } Gets or sets the checkpoint file path, or null when checkpointing was off.
string CompatibilityHash { get; set; } Gets or sets the configuration hash a checkpoint must match to be resumable by this run.
string OutputDirectory { get; set; } Gets or sets the directory the run’s files were written under, or null when nothing was written.
string RunId { get; set; } Gets or sets the run identifier the checkpoint and trace files were named after.
string StateHash { get; set; } Gets or sets the deterministic state hash; equal hashes mean two runs did exactly the same work.
string TracePath { get; set; } Gets or sets the trace file path, or null when tracing was off.

Methods

Method Summary
EvolutionEliteSummary BestBy(string metric, EvolutionOptimizationDirection? direction) Returns the retained elite that scored best on a named metric.
IReadOnlyList<EvolutionEliteSummary> TopBy(string metric, int count, EvolutionOptimizationDirection? direction) Returns the retained elites that scored best on a named metric, best first.
IReadOnlyList<string> MetricNames() Returns every metric name any retained elite reported, ordered for stable display.
string ToString() Returns a short description that never echoes candidate content.

Fields

Field Summary
int DefaultEliteCount The default number of elites a summary retains, best first.