Installing PDL on Windows
|Line 7:||Line 7:|
Then install the PGPLOT (optional), OpenGL (
Then install the PGPLOT (optional), OpenGL () and PDL modules by running, from the command line:
ppm install http://www.sisyphusion.tk/ppm/OpenGL.ppd
ppm install http://www.sisyphusion.tk/ppm/OpenGL.ppd
Revision as of 03:05, 30 January 2012
These instructions relate only to perl 5.8 and later. (For 64-bit builds of perl, ppm packages are provided only for perl versions 5.10 and later.) PDL is not supported for perl versions prior to 5.8.0. It's also assumed that you have the PPM utility. If you don't have PPM then you can either install it from CPAN or you'll have to build PDL from source. (To build from source, see Win32\INSTALL in the PDL source distro.)
First up install Astro::FITS::Header and Convert::UU by running:
ppm install Astro-FITS-Header ppm install Convert-UU
Then install the PGPLOT (optional), OpenGL (prerequisite) and PDL modules by running, from the command line:
ppm install http://www.sisyphusion.tk/ppm/OpenGL.ppd ppm install http://www.sisyphusion.tk/ppm/PGPLOT.ppd ppm install http://www.sisyphusion.tk/ppm/PDL.ppd
That will give you the latest stable release of PDL. If, instead, you want the latest devel release:
ppm install http://www.sisyphusion.tk/ppm/PDL_dev.ppd
For all of these packages, you can find out which version of the module is being provided by going to http://www.sisyphusion.tk/ppmindex.html and scrolling down to the appropriate entry.
OpenGL ppm packages are also available from other repos, but those packages are usually built against a dynamic freeglut library and they don't work well with the above PDL packages (which expect a static freeglut library). If installing OpenGL, it's therefore advisable to install from the sisyphusion repo, as above.
Having installed the relevant ppm package, PLPLOT and PROJ4 support is enabled by setting the PLPLOT_LIB and PROJ_LIB environment variables to the location of the plplot_supp and proj_supp folders (respectively). The ppm post-install script will terminate with a message that tells you the settings these environment variables should take on. (If you missed the message, the two folders will be in your perl/site/lib directory - eg, for most builds of ActivePerl the PLPLOT_LIB environment variable needs to be set to C:\perl\site\lib\PDL\plplot_supp, and PROJ_LIB needs to be set to C:\perl\site\lib\PDL\proj_supp.)
Installing ffmpeg will enable the creation of mp4 and animated gif files, whereby one can turn a piddle of images into a movie. For a demo of this feature, create an mp4 file (bounce.mp4) by running the Example/IO/wmpeg.pl that ships with the PDL source. The requisite ffmpeg binaries are available from a number of places, including(at time of writing):
but googling for 'ffmpeg download' should turn up useful hits if those 2 links become dead in the future.
Once PDL has been installed, the following PDL-based packages (available from CPAN, but not part of the "core" PDL distribution) can also be installed:
ppm install http://www.sisyphusion.tk/ppm/PDL-IO-HDF5.ppd ppm install http://www.sisyphusion.tk/ppm/PDL-NetCDF.ppd ppm install http://www.sisyphusion.tk/ppm/PDL-Stats.ppd ppm install http://www.sisyphusion.tk/ppm/PDL-Audio.ppd and, for 64-bit perls only: ppm install http://www.sisyphusion.tk/ppm/PDL-LinearAlgebra
The PDL::Graphics::PLplot module is 'dual-lived' - ie, in addition to shipping with the above PDL ppm packages, it also exists as an extension on CPAN. These 2 versions of PDL::Graphics::PLplot are not always in sync. If you would like to override the version that shipped as part of the PDL ppm package with the latest CPAN version:
ppm install http://www.sisyphusion.tk/ppm/PDL-Graphics-PLplot.ppd --force
but it's probably a good idea to first check which of the 2 versions is the later before doing that.
ActiveState also usually provide ppm packages for PDL, but they lack the functionality of the build available from sisyphusion.tk - eg no Slatec, FFTW, GD, GSL, Minuit, PGPLOT, PLPLOT or PROJ4 support.
NOTE 1: If using ppm's gui to install from the sisyphusion repo, you need to exercise care to ensure that the PDL and OpenGL packages are, in fact, being installed from the sisyphusion repo, not from the ActiveState repo - hence the advice (above) to install these packages using the given "ppm install ..." commands, instead of using the gui.
NOTE 2: The mechanism that allows the PGPLOT module to load is broken in the 5.10.0 DynaLoader.pm. Affected perls are therefore any perl built from 5.10.0 source - eg Strawberry Perl 5.10.0. With ActivePerl, this broken DynaLoader.pm was included in some of their 5.8.x builds, as well as their first 5.10.0 build - though the error was fixed in their later builds (eg build 1005) of 5.10.0 . The error produced when trying to load the PGPLOT module using this broken DynaLoader.pm begins "Can't locate loadable object for module PGPLOT in @INC ...". If you receive that error, then try installing an unbroken DynaLoader.pm (eg by copying one from a perl-5.10.1 installation) - or upgrade your perl to at least 5.10.1 (which is a safer option than copying a DynaLoader.pm from another installation).
NOTE 3: When upgrading the above modules using those ppm commands, you may encounter an error message telling you that you need to use force. That is achieved by appending " --force" to the "ppm install ..." command.