Skip to content

kwb.raindrop (v.2.0): R Package for Optimisation Simulations for Rainwater Management Simulations Performed with Calculation Engine Provided by Tandler

Latest

Choose a tag to compare

@mrustl mrustl released this 13 Nov 11:40
6581e32

The 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() gains roof_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

Developed within the project RainDrop (GZ C300428), funded by the
Austrian Federal Ministry of Agriculture, Forestry, Regions and Water
Management (BMLUK).