+---------------------------+
|  PDL Module Dependencies  | 
+---------------------------+

This file lists dependencies of PDL modules on external programs
or libraries.  Some of the modules will build ok without the
external software but in general are not very useful without it.
Others require certain libraries/include files to be installed.

See INSTALL on hints how to enable/disable building of some modules
in the distribution if required.

The easiest way to resolve dependencies on other Perl modules is
to use the CPAN module to install PDL. Installation should be as
simple as

  cpan install PDL   # if the cpan script is in your path

or if you don't have the cpan script try

  perl -MCPAN -e shell
  cpan> install PDL



+----------------+---------------------+-------------------------------------+
|    MODULE      |     DEPENDS ON      |             COMMENT                 |
+----------------+---------------------+-------------------------------------+

PDL (all)         perl >= 5.8.x           PDL requires at least this version
                                          of perl to build and run.

                  File::Spec              Version >= 0.6 required, included
                                          with perl.


PDL::NiceSlice    Text::Balanced          A nicer way to index piddles.
                  Filter::Util::Call


Inline::Pdlpp     Inline                  Version >= 0.43 required.  This
                                          module allows to define fast PP
                                          code inline in your scripts.


PDL::IO::Dumper   Data::Dumper            Version >=2.121 is required.
                  Convert::UU             Convert::UU is required.

                  uuencode/uudecode       (Optional) Better performance on
                                          unix flavor platforms!  They will
                                          be used instead of Convert::UU
                                          if detected.


PDL::IO::Storable Storable                Version >=1.03 is required.


pdl2   (shell)    Devel::REPL and         Version >= 1.003011
                  Term::ReadLine::Perl    
                  or Term::ReadLine::Gnu 

perldl (shell)    Term::ReadLine::Perl    
                  or Term::ReadLine::Gnu 

                                          pdl2 (and perldl) will be installed
                                          by default.  If Devel::REPL is not
                                          installed, pdl2 uses perldl.  The
					  same thing if a Term::ReadLine::Perl
					  or Term::ReadLine::Gnu is not installed.


PDL::FFTW         Needs the FFTW library version 2 installed.
                  FFTW is a free C FFT library including multi-
                  dimensional, real, and parallel transforms.
                  See http://www.fftw.org/ 

                  NOTE: The latest version of FFTW is FFTW3.

                                          Will *not* be built unless
                                          FFTW version 2 is detected.


PDL::GIS::Proj
PDL::Transform::Proj
                  A PDL interface to the PROJ4 geographic projection
                  library and the PDL::Transform interface to PROJ4.
                  See http://trac.osgeo.org/proj/

                                          Module will be built if the PROJ4
                                          library is installed and detected.


PDL::Graphics::TriD
                  Requires the perl OpenGL module be installed.
                  Perl OpenGL requires you have the OpenGL graphics
                  library and FreeGLUT (Apple GLUT on Mac OS X)
                  installed.  See perldl.conf file for the minimum
                  required version of Perl OpenGL.

                                          PDL::Graphics::TriD will be
                                          built if Perl OpenGL is detected.
                                          To disable the build, edit
                                          perldl.conf and set WITH_3D => 0.


PDL::Graphics::PGPLOT
                  Requires both the PGPLOT perl module **and**
                  the PGPLOT fortran library.  See
                  http://astro.caltech.edu/~tjp/pgplot for the
                  library and
                  http://search.cpan.org/search%3fmodule=PGPLOT
                  for the perl module (on CPAN).
                
                  NOTE: These are two separate items to be installed.
  
                                          PDL::Graphics::PGPLOT Module
                                          builds ok without PGPLOT module
                                          and library.


PDL::Graphics::PLplot
                  The PLplot graphics library.
                  See http://plplot.sourceforge.net 

                                          Module will be built if the
                                          PLplot library is detected.


PDL::Graphics::IIS
                  To be useful an application that supports
                  the 'IIS' protocol must be installed, e.g.
                  SAOimage or Ximtool, see
                  http://tdc-www.harvard.edu/software/saoimage.html
                  http://iraf.noao.edu/iraf/web/projects/x11iraf/

                                          PDL::Graphics::IIS  builds
                                          without viewers.


PDL::Graphics::Karma
                  The Karma interface is *DEPRECATED* and not
                  supported.  Please use another visualization tool.

                                          PDL::Graphics::Karma will
                                          *NOT* be built or installed.


PDL::GSL modules
                  Needs the GSL (Gnu Scientific Library) to
                  build.  Version >= 1.0 is required
                  See http://www.gnu.org/software/gsl/

                                          Will not be built unless
                                          an appropriate GSL version
                                          is installed and detected.


PDL::IO::Browser
                  Requires a 'curses'-compatible library.
                  Build appears to be broken.

                                          Not built by default.


PDL::IO::FITS     Needs Astro::FITS::Header for full support
                  of all FITS header features.  Will build ok,
                  and run, without it but for given that
                  Astro::FITS::Header is a Perl only module, you
                  should install it unless you specifically need not.

                  NOTE: It is currently listed as an official
                  prerequisite module for the purposes of building
                  with the cpan shell.


PDL::IO::GD       PDL interface to the GD image library.
                  See http://www.libgd.org
                                        
                                          Will not be built unless
                                          libgd is already installed
                                          and detected.


PDL::IO::HDF      PDL interface to HDF4 library.  See
                  PDL::IO::HDF5 on CPAN for HDF5 bindings.
                  Not all HDF4 types are supported.
                  See http://www.hdfgroup.org/products/hdf4/

                                          Will not be built unless the
                                          HDF4 libraries are detected.


PDL::IO::NDF      NOTE: These refs/URLs may be incorrect or outdated.

                  Requires the perl/NDF interface, NDFPERL, which
                  also requires a fortran compiler and the fortran
                  NDF library.  Get the STARPERL package from
                  http://starlink.jach.hawaii.edu/starlink where
                  there appears to be a git repository for STARPERL at
                  http://starlink.jach.hawaii.edu/git/?p=starperl.git;a=summary .

                                          Module builds ok without
                                          NDF module and library


PDL::IO::Pic      rpic/wpic: PBM+ or NetPBM converters
                  See http://netpbm.sourceforge.net/

                  wmpeg: requires the ffmpeg program
                  See http://ffmpeg.org/

                                          Module builds ok without
                                          converters but t/pic_16bit
                                          will fail without a recent
                                          enough version of NetPBM.


PDL::Minuit       PDL interface to Minuit minimization routines in
                  the CERN library,
                  http://wwwasdoc.web.cern.ch/wwwasdoc/minuit/minmain.html
                  The Minuit library code is included.  A fortran compiler
                  is required and ExtUtils:F77 (version >= 1.03).

                                          Will not be built unless
                                          ExtUtils::F77 is installed *and*
                                          supports your platform.


PDL::Slatec       Linear algebra routines.
                  Several other PDL modules use PDL::Slatec

                  Slatec fortran lib is included but
                  requires a fortran compiler and
                  ExtUtils::F77 (version >= 1.03).

                                          Will not be built unless
                                          ExtUtils::F77 is installed *and*
                                          supports your platform.
