Deprecated methods for installing RAVE
Additional Demo data
RAVE includes time series data from one subject for single subject processing and collated data from many subjects for learning group analysis. Additional time series data can be obtained with
options('timeout' = 100000); rave::download_sample_data('XX')
Where XX is one of the following: KC, YAB, YAD, YAF, YAH, YAI, YAJ, YAK (~ 1GB per subject). For sample data included with RAVE, XX is 'DemoSubject' and '_group_data'.
By default, R limits the amount of time a script can attempt to download a file to 60 seconds. Depending on your Internet connection speed, demo datasets may not download within 60 seconds. You can increase the download timeout by setting a global option. The options('timeout' = 100000) command sets the timeout to 100,000 seconds (27 hours), long enough for even slow connections. You can query the current timeout with:
Mac Install via script (recommended for Intel Macs only)
This script has only been tested with Catalina (MacOS 10.15). May not work with newer OS or Mac. For the new Mac architecture with Apple silicon (instead of Intel) follow the full installation guide. The forthcoming R version 4.1 is expected to include a native Apple silicon binary. Until then, R will use Apple's Rosetta2 Intel emulation.
- After download, find the file "rave-installer-macosx.command.zip" in the "Downloads" folder.
- If it has not automatically been unzipped, double-click to extract the file named "rave-installer-macosx.command".
- To run the the commands in the script, right click (with no right mouse button, hold down the control key on the keyboard and click the mouse button or trackpad) on the file to bring up an actions menu and select the first choice, "Open". The warning "rave-installer-macosx.command is from an unidentified developer. Are you sure you want to open it?" will be presented, choose "Open" to proceed. If "Open" is not shown (only "OK") you may have left-clicked instead of right-clicked on the installer script. Select "OK" and try again.
The script installs R, RStudio, RAVE and all dependencies including the 3D Viewer, the N27 brain and demo data. You will be asked various "Do you accept this license?"-type questions along the way. The installer will place a "RAVE" icon on your desktop. Double-click the icon to launch RAVE.
Mac Install via package
Installation via package can be useful in some cases, such as a computer that is not connected to the Internet; the package can be loaded on the machine with a USB key. This script has only been tested with Catalina (MacOS 10.15) and may not work with other OS versions.
- Download the RAVE installer package from https://github.com/beauchamplab/ravecmd/raw/main/osx/RAVE%20Bundled%20Installer/build/rave-bundled-installer-1.0.2.pkg. Double click on the package, Click "Continue", then click "Install." You will be prompted for your Mac password, as when installing any other software. You should be rewarded with the message "The installation was successful." Click "Close". You will be given the choice to move the Installer to "Trash"; either option is fine. These steps will place the installer in the /Applications folder.
- Click anywhere on the Mac desktop to go the Finder. Click "Go/Applications" in the menu bar to open the Applications folder. Open the /Applications/RAVE folder, then double-click on the "RAVE Bundled Installer" icon (you will be prompted for your Mac password, as when installing any other software).
- If asked, click "Accept" to install the Apple Xcode command line toolbox. Drag the RStudio icon to the /Applications folder. (These steps are optional but recommended).
- Verify that the installation is complete by waiting until the "[Process completed]" messages appears in the console window. This may take ~30 minutes.
- Go to Finder and find the /Applications/RAVE/bin folder. Click on the "rave" icon to launch the main application.
- To install demo data, double-click on "rave-demo-data" located in /Applications/RAVE/bin (optional but recommended)
- To update RAVE, simply repeat the steps above. To ONLY update the utility scripts in /Applications/RAVE/bin double-click on "Update Scripts".
For the latest experimental features, install the development build. Check GitHub for latest versioning information.
devtools::install_github('beauchamplab/ravebuiltins@migrate2') devtools::install_github('beauchamplab/rave') devtools::install_github('dipterix/threeBrain') devtools::install_github('dipterix/dipsaus')
These packages have more recent versions available. It is recommended to update all of them. Which would you like to update?
Restart the RStudio session after installing the new version.