Skip to main content

Module core

celestial_core::location

Module core 

Source
Expand description

Observer location on Earth using WGS84 geodetic coordinates.

This module provides the Location type for representing geographic positions. Coordinates are geodetic (latitude/longitude relative to the WGS84 ellipsoid), not geocentric (relative to Earth’s center of mass).

The distinction matters for precision astronomy: geodetic latitude differs from geocentric latitude by up to ~11 arcminutes at mid-latitudes due to Earth’s equatorial bulge.

§Coordinate conventions

  • Latitude: North positive, stored in radians, range [-pi/2, pi/2]
  • Longitude: East positive, stored in radians, range [-pi, pi]
  • Height: Meters above the WGS84 ellipsoid (not sea level)

§Example

use celestial_core::Location;

// Mauna Kea summit
let obs = Location::from_degrees(19.8207, -155.4681, 4205.0)?;

// Access coordinates
assert!((obs.latitude_degrees() - 19.8207).abs() < 1e-10);

Structs§

Location
A geographic location on Earth in WGS84 geodetic coordinates.