RAVE:Launching

From OpenWetWare
(Redirected from RAVE:RAVEGUI Help)
Jump to navigationJump to search
RAVE logo R Analysis and Visualization of iEEG


Launching RAVE

Installing RAVE may create a desktop RAVE shortcut. If so, double-click the icon to launch RAVE. Otherwise, open RStudio and enter the following command into the console:

 rave::start_rave()

A new web browser window should open with the RAVE splash screen. RAVE is developed and tested using Google Chrome: some features in the Volume/Surface viewer, such as recording videos and loading volumetric MRIs, may not work in other browsers.

In the RAVE Toolbar click on Select Data to explore the provided demo data. To load your own data, follow these steps. User interactions with RAVE occur through a web browser.

Shutting down RAVE

Closing the browser window does not affect the RAVE server. To stop the server:

  1. If you launched RAVE by double-clicking a desktop shortcut, close the terminal window.
  2. If you launched RAVE from RStudio, click the red "stop sign" icon in the RStudio window. In RStudio, select "RStudio"/"Quit RStudio". You will be asked "Save workspace image?". Click "Don't Save". To disable asking, select "RStudio"/"Preferences". In the "General" Tab, change "Save Workspace to .Rdata on exit" to "Never".

Shutting down the server will freeze the browser window and it may be closed.

Advanced: Launch RAVE in server mode

To launch a RAVE server, enter the following command on the server machine:

rave::start_rave(host = 'Server_IP_Address', launch.browser=FALSE, port = 1111)

Port numbers 0-1023 are reserved and should not be used but any other port value should be fine. Client computers on the local network can interact with the RAVE server using a web browser:

http://Server_IP_Address:1111

where Server_IP_Address and 1111 match the server values above. A server can host multiple RAVE instances by opening a new RStudio session ("Session"/"New Session") and launching RAVE with a different port number.

Troubleshooting

iEEG files are very large so a common problem is running out of disk space. This can generate errors that are not obviously due to low disk space, such as this one:

Warning in mccollect(jobs = jobs, wait = TRUE) :
 1 parallel job did not deliver a result
x Failed to retrieve the result of MulticoreFuture (<none>) from the forked worker

In the event of errors like this, the first step should be to check the amount of free disk space (on Mac, click on the icon for "Macintosh HD" and type Apple-I to show the amount of free disk space.) To free up space, it is OK to delete any cache files that may have accumulated. They are located in

~/rave_data/cache_dir

The cache directory can also be changed to a disk with more free space, such as a RAID.


How to use RAVE on the BeauchampLab MacPro

Older notes