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.

Arguments

• azimuth - Azimuth angle in degrees (will be normalized to 0-360°)
• zenith_angle - Zenith angle in degrees (must be 0-180°)

Returns

Solar position or error if zenith angle is invalid

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.

Returns

Azimuth angle (0° to 360°, 0° = North, increasing clockwise)

pub const fn zenith_angle(&self) -> f64

Gets the zenith angle in degrees.

Returns

Zenith angle (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

Returns

Elevation angle (-90° to 90°, 90° = zenith, 0° = horizon, -90° = nadir)

pub fn is_sun_up(&self) -> bool

Checks if the sun is above the horizon.

Returns

true if elevation angle > 0°, false otherwise

pub fn is_sun_down(&self) -> bool

Checks if the sun is at or below the horizon.

Returns

true if elevation angle <= 0°, false otherwise

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 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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SolarPosition

impl StructuralPartialEq for SolarPosition