Chart::XMGR
-----------

This module provides a perl/PDL interface to the XMGR plotting package. 
Can be used to plot PDLs or Perl arrays.

A simple function interface is provided that is based on the
more complete object-oriented interface.


Requirements
------------

This module is written entirely in perl (no XS) but does require that
the PDL::Options module is installed. This is available as part of the
PDL distribution (http://pdl.perl.org) or separately in the PDL
directory on CPAN (e.g. in my author directory).

In addition to this module, the XMGR plotting tool is also required.
This can be downloaded from the XMGR web page (note that this module
will probably not work with GRACE [XMGR v5]. The XMGR/GRACE home
page is at http://plasma-gate.weizmann.ac.il/Xmgr/ .

This module also requires a version of perl containing the IO::Pipe
and IO::File modules (tested with 5.00404). The named
pipe facility also requires that the POSIX::mkfifo command is supported
If POSIX::mkfifo is not available then the named pipe option will not
be available (and the npipe.t test will fail).


Building and installation
-------------------------

This package uses the standard CPAN installation system:
Unpack the distribution, change to the module directory and

  % perl Makefile.PL
  % make
  % make test
  % make install

The first command will fail if PDL::Options is not available.
The test script will launch XMGR and send some data to it. Each
test (one using simple pipes the other using named pipes) will launch
an XMGR process -- this process must be exited before the further
tests will start.

Full documentation can be found in the XMGR.pm file using POD.

Author and Copyright notice
---------------------------

Copyright (C) Tim Jenness 1998,1999 (t.jenness@jach.hawaii.edu).  All
rights reserved. This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.
