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).
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.
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)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.
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.
The path(s) obtained are also the path you put into the “Search path of CornerstoneR package:” field of “File -> Preferences -> RScript” in Cornerstone.
In case the user has no web access, it is advised to download following needed/suggested packages and install them by hand.
| Suggested Packages | Version | CRAN Link |
|---|---|---|
| knitr | 1.38 | https://cran.r-project.org/web/packages/knitr/index.html |
| prettydoc | 0.4.1 | https://cran.r-project.org/web/packages/prettydoc/index.html |
| rmarkdown | 2.13 | https://cran.r-project.org/web/packages/rmarkdown/index.html |
| markdown | 1.1 | https://cran.r-project.org/web/packages/markdown/index.html |
| roxygen2 | 7.1.2 | https://cran.r-project.org/web/packages/roxygen2/index.html |
| testthat | 3.1.3 | https://cran.r-project.org/web/packages/testthat/index.html |
| DiceDesign | 1.9 | https://cran.r-project.org/web/packages/DiceDesign/index.html |