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. |