Struct Location 

pub struct Location {
    pub latitude: f64,
    pub longitude: f64,
    pub tz: Tz,
    pub altitude: f64,
    pub name: String,
}

Represents a physical location on Earth.

pvlib-python equivalently uses Location class with attributes: latitude, longitude, tz, altitude, and name.

Fields

latitude: f64

longitude: f64

tz: Tz

altitude: f64

name: String

Implementations

impl Location

pub fn new( latitude: f64, longitude: f64, tz: Tz, altitude: f64, name: &str, ) -> Self

Create a new Location instance.

Inputs are not validated — pass garbage latitude or longitude and you will get garbage solar-position output. Use Location::try_new at trust boundaries (weather API input, user-supplied config) for a validated constructor.

Arguments

• latitude - Latitude in decimal degrees. Positive north of equator, negative to south.
• longitude - Longitude in decimal degrees. Positive east of prime meridian, negative to west.
• tz - Timezone as a chrono_tz::Tz enum variant.
• altitude - Altitude from sea level in meters.
• name - Name of the location.

pub fn try_new( latitude: f64, longitude: f64, tz: Tz, altitude: f64, name: &str, ) -> Result<Self, LocationError>

Create a new Location with validated coordinates.

Returns Err(LocationError) if latitude is outside [-90, 90], longitude is outside [-180, 180], or altitude is non-finite.

pub fn get_solarposition( &self, time: DateTime<Tz>, ) -> Result<SolarPosition, SpaError>

Calculate the solar position for this location at the given time.

Convenience wrapper around solarposition::get_solarposition.

pub fn get_clearsky( &self, time: DateTime<Tz>, model: &str, ) -> ClearSkyIrradiance

Calculate clear sky irradiance for this location at the given time.

Arguments

• time - Date and time with timezone.
• model - Clear sky model: “ineichen”, “haurwitz”, or “simplified_solis”.

Returns

GHI, DNI, DHI in W/m^2. Returns zeros if the sun is below the horizon.

pub fn get_airmass(&self, time: DateTime<Tz>) -> (f64, f64)

Calculate relative and absolute airmass for this location at the given time.

Uses Kasten-Young model for relative airmass and site pressure derived from altitude for absolute airmass.

Returns

(airmass_relative, airmass_absolute). Values may be NaN if the sun is below the horizon.

Trait Implementations

impl Clone for Location

fn clone(&self) -> Location

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Location

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

Formats the value using the given formatter.

impl PartialEq for Location

fn eq(&self, other: &Location) -> 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 StructuralPartialEq for Location