Package: kwb.raindrop 0.1.0

Michael Rustler

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

R Package for Optimisation Simulations for Rainwater Management Simulations Performed With Calculation Engine Provided by Tandler.

Authors:Michael Rustler [aut, cre], RAINDROP [fnd], Kompetenzzentrum Wasser Berlin gGmbH [cph]

kwb.raindrop_0.1.0.tar.gz
kwb.raindrop_0.1.0.zip(r-4.7-any)kwb.raindrop_0.1.0.zip(r-4.6-any)kwb.raindrop_0.1.0.zip(r-4.5-any)
kwb.raindrop_0.1.0.tgz(r-4.6-any)kwb.raindrop_0.1.0.tgz(r-4.5-any)
kwb.raindrop_0.1.0.tar.gz(r-4.7-any)kwb.raindrop_0.1.0.tar.gz(r-4.6-any)
kwb.raindrop_0.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
kwb.raindrop/json (API)

# Install 'kwb.raindrop' in R:
install.packages('kwb.raindrop', repos = c('https://kwb-r.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/kwb-r/kwb.raindrop/issues

On CRAN:

Conda:

optimizationrainwater-managementstormwater-runoff

4.59 score 10 scripts 42 exports 49 dependencies

Last updated from:7fe792f52c. Checks:7 NOTE, 2 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develNOTE248
source / vignettesOK191
linux-releaseNOTE240
macos-releaseNOTE181
macos-oldrelNOTE179
windows-develNOTE214
windows-releaseNOTE200
windows-oldrelNOTE190
wasm-releaseOK116

Exports:%>%add_overflow_events_and_waterbalancecompute_costscost_rates_captiondefault_canonical_wb_variablesdefault_cost_ratesdefault_param_labelsdefault_storage_specdefault_storage_typesdownload_enginefind_min_feasiblefind_single_param_variationsget_simulation_results_allget_simulation_results_optimget_simulation_results_optim_parallelh5_ensure_dataseth5_ensure_datasets_from_valuesh5_read_valuesh5_validate_writeh5_write_valueslist_h5_datasetsmake_swale_runneroptimise_swale_designoptimise_swale_design_simultaneousplot_cost_overflow_boxplotplot_cost_vs_evaporationplot_cost_vs_overflow_volumeplot_hpond_vs_refplot_main_effectsplot_valid_design_spaceplot_wb_tradeoff_overflowsplotly_add_captionplotly_split_legendread_hdf5_connectionsread_hdf5_scalarsread_hdf5_timeseriesread_raindrop_errorsread_site_timeseriesrun_modelrun_scenariossickerbox_level_presetsstack_levels

Dependencies:bitbit64clicodetoolscpp11digestdplyrfarverforcatsfsfuturefuture.applygenericsggplot2globalsgluegridExtragtablehdf5risobandkwb.datetimekwb.eventkwb.plotkwb.utilslabelinglifecyclelistenvlubridatemagrittrparallellypillarpkgconfigprogressrpurrrR6RColorBrewerrlangS7scalesstringistringrtibbletidyrtidyselecttimechangeutf8vctrsviridisLitewithr

Minimal example: Wien, ET-diagnostics scenario grid
Input data | Static base.h5 parameter overview | Twelve-scenario parameter grid | Run the twelve scenarios | Persist per-scenario engine inputs to XLSX | Results
Rendered fromexample_wien_minimal.Rmdusingknitr::rmarkdown

Last update: 2026-08-07
Started: 2026-05-06

Workflow Bad Aussee (2011 - 2025)
Input data | Define Paths and Scenarios | Run Model | Analyse Results
Rendered fromworkflow_badaussee.Rmdusingknitr::rmarkdown

Last update: 2026-08-07
Started: 2026-02-24

Workflow Eisenstadt 2005
Input data | Define Paths and Scenarios | Run Model | Analyse Results
Rendered fromworkflow_eisenstadt-2005.Rmdusingknitr::rmarkdown

Last update: 2026-08-07
Started: 2026-01-19

Workflow Optimierung — Simultane Suche (alle Parameter gleichzeitig)
Ziel | Standort-Konfiguration | Simultane Optimierung aller Standorte (Nelder-Mead, parallel) | Ergebnis: günstigstes Design je Standort und Überlaufziel | Gegenprobe: Vergleich mit der Bisektion | Alternative Optimierer im Vergleich | Einordnung
Rendered fromworkflow_optimisation_simultaneous.Rmdusingknitr::rmarkdown

Last update: 2026-08-07
Started: 2026-08-07

Workflow Optimierung (Eisenstadt · Wien · Bad Aussee)
Ziel | Standort-Konfiguration | Suchraum und Kostensätze | Optimierung aller Standorte (parallel) | Ergebnis: günstigstes Design je Standort und Überlaufziel | Monte-Carlo-Analyse: Wie robust ist die Suche selbst? | Einordnung
Rendered fromworkflow_optimisation.Rmdusingknitr::rmarkdown

Last update: 2026-08-07
Started: 2026-08-07

Workflow Wien (2011 - 2025)
Input data | Define Paths and Scenarios | Analyse Results
Rendered fromworkflow_wien.Rmdusingknitr::rmarkdown

Last update: 2026-08-07
Started: 2026-02-19

Readme and manuals

Help Manual

Help pageTopics
Add overflow-event metrics and water-balance shares (percent) to simulation resultsadd_overflow_events_and_waterbalance
Compute construction costs for an infiltration-swale parameter gridcompute_costs
Caption line naming the unit-cost rates behind the cost plotscost_rates_caption
Canonical water-balance variable names emitted by the Tandler enginedefault_canonical_wb_variables
Default unit-cost rates for infiltration-swale installationsdefault_cost_rates
German / English labels for optimisation parameter-grid columnsdefault_param_labels
Default storage specification for the swale-design optimiserdefault_storage_spec
Default storage-type soil presets (Speicher layer)default_storage_types
Download the Tandler "Regenwasserbewirtschaftung" calculation enginedownload_engine
Smallest feasible parameter value via bisection (monotone threshold search)find_min_feasible
Find scenarios that differ from a reference in exactly one parameterfind_single_param_variations
Read Raindrop optimisation simulation results (all) from HDF5get_simulation_results_all
Read Raindrop optimisation simulation results from HDF5get_simulation_results_optim
Read Raindrop optimisation simulation results from HDF5 (parallel via future.apply + progress)get_simulation_results_optim_parallel
Ensure that an HDF5 dataset exists (create if missing)h5_ensure_dataset
Ensure that all datasets referenced by a values list existh5_ensure_datasets_from_values
Read values of all (or selected) datasetsh5_read_values
Validate what would be written where (pre-flight check)h5_validate_write
Write (updated) values back into existing HDF5 datasets (robust for your hdf5r build)h5_write_values
List all datasets (recursive)list_h5_datasets
Create a site-specific single-scenario runner for the optimisermake_swale_runner
Find the cost-optimal swale design per overflow targetoptimise_swale_design
Find the cost-optimal swale design by simultaneous parameter searchoptimise_swale_design_simultaneous
Cost boxplot per overflow-event count, points sized by overflow volumeplot_cost_overflow_boxplot
Cost vs. evapotranspiration scatter with storage-type shapesplot_cost_vs_evaporation
Cost vs. overflow-volume scatter with n_overflows-coloured pointsplot_cost_vs_overflow_volume
Plot the influence of single-parameter variations on a responseplot_hpond_vs_ref
Plot main effects of multiple parameters on an outcome (violin/box/jitter)plot_main_effects
Valid solutions in design space (x × y) with overflow-threshold discrete color scaleplot_valid_design_space
Trade-off plot: Infiltration vs. Evapotranspiration (discrete colors by overflow threshold)plot_wb_tradeoff_overflows
Add a caption annotation to a ggplotly objectplotly_add_caption
Split the combined (colour, shape) ggplotly legend into two clean legendsplotly_split_legend
Read surface-water connections from an HDF5 results fileread_hdf5_connections
Read scalar datasets from an HDF5 groupread_hdf5_scalars
Read HDF5 time series datasets from a group (supports deeperLayers)read_hdf5_timeseries
Read RAINDROP error logs into a nested tibbleread_raindrop_errors
Read and prepare site rain/ET0 time series for the engine (mm/h)read_site_timeseries
Run an rainwater management model executable with an input filerun_model
Run scenarios (parallel or sequential) with a user-supplied worker functionrun_scenarios
Sickerbox storage-height presets (brute force default + manufacturers)sickerbox_level_presets
Achievable storage-layer stack heights from module heightsstack_levels