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