Kartograf

Narzędzie CLI i biblioteka Python do automatycznego pobierania danych przestrzennych z polskich i międzynarodowych źródeł geodezyjnych.

Materiał przygotowany z pomocą AI

Status

Repozytorium prywatne (kopia zapasowa, brak dostępu publicznego). Wersja: 0.5.0 | Licencja: MIT | Python 3.12+

Idea projektu

Dane przestrzenne potrzebne w hydrologii są rozproszone po wielu serwisach (GUGiK, Copernicus CLMS, ISRIC SoilGrids), z których każdy ma inne API, formaty, systemy uwierzytelniania i konwencje nazewnictwa arkuszy. Kartograf oferuje jednolity interfejs do pobierania ich wszystkich — od Numerycznego Modelu Terenu, przez pokrycie terenu, po dane glebowe.

Projekt obsługuje polskie układy współrzędnych (PL-1992, PL-2000) z automatyczną detekcją układu na podstawie godła arkusza mapy.

Zakres możliwości

Źródła danych

Źródło	Dane	Dostawca
NMT/NMPT	Numeryczny Model Terenu i Pokrycia Terenu (1m, 5m)	GUGiK
Ortofotomapa	Zdjęcia lotnicze 25cm (2018-2025)	GUGiK
BDOT10k	Baza Danych Obiektów Topograficznych	GUGiK
CORINE	Europejska klasyfikacja pokrycia terenu (1990-2018)	Copernicus
SoilGrids	Globalne dane glebowe	ISRIC

Funkcje obliczeniowe

• Parser godeł — rozkład godeł arkuszy topograficznych w układach PL-1992 (skale 1:1M do 1:10k) i PL-2000 (skale 1:10k do 1:500) z autodetekcją układu
• Grupy hydrologiczne gleby (HSG) — klasyfikacja tekstury wg trójkąta USDA (12 klas), mapowanie na 4 grupy hydrologiczne (A-D) dla metody SCS-CN
• Selekcja przestrzenna — wyszukiwanie arkuszy po bounding box lub geometrii (SHP/GPKG)

Przykład użycia

# Informacje o godle arkusza
kartograf parse N-34-130-D-d-2-4
 
# Pobranie NMT
kartograf download N-34-130-D-d-2-4
 
# Pobranie pokrycia terenu BDOT10k dla powiatu
kartograf landcover download --source bdot10k --teryt 1465
 
# Obliczenie grup hydrologicznych gleby
kartograf soilgrids hsg --godlo N-34-130-D --stats

Powiązania z ekosystemem

Kartograf jest komponentem danych przestrzennych w ekosystemie narzędzi hydrologicznych:

• Hydrograf — główna aplikacja, wykorzystuje Kartograf do pobierania NMT, pokrycia terenu BDOT10k/CORINE i obliczania HSG w pipeline preprocessingu
• Hydrolog — silnik obliczeniowy; opcjonalnie korzysta z HSGCalculator i SoilGridsProvider z Kartografa do klasyfikacji gleb
• IMGWTools — uzupełniający komponent danych obserwacyjnych; Kartograf i IMGWTools nie zależą od siebie, ale oba są integrowane przez Hydrograf

Hydrograf (hub)
├── IMGWTools  ← dane obserwacyjne IMGW
├── Kartograf  ← dane przestrzenne GUGiK    ← TEN PROJEKT
└── Hydrolog   ← obliczenia hydrologiczne
        └── Kartograf (opcjonalnie)

Zobacz także

• Hydrograf — hub integrujący ekosystem narzędzi
• IMGWTools — dane obserwacyjne z IMGW
• Hydrolog — obliczenia hydrologiczne
• GIS — systemy informacji geograficznej
• Praca z rastrami w Pythonie — jak otworzyć i przetwarzać NMT pobrany Kartografem (rasterio, xarray)