The evoland-plus R package (or evoland for short) provides tools for analyzing and projecting land use evolution. The package implements a statistically calibrated, constrained model for predicting locations of future land use / land cover change (LULCC).
The fundamental purpose of evoland-plus is to:
- Gather and process land use/land cover data from multiple sources into a clearly defined database structure.
- Calibrate statistical models to understand historical land use transitions
- Project future land use patterns using predictive models and allocation algorithms
- Support scenario analysis through interventions and parameter modifications
We suggest you use rv to manage your dependencies in an encapsulated environment.
Simply create an rproject.toml at the project root and execute rv sync.
# sample rproject.toml
[project]
name = "evoland-plus"
r_version = "4.5"
repositories = [
{ alias = "CRAN", url = "https://stat.ethz.ch/CRAN/" },
]
dependencies = [
# just use it: load using library(evoland)
{ name = "evoland", git = "https://github.com/ethzplus/evoland-plus/", branch = "main" },
]If you want to develop the model logic itself, you can opt to only install dependencies but not the package itself:
dependencies = [
# only install dependencies declared in DESCRIPTION
{ name = "evoland", path = "~/path/to/local/repo", dependencies_only = true, install_suggestions = true },
"devtools", # sundry development tasks
"mirai", # modern multiprocessing
"httpgd", # webview plotting
"languageserver", # assuming your IDE loads the rv library instead of system
]During development, devtools::load_all() acts as though you were calling library(evoland) on an installed package.
This makes it easy to rapidly reload code when you've changed something.
PRs are very welcome!
It's probably best to first discuss the underlying issue; @mmyrte is very happy to help figure out a solution.
Code should be autoformatted using air before committing.
Tests are written as tinytests that can be run after package installation, ensuring that your system is set up correctly.
evoland-plus uses Dinamica EGO as its spatial allocation engine.
See the Installing Dinamica EGO vignette for installation instructions.
Note that Dinamica only runs on Linux x86 / amd64 (the Windows installer exists but is untested with evoland-plus); users on other platforms should use the Docker container.
This package uses pkgdown, see http://ethzplus.github.io/evoland-plus.
- Tutorials & How-to Guides: Package vignettes and examples in R man pages
- Reference Documentation: R man pages using the standard
?function_name - Explanation & Design Rationale: See the project wiki for
- Detailed explanation of the modeling approach
- Database schema and architecture decisions
- Development guidelines and coding standards
This project is licensed under the AGPL-3 License - see the LICENSE.md file for details.
This work represents a re-implementation and enhancement of Benjamin Black's land use model published at https://github.com/ethzplus/evoland-plus-legacy, building on substantial prior experience while modernizing the technical implementation.