meteoalarm 0.3.0

A Python library for accessing MeteoAlarm weather warnings

A Python package for accessing and filtering weather warnings from MeteoAlarm's CAP (Common Alerting Protocol) feeds. This package provides easy access to weather warnings across European countries through MeteoAlarm's official feeds.

Features

• Access weather warnings for multiple European countries
• Filter warnings based on various attributes (severity, type, description, etc.)
• Support for multiple languages per warning
• Automatic parsing of CAP format warnings
• GeoJSON geometry support for warning areas
• Timezone-aware datetime handling

Installation

Install the package using pip:

pip install meteoalarm

Quickstart

from meteoalarm import MeteoAlarm

# Initialize with one or more countries
warnings = MeteoAlarm(["estonia", "denmark"])

# Print all warnings
for warning in warnings:
    print(f"""\nWarning for {warning.area["areaDesc"]} ({warning.country}):""")
    print(f"""Headline: {warning.get_headline("en-EN")}""")
    print(f"Severity: {warning.severity}")
    print(f"Valid until: {warning.expires}")

Filtering Warnings

The package provides flexible filtering capabilities:

# Filter by severity
severe_warnings = warnings.filter(severity="Severe")

# Filter by description content (searches in all languages)
wind_warnings = warnings.filter(description="wind")

# Filter by multiple criteria
specific_warnings = warnings.filter(
    country="estonia",
    severity="Moderate",
    awareness_type="2"
)

# Filter with meteoalarm.Regex
from meteoalarm import Regex
regex_warnings = warnings.filter(area=Regex(r"^Orange.*"))

# Filter with datetime.datatime objects
from datetime import datetime
active_warnings = warnings.filter(onset=datetime.now())

# Filter with ISO 8601 date strings
active_warnings_iso = warnings.filter(onset="2024-12-31T23:59:59Z")

# Chain filters
critical_wind = warnings.filter(awareness_type="Wind").filter(severity="Severe")

Multilingual Support

Warnings are available in multiple languages:

# Get available languages for a warning
languages = warning.get_available_languages()

# Get warning information in specific language
english_headline = warning.get_headline("en-EN")
estonian_desc = warning.get_description("et-ET")

Plotting the Warning Area

from shapely.geometry import shape
import geopandas as gpd
import matplotlib.pyplot as plt
import contextily as ctx
import json

# Parse the GeoJSON string
geojson_dict = json.loads(warnings[0].geometry)

# Create geometry object
geometry = shape(geojson_dict)

# Create GeoDataFrame directly
gdf = gpd.GeoDataFrame(geometry=[geometry], crs="EPSG:4326")

# Convert to Web Mercator projection for contextily
gdf_web = gdf.to_crs(epsg=3857)

# Create plot
fig, ax = plt.subplots(figsize=(10, 10))
gdf_web.plot(ax=ax, alpha=0.5, color='red')

# Add background map
ctx.add_basemap(ax)

plt.axis('off')
plt.show()

Warning Attributes

Each warning object contains the following attributes:

• category: Warning category
• event: Event type
• urgency: Urgency level
• severity: Severity level
• certainty: Certainty level
• onset: Start time (datetime object)
• effective: Effective time (datetime object)
• expires: Expiration time (datetime object)
• sender: Dictionary containing sender information
• headline: Dictionary of headlines in available languages
• description: Dictionary of descriptions in available languages
• awareness_level: Awareness level
• awareness_type: Type of weather warning
• area: Dictionary containing area description and EMMA_ID
• geometry: GeoJSON geometry of the warning area

Requirements

• Python 3.7+
• requests
• pytz
• pyyaml

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

• Data provided by MeteoAlarm
• Based on the CAP (Common Alerting Protocol) standard