Installation

This section discusses how to install and use the RserveClient library.

Prerequisites

For this code to do anything useful, you will need access to an Rserve server.
Instructions for downloading and configuring this to work with R are available at the Rserve documentation site.

Ideally, you will have an Rserve server available at the standard port (6311) on localhost when you install the Statistics::RserveClient module.

Note: if you wish to use RserveClient to generate graphics (e.g., plots), the build of R used with Rserve should be compiled with the --use-cairo option to enable bitmap generation. This is the most common cause of images failing to display.

Installation

The easiest way to install the latest release of this code is to use CPAN. For example, from a Linux/Unix shell:

cpan install Statistics::RserveClient

Testing

A number of tests are provided, and will run at install time if an Rserve server is available at localhost, as described above.

You can run tests from the build directory (for a CPAN install) or root directory of the distribution as follows:

    cd lib;
    prove -rv ../t

This root directory also contains a small shell Rshell which can be used interactively to send queries to R and display the results.