API Reference / searchConfigurations · function
Function: searchConfigurations()
function searchConfigurations(
engine,
target,
opts): RankedMoment[];
Rank the instants in [start, end] by how closely the sky resembles a
target feature vector, best first — a realization search over the feature
space. Build target with chartFeatures (e.g. from a natal chart).
Parameters
| Parameter | Type | Description |
|---|---|---|
engine | Engine | The engine used to evaluate positions. |
target | number[] | A target feature vector from chartFeatures. |
opts | SearchConfigOptions | start/end (Julian Days, UT) and step (days) define the scan, limit caps the results, plus the FeatureOptions (bodies, weights, zodiac) — which must match those used to build target. |
Returns
Ranked { jd, score } moments, highest similarity first.
Example
const natal = chartFeatures(engine, julianDay(1990, 6, 10, 14, 30));
const matches = searchConfigurations(engine, natal, {
start: julianDay(2025, 1, 1), end: julianDay(2026, 1, 1), step: 1, limit: 5,
});
matches[0].jd; // best-matching instant