import ulg
ulg.element("wildflower_meadow").fill # '#DADDBC': Farben nachschlagen, nie erfinden
ulg.resolve("osm", landuse="meadow", meadow="wildflower") # 'wildflower_meadow'
ulg.resolve("alkis", objart="41008", funktion="4420") # 'green_space'
gdf["element"] = ulg.classify(gdf, "osm") # OSM, ALKIS, XPlanung, CORINE … → Elemente
ulg.render_svg(gdf, scale=500, path="plan.svg") # druckfertiges SVG, maßstabsgetreu
ulg.render_svg(gdf, scale=1500, theme="planzv") # dieselben Daten als Bauleitplan
ulg.indicators(ulg.flatten(gdf)) # Versiegelung, BFF, Abfluss, Baumkronen
Was es ist#
- 173 Elemente auf Englisch und Deutsch (Vegetation, Bäume, Wasser, Boden, 33 Oberflächen, Flächennutzung, Gebäude, Ausstattung, Grenzen, Planungs- und Analyse-Overlays), jedes mit einer Füllung, einer Textur pro Detailstufe, einem Linien- oder Punktsymbol, Aliasen und dokumentierten Kennwerten.
- Ein Stil, der GIS-exakt bleibt. Die Zeichen sind im Gelände verankert, nicht am einzelnen Objekt, sodass Muster über Polygongrenzen hinweg weiterlaufen und an Kachelgrenzen nahtlos anschließen; die handgezeichnete Kontur weicht nie um mehr als eine halbe Strichstärke von der wahren Kante ab.
- 26 Zuordnungstabellen (Crosswalks) für OSM-Tags, ALKIS/NAK, XPlanung, PlanZV, basemap.de, LBM-DE, BKompV, BayKompV, FFH, die Berliner Biotopkarte, DIN 276, CORINE, Urban Atlas, CLC+, EUNIS, HILUCS, LUCAS, ESA WorldCover, LCZ sowie die nationalen Modelle der Niederlande, der Schweiz, Österreichs und Englands: 3926 Klassen, jede mit einem Passgrad.
- Sieben Themes: der sanfte Hausstil sowie PlanZV, ALKIS, basemap.de, BfN-Landschaftsplanung, OpenStreetMap Carto und eine Schwarz-Weiß-Zeichnung, mit den veröffentlichten Farbwerten.
- Eingebaute Standards: Statussymbole für Bäume nach ISO 11091 und PlanZV, Wurzelschutzbereiche nach DIN 18920, der Berliner Biotopflächenfaktor (BFF), Abfluss nach DIN 1986-100, das urbane Grün der Verordnung (EU) 2024/1991 zur Wiederherstellung der Natur (Nature Restoration Regulation, NRR), nach WCAG geprüfte Lesbarkeit einschließlich Farbsehschwächen.
- Überall: SVG und Matplotlib; QGIS (QML mit handgezeichneter Kontur und maßstabsabhängigem Detailgrad); OGC SLD; MapLibre-Sprites und -Layer mit Bäumen und Straßen in Metern; CSS- und DTCG-Design-Tokens; eine Kommandozeile; ein Skill für KI-Coding-Agenten.
Installation#
pip install "urban-landscape-graphics[all] @ git+https://github.com/UrbanSens/Urban-Landscape-Graphics"
Python 3.10+. Die Kernabhängigkeiten sind NumPy und Shapely; [all] ergänzt GeoPandas und Matplotlib. Die
PNG-Ausgabe nutzt rsvg-convert, CairoSVG oder Inkscape, sofern eines davon installiert ist. Prüfen Sie die
Installation:
ulg check
Um die Beispiele auszuprobieren oder an der Bibliothek zu arbeiten, verwenden Sie einen Klon:
git clone https://github.com/UrbanSens/Urban-Landscape-Graphics.git
cd Urban-Landscape-Graphics
pip install -e ".[dev]"
python examples/quickstart.py
Dokumentation#
Beginnen Sie bei Inhalt:
- Herkunft: vom Englischen Garten und der bayerischen Uraufnahme von 1808 bis zum GIS
- Der Stilleitfaden: Prinzipien, Palette, Texturen, Symbole, Zeichenreihenfolge, Lesbarkeit
- Der Katalog: alle Elemente und ihre Kennwerte
- Python: Zeichnen, Klassifizieren, Messen, die Kommandozeile
- GIS und Web: QGIS, GeoServer, MapLibre, Tokens
- Standards: woran sich der Stil hält, mit dem vollständigen Standards-Bericht
- Für KI-Agenten:
ulg agent install - Erweitern des Stils: wie der Stilleitfaden wächst
Repository#
src/ulg/ das Paket; src/ulg/data enthält Katalog, Palette, Themes und Crosswalks als JSON
docs/ Dokumentation (Deutsch, Englisch in docs/en), erzeugte Referenzseiten, Recherche
examples/ lauffähige Beispiele, Beispieldaten, eine MapLibre-Seite
tools/ Generatoren für Dokumentationsbilder, Logo, Referenzseiten und HTML; Daten-Formatierer
tests/ pytest-Suite
.github/ Tests und die Dokumentationsseite (GitHub Pages) laufen bei jedem Push
Mitarbeit an der Bibliothek: Die Regeln und Befehle stehen in Working on ulg (für Menschen und Coding-Agenten gleichermaßen) und im Kapitel Erweitern des Stils.
Lizenz und Nennung#
ulg ist freie Software unter der MIT-Lizenz: Sie dürfen sie nutzen,
verändern und in kommerziellen Produkten ausliefern; der Lizenzhinweis muss beim Code bleiben. Die Karten und Blätter,
die Sie damit zeichnen, gehören Ihnen.
Bitte nennen Sie uns. Wenn ulg oder der UrbanSens Ecological Vector Style bei einer Karte, einem Plan, einem
Bericht, einer Ausschreibung oder einem Fachartikel geholfen hat, sagen Sie es in der Bildunterschrift oder im
Quellenverzeichnis:
Kartenstil: UrbanSens Ecological Vector Style (ulg), urbansens.de
Map style: UrbanSens Ecological Vector Style (ulg), urbansens.de
ulg.credit_line() liefert sie als Zeichenkette (mit Versionsnummer; ulg.credit_line("en") die englische Fassung). Die Stilblätter und die Katalogblätter (das Verzeichnis aller Elemente), die
ulg zeichnet, tragen in der Ecke ein kleines UrbanSens-Zeichen. Belassen Sie es, wenn Sie die Blätter weitergeben
(credit=False schaltet es ab); Ihre eigenen Karten erhalten nie einen Stempel. BibTeX, APA, die Regeln zu den Logos und
die Hinweise zu Material von Dritten: Lizenz und Nennung.
Status#
Version 0.1.0 (2026-09-30), UrbanSens. Siehe Changelog. Die Standards wurden am 30. September 2026 recherchiert; der Standards-Bericht nennt, was geprüft wurde, was hinter einer Bezahlschranke liegt und was bei Änderungen der Standards erneut zu prüfen ist.
