IMapElitesAutoMLModel<T, TInput, TOutput>

Interfaces · AiDotNet.Interfaces

Adds immutable quality-diversity archive inspection to the standard AutoML contract.

Implements: IAutoMLModel<T, TInput, TOutput>

Known implementations: MapElitesAutoML<T, TInput, TOutput>

For Beginners

Normal AutoML hands you a single winner. MAP-Elites AutoML also hands you a map of “best in class” runners-up, for example the best small linear model, the best mid-sized tree ensemble, and the best large neural network, each with its validation score. Use this interface when you want more than one answer: perhaps the overall winner is too slow for production and the best entry from a simpler family is a better fit. Select the strategy with AutoMLOptions.SearchStrategy = AutoMLSearchStrategy.MapElites when calling ConfigureAutoML on the model builder, then read Archive once the search completes.

How It Works

A standard IAutoMLModel returns one best model. A MAP-Elites search also produces an archive: the best validated specification for every combination of model family and configuration-complexity bin that the search visited. This interface exposes that archive as immutable MapElitesAutoMLArchiveEntry values, which hold specifications and scores rather than live trained models, together with a deterministic state hash, so callers can compare two runs, log the diversity that was found, or choose an alternative model family after the fact.

ArchiveStateHash excludes wall-clock timing and therefore matches across two runs with the same seed, data, candidate models, and search space; it is the cheapest way to assert reproducibility in tests. Both members describe the most recent completed search; the built-in MapElitesAutoML returns an empty archive and an empty hash before its first search runs.

Properties

Property Summary
IReadOnlyList<MapElitesAutoMLArchiveEntry> Archive { get; } Gets the immutable elite specifications from the most recent completed search.
string ArchiveStateHash { get; } Gets a deterministic hash of the most recent engine state, excluding wall-clock timing.