mostlyright.weather.forecasts

mostlyright.weather.forecasts(station, from_date=None, to_date=None, , source=‘model_output_statistics’, models=None)

Return the settlement-day forecast frame for station over [from_date, to_date].

• Parameters:
  • station (str) – The station id to fetch forecasts for.
  • from_date (DateLike | None) – Inclusive ISO start date (YYYY-MM-DD). Required.
  • to_date (DateLike | None) – Inclusive ISO end date (YYYY-MM-DD). Required.
  • source (str) – The forecast engine — "model_output_statistics" (alias "mos", default), "open_meteo", or "numerical_weather_prediction" (alias "nwp").
  • models (str | list[str] | None) – Product(s) WITHIN source. A str or single-item list for MOS/Open-Meteo; a list for raw NWP. Ambiguous multi-model MOS selections raise.
• Return type: pd.DataFrame
• Returns: The eager fcst_* frame keyed by station + settlement date.
• Raises: ContractError – from_date/to_date is missing or the window is inverted (raised before any I/O); or source/models is invalid or ambiguous.

Example

>>> from mostlyright.weather import forecasts
>>> df = forecasts("KNYC", "2025-01-01", "2025-01-07")