pymeteoclimatic 0.1.0

A Python wrapper around the Meteoclimatic service

PyMeteoclimatic

A Python wrapper around the Meteoclimatic service.

PyMeteoclimatic is a client Python wrapper library for Meteoclimatic. Meteoclimatic is a large network of non-professional automatic real-time weather stations and an important directory of weather resources. The geographical scope of Meteoclimatic comprises the Iberian Peninsula, the two Spanish archipelagos (the Balearic Islands and the Canary Islands), southern France and Africa near the Strait of Gibraltar.

PyMeteoclimatic relies on the Meteoclimatic RSS feed. More specifically, PyMeteoclimatic leverages the coded, normalized data blocks included as HTML comments in the feeds between the [[<BEGIN:identificador:DATA>]] and [[<END:identificador:DATA>]] tags to obtain station weather information.

What data can I get?

With PyMeteoclimatic you can obtain weather information directly from Meteoclimatic stations identified by their code. You can find out the station code from the station profile page in the Meteoclimatic site.

When obtaining the weather information from a station, you will get a meteoclimatic.Observation object, which represents the weather which is currently being observed from a certain station and contains the following fields.

Field	Type	Description
reception_time	datetime.datetime	Timestamp telling when the weather obervation has been received from the station
station	meteoclimatic.Station	The Station relative to this observation
weather	meteoclimatic.Weather	The Weather relative to this observation

A meteoclimatic.Station object contains the following data.

Field	Type	Description
name	str	Name of the station
code	str	Meteoclimatic code of the station (e.g. "ESCAT4300000043206B")
url	str	URL of the Meteoclimatic station page

A meteoclimatic.Weather object contains the following data. Note that not all stations have the same physical sensors and capabilities (e.g. pluviometer, barometer, ...), therefore, some of these values may be None for some stations. Check the Meteoclimatic station page for more information on your preferred station capabilities.

Field	Type	Description
reference_time	datetime.datetime	Timestamp of weather measurement
condition	meteoclimatic.Condition or str	Single-word weather condition (e.g. "sun", "suncloud", "rain", ...). If it's a recognized condition, it will be mapped to a value of the meteoclimatic.Condition enumerate, otherwise it will be stored as a string
temp_current	float	Current temperature in Celsius
temp_max	float	Maximum temperature in Celsius for the past 24 hours
temp_min	float	Minimum temperature in Celsius for the past 24 hours
humidity_current	float	Current humidity in percentage points
humidity_max	float	Maximum humidity in percentage points for the past 24 hours
humidity_min	float	Minimum humidity in percentage points for the past 24 hours
pressure_current	float	Current atmospheric pressure in hPa units
pressure_max	float	Maximum atmospheric pressure in hPa units for the past 24 hours
pressure_min	float	Minimum atmospheric pressure in hPa units for the past 24 hours
wind_current	float	Current wind speed in km/h units
wind_max	float	Maximum wind speed in km/h units for the past 24 hours
wind_bearing	float	Wind bearing in degree units
rain	float	Precipitation in mm units for the past 24 hours

Installation

Install with pip for your ease.

$ pip install pymeteoclimatic

Example

from meteoclimatic import MeteoclimaticClient

client = MeteoclimaticClient()
observation = client.weather_at_station("ESCAT4300000043206B")

print("Timestamp")
print("~~~~~~~~~")
print(observation.reception_time)
print()
print("Station")
print("~~~~~~~")
print(observation.station)
print()
print("Weather")
print("~~~~~~~")
print(observation.weather)

Output:

Timestamp
~~~~~~~~~
2020-06-09 13:45:55+00:00

Station
~~~~~~~
<class 'meteoclimatic.station.Station'>({'name': 'Reus - Nord (Tarragona)', 'code': 'ESCAT4300000043206B', 'url': 'http://www.meteoclimatic.net/perfil/ESCAT4300000043206B'})

Weather
~~~~~~~
<class 'meteoclimatic.weather.Weather'>({'reference_time': datetime.datetime(2020, 6, 9, 13, 45, 55, tzinfo=datetime.timezone.utc), 'condition': <Condition.sun: 'sun'>, 'temp_current': 24.0, 'temp_max': 24.2, 'temp_min': 13.7, 'humidity_current': 45.0, 'humidity_max': 80.0, 'humidity_min': 44.0, 'pressure_current': 1013.5, 'pressure_max': 1015.3, 'pressure_min': 1013.5, 'wind_current': 13.0, 'wind_max': 31.0, 'wind_bearing': 232.0, 'rain': 0.2})

Contributing

Please feel free to submit issues or fork the repository and send pull requests to update the library and fix bugs, implement support for new sentence types, refactor code, etc.

License

MIT License