[bd23186f] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[6732c094] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[bd23186f] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[0aeb696] | 7 | <!-- Inserted as a reminder to do this. The mention of a test suite
|
---|
| 8 | is usually right before the root user installation commands. Please
|
---|
| 9 | delete these 12 (including one blank) lines after you are done.-->
|
---|
| 10 |
|
---|
| 11 | <!-- Use one of the two mentions below about a test suite,
|
---|
| 12 | delete the line that is not applicable. Of course, if the
|
---|
| 13 | test suite uses syntax other than "make check", revise the
|
---|
| 14 | line to reflect the actual syntax to run the test suite -->
|
---|
| 15 |
|
---|
| 16 | <!-- <para>This package does not come with a test suite.</para> -->
|
---|
| 17 | <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
|
---|
| 18 |
|
---|
[fce275e] | 19 | <!ENTITY pdl-download-http "&sourceforge-repo;/pdl/PDL-&pdl-version;.tar.gz">
|
---|
[fb2e525] | 20 | <!ENTITY pdl-download-ftp "&gentoo-ftp-repo;/PDL-&pdl-version;.tar.gz">
|
---|
[7dac9f1] | 21 | <!ENTITY pdl-md5sum "edd056a006eae8b46e8ef804b9774a93">
|
---|
| 22 | <!ENTITY pdl-size "2.1 MB">
|
---|
| 23 | <!ENTITY pdl-buildsize "74 MB">
|
---|
| 24 | <!ENTITY pdl-time "2.56 SBU">
|
---|
[bd23186f] | 25 | ]>
|
---|
| 26 |
|
---|
[31784c8] | 27 | <sect1 id="pdl" xreflabel="PDL-&pdl-version;">
|
---|
[7dac9f1] | 28 | <?dbhtml filename="pdl.html" ?>
|
---|
| 29 |
|
---|
| 30 | <sect1info>
|
---|
| 31 | <date>$Date$</date>
|
---|
| 32 | </sect1info>
|
---|
| 33 |
|
---|
| 34 | <title>PDL-&pdl-version;</title>
|
---|
| 35 |
|
---|
| 36 | <indexterm zone="pdl">
|
---|
| 37 | <primary sortas="a-PDL">PDL</primary>
|
---|
| 38 | </indexterm>
|
---|
| 39 |
|
---|
| 40 | <sect2 role="package">
|
---|
| 41 | <title>Introduction to PDL</title>
|
---|
| 42 |
|
---|
[dae2ba0b] | 43 | <para><application>PDL</application> (Perl Data Language) gives
|
---|
| 44 | standard <application>Perl</application> the ability to compactly store
|
---|
| 45 | and quickly manipulate the large N-dimensional data arrays common to
|
---|
| 46 | scientific computing. <application>PDL</application> turns
|
---|
| 47 | <application>Perl</application> into an array-oriented, numerical language
|
---|
[919683dc] | 48 | similar to such commercial packages as <application>IDL</application>
|
---|
[dae2ba0b] | 49 | and <application>MatLab</application>. One can write simple
|
---|
| 50 | <application>Perl</application> expressions to manipulate entire numerical
|
---|
[7dac9f1] | 51 | arrays all at once.</para>
|
---|
| 52 |
|
---|
[dae2ba0b] | 53 | <para><application>PDL</application> provides extensive numerical and
|
---|
| 54 | semi-numerical functionality with support for two- and three-dimensional
|
---|
| 55 | visualisation as well as a variety of I/O formats. The goal is to allow
|
---|
[b307885b] | 56 | <application>PDL</application> to interact with a variety of external
|
---|
| 57 | numerical packages, graphics and visualisation systems. Easy interfacing
|
---|
| 58 | to such systems is one of the core design features of
|
---|
| 59 | <application>PDL</application>.</para>
|
---|
[7dac9f1] | 60 |
|
---|
| 61 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 62 | <itemizedlist spacing="compact">
|
---|
| 63 | <listitem>
|
---|
| 64 | <para>Download (HTTP): <ulink url="&pdl-download-http;"/></para>
|
---|
| 65 | </listitem>
|
---|
| 66 | <listitem>
|
---|
| 67 | <para>Download (FTP): <ulink url="&pdl-download-ftp;"/></para>
|
---|
| 68 | </listitem>
|
---|
| 69 | <listitem>
|
---|
| 70 | <para>Download MD5 sum: &pdl-md5sum;</para>
|
---|
| 71 | </listitem>
|
---|
| 72 | <listitem>
|
---|
| 73 | <para>Download size: &pdl-size;</para>
|
---|
| 74 | </listitem>
|
---|
| 75 | <listitem>
|
---|
| 76 | <para>Estimated disk space required: &pdl-buildsize;</para>
|
---|
| 77 | </listitem>
|
---|
| 78 | <listitem>
|
---|
| 79 | <para>Estimated build time: &pdl-time;</para>
|
---|
| 80 | </listitem>
|
---|
| 81 | </itemizedlist>
|
---|
| 82 |
|
---|
| 83 | <bridgehead renderas="sect3">PDL Dependencies</bridgehead>
|
---|
| 84 |
|
---|
[dae2ba0b] | 85 | <para><application>PDL</application> is a collection of over 90
|
---|
| 86 | <application>Perl</application> modules. Some of these modules require
|
---|
[b307885b] | 87 | additional libraries, packages and/or <application>Perl</application>
|
---|
| 88 | modules for full functionality. Listed below are the modules which require
|
---|
| 89 | additional software or configuration. If you don't need a particular
|
---|
| 90 | module's functionality, you don't need to install its dependencies. The
|
---|
| 91 | dependency tree for each module is listed downward, meaning you'll need to
|
---|
| 92 | start at the bottom of a module's tree and work up. The dependencies are
|
---|
| 93 | listed in the same order as they are in the
|
---|
| 94 | <filename>DEPENDENCIES</filename> file, found in the package source
|
---|
| 95 | tree.</para>
|
---|
| 96 |
|
---|
| 97 | <para>This package (and many of the dependency packages) requires a Fortran
|
---|
| 98 | compiler for full functionality of all the different modules. The
|
---|
| 99 | <command>gfortran</command> compiler installed with the current BLFS
|
---|
| 100 | version of <application>GCC</application> (&gcc-version;) will not work. If
|
---|
| 101 | you want to compile the parts of this package that require a Fortran
|
---|
| 102 | compiler, you'll need to install a
|
---|
| 103 | <application>GCC</application>-3.x.x version of Fortran. The
|
---|
| 104 | <application>GCC</application> developers recommend using Fortran from
|
---|
| 105 | <application>GCC</application>-3.4.6. You can find specific instructions
|
---|
| 106 | to install a <application>GCC</application>-3.4.6 compiler on the
|
---|
[4e88613] | 107 | <ulink url="&blfs-wiki;/gcc3">BLFS
|
---|
[08f1ff7] | 108 | Wiki</ulink>. <!-- Alternatively, if you have a need to install
|
---|
[b307885b] | 109 | <xref linkend="gcc3"/>, you can add the Fortran compiler to the list of
|
---|
| 110 | compilers installed in those instructions. Don't forget to put the
|
---|
| 111 | directory containing the <command>{g,f}77</command> commands at the
|
---|
| 112 | beginning of your <envar>PATH</envar> environment variable before
|
---|
[08f1ff7] | 113 | beginning the compilation.--> </para>
|
---|
[7dac9f1] | 114 |
|
---|
| 115 | <bridgehead renderas="sect4">PDL::NiceSlice</bridgehead>
|
---|
[0619e6d] | 116 |
|
---|
[dae2ba0b] | 117 | <para>The <application>PDL</application>::NiceSlice module is used to
|
---|
[b307885b] | 118 | enhance <application>PDL</application>'s slice syntax.
|
---|
| 119 | <quote>Slicing</quote> is a term used in the process of creating a
|
---|
| 120 | cross-section, or slice, of a <application>PDL</application> object
|
---|
| 121 | (piddle).</para>
|
---|
[7dac9f1] | 122 |
|
---|
| 123 | <itemizedlist spacing='compact'>
|
---|
| 124 | <listitem>
|
---|
[dae2ba0b] | 125 | <para><ulink
|
---|
[7dac9f1] | 126 | url="http://www.cpan.org/authors/id/P/PM/PMQS/Filter-&Filter-version;.tar.gz">
|
---|
| 127 | Filter-&Filter-version;</ulink></para>
|
---|
| 128 | </listitem>
|
---|
| 129 | </itemizedlist>
|
---|
| 130 |
|
---|
| 131 | <bridgehead renderas="sect4">Inline::Pdlpp</bridgehead>
|
---|
| 132 |
|
---|
[dae2ba0b] | 133 | <para>The Inline::Pdlpp module allows you to define fast PP
|
---|
[7dac9f1] | 134 | code inline in your scripts.</para>
|
---|
| 135 |
|
---|
| 136 | <itemizedlist spacing='compact'>
|
---|
| 137 | <listitem>
|
---|
[dae2ba0b] | 138 | <para><ulink
|
---|
[7dac9f1] | 139 | url="http://www.cpan.org/authors/id/I/IN/INGY/Inline-&Inline-version;.tar.gz">
|
---|
| 140 | Inline-&Inline-version;</ulink></para>
|
---|
| 141 | <itemizedlist>
|
---|
| 142 | <listitem>
|
---|
[dae2ba0b] | 143 | <para><ulink
|
---|
[7dac9f1] | 144 | url="http://www.cpan.org/authors/id/D/DC/DCONWAY/Parse-RecDescent-&Parse-RecDescent-version;.tar.gz">
|
---|
| 145 | Parse-RecDescent-&Parse-RecDescent-version;</ulink></para>
|
---|
| 146 | </listitem>
|
---|
| 147 | </itemizedlist>
|
---|
| 148 | </listitem>
|
---|
| 149 | </itemizedlist>
|
---|
| 150 |
|
---|
| 151 | <bridgehead renderas="sect4">Perldl</bridgehead>
|
---|
| 152 |
|
---|
[dae2ba0b] | 153 | <para><command>perldl</command> is a simple shell (written in
|
---|
| 154 | <application>Perl</application>) which allows interactive
|
---|
[7dac9f1] | 155 | use of <application>PDL</application>.</para>
|
---|
| 156 |
|
---|
| 157 | <itemizedlist spacing='compact'>
|
---|
| 158 | <listitem>
|
---|
[dae2ba0b] | 159 | <para><ulink
|
---|
[7dac9f1] | 160 | url="http://www.cpan.org/authors/id/H/HA/HAYASHI/Term-ReadLine-Gnu-&Term-ReadLine-Gnu-version;.tar.gz">
|
---|
| 161 | Term-ReadLine-Gnu-&Term-ReadLine-Gnu-version;</ulink></para>
|
---|
| 162 | </listitem>
|
---|
| 163 | </itemizedlist>
|
---|
| 164 |
|
---|
| 165 | <bridgehead renderas="sect4">PDL::Graphics::TriD</bridgehead>
|
---|
| 166 |
|
---|
[dae2ba0b] | 167 | <para>The <application>PDL</application>::Graphics::TriD module implements
|
---|
| 168 | a generic 3D plotting interface for <application>PDL</application>. Points,
|
---|
[7dac9f1] | 169 | lines and surfaces (among other objects) are supported.</para>
|
---|
| 170 |
|
---|
| 171 | <itemizedlist spacing='compact'>
|
---|
| 172 | <listitem>
|
---|
[e77976f] | 173 | <para>OpenGL (<xref linkend="x-window-system"/>)</para>
|
---|
[7dac9f1] | 174 | </listitem>
|
---|
| 175 | </itemizedlist>
|
---|
| 176 |
|
---|
| 177 | <bridgehead renderas="sect4">PDL::Graphics::PGPLOT</bridgehead>
|
---|
| 178 |
|
---|
[dae2ba0b] | 179 | <para>The <application>PDL</application>::Graphics::PGPLOT module is a
|
---|
| 180 | convenience interface to the <application>PGPLOT</application> commands,
|
---|
[0619e6d] | 181 | implemented using the object oriented <application>PGPLOT</application>
|
---|
[b307885b] | 182 | plotting package in the PDL::Graphics::PGPLOT::Window module.</para>
|
---|
[7dac9f1] | 183 |
|
---|
| 184 | <itemizedlist spacing='compact'>
|
---|
| 185 | <listitem>
|
---|
[dae2ba0b] | 186 | <para><ulink
|
---|
[b307885b] | 187 | url="http://www.cpan.org/authors/id/K/KG/KGB/PGPLOT-&PGPLOT-perl-version;.tar.gz">
|
---|
| 188 | PGPLOT-&PGPLOT-perl-version;</ulink></para>
|
---|
[7dac9f1] | 189 | <itemizedlist>
|
---|
| 190 | <listitem>
|
---|
[dae2ba0b] | 191 | <para><ulink
|
---|
[7dac9f1] | 192 | url="http://www.cpan.org/authors/id/K/KG/KGB/ExtUtils-F77-&ExtUtils-F77-version;.tar.gz">
|
---|
| 193 | ExtUtils-F77-&ExtUtils-F77-version;</ulink></para>
|
---|
| 194 | <itemizedlist>
|
---|
| 195 | <listitem>
|
---|
[b307885b] | 196 | <para><ulink
|
---|
[4e88613] | 197 | url="&blfs-wiki;/gcc3">a Fortran
|
---|
[b307885b] | 198 | compiler</ulink></para>
|
---|
[7dac9f1] | 199 | </listitem>
|
---|
| 200 | </itemizedlist>
|
---|
| 201 | </listitem>
|
---|
| 202 | <listitem>
|
---|
[dae2ba0b] | 203 | <para><ulink
|
---|
[b307885b] | 204 | url="http://astro.caltech.edu/~tjp/pgplot/">PGPLOT</ulink></para>
|
---|
[7dac9f1] | 205 | <itemizedlist>
|
---|
| 206 | <listitem>
|
---|
[e77976f] | 207 | <para><xref linkend="x-window-system"/>,
|
---|
[2d1ea57b] | 208 | <!-- <xref linkend="lesstif"/>, -->
|
---|
| 209 | <ulink url="http://sourceforge.net/projects/lesstif/">LessTif</ulink>,
|
---|
[b307885b] | 210 | <xref linkend="tk"/>, and <ulink
|
---|
[4e88613] | 211 | url="&blfs-wiki;/gcc3">a Fortran
|
---|
[b307885b] | 212 | compiler</ulink></para>
|
---|
[7dac9f1] | 213 | </listitem>
|
---|
| 214 | </itemizedlist>
|
---|
| 215 | </listitem>
|
---|
| 216 | </itemizedlist>
|
---|
| 217 | </listitem>
|
---|
| 218 | </itemizedlist>
|
---|
| 219 |
|
---|
| 220 | <bridgehead renderas="sect4">PDL::Graphics::PLPLOT</bridgehead>
|
---|
| 221 |
|
---|
[dae2ba0b] | 222 | <para>The <application>PDL</application>::Graphics::PLPLOT module is a
|
---|
[7dac9f1] | 223 | simple interface to the <application>PLplot</application> plotting library.</para>
|
---|
| 224 |
|
---|
| 225 | <itemizedlist spacing='compact'>
|
---|
| 226 | <listitem>
|
---|
| 227 | <para><ulink url="http://plplot.sourceforge.net/">PLplot</ulink></para>
|
---|
| 228 | <itemizedlist>
|
---|
| 229 | <listitem>
|
---|
[358241d1] | 230 | <para><!-- <xref linkend="pkgconfig"/>, -->
|
---|
[e77976f] | 231 | <xref linkend="x-window-system"/>,
|
---|
[dae2ba0b] | 232 | <xref linkend="freetype2"/>,
|
---|
| 233 | <ulink url="http://www.boutell.com/gd/">GD</ulink>,
|
---|
| 234 | <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
|
---|
[dcd55b37] | 235 | <!-- <xref linkend="gnome-libs"/>, -->
|
---|
[6e5fd759] | 236 | <ulink url="&gnome-download-http;/gnome-libs/1.4/">GNOME
|
---|
[dcd55b37] | 237 | Libraries-1.4</ulink>,
|
---|
[49b50d4] | 238 | <xref linkend="openjdk"/>, <!-- or <xref linkend="jdk"/>, -->
|
---|
[dae2ba0b] | 239 | <xref linkend="tk"/>,
|
---|
[4716d52] | 240 | <xref linkend="python2"/> (with
|
---|
[e77976f] | 241 | <ulink url="http://www.numpy.org/">Numeric Python</ulink>),
|
---|
[4e88613] | 242 | <ulink url="&blfs-wiki;/gcc3">a
|
---|
[b307885b] | 243 | Fortran compiler</ulink>,
|
---|
[e77976f] | 244 | <ulink url="http://www.swig.org/">SWIG</ulink>, and
|
---|
[7dac9f1] | 245 | <ulink url="http://sourceforge.net/projects/incrtcl/">iTcl</ulink></para>
|
---|
| 246 | </listitem>
|
---|
| 247 | </itemizedlist>
|
---|
| 248 | </listitem>
|
---|
| 249 | </itemizedlist>
|
---|
| 250 |
|
---|
| 251 | <bridgehead renderas="sect4">PDL::Graphics::IIS</bridgehead>
|
---|
| 252 |
|
---|
[dae2ba0b] | 253 | <para>The <application>PDL</application>::Graphics::IIS
|
---|
[0619e6d] | 254 | module provides an interface to any image display <quote>device</quote>
|
---|
[7dac9f1] | 255 | which supports the <quote>IIS protocol</quote>.</para>
|
---|
| 256 |
|
---|
| 257 | <itemizedlist spacing='compact'>
|
---|
| 258 | <listitem>
|
---|
[dae2ba0b] | 259 | <para><ulink
|
---|
[7dac9f1] | 260 | url="http://tdc-www.harvard.edu/software/saoimage.html">SAOimage</ulink></para>
|
---|
| 261 | <itemizedlist>
|
---|
| 262 | <listitem>
|
---|
[e77976f] | 263 | <para><xref linkend="x-window-system"/></para>
|
---|
[7dac9f1] | 264 | </listitem>
|
---|
| 265 | </itemizedlist>
|
---|
| 266 | </listitem>
|
---|
| 267 | <listitem>
|
---|
[dae2ba0b] | 268 | <para><ulink
|
---|
| 269 | url="http://iraf.noao.edu/iraf/web/projects/x11iraf/x11iraf.html">X11
|
---|
[7dac9f1] | 270 | IRAF</ulink></para>
|
---|
| 271 | <itemizedlist>
|
---|
| 272 | <listitem>
|
---|
[e77976f] | 273 | <para><xref linkend="x-window-system"/> and
|
---|
[7dac9f1] | 274 | <xref linkend="tk"/></para>
|
---|
| 275 | </listitem>
|
---|
| 276 | </itemizedlist>
|
---|
| 277 | </listitem>
|
---|
| 278 | </itemizedlist>
|
---|
| 279 |
|
---|
| 280 | <bridgehead renderas="sect4">PDL::Graphics::Karma</bridgehead>
|
---|
| 281 |
|
---|
[dae2ba0b] | 282 | <para>The <application>PDL</application>::Graphics::Karma
|
---|
| 283 | module is an interface to <application>Karma</application> visualisation
|
---|
[7dac9f1] | 284 | applications.</para>
|
---|
| 285 |
|
---|
| 286 | <itemizedlist spacing='compact'>
|
---|
| 287 | <listitem>
|
---|
[dae2ba0b] | 288 | <para><ulink
|
---|
[7dac9f1] | 289 | url="http://www.atnf.csiro.au/computing/software/karma/">Karma</ulink></para>
|
---|
| 290 | <itemizedlist>
|
---|
| 291 | <listitem>
|
---|
[e77976f] | 292 | <para><xref linkend="x-window-system"/></para>
|
---|
[7dac9f1] | 293 | </listitem>
|
---|
| 294 | </itemizedlist>
|
---|
| 295 | </listitem>
|
---|
| 296 | </itemizedlist>
|
---|
| 297 |
|
---|
[dae2ba0b] | 298 | <para><emphasis>Note:</emphasis> You may need to modify the
|
---|
| 299 | <option>WHERE_KARMA => undef</option> line in the source tree
|
---|
| 300 | <filename>perldl.conf</filename> file to point to your installation
|
---|
[7dac9f1] | 301 | of <application>Karma</application></para>
|
---|
| 302 |
|
---|
| 303 | <bridgehead renderas="sect4">PDL::IO::Pic</bridgehead>
|
---|
| 304 |
|
---|
[dae2ba0b] | 305 | <para> The <application>PDL</application>::IO::Pic module implements I/O
|
---|
| 306 | for a number of popular image formats by exploiting the
|
---|
[0619e6d] | 307 | <command>xxxtopnm</command> and <command>pnmtoxxx</command>
|
---|
[dae2ba0b] | 308 | converters from the <application>Netpbm</application> package and the
|
---|
| 309 | <command>cjpeg</command> and <command>djpeg</command> converters.
|
---|
| 310 | It also contains the routine wmpeg to write MPEG movies from piddles
|
---|
[7dac9f1] | 311 | representing image stacks.</para>
|
---|
| 312 |
|
---|
| 313 | <itemizedlist spacing='compact'>
|
---|
| 314 | <listitem>
|
---|
[dae2ba0b] | 315 | <para><ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
|
---|
| 316 | <xref linkend="libjpeg"/> and
|
---|
[7dac9f1] | 317 | <ulink url="ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/encode/">
|
---|
| 318 | mpeg_encode</ulink></para>
|
---|
| 319 | </listitem>
|
---|
| 320 | </itemizedlist>
|
---|
| 321 |
|
---|
| 322 | <bridgehead renderas="sect4">PDL::Slatec</bridgehead>
|
---|
| 323 |
|
---|
[dae2ba0b] | 324 | <para> The <application>PDL</application>::Slatec module serves the dual
|
---|
| 325 | purpose of providing an interface to parts of the slatec library and showing
|
---|
| 326 | how to interface <application>PDL</application> to an external library.
|
---|
| 327 | The module provides routines to manipulate matrices, calculate FFTs, fit
|
---|
| 328 | data using polynomials, and interpolate/integrate data using piecewise
|
---|
[7dac9f1] | 329 | cubic Hermite interpolation.</para>
|
---|
| 330 |
|
---|
| 331 | <itemizedlist spacing='compact'>
|
---|
| 332 | <listitem>
|
---|
[dae2ba0b] | 333 | <para><ulink
|
---|
[7dac9f1] | 334 | url="http://www.cpan.org/authors/id/K/KG/KGB/ExtUtils-F77-&ExtUtils-F77-version;.tar.gz">
|
---|
| 335 | ExtUtils-F77-&ExtUtils-F77-version;</ulink></para>
|
---|
| 336 | <itemizedlist>
|
---|
| 337 | <listitem>
|
---|
[b307885b] | 338 | <para><ulink
|
---|
[4e88613] | 339 | url="&blfs-wiki;/gcc3">a Fortran
|
---|
[b307885b] | 340 | compiler</ulink></para>
|
---|
[7dac9f1] | 341 | </listitem>
|
---|
| 342 | </itemizedlist>
|
---|
| 343 | </listitem>
|
---|
| 344 | </itemizedlist>
|
---|
| 345 |
|
---|
| 346 | <bridgehead renderas="sect4">PDL::GSL</bridgehead>
|
---|
| 347 |
|
---|
[0619e6d] | 348 | <para> The <application>PDL</application>::<application>GSL</application>
|
---|
[7dac9f1] | 349 | module is an interface to the functions provided by the Gnu Scientific Library.</para>
|
---|
| 350 |
|
---|
| 351 | <itemizedlist spacing='compact'>
|
---|
| 352 | <listitem>
|
---|
[37bea21] | 353 | <para><xref linkend="gsl"/></para>
|
---|
[7dac9f1] | 354 | </listitem>
|
---|
| 355 | </itemizedlist>
|
---|
| 356 |
|
---|
| 357 | <bridgehead renderas="sect4">PDL::FFTW</bridgehead>
|
---|
| 358 |
|
---|
[0619e6d] | 359 | <para> The <application>PDL</application>::<application>FFTW</application>
|
---|
[dae2ba0b] | 360 | module is a means to interface <application>PDL</application> with the
|
---|
| 361 | <application>FFTW</application> library. It's similar to the standard FFT
|
---|
| 362 | routine but it's usually faster and has support for real transforms. It works
|
---|
| 363 | well for the types of piddles for which the library was compiled (otherwise it
|
---|
[7dac9f1] | 364 | must do conversions).</para>
|
---|
| 365 |
|
---|
| 366 | <itemizedlist spacing='compact'>
|
---|
| 367 | <listitem>
|
---|
| 368 | <para><ulink url="http://www.fftw.org/">FFTW-2.x</ulink></para>
|
---|
| 369 | </listitem>
|
---|
| 370 | </itemizedlist>
|
---|
| 371 |
|
---|
| 372 | <bridgehead renderas="sect4">PDL::IO::Browser</bridgehead>
|
---|
| 373 |
|
---|
[dae2ba0b] | 374 | <para>The <application>PDL</application>::IO::Browser module
|
---|
[7dac9f1] | 375 | is a 2D cursor terminal data browser for piddles.</para>
|
---|
| 376 |
|
---|
[dae2ba0b] | 377 | <para>There is no additional software required to use the module. However,
|
---|
| 378 | the default is to not install the module because some platforms don't provide
|
---|
| 379 | a curses compatible library. To enable the module, issue the following
|
---|
[7dac9f1] | 380 | command:</para>
|
---|
| 381 |
|
---|
| 382 | <screen><userinput>sed -i -e "s/WITH_IO_BROWSER => 0/WITH_IO_BROWSER => 1/" \
|
---|
| 383 | perldl.conf</userinput></screen>
|
---|
| 384 |
|
---|
| 385 | <bridgehead renderas="sect4">PDL::IO::NDF</bridgehead>
|
---|
| 386 |
|
---|
[dae2ba0b] | 387 | <para>The <application>PDL</application>::IO::NDF module adds the ability to
|
---|
[7dac9f1] | 388 | read and write Starlink N-dimensional data files as N-dimensional piddles.</para>
|
---|
| 389 |
|
---|
| 390 | <itemizedlist spacing='compact'>
|
---|
| 391 | <listitem>
|
---|
[dae2ba0b] | 392 | <para><ulink
|
---|
[7dac9f1] | 393 | url="http://www.cpan.org/authors/id/A/AA/AALLAN/Astro-FITS-Header-&Astro-FITS-Header-version;.tar.gz">
|
---|
| 394 | Astro-FITS-Header-&Astro-FITS-Header-version;</ulink></para>
|
---|
| 395 | <itemizedlist>
|
---|
| 396 | <listitem>
|
---|
[dae2ba0b] | 397 | <para><ulink
|
---|
[7dac9f1] | 398 | url="http://www.cpan.org/authors/id/P/PR/PRATZLAFF/Astro-FITS-CFITSIO-&Astro-FITS-CFITSIO-version;.tar.gz">
|
---|
| 399 | Astro-FITS-CFITSIO-&Astro-FITS-CFITSIO-version;</ulink></para>
|
---|
| 400 | <itemizedlist>
|
---|
| 401 | <listitem>
|
---|
[dae2ba0b] | 402 | <para><ulink
|
---|
[7dac9f1] | 403 | url="http://heasarc.gsfc.nasa.gov/docs/software/fitsio/">CFITSIO</ulink></para>
|
---|
| 404 | </listitem>
|
---|
| 405 | </itemizedlist>
|
---|
| 406 | </listitem>
|
---|
| 407 | <listitem>
|
---|
[dae2ba0b] | 408 | <para><ulink
|
---|
[9d332fc9] | 409 | url="&files-anduin;/sources/NDF-&NDF-version;.tar.gz">
|
---|
[b307885b] | 410 | NDF-&NDF-version;</ulink></para>
|
---|
[7dac9f1] | 411 | <itemizedlist>
|
---|
| 412 | <listitem>
|
---|
[dae2ba0b] | 413 | <para><ulink
|
---|
[9d332fc9] | 414 | url="&files-anduin;/sources/Starlink-Config-&Starlink-Config-version;.tar.gz">
|
---|
[7dac9f1] | 415 | Starlink-Config-&Starlink-Config-version;</ulink></para>
|
---|
| 416 | <itemizedlist>
|
---|
| 417 | <listitem>
|
---|
[2d8d020] | 418 | <para><ulink
|
---|
[9d332fc9] | 419 | url="&files-anduin;/sources/Starlink_IMG.tar.gz">
|
---|
[2d8d020] | 420 | Starlink IMG</ulink></para>
|
---|
[7dac9f1] | 421 | <itemizedlist>
|
---|
| 422 | <listitem>
|
---|
[2d8d020] | 423 | <para><ulink
|
---|
[9d332fc9] | 424 | url="&files-anduin;/sources/Starlink_NDF.tar.gz">
|
---|
[2d8d020] | 425 | Starlink NDF</ulink> (requires the following Starlink
|
---|
| 426 | modules installed in this order, some will already be
|
---|
| 427 | installed if you installed Starlink GSD):
|
---|
[9d332fc9] | 428 | <ulink url="&files-anduin;/sources/Starlink_HTX.tar.gz">
|
---|
[2d8d020] | 429 | HTX</ulink>,
|
---|
[9d332fc9] | 430 | <ulink url="&files-anduin;/sources/Starlink_SAE.tar.gz">
|
---|
[2d8d020] | 431 | SAE</ulink>,
|
---|
[9d332fc9] | 432 | <ulink url="&files-anduin;/sources/Starlink_HLP.tar.gz">
|
---|
[2d8d020] | 433 | HLP</ulink>,
|
---|
[9d332fc9] | 434 | <ulink url="&files-anduin;/sources/Starlink_CNF.tar.gz">
|
---|
[2d8d020] | 435 | CNF</ulink>,
|
---|
[9d332fc9] | 436 | <ulink url="&files-anduin;/sources/Starlink_SLA.tar.gz">
|
---|
[2d8d020] | 437 | SLA</ulink>,
|
---|
[9d332fc9] | 438 | <ulink url="&files-anduin;/sources/Starlink_CHR.tar.gz">
|
---|
[2d8d020] | 439 | CHR</ulink>,
|
---|
[9d332fc9] | 440 | <ulink url="&files-anduin;/sources/Starlink_EMS.tar.gz">
|
---|
[2d8d020] | 441 | EMS</ulink>,
|
---|
[9d332fc9] | 442 | <ulink url="&files-anduin;/sources/Starlink_PSX.tar.gz">
|
---|
[2d8d020] | 443 | PSX</ulink>,
|
---|
[9d332fc9] | 444 | <ulink url="&files-anduin;/sources/Starlink_HDS.tar.gz">
|
---|
[2d8d020] | 445 | HDS</ulink>,
|
---|
[9d332fc9] | 446 | <ulink url="&files-anduin;/sources/Starlink_PCS.tar.gz">
|
---|
[2d8d020] | 447 | PCS</ulink>,
|
---|
[9d332fc9] | 448 | <ulink url="&files-anduin;/sources/Starlink_MER.tar.gz">
|
---|
[2d8d020] | 449 | MER</ulink>,
|
---|
[9d332fc9] | 450 | <ulink url="&files-anduin;/sources/Starlink_PRM.tar.gz">
|
---|
[2d8d020] | 451 | PRM</ulink>,
|
---|
[9d332fc9] | 452 | <ulink url="&files-anduin;/sources/Starlink_PAR.tar.gz">
|
---|
[2d8d020] | 453 | PAR</ulink>,
|
---|
[9d332fc9] | 454 | <ulink url="&files-anduin;/sources/Starlink_ARY.tar.gz">
|
---|
[2d8d020] | 455 | ARY</ulink>,
|
---|
[9d332fc9] | 456 | <ulink url="&files-anduin;/sources/Starlink_AST.tar.gz">
|
---|
[2d8d020] | 457 | AST</ulink>)</para>
|
---|
[7dac9f1] | 458 | <itemizedlist>
|
---|
| 459 | <listitem>
|
---|
[b307885b] | 460 | <para><ulink
|
---|
[4e88613] | 461 | url="&blfs-wiki;/gcc3">a
|
---|
[b307885b] | 462 | Fortran compiler</ulink></para>
|
---|
[7dac9f1] | 463 | </listitem>
|
---|
| 464 | </itemizedlist>
|
---|
| 465 | </listitem>
|
---|
| 466 | </itemizedlist>
|
---|
| 467 | </listitem>
|
---|
| 468 | </itemizedlist>
|
---|
| 469 | </listitem>
|
---|
| 470 | </itemizedlist>
|
---|
| 471 | </listitem>
|
---|
| 472 | <listitem>
|
---|
[dae2ba0b] | 473 | <para><ulink
|
---|
[9d332fc9] | 474 | url="&files-anduin;/sources/GSD-&GSD-version;.tar.gz">
|
---|
[b307885b] | 475 | GSD-&GSD-version;</ulink></para>
|
---|
[7dac9f1] | 476 | <itemizedlist>
|
---|
| 477 | <listitem>
|
---|
[dae2ba0b] | 478 | <para><ulink
|
---|
[9d332fc9] | 479 | url="&files-anduin;/sources/Starlink-Config-&Starlink-Config-version;.tar.gz">
|
---|
[7dac9f1] | 480 | Starlink-Config-&Starlink-Config-version;</ulink></para>
|
---|
| 481 | <itemizedlist>
|
---|
| 482 | <listitem>
|
---|
[dae2ba0b] | 483 | <para><ulink
|
---|
[9d332fc9] | 484 | url="&files-anduin;/sources/Starlink_GSD.tar.gz">
|
---|
[2d8d020] | 485 | Starlink GSD</ulink> (requires the following Starlink
|
---|
| 486 | modules installed in this order:
|
---|
[9d332fc9] | 487 | <ulink url="&files-anduin;/sources/Starlink_HTX.tar.gz">
|
---|
[2d8d020] | 488 | HTX</ulink>,
|
---|
[9d332fc9] | 489 | <ulink url="&files-anduin;/sources/Starlink_SAE.tar.gz">
|
---|
[2d8d020] | 490 | SAE</ulink>,
|
---|
[9d332fc9] | 491 | <ulink url="&files-anduin;/sources/Starlink_CNF.tar.gz">
|
---|
[2d8d020] | 492 | CNF</ulink>,
|
---|
[9d332fc9] | 493 | <ulink url="&files-anduin;/sources/Starlink_CHR.tar.gz">
|
---|
[2d8d020] | 494 | CHR</ulink>,
|
---|
[9d332fc9] | 495 | <ulink url="&files-anduin;/sources/Starlink_EMS.tar.gz">
|
---|
[2d8d020] | 496 | EMS</ulink>,
|
---|
[9d332fc9] | 497 | <ulink url="&files-anduin;/sources/Starlink_PRM.tar.gz">
|
---|
[2d8d020] | 498 | PRM</ulink>)</para>
|
---|
[7dac9f1] | 499 | <itemizedlist>
|
---|
| 500 | <listitem>
|
---|
[b307885b] | 501 | <para><ulink
|
---|
[4e88613] | 502 | url="&blfs-wiki;/gcc3">a
|
---|
[b307885b] | 503 | Fortran compiler</ulink></para>
|
---|
[7dac9f1] | 504 | </listitem>
|
---|
| 505 | </itemizedlist>
|
---|
| 506 | </listitem>
|
---|
| 507 | </itemizedlist>
|
---|
| 508 | </listitem>
|
---|
| 509 | </itemizedlist>
|
---|
| 510 | </listitem>
|
---|
| 511 | </itemizedlist>
|
---|
| 512 | </listitem>
|
---|
| 513 | </itemizedlist>
|
---|
| 514 |
|
---|
[1039de3] | 515 | <para condition="html" role="usernotes">User Notes:
|
---|
| 516 | <ulink url="&blfs-wiki;/pdl"/></para>
|
---|
| 517 |
|
---|
[7dac9f1] | 518 | </sect2>
|
---|
| 519 |
|
---|
| 520 | <sect2 role="installation">
|
---|
| 521 | <title>Installation of PDL</title>
|
---|
| 522 |
|
---|
[dae2ba0b] | 523 | <para>Install <application>PDL</application> (and all the dependency
|
---|
[7dac9f1] | 524 | <application>Perl</application> modules) by running the following commands:</para>
|
---|
| 525 |
|
---|
[7768cf26] | 526 | <screen><userinput>sed -i 's/\(dirname);\)/\1\nuse blib;/' Demos/BAD*demo.pm.PL &&
|
---|
| 527 | perl Makefile.PL &&
|
---|
[bd23186f] | 528 | make &&
|
---|
[7dac9f1] | 529 | make test</userinput></screen>
|
---|
| 530 |
|
---|
| 531 | <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
|
---|
| 532 |
|
---|
| 533 | <screen role="root"><userinput>make install</userinput></screen>
|
---|
| 534 |
|
---|
| 535 | </sect2>
|
---|
| 536 |
|
---|
[7768cf26] | 537 | <sect2 role="commands">
|
---|
| 538 | <title>Command Explanations</title>
|
---|
| 539 |
|
---|
| 540 | <para><command>sed -i '...' Demos/BAD*demo.pm.PL</command>: This is
|
---|
| 541 | necessary to fix a build issue caused by changes in
|
---|
| 542 | ExtUtils::MakeMaker-6.30 which was introduction in
|
---|
| 543 | <application>Perl</application>-5.8.8.</para>
|
---|
| 544 |
|
---|
| 545 | </sect2>
|
---|
| 546 |
|
---|
[7dac9f1] | 547 | <sect2 role="configuration">
|
---|
| 548 | <title>Configuring PDL</title>
|
---|
| 549 |
|
---|
| 550 | <sect3 id="pdl-config">
|
---|
| 551 | <title>Config Files</title>
|
---|
| 552 |
|
---|
[dae2ba0b] | 553 | <para><filename>~/.perldlrc</filename> and
|
---|
[7dac9f1] | 554 | <filename>local.perldlrc</filename> in the current directory</para>
|
---|
| 555 |
|
---|
| 556 | <indexterm zone="pdl pdl-config">
|
---|
| 557 | <primary sortas="e-AA.perldlrc">~/.perldlrc</primary>
|
---|
| 558 | </indexterm>
|
---|
| 559 |
|
---|
| 560 | <indexterm zone="pdl pdl-config">
|
---|
| 561 | <primary sortas="e-local.perldlrc">local.perldlrc</primary>
|
---|
| 562 | </indexterm>
|
---|
| 563 |
|
---|
| 564 | </sect3>
|
---|
| 565 |
|
---|
| 566 | <sect3>
|
---|
| 567 | <title>Configuration Information</title>
|
---|
| 568 |
|
---|
[dae2ba0b] | 569 | <para>See <ulink
|
---|
[0619e6d] | 570 | url="http://pdl.sourceforge.net/PDLdocs/perldl.html#the startup file ~/.perldlrc"/>
|
---|
[dae2ba0b] | 571 | for information about configuring <command>perldl</command> to suit your
|
---|
[7dac9f1] | 572 | needs.</para>
|
---|
| 573 |
|
---|
| 574 | </sect3>
|
---|
| 575 |
|
---|
| 576 | </sect2>
|
---|
| 577 |
|
---|
| 578 | <sect2 role="content">
|
---|
| 579 | <title>Contents</title>
|
---|
| 580 |
|
---|
| 581 | <segmentedlist>
|
---|
| 582 | <segtitle>Installed Programs</segtitle>
|
---|
| 583 | <segtitle>Installed Modules</segtitle>
|
---|
| 584 | <segtitle>Installed Directories</segtitle>
|
---|
| 585 |
|
---|
| 586 | <seglistitem>
|
---|
| 587 | <seg>pdl, pdldoc, perldl, and pptemplate</seg>
|
---|
| 588 | <seg>90+ individual <application>Perl</application> modules</seg>
|
---|
[55fb7f56] | 589 | <seg>/usr/lib/perl5/site_perl/&lfs-perl-version;/i686-linux/{,auto/}PDL</seg>
|
---|
[7dac9f1] | 590 | </seglistitem>
|
---|
| 591 | </segmentedlist>
|
---|
| 592 |
|
---|
| 593 | <variablelist>
|
---|
| 594 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 595 | <?dbfo list-presentation="list"?>
|
---|
| 596 | <?dbhtml list-presentation="table"?>
|
---|
| 597 |
|
---|
| 598 | <varlistentry id="pdl-prog">
|
---|
| 599 | <term><command>pdl</command></term>
|
---|
| 600 | <listitem>
|
---|
[dae2ba0b] | 601 | <para>is a binary program called from
|
---|
[7dac9f1] | 602 | <application>PDL</application> scripts which is used to
|
---|
| 603 | interface <command>perldl</command>.</para>
|
---|
| 604 | <indexterm zone="pdl pdl-prog">
|
---|
| 605 | <primary sortas="b-pdl">pdl</primary>
|
---|
| 606 | </indexterm>
|
---|
| 607 | </listitem>
|
---|
| 608 | </varlistentry>
|
---|
| 609 |
|
---|
| 610 | <varlistentry id="pdldoc">
|
---|
| 611 | <term><command>pdldoc</command></term>
|
---|
| 612 | <listitem>
|
---|
| 613 | <para>is a shell interface to
|
---|
| 614 | <application>PDL</application> documentation.</para>
|
---|
| 615 | <indexterm zone="pdl pdldoc">
|
---|
| 616 | <primary sortas="b-pdldoc">pdldoc</primary>
|
---|
| 617 | </indexterm>
|
---|
| 618 | </listitem>
|
---|
| 619 | </varlistentry>
|
---|
| 620 |
|
---|
| 621 | <varlistentry id="perldl">
|
---|
| 622 | <term><command>perldl</command></term>
|
---|
| 623 | <listitem>
|
---|
[dae2ba0b] | 624 | <para>is a simple shell (written in <application>Perl</application>)
|
---|
[7dac9f1] | 625 | for interactive use of <application>PDL</application>.</para>
|
---|
| 626 | <indexterm zone="pdl perldl">
|
---|
| 627 | <primary sortas="b-perldl">perldl</primary>
|
---|
| 628 | </indexterm>
|
---|
| 629 | </listitem>
|
---|
| 630 | </varlistentry>
|
---|
| 631 |
|
---|
| 632 | <varlistentry id="pptemplate">
|
---|
| 633 | <term><command>pptemplate</command></term>
|
---|
| 634 | <listitem>
|
---|
[0619e6d] | 635 | <para>is a script to generate <filename>Makefile.PL</filename>
|
---|
[7dac9f1] | 636 | and PP file skeletons.</para>
|
---|
| 637 | <indexterm zone="pdl pptemplate">
|
---|
| 638 | <primary sortas="b-pptemplate">pptemplate</primary>
|
---|
| 639 | </indexterm>
|
---|
| 640 | </listitem>
|
---|
| 641 | </varlistentry>
|
---|
| 642 |
|
---|
| 643 | </variablelist>
|
---|
| 644 |
|
---|
| 645 | </sect2>
|
---|
[bd23186f] | 646 |
|
---|
| 647 | </sect1>
|
---|