-
Notifications
You must be signed in to change notification settings - Fork 26
/
install.Rmd
184 lines (123 loc) · 10.6 KB
/
install.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
---
title: Radiant -- Business analytics using R and Shiny
---
Radiant is a platform-independent browser-based interface for business analytics in [R](https://www.r-project.org/), based on the [Shiny](https://shiny.posit.co/) package. Developed by <a href="https://rady.ucsd.edu/faculty-research/faculty/vincent-nijs.html" target="_blank">Vincent Nijs</a>. Please use the issue tracker on GitHub to suggest enhancements or report problems: <a href="https://github.com/radiant-rstats/radiant/issues" target="_blank">https://github.com/radiant-rstats/radiant/issues</a>. For other questions and comments please use [email protected].
> **Note:** R 4.3 or higher is required to use the latest version of Radiant.
> **Note:** User profiles (or user names or logins) containing non-ASCII characters may cause problems during installation. To address this issue please use a profile name (login) that contains ASCII (A-Z, a-z) letters and numbers only. For example, c:\\users\\myprofilename
## Installing R, Rstudio, and Radiant on Windows
<!-- For Windows, download and run the all-in-one installer for <a href="https://rady.ucsd.edu/faculty/directory/vnijs/Rady-Radiant-Installer-Latest.exe">R, Rstudio, and Radiant</a>. If you see a warning message like the image shown below when you run the installer click on "More info" and then on "Run anyway". -->
For Windows, download and run the all-in-one installer for <a href="https://download.rady.ucsd.edu/Rady-Radiant-Installer-Latest.exe">R, Rstudio, and Radiant</a>. If you see a warning message like the image shown below when you run the installer click on "More info" and then on "Run anyway".
<img src="images/win-protected.png" width="300px">
For a video tutorial see the `Install Radiant on Windows` video below:
<iframe width="640" height="375" src="https://www.youtube.com/embed/ZNgwgosdNhM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
> Credits: Thanks go to Brandon Salas (Rady School of Management @ UCSD) for creating the Windows installer and Greg Aujero (Rady School of Management @ UCSD) for updating the installer.
We recommend you use or [Chrome](https://www.google.com/chrome) or [Microsoft's Edge browser](https://www.microsoft.com/en-us/edge) or [Firefox](https://www.mozilla.org/en-US/firefox) as your default browser.
## Installing R, Rstudio, and Radiant on macOS
* If you have a mac with an Intel Chip (models prior to late 2020), that can still run macOS Big Sur (11.7.10) or newer, download and install the latest version of R from <a href="https://cloud.r-project.org/bin/macosx/big-sur-x86_64/base/R-release.pkg" target="_blank">https://cloud.r-project.org/bin/macosx/big-sur-x86_64/</a>
* If you have a mac with an Intel Chip (models prior to late 2020), that cannot be upgraded to macOS Big Sur or newer, you may still be able to run Radiant if you can download and install R 4.2.3, from <a href="https://cloud.r-project.org/bin/macosx/base/R-4.2.3.pkg" target="_blank">https://cloud.r-project.org/bin/macosx/base/R-4.2.3.pkg</a>
* If you have a mac with an ARM chip (models launched after 2020), with macOS Big Sur (11.7.10) or newer, download and install the latest version of R from <a href="https://cloud.r-project.org/bin/macosx/big-sur-arm64/base/R-release.pkg" target="_blank">https://cran.r-project.org/bin/macosx/big-sur-arm64/</a>
Double click on the .pkg file to install and follow the prompts. After R has been installed, open R, copy-and-paste the command below into R, and press return. Accept all default settings during the install process:
```r
source("https://raw.githubusercontent.com/radiant-rstats/minicran/gh-pages/install.R")
```
For a video tutorial see the `Installing R, Rstudio, and Radiant on macOS` video below:
<iframe width="640" height="375" src="https://www.youtube.com/embed/f5h2oDBsnJI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
> Note: It is possible that you will be asked for your password during the install process to correct permission settings for the directory /usr/local/bin. If there is still an error installing `tinytex` please run the command below from the "terminal" app in macOS
```bash
sudo chown -R $(whoami):admin /usr/local/bin; R -e "tinytex::install_tinytex()"
```
## Installing R, Rstudio, and Radiant on Linux
The first step will be to install R and a several additional linux tools. The commands required for Ubuntu 18.04 are shown below:
```sh
sudo apt-get update
sudo apt-get install gpg-agent gdebi-core
## Appends the CRAN repository to your sources.list file
sudo sh -c "echo 'deb http://cloud.r-project.org/bin/linux/ubuntu focal-cran40/' >> /etc/apt/sources.list"
sudo gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys E298A3A825C0D65DFD57CBB651716619E084DAB9
sudo gpg -a --export E298A3A825C0D65DFD57CBB651716619E084DAB9 | apt-key add -
sudo apt-get update
## Install R and required linux tools
sudo apt-get install r-base r-base-dev
sudo apt-get install libssl-dev libcurl4-openssl-dev libxml2-dev libicu-dev \
unixodbc-dev libpq-dev libgdal-dev libproj-dev libcairo2-dev cargo libgsl-dev
## Download and install Rstudio (preview)
wget -O rstudio-amd64.deb https://download1.rstudio.org/desktop/bionic/amd64/rstudio-2022.02.2-485-amd64.deb
sudo gdebi rstudio-amd64.deb
rm rstudio-amd64.deb
```
Run the following command to install the required R-packages for a user:
```r
R -e "source('https://raw.githubusercontent.com/radiant-rstats/minicran/gh-pages/update.R')"
```
To make R-packages available to all users on a linux system run the command below instead:
```r
sudo su -c "R -e \"source('https://raw.githubusercontent.com/radiant-rstats/minicran/gh-pages/update.R')\""
```
To ensure that all packages are available and up to date use:
```r
R -e "radiant.update::radiant.update()"
```
or
```r
sudo su -c "R -e 'radiant.update::radiant.update()'"
```
## Starting, Stopping, and Updating Radiant
I recommend you use Rstudio to run the Radiant application. When you open Rstudio you can start Radiant through the `Addins` menu at the top of the screen `Start radiant (browser)`. If for some reason the `Start radiant (browser)` is not shown in the dropdown, enter `radiant::radiant()` in the Rstudio console. To close the application click the <i title='Power off' class='fa fa-power-off'></i> icon in the navigation bar and then click `Stop`. The Radiant process will stop and the browser window will close or gray-out.
To add an option to upgrade Radiant easily, use the commands below to install the `radiant.upgrade` package. You should now see two new item in the `Addins` dropdown that you can use for future radiant upgrades.
```r
options(repos = c(RSM = "https://radiant-rstats.github.io/minicran", CRAN = "https://cloud.r-project.org"))
install.packages("remotes")
remotes::install_github("radiant-rstats/radiant.update", upgrade = "never")
radiant.update::radiant.update()
```
## Sharing Rstudio projects with others
An excellent way to share an Rstudio project hosted online (e.g., on Dropbox) with others is to use the `usethis` package
```r
install.packages("usethis")
?usethis::use_course
```
As an example, run the command below to download and open an Rstudio project. Note the "1" at the end of the URL instead of Dropbox's default which is "0".
```r
usethis::use_course("https://www.dropbox.com/sh/0dmcr2xsphtn1ha/AADsrYsi8KBkddWx_B-aQbi1a?dl=1")
```
## Installing additional R-development tools
To install additional development tools (i.e., Rtools, git, homebrew) copy-and-paste the command below into R or Rstudio and press return. When installing Rtools, Windows users should make sure to check the option to add Rstools to the system path.
```r
source("https://raw.githubusercontent.com/radiant-rstats/minicran/gh-pages/install_dev.R")
```
## Documentation
Documentation and tutorials for each of the apps are available at <https://radiant-rstats.github.io/docs/> and in the Radiant web interface (the <i title='Help' class='fa fa-edit'></i> icons on each page and the <i title='Help' class='fa fa-question-circle'></i> icon in the navigation bar). See also the [pkgdown](https://github.com/r-lib/pkgdown) documentation sites:
* http://radiant-rstats.github.io/radiant
* http://radiant-rstats.github.io/radiant.data
* http://radiant-rstats.github.io/radiant.design
* http://radiant-rstats.github.io/radiant.basics
* http://radiant-rstats.github.io/radiant.model
* http://radiant-rstats.github.io/radiant.multivariate
Want more help getting started? Watch the tutorials on the [documentation site](https://radiant-rstats.github.io/docs/tutorials.html).
## Trouble shooting
Windows users may need to start R and Rstudio `as administrator`. On rare occasions R(studio) may complain that a package is not yet installed when starting Radiant. If so, install the package mentioned using the command below but replace 'package-that-is-not-yet-installed' with the package name mentioned in the error message
```r
install.packages("package-that-is-not-yet-installed", repos = "https://cran.rstudio.com", type = "binary")
```
or copy-and-paste the commands below into R to check if any required packages have not yet been installed
```r
options(repos = c(RSM = "https://radiant-rstats.github.io/minicran", CRAN = "https://cloud.r-project.org"))
install.packages("remotes")
remotes::install_github("radiant-rstats/radiant.update", upgrade = "never")
radiant.update::radiant.update()
```
If you are having trouble updating Radiant on Windows please (1) Restart Rstudio and (2) run the code below:
```r
options(repos = c(RSM = "https://radiant-rstats.github.io/minicran", CRAN = "https://cloud.r-project.org"))
install.packages(c("fs", "remotes"))
remotes::install_github("radiant-rstats/radiant.update", upgrade = "never")
fs::dir_delete(file.path(.libPaths()[1], "00LOCK"))
radiant.update::radiant.update(options = "--no-lock")
```
Some users have reported that the Malwarebytes software can inappropriately block R-packages from being installed or updated. If you use Malwarebytes and are experiencing problems you can try (temporarily) turning it off during the install process or when upgrading.
If there is an error installing `tinytex` on macOS please run the command below from the "terminal" app:
```bash
sudo chown -R $(whoami):admin /usr/local/bin; R -e "tinytex::install_tinytex()"
```
## Reporting issues
Rady students can report any issues they might have with Radiant on Piazza. Otherwise, please use the GitHub issue tracker at <a href="https://github.com/radiant-rstats/radiant/issues" target="_blank">github.com/radiant-rstats/radiant/issues</a>.