The rserve script populates locale rserve with the core methods for communicating with R. Load with:
Each method begins with prefix "rd" (R driver).
rdopen open connection to R (if not already open) rdclose close connection rdcmd send command, wth no response rdget send command, return response in map format rdgetexp send command, return response in SEXP format rdset set name in R to value. Form is: name(s) Rset value(s)
A corresponding set of interactive methods is defined in z, with names prefixed 'R', for example:
See Formats for an explanation of the different result formats.
Rserve methods return only their results, and not a returncode.
If an error occurs, such as a bad format in an Rserve result, then:
- an error message is written to noun throwtext_rserve_
- if debug is on (13!:0[1) and noun FORCETHROW_rserve_ is 0, then the error message is displayed in a information box and a stop is put on all verbs in the stack. This suspends the current verb and allows the state to be examined.
This appropriate for development purposes.
- otherwise, the error message is written to the J session, and a throw. is executed. This is appropriate for production use, and means that a sequence of calls to R should be wrapped in a try./catcht. block.