Rtcl - A Tcl Extension for Embedding the R Statistical Language

DESCRIPTION

The Rtcl extension embeds an interpreter for the R programming language (see http://www.r-project.org) inside a Tcl interpreter. It provides commands for evaluating R expressions, for importing their values into Tcl, and for determining their type.

REQUIREMENTS

Rtcl requires the following software packages to be installed:

1. Tcl, version 8.6 or newer
2. R, version 3.4 or newer, built with shared libraries

At runtime Rtcl tries to dynamically link the main R shared library from the following locations:

POSIX: ${R_HOME}/lib/libR.so /usr/local/lib/R/lib/libR.so /usr/lib64/R/lib/libR.so /usr/lib/R/lib/libR.so

MacOSX: ${R_HOME}/lib/libR.dylib /usr/local/lib/R/lib/libR.dylib

Win32: %R_HOME%/bin/i386/R.dll %ProgramFiles%/R/R-3./bin/i386/R.dll %ProgramW6432%/R/R-3./bin/i386/R.dll

Win64: %R_HOME%/bin/x64/R.dll %ProgramFiles%/R/R-3.*/bin/x64/R.dll

INSTALLATION

Installation of Rtcl follows Tcl's usual configure/make/make install pattern. A typical installation on Unix will look like:

$ tar xvzf Rtcl1.2.tar.gz
$ cd Rtcl1.2
$ ./configure
$ make
$ make test
$ sudo make install

The configure script accepts a number of options, including:

--with-tcl=tclDir        Directory containing "tclConfig.sh"

USING IT

Fire up your tclsh:

tclsh8.6
% package require Rtcl
1.2

Use man Rtcl for further details.

HISTORY

Versions 0.1 through 0.3 were initially developed and released by Neil McKay on Redhat Linux 8. Versions 1.0 and later were revised and packaged by Matt Adams on FreeBSD 11.

Version 1.2 incorporated changes from Christian Werner as made for Androwish. See http://androwish.org/home/dir?ci=tip&name=undroid/Rtcl for Christian's codebase which is derived from this one.

See ChangeLog for detailed notes.

VERSION NUMBERS

New releases require version number changes in the following files:

README
configure.ac (line 22)
doc/Rtcl.tmml
doc/Rtcl.n
generic/rtcl.c (line 1021)
tests/rtcl.test (line 27)