R

The R.classes bundle

(R.oo and friends)

version 0.62, 2001-2005

Henrik Bengtsson
Mathematical Statistics, Centre for Mathematical Sciences
Lund University, Sweden


Table of Content


1. Introduction

The R.classes bundle contains several packages where the R.oo package [1] is the most import one because it provides a object-oriented core with support for reference variables. The current version of R.classes contains the following package:

R.oo R.audio R.basic R.batch R.colors R.graphics R.image R.io R.lang R.matlab R.ui

Note that R.base is made obsolete and replaced by R.basic. Loading R.base will load R.basic and give a warning. Some of the other packages, especially R.tcltk, R.util and R.lang, contain just trial and proof-of-concept code that should not be taken too serious. In other words, do not expect those packages to ever be completed.

2. Installation

Since all packages were written in 100% R it means that the installation is straight forward. The R.oo package is part of a bundle of packages called R.classes and for now the package R.oo is only available by downloading and installing the whole bundle. The change log of the R.classes bundle is found in the HISTORY, which is also distributed with the bundle.

R.classes is no longer built for R v1.9.1 and before. The rule of thumb is that we test and build it for the current and the previous version of R.

To download and install the R.classes bundle in one step, call

install.packages("R.classes", contriburl="http://www.maths.lth.se/help/R/R.classes/")
Note the new URL (only for the R.classes bundle). /HB 2005-06-28

from within [R]. Verify by loading the R.oo package, e.g. library(R.oo).

2.1 Installation on Mac OSX w/ Aqua Rv2.0.0

With R v2.0.0 on Mac OSX with Aqua, installation of bundles does currently (2004-11-05) not work out of the box. The R/Aqua maintainer Stefano Iacus is working on this. He has kindly suggested the following workaround for now:

  1. Authenticate as root from within the Aqua GUI (i.e. click on the "lock").
  2. install.packages("R.classes", contriburl="http://www.maths.lth.se/help/R/R.classes/", lib=.libPaths()[2]). This will install the bundle inside the framework.
Note the new URL (only for the R.classes bundle). /HB 2005-06-28

For more information, see R-SIG-Mac email thread [R-SIG-Mac] RE: R.matlab.

If the above for some reason does not work, you can always download (*.tar.gz) the bundle by hand and then call

R CMD INSTALL R.classes_0.62.tar.gz

Some reported that it seems necessary to "authenticate as root in the GUI".

2.2 Troubleshooting

If you get an error on "cannot open URL ... *.tgz", then try to do oopt <- options(pkgType="source") before calling the above commands. This should download *.tar.gz files instead. When done, reset option with options(oopt).

2.3 Manual download and installation

If the above instructions should not work (for unknown reasons), it is also be possible to download and install the package manually. Download the Windows binary distribution (*.zip) or the non-Windows source distribution (*.tar.gz) to the working directory. From withing R run install.packages("R.classes.zip", CRAN=NULL) or install.packages("R.classes_0.62.tar.gz", CRAN=NULL) depending if you running Windows or not.

2.4 Update packages

For future updates do

update.packages(contriburl="http://www.maths.lth.se/help/R/R.classes/")
Note the new URL (only for the R.classes bundle). /HB 2005-06-28

3. License

It is still to be decided if the R.classes bundle should be published under either the GNU General Public License (GPL) or the GNU Lesser General Public License (LGPL). It will be the one that will be most useful for everyone.

4. Citing this document

Whenever using the R.oo package please cite according to:

@InProceedings{HBengtsson_DSC2003,
  author       = "Henrik Bengtsson",
  title        = "The {R.oo} package - Object-Oriented Programming with
                  References Using Standard {R} Code",
  booktitle    = "Proceedings of the 3rd International Workshop on 
                  Distributed Statistical Computing (DSC 2003)",
  address      = "Vienna, Austria",
  editor       = "Kurt Hornik and Friedrich Leisch and Achim Zeileis",
  month        = "March",
  year         = "2003",
  issn         = "1609-395X",
  howpublished = "http://www.ci.tuwien.ac.at/Conferences/DSC-2003/"
}

References

[1] Henrik Bengtsson, The R.oo package - Object-Oriented Programming with References Using Standard R Code. In Kurt Hornik, Friedrich Leisch and Achim Zeileis, editors, Proceedings of the 3rd International Workshop on Distributed Statistical Computing (DSC 2003), March 20-22, Vienna, Austria.
http://www.ci.tuwien.ac.at/Conferences/DSC-2003/

About this page

This page was dynamically generated. In other words, you can trust that the version number shown, the list of contained packages of the bundle and the files linked to, reflect the latest version of the R.classes bundle.