bressen 2024.6.0

Converteren van breslocaties naar bresvlakken

Bressen

Voor het bewerken van breslocaties voor het Tygron Platform. Maakt bresvlakken (polygonen) als invoer voor de overstromingsmodule op basis van breslocaties (punten) keringen (polylijnen), peilvlakken (polygonen) en watervlakken (polygonen).

Python environment

Bressen gebruikt een recente versie (maart 2024) van geopandas en een versie van shapely en pandas groter dan 2.0. De module pyogrio wordt gebruikt voor het efficient lezen en schrijven van GeoPackages.

Wij bevelen het gebruik van Mamba aan voor het bouwen van Python-environments. Voor het installeren van MicroMamba, zie prefix.dev: https://prefix.dev/docs/mamba/overview#installation.

Een environment.yml bestand moet in ieder geval de volgende inhoud bevatten:

channels:
  - conda-forge
 
dependencies:
  - python<3.13
  - geopandas
  - pandas>2.0
  - pyogrio
  - shapely>2.0

Met deze environment.yml en MicroMamba bouw je je environment (we gebruiken hier de naam bressen) vanaf de command-line met:

micromamba env create -f environment.yml -n bressen

Installatie

Voor gebruikers

Vanuit de geactiveerde environment (in dit voorbeeld micromamba activate bressen) installeer je de bressen module met:

pip install bressen

Voor ontwikkelaars

Clone deze repository of download de main-branch lokaal. Vanuit de geactiveerde environment (in dit voorbeeld micromamba activate bressen) en de module-folder (waar je pyproject.toml vindt) installeer je de bressen-module via de command-line met:

pip install .

Wanneer je de module hebt gecloned én wilt kunnen bijwerken via Git of GitHub Desktop, kun je de module ook in edit-mode linken aan je Python-environment door:

pip install -e .

Nu kun je wijzigingen van de module eenvoudig opnemen door de repository bij te werken. En beter nog, actief bijdragen aan de (door)ontwikkeling van deze module!

Gebruik

Bressen worden berekend in 2 stappen, in deze repository uitgelegd in twee Jupyter Notebooks:

• Het verwerken van basisgegevens, zie 1_voorbereiden_data.ipynb
• Het processen van de basisgegevens, zie 2_processen_bressen.ipynb

Credits

Bressen is ontwikkeld door D2Hydro in opdracht van Waternet en Open Source beschikbaar onder een MIT licentie