# Test the Embeddable R Library

This a collection of tests for verifying that using R as a library within another application (i.e. embedded R) works for this installation. This is only relevant if one has configured R with the `--enable-R-shlib` argument for the top-level `configure`.

More information can be found at the R Developer's site

### Test Applications

- Rtest
  Just prints the vector `c(1, 2, ..., 10)`
- Rplot
  Creates a basic plot of `c(1,2,..., 10)` in the default device and then quits immediately.
- Rpostscript
  Produces a plot of `1:100` using the Postscript graphics device. This creates a file named `Rplots.ps`
- Rerror
  Reads a function definition from an external file (`code.R`) and calls it which in turn generates an "error" via `stop()`. The local error handler defined for this application catches this error and recovers.
- RNamedCall
  Calls a function with some named arguments.
- RParseEval
  Parses a string and evaluates the resulting expression(s).
- Rpackage
  Invokes `example()` for functions in ctest and mva to ensure that packages can be loaded into R in an embedded context. These packages must be linked against libR.so.
- embeddedRCall.c
  Collection of routines used in the different tests.
- Other Tests
  This has been tested in many other situations including the some of the Omegahat packages:
  - As a procedural language within Postsgres. See R in Postgres
  - SJava
  - SNetscape
  - SXalan
  - SXalan
  - RSPython
  - RSPerl
  These can be used as example code for embedding R within other applications.

Duncan Temple Lang <duncan@research.bell-labs.com> Last modified: Sat Jan 12 2008