In ConvergenceDA/visdomloadshape: R package for load shape clustering and analysis, extending the visdom package

Simplest approach

There is support in R for installing and updating packages directly from their version control repositories. If you plan to use this package without altering any of its source code, this is the preferred method of installation.

Install VISDOM Load Shapes directly from GitHub source

One useful feature of R documentation is its ability to present formatted examples of code usage and outputs, called vignettes. When installing from github, these vignettes are not built by default, largely due to their additional R module dependencies (and their runtimes in some cases). Still, it is highly recommended that you do build and refer to the vignettes. Note that any missing packages that R warns you about can likely be installed using the install.packages command. For example, if a package called plyr is not installed and you try to run code that depends on it, you will get a message like: there is no package called ‘plyr’. You can address this by calling install.packages('plyr') and repeat until your dependencies are all loading correctly.

install.packages(c("devtools"))

# if you haven't doens so already, install the core visdom package.
devtools::install_github("convergenceda/visdom" )

# build_vignettes=T will build vignettes that serve as examples of usage
# however, this will invoke other dependencies that might complicate things.
# It can be set to F to just get the core code installed, but much of the documentation
# effort to date has been in the form of vignettes.
devtools::install_github("convergenceda/visdomloadshape", build_vignettes=T )

Install VISDOM Load Shapes directly from local source

If you are planning to read through, experiment with, or update the VISDOM Load Shapes source code itself, you will want a local copy of the reopsitory on your machine.

First ensure that you have cloned the repository into working version only your local machine, choosing one of:

```{bash eval=F} cd /dev git clone [e-mail]:sborgeson/visdomloadshape.git git clone https://github.com/sborgeson/visdomloadshape.git

If you are working within a corporate firewall, it may be necessary to use a proxy server account to connect to GitHub. Here you will need to replace the user and pass with your usernam and password and `proxy.server` with either the name or ip address of your proxy server. The port `8080` may also be different for your specific configuration.

```{bash eval=F}
git config --global http.proxy http://user:[e-mail]:8080
git config --global https.proxy https://user:[e-mail]:8080

Then using that location as as your working directory (here we assume /dev/visdomloadshape), load requirements for package development and install from source.

install.packages(c("devtools"))

setwd('/dev/visdomloadshape')

devtools::install(build_vignettes = T)

Confirming that the package and documentation is in place

Now check that you can load VISDOM and use it.

library(visdomloadshape)

Browse through the available vignettes.

# if you built them above, you can browse well formatted 
# code vignettes that provide example usage.
browseVignettes('visdomloadshape')

Or the original/old school way.

# to list
vignette(package='visdomloadshape')
# to display a specific one as help
vignette('example_load_shape_analysis',package='visdomloadshape')

ConvergenceDA/visdomloadshape documentation built on May 8, 2019, 8:34 a.m.