Caelus3,462 checksGitHubv0.25.0MIT
API Reference / positionUncertainty · function

Function: positionUncertainty()

function positionUncertainty(
   engine, 
   body, 
   jdUt, 
   opts?): PositionUncertainty;

How well a body's longitude is known at a UT instant: the accuracy table's bound on the model, and the one-sigma effect of the ΔT uncertainty. The two are different kinds of number and are not combined.

The position is computed whether or not a bound applies. Outside the span a bound was measured over, modelBoundArcsec is null and no bound is claimed.

Parameters

ParameterTypeDescription
engineEngineThe engine to compute the position with.
bodyBodyIdBody id.
jdUtnumberJulian Day (UT).
opts{ zodiac?: Zodiac; }zodiac, as for Engine.position.
opts.zodiac?Zodiac-

Returns

PositionUncertainty

The bound, its span, the ΔT sigma, and the clock term.

Example

// The Moon in the year 100: no published bound that early, and the clock
// error of about 155 s moves it by more than a minute of arc.
positionUncertainty(engine, "moon", julianDay(100, 3, 1, 12, 0, 0, "julian"));

Start building

Quickstart →