Welcome to the PDL wiki. The wiki uses a couple of different approaches and covers a fair amount of information, but should not be your only source for information about PDL. If you are new to PDL, the best places to start reading would probably be one of the PDFs linked in the External Resources section on this page. If you have PDL installed, you may also find some of the demos to be helpful at getting you started.
If you are looking for the proper syntax for a particular function and you have PDL installed, you can type '? func-name' at the perldl prompt and a one to two page summary should pop up. You can find more technical documentation of most everything in the pod docs that come with PDL, which you can access using perldoc.
Please add your suggestions, feedback, and updates to our list at GSoC_2012_Ideas.
If you want to get started with the PDL documentation on this wiki, start here:
[Getting_Started_with_PDL] - (Meant to be) an introduction to all of the major features of PDL.
[PDL_Cookbook] - Short and quick recipes to perform common tasks in PDL. (If you need a recipe or have suggestions for recipes, try sending a message to the mailing list or sign onto the #pdl irc channel at irc.perl.org.)
[PDL_for_Matlab_users] - a quick reference and migration guide for Matlab people.
[PDL_for_IDL_users] - a quick reference and migration guide for people who are used to IDL
[A_Map_of_PDL_Users_Worldwide] - a quick view of PDL users, where they are and how they use PDL
[Plotting_with_PDL::Graphics::Gnuplot] - a tutorial and reference guide for making publication-quality plots and images
PDL can be difficult to install. Fortunately, many operating systems including Mac, Windows, and major flavors of Linux, have pre-compiled binaries that you can install. Check the easy installation page and look for your operating system.
Alternatively, you can install PDL from source or via CPAN. The instructions are not the greatest, but hopefully they will be enough to get you going.
For a more modern installation tutorial see [Installing_Using_cpanm]. App::cpanminus (cpanm to its friends) is a new CPAN client which makes installing Perl modules easier in most cases. Even though it is fairly new, it is stable and extremely popular.
The following PDF documents are probably the best way for a beginner to learn how to use PDL. Some of the information may be a bit outdated, but almost all of it will be useful if you are just getting your feet wet:
You may eventually find yourself needing more detailed information than these documents can provide. In that case, check an HTML version of the PDL documentation. And of course, clicking around this wiki should be useful, too (we hope).
There are many places one can ask questions and report bugs regarding Perl modules (including PDL), more than the PDL users and developers can monitor. If you have a PDL question, the best places to find more information are:
A question in one of the various fora (including CPAN bug reports and the PDL wiki comments) is not likely to be seen and answered in a timely manner. The PDL community primarily uses the mailing lists for questions and SourceForge for bug reports.
The Mailing Lists offer a great forum for discussing ideas, but not for organizing them. The [Developer's_Corner] is a place for the developers and any other interested PDL folk to flesh-out and organize the directions for future development.
Please review and edit/update/delete items from the [PDL_TODO_List]. The TODO file from the PDL source tree has been dormant for too long. This wiki page contains the items from that file and a new TODO file will be implemented with current items.
Meaningful contributions to PDL don't come through the code-base alone. PDL can always use new, more, and updated documentation, which can start with this wiki. If you are interested in helping out with the wiki, check out the [PDL_Wiki_Editors_Page].
PDL may not be right for everybody. Fortunately, Perl has many other good math libraries which are worth checking out.