CornerstoneR package provides generic R scripts which enable you to use existing R routines in Cornerstone.

The desktop application Cornerstone is a data analysis software provided by camLine that empowers engineering teams to find solutions even faster. The engineers incorporate intensified hands-on statistics into their projects. They benefit from an intuitive and uniquely designed graphical Workmap concept: you design experiments (DoE) and explore data, analyze dependencies, and find answers you can act upon, immediately, interactively, and without any programming.

While Cornerstone’s interface to the statistical programming language R has been available since version 6.0, the latest interface with R is even much more efficient. Cornerstone release 7.3 allows you to integrate user defined R packages directly into the standard Cornerstone GUI. While CornerstoneR version 3.0.0 and 3.1.0 are only supported by Cornerstone version 7.3, CornerstoneR 2.0.2 is supported since version 7.1.2.1. Your engineering team stays in Cornerstone’s graphical working environment and can apply R routines immediately and without the need to deal with programming code.

Learn how to use R packages in Cornerstone 7.1 on camLineTV YouTube channel (available in German).

## Installation

The installation of ‘CornerstoneR’ is written from the perspective of a ‘Cornerstone’ user. A successful installation and licensing of ‘Cornerstone’ is required. No experience with ‘R’ is expected.

1. Download ‘R’, click on ‘Download R for Windows’ and ‘base’ on the following page. You will then be taken to a page from which you can download the current version of ‘R’ (currently R is supported until version 4.1.3 (https://cran.r-project.org/bin/windows/base/old/)). Execute the file and follow the installation instructions.
2. Start ‘R’. A window with blue text and the title ‘R Console’ is displayed which is embedded in a window with the title ‘RGui’. This is the default environment of ‘R’ where you install packages and execute commands directly in ‘R’.
3. Now install ‘CornerstoneR’ using one of the options from the following sections. When asking for a download mirror you can decide freely. The first ‘cloud’ link automatically redirects to servers worldwide, and is currently sponsored by ‘RStudio’.
4. When packages are installed for the first time, you are asked if you want to install them into your private library. Answer this question with Yes.

### CRAN Version

Packages at CRAN (Comprehensive R Archive Network) are precompiled and checked by the R Team. The package ‘CornerstoneR’ will be updated on CRAN when new versions are released. Currently the CornerstoneR version on CRAN is 2.0.2.

Install the version from CRAN by copying and executing the following command in the R console.

install.packages("CornerstoneR")

Start Cornerstone and check under “File->Preferences->RScript” in the field “Search path of CornerstoneR package:” if the path to the CornerstoneR package is correct.

To check if everything worked correctly run “Show Versions” from following menu in a Dataset “Analyses -> CornerstoneR -> Show Versions”. It can happen that you get an error about some missing packages. To install them, simply type the following command in the R console until all missing packages are installed.

install.packages("NameOfMissingPackage")

To update all packages from CRAN, first close ‘Cornerstone’ and ‘R’. Afterwards open ‘R’ and run the following command

update.packages(ask=FALSE)

### Development Version

The latest features are available in the development version of ‘CornerstoneR’. Your feedback is integrated into the development process and can be tested in this version.

For the development version from GitLab we use remotes. Install the development version by copying and executing the following two commands in the R console.

install.packages("remotes")
remotes::install_gitlab("camLine/CornerstoneR", dependencies = TRUE, build_opts = c("--no-resave-data", "--no-manual"))

Sometimes it is necessary to install certain versions, for example from a specific branch. To install a certain branch, commit, or tag append the corresponding name after an @ to the repository name:

remotes::install_gitlab("camLine/CornerstoneR@name", dependencies = TRUE, build_opts = c("--no-resave-data", "--no-manual"))

To update the development version, first close ‘Cornerstone’ and ‘R’. Afterwards open ‘R’ and run the installation command again.

### Tips and Tricks Installation

If you need to install the R package into a different folder use:

install.packages("CornerstoneR", lib= "C:\\Your\\Foldername")

Please ensure, that CornerstoneR and all needed packages are in the same folder. You can find the folder paths by typing the following into the R console and then checking manually for package names.

.libPaths()

The path(s) obtained are also the path you put into the “Search path of CornerstoneR package:” field of “File -> Preferences -> RScript” in Cornerstone.

### Offline Installation

In case the user has no web access, it is advised to download following needed/suggested packages and install them by hand.

checkmate 2.0.0 https://cran.r-project.org/web/packages/checkmate/index.html
data.table 1.14.2 https://cran.r-project.org/web/packages/data.table/index.html
minpack.lm 1.2-1 https://cran.r-project.org/web/packages/minpack.lm/index.html
ranger 0.13.1 https://cran.r-project.org/web/packages/ranger/index.html
rpart 4.1.16 https://cran.r-project.org/web/packages/rpart/index.html
rpart.plot 3.1.0 https://cran.r-project.org/web/packages/rpart.plot/index.html
SpatialTools 1.0.4 https://cran.r-project.org/web/packages/SpatialTools/index.html
car 3.0-12 https://cran.r-project.org/web/packages/car/index.html
gdata 2.18.0 https://cran.r-project.org/web/packages/gdata/index.html
ggplot2 3.3.5 https://cran.r-project.org/web/packages/ggplot2/index.html
ggmosaic 0.3.3 https://cran.r-project.org/web/packages/ggmosaic/index.html
mcp 0.3.2 https://cran.r-project.org/web/packages/mcp/index.html
stringr 1.4.0 https://cran.r-project.org/web/packages/stringr/index.html
survival 3.2-13 https://cran.r-project.org/web/packages/survival/index.html
corrplot 0.92 https://cran.r-project.org/web/packages/corrplot/index.html
lubridate 1.8.0 https://cran.r-project.org/web/packages/lubridate/index.html
laGP 1.5-6 https://cran.r-project.org/web/packages/laGP/index.html
DoE.base 1.2 https://cran.r-project.org/web/packages/DoE.base/index.html
flexsurv 2.1 https://cran.r-project.org/web/packages/flexsurv/index.html