Reference · Facts, line drawings and positions
Apparenttype
What the sky shows of a body at a time: its pose, the latitude the viewer sees it from (how open its rings are), the longitude at the middle of the disc, the phase and the size.
Import it
import type { Apparent } from "@johnmorrisdotca/wakusei-planets";
Definition
interface Apparent extends Pose {
id: BodyId;
time: number;
subObserverLat: number;
centralMeridian: number;
phaseAngle: number;
illumination: number;
distanceKm: number;
diameterDeg: number;
frame: {
right: Vec3;
up: Vec3;
toward: Vec3;
};
}
Members
| Name | Type | Description |
|---|---|---|
id | BodyId | How the body is turned. |
time | number | The instant, in milliseconds since 1970. |
subObserverLat | number | Degrees above (positive) or below the body's equator that the viewer sees it from: how open its rings are. |
centralMeridian | number | The longitude at the middle of the disc, degrees east, 0 to 360. |
phaseAngle | number | The Sun–body–viewer angle in degrees: 0 is full, 180 is new. |
illumination | number | The fraction of the disc that is lit, 0 to 1. |
distanceKm | number | The distance from the viewer in kilometres. |
diameterDeg | number | The angular diameter in degrees. |
frame | { right: Vec3; up: Vec3; toward: Vec3; } | The viewer's frame in J2000 ecliptic vectors, to turn more vectors into the same view. |
pole | Vec3 | The north pole. |
meridian | Vec3 | The direction of longitude 0 on the equator. |
light | Vec3 | The direction of the Sun, from the body. |
Examples
import { apparent, type Apparent } from "@johnmorrisdotca/wakusei-planets";
const moon: Apparent = apparent("moon", Date.UTC(2026, 10, 24, 14));
console.log(moon.illumination.toFixed(2));1.00What it prints (run when this page was built)