███████╗██████╗ ███╗ ███╗ ████████╗ ██████╗ ██████╗ ██╗
██╔════╝██╔══██╗████╗ ████║ ╚══██╔══╝██╔═══██╗██╔═══██╗██║
███████╗██║ ██║██╔████╔██║ ██║ ██║ ██║██║ ██║██║
╚════██║██║ ██║██║╚██╔╝██║ ██║ ██║ ██║██║ ██║██║
███████║██████╔╝██║ ╚═╝ ██║ ██║ ╚██████╔╝╚██████╔╝███████╗
╚══════╝╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
This repo contains R packages, Shiny apps, and documentation that describes and implements the SDM Evaluation Tool.
docs: Documentation for evaluators, modelers, and developers.misc: A folder where we keep gitignored files (materials used for testing, etc.)sdmEvalToolCore: R package implementing the SDM Evaluation Tool core functionalitysdmEvalToolUI: R package implementing the SDM Evaluation Tool UI modules and Shiny appsspec: SDM Evaluation Tool specifications.working: Scripts used in the interim.
Prerequisites:
- R
- Rtools on Windows
- RStudio Desktop or a similar environment of you choosing
Before installation, first create a new RStudio Project where you'll store the
data required for this tool. To do so, select File > New Project. When prompted, select New Directory and New Project. Under the field Directory name, type in sdmEvaluationTool, then, click on the Browse button and select a location you'll remember (e.g., c:/users/user_name/work).
Use this script in R to install required packages and download/extract the example data set (say 'yes' or select the 'All' option to update packages if asked):
source("https://raw.githubusercontent.com/LandSciTech/sdmEvaluationTool/refs/heads/main/setup.R")You can now run the following script:
# load libraries
library(sdmEvalToolCore)
library(sdmEvalToolUI)
# start the app
sdm_tool()A window should pop-up with the loaded app. Alternatively, you can visit the following link in your browser: http://localhost:8080.
If you see an error message Error: Could not connect to database,
try setting the right folder with sdmevaltool_options():
# use your path here to point to the right folder
sdmevaltool_options(base = "./sdm_evaluation_results")The R packages can be checked locally following the RELEASE.R
file.
The GitHub Action workflows are triggered when changes are made to files in the
corresponding folders, see YAML files inside the .github/workflows folder.
To test a vanilla install of the packages, use Docker:
# build the image
docker build -t sdmevaltool:v1 .
# run the image
docker run -p 8080:8080 sdmevaltool:v1Visit http://localhost:8080.
See the CONTRIBUTING.md file.
TBD