$R_HOME/bin/libR.so. To do this, reconfigure and recompile R using the commands
./configure --enable-R-shlib any other arguments make
To install this package, you will also need the source code for gnumeric. I have used version 0.64 for the original implementation and, more recently, versions 1.0.1, 1.0.8 and 1.0.10. The plugin may work with earlier versions, but there is not guarantee. We would appreciate hearing of any problems and successes (firstname.lastname@example.org). Gnumeric has its own dependencies which we will not describe here.
You need the source code for Gnumeric since a plugin needs access to header files that are not installed when Gnumeric is installed on your machine. Note that you must ensure that the Gnumeric source corresponds to the version that you run. Ideally, you should download the most recent version of Gnumeric and build and install it from source. Not only will you need the source of Gnumeric, but also its gnumeric-config.h file which is generated when you configure the source for building.
At this point, let's assume you have the Gnumeric source and a running Gnumeric. You will need to tell the configuration script for this R package where the directory containing the Gnumeric source is located. The directory of interest is the one containing the src/, plugins/ and po/ directories of the gnumeric source. If you download the Gnumeric source and simply un-tar it, the resulting top-level directory is the one we need.
There are two ways to specify this location.
The first is by setting the environment variable
to the fully qualified name of the that directory.
The second is to specify it as a command line argument
This is done
as the value of the
of the configure script.
Since configure is invoked via the R INSTALL command,
passing an argument to it is slightly more complicated.
This is done as
R CMD INSTALL --configure-args='gnumeric/directory/' RGnumeric
The compilation also requires access to the file named
gnomesupport.h that is installed with the gnome libraries. The
configuration script attempts to find this in a variety of different
ways. As a last resort, it explicitly looks for it in the directory
/usr/local/lib/gnome-libs/include/. If it is not found,
the configuration will fail. In that case, you can specify the
directory in which it is available using the environment variable
.gnumeric/version-number/plugins/R. To install it in a different place, specify the target directory by setting the environment variable
cleanup script will copy the file
plugin.xml in this distribution to the installation
directory where gnumeric looks for plugins. It will also create a
symbolic link to the shared library in the installed R library
To perform this installation as part of the R installation,
R CMD INSTALL with the
R CMD INSTALL -c RGnumeric_0.1-0.tar.gzAt this point, Gnumeric should be able to see the plugin.
LD_LIBRARY_PATHenvironment variable includes the directory in which libR.so is located. This is in
$R_HOME/bin/and you can find the value of
R_HOMEvia the command
Now you are ready to run Gnumeric and activate the plugin. Start
Gnumeric by issuing the command
gnumeric. Then, click on
the Tools menu and select Plug-ins.... This dialog
window allows you to scroll through the list of available plugins, the
top component showing the already active ones and the lower component
showing the currently inactive ones. If the entry
Plugin is not in the Active plugins box, click on it in the
Available inactive plugins box and then click the Activate
plugin button to the right. If all goes well, the R Plugin
entry should now be in the top component of the window indicating it
is active. Check the terminal console for any error messages and look
at the FAQ for how to deal with them. Please note that you will only
need to do activate the plugin once.
examples/directory. You will need to set the environment variable
examples/directory of the installed library. Please read QuickOverview.