GitLocker: The Coding Marketplace

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