rchitect 0.3.16

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 reinvent the wheel?

You may be curious why I reinvented the wheel 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 python 2.7 and 3.5+.

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

How to specify R_HOME location

If rchitect fails to open the R shared library, user should first try to expose the path to R to the PATH vaiable.

In Linux/macOS, you could also export the environment variable R_HOME. For example,

$ export R_HOME=/usr/local/lib/R

Sometimes, you may also need to futher specify LD_LIBRARY_PATH if R fails to find some shared libraries,

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

Please also make sure that R was installed with the R shared library libR.so or libR.dylib or libR.dll. On Linux, the flag --enable-R-shlib may be needed to install R from the source.

Microsoft Store python

It is known that rchitect doesn't work with python from Microsoft Store.

Wiki

reticulate conversions