Open-Channel Computation with R

The rivr package provides a computational toolset for simulating steady and unsteady one dimensional flows in open channels. It is designed primarily for use by instructors of undergraduate and graduate-level open-channel hydrodynamics courses in such diverse fields as river engineering, physical geography and geophysics. The governing equations used to describe open-channel flows are briefly presented, followed by example applications. These include the computation of gradually varied flows and two examples of unsteady flows in channels—namely, the tracking of the evolution of a flood wave in a channel and the prediction of extreme variation in the water-surface profile that results when a sluice gate is abruptly closed. Model results for the unsteady flow examples are validated against standard benchmarks. The article concludes with a discussion of potential modifications and extensions to the package.

Michael C. Koohafkan , Bassam A. Younis

CRAN packages used

rivr, knitr, shiny, Rcpp

CRAN Task Views implied by cited packages

HighPerformanceComputing, NumericalMathematics, ReproducibleResearch, WebTechnologies


Text and figures are licensed under Creative Commons Attribution CC BY 4.0. The figures that have been reused from other sources don't fall under this license and can be recognized by a note in their caption: "Figure from ...".


For attribution, please cite this work as

Koohafkan & Younis, "The R Journal: Open-Channel Computation with R", The R Journal, 2015

BibTeX citation

  author = {Koohafkan, Michael C. and Younis, Bassam A.},
  title = {The R Journal: Open-Channel Computation with R},
  journal = {The R Journal},
  year = {2015},
  note = {},
  doi = {10.32614/RJ-2015-034},
  volume = {7},
  issue = {2},
  issn = {2073-4859},
  pages = {249-262}