Files in undroid/Rtcl/ of trunk
Not logged in

Files in directory undroid/Rtcl from the latest check-in of branch trunk


	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.1.tar.gz
    % cd Rtcl1.1
    % ./configure
    % make
    % make test
    % su
    password:
    # make install
    # ^D
    %

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.1

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.

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
tests/rtcl.test (line 27)