
This package replaces the standard Octave 2d plotting functions with
new ones which use Grace (http://plasma-gate.weizmann.ac.il/Grace/).

Installation with Octave-forge
------------------------------

The default Octave-forge installation puts the m-files to 

/usr/share/octave/<octave-version>/site/octave-forge-alternatives/m/graceplot/

which is not in the default loadpath. Functions grace_octave_path.m
and toggle_grace_use.m can be used to set the m-file path (the default
is as above) and toggle the use of Grace. These two functions are
installed to

/usr/share/octave/<octave-version>/site/m/octave-forge/graceplot/

which is in the default loadpath.

On a normal Octave-forge installation, no manual setting of paths is
needed, just type "toggle_grace_use" to Octave prompt. This overrides
the default plotting functions. To start using gnuplot, type
toggle_grace_use again.

If this does not work, try the manual installation instructions below.

Manual Installation
-------------------

1. 
Get Grace from 
http://plasma-gate.weizmann.ac.il/Grace/ 
(or from Debian package grace) and check that it works and is available on
your $PATH.

2.
Compile the interface plugin:

$ cd grplot
$ mkoctfile __grcmd__.cc

3.
copy all the m-files and the oct-files to a directory which is _not_ in your
Octave LOADPATH.

$ cp *.m *.oct $HOME/grace-octave

4.
Run the install.sh in this directory. It creates the necessary symlinks to
__grcmd__.oct.

$ bash install.sh

5. 
Copy the m-files toggle_grace_use.m and grace_octave_path.m to a directory
which _is_ in your Octaves LOADPATH.

$ cp toggle_grace_use.m grace_octave_path.m $HOME/octave

6. 
Put the line

grace_octave_path("<grace-octave-dir>")

to your .octaverc, where <grace-octave-dir> is the directory you copied all
the m-files into.

7.
Start Octave and run the script toggle_grace_use. You should see something
like this:

octave:1> toggle_grace_use
Use Grace: on
octave:2>

8.
Try some 2d-plots:

octave:2> x = linspace(0, 2*pi,100)'; plot(x, sin(x))

9.
Report bugs to tpikonen@pcu.helsinki.fi


Teemu Ikonen <tpikonen@pcu.helsinki.fi> 
21.8.2003
