PDL: The Perl Data Language:
Tables and Examples
Software Careers Fall 1997 Dr. Dobb's Journal
by Karl Glazebrook and Frossie Economou
Jump to Table 1
Examples:
 




Tables
<B>(a)</b> <hr> +  * / > < >= Array operators/functions <= << >> & (same as Perl and C  ^ == != += but they act element by = *= /= %= element) **= <<= >>= &= = ^= <=> ** % ! ++  "" atan2* sqrt* sin* cos* log* exp* abs* X Matrix multiplication ~ Matrix transpose byte short Type conversions ushort long float double convert pdl Create/copy a piddle topdl Coerce to piddle if scalar howbig Size of piddle datatype in bytes nelem Number of elements dims Return list of dimensions inplace Perform operation in place list Convert piddle to list, e.g. for (list $x) { } listindices Return list of index values (1D) log10* Take log base 10 min max sum Min/max/sum of piddle zeroes ones Create zero/onefilled piddle sequence Create sequencefilled piddle reshape Reshape the dimensions of a piddle sec Subsection of a piddle int* set Insertion/Setting at Return pixel value at (x, y, z, ...) axisvals* Fill piddle with axis values xvals* yvals* zvals* rvals Fill piddle with distance from its center callext Call external C code in dynamically loadable object convolve Convolve image with kernel (real space) hist Histogram of data stats Return mean and standard deviation transpose Matrix transpose qsort* Quick sort piddle median Median of piddle oddmedian Lower odd median of piddle <B>(b)</B> <hr> fibonacci* Compute Fibonacci series (simple 1D example) cc8compt* Connected 8component labelling (2D example) <B>(c)</B> <hr> rfits Read a FITS format file wfits Write a FITS format file rcols Read columns in a text file into piddles rgrep Read <I>regexp</I> matches into piddles rdsa Read a DSA format file (Starlink systems only) <B>(d)</B> <hr> imag Display an image ctab Load an image color table line Plot vector as connected points points Plot vector as points errb Plot error bars cont Display image as contour map bin Plot vector as histogram (<I>bin hist $data</I>, for instance) hi2d Plot image as 2D histogram poly Draw a polygon vect Display two images as a vector field hold Hold current plot window range; for example, for overlays release Autoscale new plot window for each command rel Synonym for "release" env Define a plot window, put on "hold" dev Explicitly set a new PGPLOT graphics device <B>(e)</B> <hr> iis Display image iiscur Return a cursor position iiscirc Draw circles on image display saoimage Start SAOimage ximtool Start Ximtool <B>(f)</B> <hr> flush Update C cache from piddle Perl data structure copy Copy a piddle new Create a piddle 
Table 1: PDL 1.11 functions. Starred items (log10*, for instance) act as mutators: When you say log10(inplace($a)), every element of $a is replaced with its logarithm base 10. (a) Defined in PDL::Core; (b) defined in PDL::Examples; (c) defined in PDL::Io; (d) defined in PDL::Graphics::PG (PGPLOT graphics); (e) defined in PDL::Graphics::IIS (talk to IIS protocol image display widget); (f) PDL methods. 
DDJ