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
| Parameter | Type | Description |
|---|---|---|
engine | Engine | The engine to compute the position with. |
body | BodyId | Body id. |
jdUt | number | Julian Day (UT). |
opts | { zodiac?: Zodiac; } | zodiac, as for Engine.position. |
opts.zodiac? | Zodiac | - |
Returns
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"));