PDL  2.025
About: PDL (Perl Data Language) aims to turn perl into an efficient numerical language for scientific computing (similar to IDL and MatLab).
  Fossies Dox: PDL-2.025.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

PDL Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies
  4. PDL-2.025.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
++ WARNING: There is absolutely no warranty for this software ++
++ package. See the file COPYING for details.                 ++

Important reading

Please check the following files for further information
*BEFORE* sending us your questions:

INSTALL 		Basic installation instructions

INTERNATIONALIZATION    Notes re PDL i18n issue and status

DEPENDENCIES		Other software that PDL relies on (and where to get it)

Release_Notes		A list of features or issues with regard to the
                        current version, always worth checking!

Known_problems	 	Check before you report problems

BUGS.pod		How to make a bug report, PDL::Bugs

perldl.conf		PDL configuration options

Basic/Pod/FAQ.pod 	The FAQ in pod format
			Try 'perldoc PDL::FAQ' after installation.

			A quick overview of PDL
			Try 'perldoc PDL::QuickStart' after installation.

                        A discussion of the bad value support in PDL

DEVELOPMENT		How to participate in the development of PDL

*NOTE*  Most PDL documentation is available online within the PDL shell,
        pdl2 (or perldl).  Try the help command within either shell.

PDL -- the package
The Perl Data Language (a.k.a. PerlDL or PDL) project aims to turn perl
into an efficient numerical language for scientific computing. The PDL
module gives standard perl the ability to COMPACTLY store and SPEEDILY
manipulate the large N-dimensional data sets which are the bread and
butter of scientific computing.  e.g. $x=$y+$c can add two 2048x2048
images in only a fraction of a second.

The aim is to provide tons of useful functionality for scientific and
numeric analysis.

Check the pdl web site at http://pdl.perl.org for more information.

Please read the file INSTALL for information on how to
configure and install PDL.  The Release_Notes and Known_problems
files contain important version specific information.  Be *sure*
to read Known_problems if you have any INSTALL issues.

Once you have built PDL and either installed it or done
'make doctest', try either

	perl -Mblib Perldl2/pdl2

from within the root of the PDL tree or just

if you have installed PDL already ('make install') to get the
interactive PDL shell.  In this shell, 'help' gives you
access to PDL documentation for each function separately
('help help' for more about this) and 'demo' gives you some
basic examples of what you can do.

Bug Reports
You can check the existing PDL bugs on GitHub at


The mailing list archives can be searched/read at


Questions about problems and possible bugs can be discussed
via the pdl-general mailing list.  This is very useful if you are
not sure what you have is a bug or not.  For example, the list
is the place to go for install problems.

If you need to post a problem report, and after checking with
the pdl-general list that it *is* a bug, please use the GitHub issue
tracker system following the guidance in the BUGS file.

Directory structure:

Basic/	   - The stuff that PDL would be no use without
Demos/     - Showcase for PDL, type demo at the perldl prompt.
Doc/       - Modules for building/using the PDL documentation database
Example/   - Sample programs using PDL
Graphics/  - The stuff that PDL needs to make pictures
IO/	   - The stuff that PDL needs to write and read strange files
Lib/	   - The stuff that PDL would still be useful without but
	       which makes PDL even more useful
Perldl2/   - The PDL shell version 2 source and development
TestTools/ - Tools for testing PDL
cygwin/    - Platform specific information
debian/    - Platform specific information
inc/       - Local module directory for PDL build process development
macosx/    - Platform specific information
t/         - PDL tests directory
utils/     - Utilities relating to PDL
win32/     - Platform specific information

Comments are welcome - so are volunteers to write code and documentation!
Please contact the developers mailing list pdl-devel@lists.sourceforge.net
(subscription info http://pdl.perl.org/?page=mailing-lists) with ideas
and suggestions.

  The PDL developers.

Compilation Reports:
The CPAN Testers' result page provides a database showing the results
of compiling PDL and many other CPAN packages on multiple platforms.
See http://www.cpantesters.org.