rchitect 0.3.0

Mapping R API to Python

Interoperate R with Python

Installation

# install released version
pip install -U rchitect

# or the development version
pip install -U git+https://github.com/randy3k/rchitect

Why?

Why writing another package when there is rpy2?

The main reason is to drive radian. rpy2 was not suitable because it is missing some key features for running the R REPL. Speaking of compatibility, rchitect has been thoroughly tested on multiple platforms such as Windows, macOS and Linux and we also provide binary wheels for user convenience.

Getting started

from rchitect import *
a = reval("1:5")     # evaluate an R expression in the global environment
b = rcopy(a)         # convert any RObject returned by `reval` to its python type
c = robject(b)       # convert any python object to its R type
d = rcall("sum", c)  # call an R function. Python objects are converted to RObjects implicitly.

FAQ

Sometimes, rchitect may fail to open the R shared library. User could first try to expose the path to R to the PATH vaiable. In Linux/macOS, one could also specify R_HOME explictly:

export R_HOME=/usr/local/lib/R

Note that it should be the path to R_HOME, not the path to the R binary. In Linux, you may need to futher specify LD_LIBRARY_PATH,

export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:`R RHOME`/lib"

Wiki

reticulate conversions