NAME¶
PDL::Dbg - functions to support debugging of PDL scripts
SYNOPSIS¶
use PDL;
use PDL::Dbg;
$c = $a->slice("5:10,2:30")->px->diagonal(3,4);
PDL->px;
DESCRIPTION¶
This packages implements a couple of functions that should come in handy when
debugging your PDL scripts. They make a lot of sense while you're doing rapid
prototyping of new PDL code, let's say inside the perldl or pdl2 shell.
FUNCTIONS¶
Print info about a piddle (or all known piddles)
pdl> PDL->px
pdl> $b += $a->clump(2)->px('clumptest')->sumover
pdl> $a->px('%C (%A) Type: %T') # prints nothing unless $PDL::debug
pdl> $PDL::debug = 1
pdl> $a->px('%C (%A) Type: %T')
PDL (52433464) Type: Double
This function prints some information about piddles. It can be invoked as a
class method (e.g. "PDL->px" ) or as an instance method (e.g.
"$pdl->px($arg)"). If
- invoked as a class method
- it prints info about all piddles found in the current package (
excluding "my" variables). This comes in quite handy when
you are not quite sure which pdls you have already defined, what data they
hold , etc. "px" is supposed to support inheritance and prints
info about all symbols for which an "isa($class)" is true. An
optional string argument is interpreted as the package name for which to
print symbols:
pdl> PDL->px('PDL::Mypack')
The default package is that of the caller.
- invoked as an instance method
- it prints info about that particular piddle if $PDL::debug is true and
returns the pdl object upon completion. It accepts an optional string
argument that is simply prepended to the default info if it doesn't
contain a "%" character. If, however, the argument contains a
"%" then the string is passed to the "info" method to
control the format of the printed information. This can be used to achieve
customized output from "px". See the documentation of
"PDL::info" for further details.
The output of px will be determined by the default formatting string that is
passed to the "info" method (unless you pass a string containing
"%" to px when invoking as an instance method, see above). This
default string is stored in $PDL::Dbg::Infostr and the default output format
can be accordingly changed by setting this variable. If you do this you should
also change the default title string that the class method branch prints at
the top of the listing to match your new format string. The default title is
stored in the variable $PDL::Dbg::Title.
For historical reasons "vars" is an alias for "px".
vars¶
Alias for "px"
BUGS¶
There are probably some. Please report if you find any. Bug reports should be
sent to the PDL mailing list perldl@jachw.hawaii.edu.
AUTHOR¶
Copyright(C) 1997 Christian Soeller (c.soeller@auckland.ac.nz). All rights
reserved. There is no warranty. You are allowed to redistribute this software
/ documentation under certain conditions. For details, see the file COPYING in
the PDL distribution. If this file is separated from the PDL distribution, the
copyright notice should be included in the file.