Repository navigation
kwb.raindrop (v.2.0): R Package for Optimisation Simulations for Rainwater Management Simulations Performed with Calculation Engine Provided by Tandler
LatestThe green-roof release — and the final release of the RainDrop
project. Roof types become a scenario dimension of the production
optimisation: every swale-trench (Mulden-Rigolen) design is optimised
for a conventional roof, an extensive and an intensive green roof
feeding the swale (SWMM-UrbanEVA parameterisation v2, D. Wicke). The
evaporation model behind it is independently validated: a cross-check
against SWMM-UrbanEVA reproduces the roof ET at both climate sites to
within 0.6 percentage points — for the extensive Wien roof the annual
ET is identical to the millimetre (516 mm/a).
Highlights
- Green roofs as a scenario dimension — new
roof_type_values(),
make_growth_curve(),default_growth_factors();
make_swale_runner()gainsroof_type/hoernschemeyer_aktiv/
growth_curve(defaults bit-identical to the published 0.1.0 runs);
both optimisers report the roof's own ET share (roof_et_pct). - Validated against SWMM-UrbanEVA (2026-11-10, setup review
D. Wicke): without surface ponding — the counterpart of the engine's
Verschaltung — engine and UrbanEVA agree to at most 0.6 percentage
points of roof ET at both sites; a berm-height series 0–30 mm
documents the ponding sensitivity.
→ UrbanEVA cross-check - Headline result — the green-roof lever is strongly
climate-dependent: in Wien, green roofs cut the cost of the
swale-trench system by ~41 % (extensive) / ~64 % (intensive) from
one allowed overflow event in 15 years; in humid-alpine Bad Aussee
the effect is ~2 %, and zero-overflow designs stay expensive
everywhere. Costs are pure swale-system costs — green-roof costs are
out of scope by design.
→ Results ·
Diagnostics - Report-ready figures —
plot_valid_design_space(palette = "viridis"): a
colour-vision-deficiency-safe ramp, validity never encoded by colour
alone (accessibility requirement of the BMLUK report template). - Vignettes aligned with the RainDrop final report (chapter 5):
validated status, published key figures, report terminology; plus
engine-free unit tests for the green-roof layer.
Install
# install.packages("remotes")
remotes::install_github("KWB-R/kwb.raindrop@v0.2.0")The proprietary calculation engine ("Regenwasserbewirtschaftung",
© Tandler.com GmbH, Windows-only) is not part of the package; fetch it
with download_engine() (release engine-2026-02-24 from
kwb.raindrop.binaries).
Changelog & citation
- Full changelog:
NEWS.md ·
v0.1.0...v0.2.0 - Cite via the concept DOI
10.5281/zenodo.21839222
(always resolves to the newest release; the version DOI for 0.2.0
appears on the Zenodo record once this release is archived).
Developed within the project RainDrop (GZ C300428), funded by the
Austrian Federal Ministry of Agriculture, Forestry, Regions and Water
Management (BMLUK).