API#

DWD (German Weather Service)#

Observation#

class wetterdienst.provider.dwd.observation.api.DwdObservationRequest(parameter, resolution, period=None, start_date=None, end_date=None, settings=None)#

The DWDObservationStations class represents a request for a station list as provided by the DWD service.

Parameters:

  • parameter (Union[str, DwdObservationDataset, DwdObservationParameter, List[Union[str, DwdObservationDataset, DwdObservationParameter]]]) – parameter set str/enumeration

  • resolution (Union[str, Resolution, DwdObservationResolution]) – resolution str/enumeration

  • period (Union[str, Period, DwdObservationPeriod, None]) – period str/enumeration

  • start_date (Union[str, datetime, Timestamp, None]) – start date to limit the stations_result

  • end_date (Union[str, datetime, Timestamp, None]) – end date to limit the stations_result

classmethod describe_fields(dataset, resolution, period, language='en')#
Parameters:

  • dataset –

  • resolution –

  • period –

  • language (str) –

Return type:

dict

Returns:

Forecast (Mosmix)#

class wetterdienst.provider.dwd.mosmix.api.DwdMosmixRequest(parameter, mosmix_type, start_issue=DwdForecastDate.LATEST, end_issue=None, start_date=None, end_date=None, station_group=None, settings=None)#

Implementation of sites for MOSMIX mosmix sites

Parameters:

  • parameter (Optional[Tuple[Union[str, DwdMosmixParameter], ...]]) – parameter(s) to be collected

  • mosmix_type (Union[str, DwdMosmixType]) – mosmix type, either small or large

  • start_issue (Union[str, datetime, DwdForecastDate, None]) – start of issue of mosmix which should be caught (Mosmix run at time XX:YY)

  • end_issue (Union[str, datetime, None]) – end of issue

  • start_date (Union[str, datetime, None]) – start date for filtering returned dataframe

  • end_date (Union[str, datetime, None]) – end date

static adjust_datetime(datetime_)#

Adjust datetime to MOSMIX release frequency, which is required for MOSMIX-L that is only released very 6 hours (3, 9, 15, 21). Datetime is floored to closest release time e.g. if hour is 14, it will be rounded to 9

Parameters:

datetime – datetime that is adjusted

Return type:

datetime

Returns:

adjusted datetime with floored hour

property issue_end#

Required for typing

property issue_start#

Required for typing

Radar#

class wetterdienst.provider.dwd.radar.api.DwdRadarValues(parameter, site=None, fmt=None, subset=None, elevation=None, start_date=None, end_date=None, resolution=None, period=None, settings=None)#

API for DWD radar data requests.

Request radar data from different places on the DWD data repository.

Parameters:

  • parameter (Union[str, DwdRadarParameter]) – The radar moment to request

  • site (Optional[DwdRadarSite]) – Site/station if parameter is one of RADAR_PARAMETERS_SITES

  • fmt (Optional[DwdRadarDataFormat]) – Data format (BINARY, BUFR, HDF5)

  • subset (Optional[DwdRadarDataSubset]) – The subset (simple or polarimetric) for HDF5 data.

  • start_date (Union[str, datetime, DwdRadarDate, None]) – Start date

  • end_date (Union[str, datetime, timedelta, None]) – End date

  • resolution (Union[str, Resolution, DwdRadarResolution, None]) – Time resolution for RadarParameter.RADOLAN_CDC, either daily or hourly or 5 minutes.

  • period (Union[str, Period, DwdRadarPeriod, None]) – Period type for RadarParameter.RADOLAN_CDC

adjust_datetimes()#

Adjust start_date and end_date attributes to match minute marks for respective RadarParameter.

query()#

Send request(s) and return generator of RadarResult instances.

Return type:

Generator[RadarResult, None, None]

Returns:

Generator of RadarResult instances.

ECCC (Environment and Climate Change Canada)#

Observation#

class wetterdienst.provider.eccc.observation.api.EcccObservationRequest(parameter, resolution, start_date=None, end_date=None, settings=None)#

Download weather data from Environment and Climate Change Canada (ECCC). - https://www.canada.ca/en/environment-climate-change.html - https://www.canada.ca/en/services/environment/weather.html

Original code by Trevor James Smith. Thanks! - https://github.com/Zeitsperre/canada-climate-python

Parameters:

  • parameter (Tuple[Union[str, EcccObservationParameter]]) – parameter or list of parameters that are being queried

  • resolution (Union[EcccObservationResolution, Resolution]) – resolution of data

  • start_date (Optional[datetime]) – start date for values filtering

  • end_date (Optional[datetime]) – end date for values filtering

NOAA (National Oceanic and Atmospheric Administration)#

Global Historical Climatology Network#

class wetterdienst.provider.noaa.ghcn.api.NoaaGhcnRequest(parameter, start_date=None, end_date=None, settings=None)#
Parameters:

  • parameter (List[str]) – list of parameter strings or parameter enums being queried

  • start_date (Union[str, datetime, Timestamp, None]) – start date for request or None if all data is requested

  • end_date (Union[str, datetime, Timestamp, None]) – end date for request or None if all data is requested