pymeteoclimatic 0.1.0

Description:

pymeteoclimatic 0.1.0

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