API Reference / chronolocate · function
Function: chronolocate()
function chronolocate(
engine,
place,
observed,
jdStart,
jdEnd,
opts?): ChronolocateResult;
Find every time window in [jdStart, jdEnd] at place where all physical
observations in observed hold simultaneously.
Prunes impossible days analytically from solar/lunar declinations and lunar phase, scans surviving spans with per-day equatorial unit-vector interpolation and narrow-peak rescue, bisects window edges to sub-second accuracy, and refines each peak with golden-section search.
Parameters
| Parameter | Type | Description |
|---|---|---|
engine | Engine | Ephemeris engine instance. |
place | ObservationPlace | Observer location and terrain metadata. |
observed | ObservedConstraints | Physical observation constraints (at least one required). |
jdStart | number | Search range start, Julian Day (UT). |
jdEnd | number | Search range end, Julian Day (UT), strictly greater than jdStart. |
opts | ChronolocateOptions | Optional scan step (stepMinutes, default 10) and window cap (maxWindows, default 64). |
Returns
ChronolocateResult with matching windows and pruning counts.