Rserve client for SWI-Prolog/SWISH

Rserve R-package:

Compiling this package

This library is configured as a SWI-Prolog pack. It can be installed using the command below. The installation requires git, autoconf and the common C++ build tools.

?- pack_install('rserve_client').

This is tested on Ubuntu (14.04 and 16.04). It performs these steps:

Using this package

This package is primarily intended for accessing R in server environments such as SWISH. We created a Docker container that runs Rserve in a sandbox. The container exposes Rserve using a Unix-domain socket at the following address:

/home/rserve/socket

With SWISH and is interface installed in adjacent directories, i.e., below the same parent, R may be linked to SWISH doing

:- use_module(lib/r_swish).

Now, R is not safe. You should either run Rserve in a tight OS container and load library(r/r_sandbox) or run SWISH in authenticated mode by loading lib/authenticate.pl.

Libraries provided

User libraries

library(r/r_call)
Defines basic user API to R
library(r/r_data)
Utilities to create and fetch R data frames

Implementation libraries

library(r/r_expand_dot)
Allow for dots in atoms and functors without quotes.
library(r/r_grammar)
R Parser utilities (lexer) that support R quasi quotations
library(r/r_term)
DCG non-terminal to translate a term into an R command string
library(r/r_sandbox)
Declare the R API sandbox-safe
library(r/r_serve)
Low-level level communication library

Status

This is just a proof of context. Obviously missing functionality:

Related projects

This interface is inspired by Real by Nicos Angelopoulos. Main differences:

Prolog files

pack.plShow source
prolog/r/r_call.pl  -- R plugin for SWISHShow source
prolog/r/r_data.pl  -- R data frame handlingShow source
prolog/r/r_expand_dot.plShow source
prolog/r/r_grammar.pl  -- R parser primitivesShow source
prolog/r/r_sandbox.pl  -- Declare the R API safeShow source
prolog/r/r_serve.pl  -- SWI-Prolog Rserve clientShow source
prolog/r/r_term.pl  -- Translate a Prolog term into an R expressionShow source