# Run this from your command line terminal. brew tap homebrew/science && brew install Caskroom/cask/xquartz && brew install r
Downloading Syberia into a sandbox that does not interfere with your usual R package library can be done by running the minimal example project:
# Run this from your command line terminal. git clone email@example.com:syberia/example.sy.git && cd example.sy && R
If you are having trouble, scroll down to the troubleshooting section.After the packages have downloaded and your R session opens type
run("example"); model$predict(iris[1:5, ])
If everything worked correctly, you should see some model predictions.
Let's walk through what happened during this process.
git clone firstname.lastname@example.org:syberia/example.sy.gitpulled the example project GitHub repository down and then we moved to the directory using
lockbox::lockbox("lockfile.yml"). This file is parsed by lockbox to understand which packages we need for this project. If you ever want to load more packages, place them in the lockfile instead of adding
install.packagescalls. This ensures pushing and pulling the project to and from version control loads an R session with the same packages across your whole team's computers.
syberia::syberia_project(). This bootstrapping procedure builds an R object called a
syberia_enginethat is built off a
directorand will manage all the files and directories in your project.
syberia_engineloaded and mounted both engines in the appropriate hierarchy of dependencies. Syberia takes care of downloading, mounting, and maintaining your engines. The modeling engine's boot file was executed to attach a new namespace called
syberia:modelingto your R search path. This is used to provide global helper functions like
runso that they do not clash with your global namespace.
run("example")in a little bit.
If you ran into any problems during the above process, continue reading for the troubleshooting guide (or use ctrl+F to jump straight to your error message). Otherwise, you can file a new issue on GitHub explaining your problem and the Syberia core team will jump to the rescue.
Note the above process installed Syberia into a custom library managed by lockbox. To install it globally, run:
This is an issue with lockbox on certain system configurations. Restarting R should fix the issue. Otherwise, try executing the following command from the terminal and then restarting R. (Make sure you are starting R from the root of the example project so that you load the necessary Rprofile.)
rm -rf ~/.R/lockbox/.staging