IMGWTools
Biblioteka Python i zestaw narzędzi do pobierania publicznych danych meteorologicznych i hydrologicznych z Instytutu Meteorologii i Gospodarki Wodnej (IMGW-PIB).
Materiał przygotowany z pomocą AI
Status
Repozytorium prywatne (kopia zapasowa, brak dostępu publicznego). Wersja: 2.1.0 | Licencja: MIT | Python 3.12+
Idea projektu
Dane IMGW są rozproszone po kilku serwisach (danepubliczne.imgw.pl, klimat.imgw.pl), każdy z innym formatem i sposobem dostępu. IMGWTools ujednolica dostęp do tych danych przez jednolite API — niezależnie od źródła, zawsze ten sam interfejs.
Kluczowa zasada: dane nie są przechowywane lokalnie (domyślnie). Narzędzie generuje bezpośrednie linki do serwerów IMGW lub pobiera je na żądanie. Opcjonalnie można włączyć cache SQLite.
Zakres możliwości
Dane bieżące
- Aktualne dane hydrologiczne (stany wód, przepływ, temperatura)
- Aktualne dane synoptyczne (temperatura, opady, wiatr, ciśnienie)
- Ostrzeżenia hydrologiczne i meteorologiczne
Dane archiwalne
- Dane hydrologiczne (od 1951) — dobowe, miesięczne, roczne
- Dane meteorologiczne (od 1951) — dobowe, miesięczne, roczne
- Parsowanie archiwów ZIP/CSV z kodowaniem CP1250
Opady maksymalne (PMAXTP)
- Opady maksymalne prawdopodobne dla dowolnych współrzędnych w Polsce
- Metody POT (Peaks Over Threshold) i AMP (Annual Maximum Precipitation)
- Różne czasy trwania i prawdopodobieństwa
Interfejsy dostępu
| Interfejs | Technologia | Zastosowanie |
|---|---|---|
| Biblioteka Python | pip install imgwtools | Integracja z innymi projektami |
| CLI | Typer + Rich | Szybkie pobieranie z terminala |
| REST API | FastAPI + Swagger | Dostęp sieciowy, mikrousługi |
| Web GUI | HTMX + Leaflet | Interaktywna mapa z wizualizacją |
Przykład użycia
from imgwtools import fetch_pmaxtp, fetch_hydro_current
# Opad maksymalny dla Warszawy: 15 min, p=50%
result = fetch_pmaxtp(latitude=52.23, longitude=21.01, method="POT")
precip = result.data.get_precipitation(15, 50)
# Aktualne dane hydrologiczne
stations = fetch_hydro_current()Powiązania z ekosystemem
IMGWTools jest częścią ekosystemu narzędzi hydrologicznych:
- Hydrograf — główna aplikacja, korzysta z IMGWTools do pobierania danych opadowych PMAXTP
- Hydrolog — silnik obliczeniowy; dane z IMGWTools (opady, przepływ) stanowią wejście do obliczeń hydrologicznych
- Kartograf — niezależny komponent danych przestrzennych; IMGWTools i Kartograf uzupełniają się
Hydrograf (hub)
├── IMGWTools ← dane obserwacyjne IMGW ← TEN PROJEKT
├── Kartograf ← dane przestrzenne GUGiK
└── Hydrolog ← obliczenia hydrologiczne