tpapp / cl-rmath

Common Lisp wrapper for libRmath.

A simple wrapper for libRmath

IMPORTANT This library is unsupported.

This is a simple, autogenerated foreign interface for the standalone R API <a href=” http://cran.r-project.org/doc/manuals/R-exts.html#The-R-API”>libRmath. There has been no effort to provide a high-level interface for the original library, instead, this library is meant to serve as a building block for such an interface.

The libRmath shared library has to be installed for this library to work. For example, on Debian/Ubuntu/…, you just need to

apt-get install r-mathlib

as root.

The function names are preserved as they are. Packages should not use the cl-rmath package, but refer to symbols using the cl-rmath or rmath package qualifiers (in fact, fround is in both cl and cl-rmath, so using the package would require shadowing).

Functions using random number generators are not expected to work out of the box.

It is only necessary to run make when Rmath.h changes.

Bugs and issues should be reported using the Github issue tracker.

The most useful source of documentation is Writing R Extensions, in particular some sections in Numerical analysis subroutines. Note however that only a small subset of the functions documented on that page are part of the standalone library.

cl-rmath's Issues

Dynamic loading of libRmath.so fails on OS X

Loading cl-rmath on OS X (using SBCL 1.0.57.49-d720bc3) fails with the following error message

Unable to load foreign library (LIBRMATH).
  Error opening shared object "libRmath.so":
  dlopen(libRmath.so, 10): image not found.
   [Condition of type CFFI:LOAD-FOREIGN-LIBRARY-ERROR]

This happens because :unix is in *features*, but the dynamic library is called libRmath.dylib on OS X. A simple fix is to change the definition of librmath to

(cffi:define-foreign-library librmath
  (:darwin "libRmath.dylib")
  (:unix "libRmath.so")
  (t (:default "libRmath")))

License not specified

People often complain when it happens. I'm sorry. Please add license note.