Struct SolarPosition 

pub struct SolarPosition { /* private fields */ }

Solar position in topocentric coordinates.

Represents the sun’s position as seen from a specific point on Earth’s surface. Uses the standard astronomical coordinate system where:

• Azimuth: 0° = North, measured clockwise to 360°
• Zenith angle: 0° = directly overhead (zenith), 90° = horizon, 180° = nadir
• Elevation angle: 90° = directly overhead, 0° = horizon, -90° = nadir

Implementations

impl SolarPosition

pub fn new(azimuth: f64, zenith_angle: f64) -> Result<Self>

Creates a new solar position from azimuth and zenith angle.

Errors

Returns error if azimuth or zenith angles are outside valid ranges.

Example

let position = SolarPosition::new(180.0, 30.0).unwrap();
assert_eq!(position.azimuth(), 180.0);
assert_eq!(position.zenith_angle(), 30.0);
assert_eq!(position.elevation_angle(), 60.0);

pub const fn azimuth(&self) -> f64

Gets the azimuth angle in degrees (0° to 360°, 0° = North, increasing clockwise).

pub const fn zenith_angle(&self) -> f64

Gets the zenith angle in degrees (0° to 180°, 0° = zenith, 90° = horizon).

pub fn elevation_angle(&self) -> f64

Gets the elevation angle in degrees.

This is the complement of the zenith angle: elevation = 90° - zenith.

pub fn is_sun_up(&self) -> bool

Checks if the sun is above the horizon (elevation angle > 0°).

pub fn is_sun_down(&self) -> bool

Checks if the sun is at or below the horizon (elevation angle ≤ 0°).

Trait Implementations

impl Clone for SolarPosition

fn clone(&self) -> SolarPosition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for SolarPosition

impl Debug for SolarPosition

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SolarPosition

fn eq(&self, other: &SolarPosition) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SolarPosition