Building the project

Initial Setup

Clone the visualization repository. You can do this in RStudio by choosing File | New Project... | Version Control | Git and pasting in the Repository URL you copied from GitHub (green "Clone or download" button).

If you don't have it, install vizlab. If the project has a specific tagged version of vizlab, you can install this using devtools::install_github("USGS-VIZLAB/vizlab@tagname").

do:

library(vizlab)
createProfile()
createMakefiles()

createProfile() may not be necessary if you've worked on vizlab before.

then make sure you have the proper packages and versions installed with:

vizlab::checkVizPackages()

and use install.packages() or devtools::install_github() to update.

To get the svglite package, use devtools::install_github("jread-usgs/svglite@svgnano"). For Windows users, you might see an error similar to Error: running command '"C:/PROGRA~1/R/R-34~1.1/bin/x64/R" --no-site-file --no-environ --no-save --no-restore --quiet CMD config CC' had status 127. If this is the case, clone Jordan Read's repository and build the package locally on the branch svgnano.

Building

Go to the "Build" tab in RStudio. If you don't see the "Build" tab yet, restart RStudio. On that tab you should see a "Build All" option. Click it!

If there are errors, logs with errors are in .hurricane-irma/vizlab/make/log. You can often open these using

full_log <- getLog('item-name')

Once you are able to complete the build, see https://github.com/USGS-VIZLAB/vizlab/wiki/Previewing-visualizations to view the results.