Caelus3,462 checksGitHubv0.25.0MIT
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

ParameterTypeDescription
engineEngineEphemeris engine instance.
placeObservationPlaceObserver location and terrain metadata.
observedObservedConstraintsPhysical observation constraints (at least one required).
jdStartnumberSearch range start, Julian Day (UT).
jdEndnumberSearch range end, Julian Day (UT), strictly greater than jdStart.
optsChronolocateOptionsOptional scan step (stepMinutes, default 10) and window cap (maxWindows, default 64).

Returns

ChronolocateResult

ChronolocateResult with matching windows and pruning counts.

Start building

Quickstart →