Dundee Root Analytical Model (DRAM) - A three-dimensional analytical model for the mobilisation of root reinforcement in direct shear conditions
v0.1.0 - March 2022 - Gerrit Meijer (gjm36@bath.ac.uk)
An online app, showcasing the capabilities of the DRAM, is currently hosted through Shinyapps.io: https://gjmeijer.shinyapps.io/DRAM/
This R package contains:
- an interactive app (using R Shiny), interactively showing how root reinforcement are affected by root properties, soil propeties and root orientations in three dimensions. The reinforcements can the compared to the predictions by existing reinforcement models.
- all functions required to make calculations
To install this package on your local machine:
- Open R. (If not installed, I recommend installing RStudio (free software) that can be downloaded from https://www.rstudio.com/products/rstudio/download/)
- If not already installed, install the
devtools
package by typinginstall.packages("devtools")
in the R console. This package allows you to interact with R packages hosted on GitHub (among many other things) - Install the
DRAM
package by typingdevtools::install_github("GJMeijer/DRAM")
in the R console
To run the included app on your local machine, type DRAM::run_app()
in the R console after installation of the package. This will open the app in your default browser. This app relies on R continuing to run in the background for any computations.
This app shows an interactive version of the DRAM. Full documentation can be found within the app itself. The app is constructed using the R package shiny
.
A wrapper function dram_runanalysis_wrapper()
is provided that takes all input parameters required for a DRAM calculation and outputs various dataframes with results. You can use this function in R to do all DRAM calculations that are performed within R using the R console rather than the app. For more information, type
?dram_runanalysis_wrapper
into your R console window.
When using this function, make sure that you use a consistent set of units (e.g. when using lenghts in meters and forces in kilonewstons, the correct unit for stress and stiffness is kPa, or when using lenghts in mm and forces in newtons, the correct unit for stress and stiffness is MPa, etc.). All angles should be specified in radians rather than degrees. All output is returned in the same unit system.
For each of the functions in the package, a help page can be opened by typing ?function_name
in the R console, where function_name
is the name of the function you want to see the documentation of.
Copyright (C) 2021 University of Bath
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.