Landscape Unit Mapping Program for R

This package provides functions for a semi-automated approach of the delineation and description of landscape units and their partitioning into terrain components. It can be used for the pre-processing of semi-distributed large-scale hydrological and erosion models using catena-representation (e.g. WASA-SED, CATFLOW). Additional pre-processing tools beyond the scope of the original LUMP algorithm are included.

• command line installation:

install.packages("devtools") 
library(devtools)
Sys.setenv(R_REMOTES_NO_ERRORS_FROM_WARNINGS=TRUE) #tell git_install() to ignore warnings. Otherwise, it gets stuck at each warning
install_github("tPilz/lumpR")

• from zip/tar:
  • download zip/tar from the github-repository
  • install via R-GUI

The main branch relies on GRASS 8. For legacy support of GRASS 7 (no further development and support), use branch [https://github.com/tpilz/lumpR/tree/grass7]

• R language, including extensions r.stream.distance and r.stream.order
• GRASS GIS, version 8.
• data base (e.g. sqlite, MariaDB, LibreOffice Base or other DBs with ODBC-driver) For instruction, see the Wiki .

Have a look at our Wiki for more detailed information .

Tutorial with test data and exemplary workflow at https://github.com/TillF/lumpR_tutorial .

Feel free to comment via github issues: >LINK<

lumpR is distributed under the GNU General Public License version 3 or later. The license is available in the file GPL-3 of lumpR's source directory or online: >LINK<

This package was also known as LUMP and has been renamed by Jan 9th 2017 to distinguish it from the LUMP algorithm published by Francke et al. (2008).

A paper describing lumpR along with an example study was published in GMD:

Pilz, T., Francke, T., and Bronstert, A. (2017): lumpR 2.0.0: an R package facilitating landscape discretisation for hillslope-based hydrological models, Geosci. Model Dev., 10, 3001-3023, doi: 10.5194/gmd-10-3001-2017

See also the accompanying github repository: https://github.com/tpilz/lumpr_paper

For the original LUMP algorithm see:

Francke, T., Güntner, A., Mamede, G., Müller, E. N., and Bronstert, A. (2008): Automated catena-based discretization of landscapes for the derivation of hydrological modelling units, Int. J. Geogr. Inf. Sci., 22, 111-132, doi:10.1080/13658810701300873, 2008.

For preparing soil data, consider using https://github.com/TillF/SoilDataPrep/tree/master