PDL Module Dependencies
=======================

This file lists dependencies of PDL modules on external
programs/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 distrib 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.6.2           you need at least this version
                (5.8.x recommended)     of perl to succeed.

                File::Spec              version >= 0.6 required, included
                                        with recent perls (5.6.x and higher)

PDL::NiceSlice  Text::Balanced          a nicer way to index piddles
                Filter::Util::Call      a must-have!!

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

PDL::IO::Dumper Data::Dumper and        Data::Dumper version >=2.121 is required
                Convert::UU and         Convert::UU is required but Works on all perl platforms!
                uuencode/uudecode       (Optional) Better performance on unix flavor platforms!

PDL::IO::Storable Storable              version >=1.03 is now listed as a
                                        required dependency

perldl (shell)  Term::ReadLine          perl provides a stub but if you
                                        compile and install a better one
                                        (Term::ReadLine::Perl or Term::ReadLine::Gnu)
                                        you get proper command line editing



PDL::FFTW
                Needs the FFTW version 2 installed.  FFTW is a free C
		FFT library including multi-dimensional, real, and
		parallel transforms.  NOTE: the released version of
		FFTW is currently FFTW3.  You'll need to explicitly
		install the FFTW v2 library to build PDL::FFTW!
		See http://www.fftw.org/

                                        Will not be built unless
                                        FFTW version 2 is installed.

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

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

PDL::Graphics::TriD
                Requires Perl OpenGL module and FreeGLUT (Apple GLUT on Mac OS X)
                See perldl.conf file for the required Perl OpenGL version.

                Also requires the OpenGL graphics libraries be installed, although
		the Perl OpenGL module should check for that.  For a free software
		implementation check out Mesa at http://www.mesa3d.org/

                                        Perl OpenGL is required.  To disable
					edit perldl.conf and unset WITH_3D
					and USE_POGL (see INSTALL).

PDL::Graphics::PGPLOT
                PGPLOT perl module **and** PGPLOT fortran library,
                see http://astro.caltech.edu/~tjp/pgplot for the library
                and CPAN at http://search.cpan.org/search%3fmodule=PGPLOT
                for the perl module.  NOTE: These are two different things
		that must be installed.

                                        Module builds ok without
                                        PGPLOT module and library

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

                                        Module builds ok without
                                        PLplot module and library

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 builds without viewers.

PDL::Graphics::Karma
                The Karma interface is deprecated.  Please use another
		visualization method.

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
                                        GSL is installed.

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

PDL::IO::Browser
                Requires a 'curses'-compatible library
                not built by default (edit perldl.conf to enable).  Build
                appears to be broken for many platforms.

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.
                It is currently listed as a prerequisite module for the
                purposes of building with the cpan shell.

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
                 http://netpbm.sourceforge.net/

                wmpeg: mpeg_encode program,
                  see http://bmrc.berkeley.edu/ftp/pub/multimedia/mpeg/encode/

		NOTE: mpeg_encode may no longer be available.

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


PDL::Minuit     ExtUtils::F77           PDL interface to Minuit minimization
                                        routines in CERN library, see the link at
                                        http://wwwasdoc.web.cern.ch/wwwasdoc/minuit/minmain.html

	        The Minuit library code is included but requires a
		fortran compiler and the ExtUtils::F77 (version >= 1.03)
		to be built.

                                        Will not be built unless
                                        ExtUtils::F77 (version >= 1.03)
                                        is installed and Extutils::F77
                                        supports your platform.

PDL::Slatec     ExtUtils::F77           linear algebra routines
                                        several other modules use PDL::Slatec

                Slatec fortran lib is included but requires a
                fortran compiler and the perl module ExtUtils::F77
                (version >= 1.03) to be installed.

                                        Will not be built unless
                                        ExtUtils::F77 (version >= 1.03)
                                        is installed and Extutils::F77
                                        supports your platform.

Perldl2        Devel::REPL and          The new perldl shell in development
               Term::ReadLine           requires Devel::REPL version 1.003010
	                                or higher be installed.  Term::ReadLine
					is also required (either Perl or Gnu).
					PDL will build without these deps.
