Reference
The bodies nearest to a body on a date, in the sky or in space, and when two bodies come closest: nearest, within, closestApproach and conjunctions
import { … } from "@johnmorrisdotca/wakusei-planets/nearest";Exports
| Name | Kind | What it is |
|---|---|---|
Approach | type | The closest two bodies come in a span: the moment of the minimum and the separation then. |
ApproachOptions | type | Where a search looks, and what counts as close. |
closestApproach | function | When two bodies come closest in a span, and how close: the span is scanned in coarse steps (the fastest body goes round forty times in the step, at most two days), then the smallest minimum is narrowed to about a second of time by golden-section search. |
ConjunctionOptions | type | The options of conjunctions. |
conjunctions | function | The close approaches of every pair of bodies in a span, soonest first: each pair's separation is scanned in coarse steps (the fastest body goes round forty times in the step, at most two days), and every minimum inside the span that is within within is narrowed to about a second of time. |
distance | function | The distance between two bodies on a date: the straight line between their centres at that instant, in kilometres and astronomical units, with no light time. |
Distance | type | The distance between two bodies at one instant: their centres, in the Sun's frame, with no light time. |
DistanceAt | type | The least or the greatest distance of a pair over a span, and when. |
distanceRange | function | The least and the greatest distance between two bodies over a span, each with its moment: the span is scanned in coarse steps (as closestApproach does) and each turning point is narrowed to about a second of time by golden-section search, the greatest on the negated distance. |
DistanceRange | type | Where a pair is nearest and farthest over a span. |
nearest | function | The bodies nearest to a body on a date, nearest first: by the angle between them in the sky of an observer, or by the distance between them in space. |
NearestKind | type | What kind of body: the Sun is "star". |
NearestOptions | type | The options of nearest, within, closestApproach and conjunctions that mean the same in each. |
SkyNeighbour | type | A body near the target in the sky: its angle from the target in degrees (0 to 180) and how far that angle may be off, in arc-seconds. |
SpaceNeighbour | type | A body near the target in space: the distance between their centres, and how far that may be off. |
Viewpoint | type | Where the sky is seen from: a body's centre ("mars" for the sky of Mars), or a place on the Earth, whose parallax counts (the Moon is up to a degree different from there than from the Earth's centre). |
within | function | Every body inside a radius of a body on a date, nearest first: nearest with no limit on how many. |