Struct NomadsRequest 

#[non_exhaustive]
pub struct NomadsRequest {
    pub latitude_deg: f64,
    pub longitude_deg: f64,
    pub model: NomadsModel,
    pub cycle_unix_s: i64,
    pub forecast_hour: u32,
    pub endpoint: Option<String>,
}

What to ask NOMADS for: a model’s run, a forecast hour and a site.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

latitude_deg: f64

The site’s latitude, degrees north, in [-90, 90].

longitude_deg: f64

The site’s longitude, degrees east, in [-180, 180].

model: NomadsModel

The model.

cycle_unix_s: i64

The run’s start (its cycle), seconds since the Unix epoch (UTC): a whole multiple of NomadsModel::cycle_hours, from 1970 to the year 9999.

forecast_hour: u32

Hours after the cycle, one the run has (NomadsModel::has_forecast_hour).

endpoint: Option<String>

Another server’s address in place of ENDPOINT, such as a mirror; None for NOMADS. It must hold no ? or #.

Implementations

impl NomadsRequest

pub fn new( latitude_deg: f64, longitude_deg: f64, model: NomadsModel, cycle_unix_s: i64, forecast_hour: u32, ) -> Self

A request to NOMADS.

pub fn valid_unix_s(&self) -> i64

The time the forecast is for, the cycle plus the forecast hour, s since the Unix epoch.

pub fn url(&self) -> Result<String, NomadsError>

The grib filter’s URL for the cut.

The URL is the cache key. It holds no coordinate of the site itself, only the box’s edges, 0.3° each way from the site, to hundredths of a degree. Each edge is worked out from the site written to 5 decimals, as crate::elevation writes it, and rounded to hundredths in decimal, halves away from zero, so a site given to 8 decimals or fewer and rebuilt from radians (−106.91° can come back as −106.91000000000001) asks for the same box and finds its saved answer. The rounding moves an edge by at most 0.005° (the 5-decimal step adds under 1e-5°), so the box still reaches more than 0.29° each way, over a GFS cell. The cut is interpolated at the site as given, not as rounded.

Errors

NomadsError::Request when a field is outside the range its doc gives.

pub fn source(&self) -> Source

The Source a Client caches this request’s answer under: NOMADS, ATTRIBUTION, 30 days.

Trait Implementations

impl Clone for NomadsRequest

fn clone(&self) -> NomadsRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NomadsRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NomadsRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for NomadsRequest

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NomadsRequest