1PLplot(3)             User Contributed Perl Documentation            PLplot(3)
2
3
4

NAME

6       PDL::Graphics::PLplot - Object-oriented interface from perl/PDL to the
7       PLPLOT plotting library
8

SYNOPSIS

10         use PDL;
11         use PDL::Graphics::PLplot;
12
13         my $pl = PDL::Graphics::PLplot->new (DEV => "png", FILE => "test.png");
14         my $x  = sequence(10);
15         my $y  = $x**2;
16         $pl->xyplot($x, $y);
17         $pl->close;
18
19       For more information on PLplot, see
20
21        http://www.plplot.org/
22
23       Also see the test file, t/plplot.pl in this distribution for some
24       working examples.
25

DESCRIPTION

27       This is the PDL interface to the PLplot graphics library.  It is
28       designed to be simple and light weight with a familiar 'perlish' Object
29       Oriented interface.
30

OPTIONS

32       The following options are supported.  Most options can be used with any
33       function.  A few are only supported on the call to 'new'.
34
35   Options used upon creation of a PLplot object (with 'new'):
36       BACKGROUND
37
38       Set the color for index 0, the plot background
39
40       DEV
41
42       Set the output device type.  To see a list of allowed types, try:
43
44         PDL::Graphics::PLplot->new();
45
46          PDL::Graphics::PLplot->new(DEV => 'png', FILE => 'test.png');
47
48       FILE
49
50       Set the output file or display.  For file output devices, sets the
51       output file name.  For graphical displays (like 'xwin') sets the name
52       of the display, eg ('hostname.foobar.com:0')
53
54          PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png');
55          PDL::Graphics::PLplot->new(DEV => 'xwin', FILE => ':0');
56
57       OPTS
58
59       Set plotting options.  See the PLplot documentation for the complete
60       listing of available options.  The value of 'OPTS' must be a hash
61       reference, whose keys are the names of the options.  For instance, to
62       obtain PostScript fonts with the ps output device, use:
63
64          PDL::Graphics::PLplot->new(DEV => 'ps', OPTS => {drvopt => 'text=1'});
65
66       MEM
67
68       This option is used in conjunction with "DEV => 'mem'".  This option
69       takes as input a PDL image and allows one to 'decorate' it using
70       PLplot.  The 'decorated' PDL image can then be written to an image file
71       using, for example, PDL::IO::Pic.  This option may not be available if
72       plplot does not include the 'mem' driver.
73
74         # read in Earth image and draw an equator.
75         my $pl = PDL::Graphics::PLplot->new (MEM => $earth, DEV => 'mem');
76         my $x  = pdl(-180, 180);
77         my $y  = zeroes(2);
78         $pl->xyplot($x, $y,
79                     BOX => [-180,180,-90,90],
80                     VIEWPORT => [0.0, 1.0, 0.0, 1.0],
81                     XBOX => '', YBOX => '',
82                     PLOTTYPE => 'LINE');
83         $pl->close;
84
85       FRAMECOLOR
86
87       Set color index 1, the frame color
88
89       JUST
90
91       A flag used to specify equal scale on the axes.  If this is not
92       specified, the default is to scale the axes to fit best on the page.
93
94         PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png', JUST => 1);
95
96       ORIENTATION
97
98       The orientation of the plot:
99
100         0 --   0 degrees (landscape mode)
101         1 --  90 degrees (portrait mode)
102         2 -- 180 degrees (seascape mode)
103         3 -- 270 degrees (upside-down mode)
104
105       Intermediate values (0.2) are acceptable if you are feeling daring.
106
107         # portrait orientation
108         PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png', ORIENTATION => 1);
109
110       PAGESIZE
111
112       Set the size in pixels of the output page.
113
114         # PNG 500 by 600 pixels
115         PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png', PAGESIZE => [500,600]);
116
117       SUBPAGES
118
119       Set the number of sub pages in the plot, [$nx, $ny]
120
121         # PNG 300 by 600 pixels
122         # Two subpages stacked on top of one another.
123         PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png', PAGESIZE => [300,600],
124                                                     SUBPAGES => [1,2]);
125
126   Options used after initialization (after 'new')
127       BOX
128
129       Set the plotting box in world coordinates.  Used to explicitly set the
130       size of the plotting area.
131
132        my $pl = PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png');
133        $pl->xyplot ($x, $y, BOX => [0,100,0,200]);
134
135       CHARSIZE
136
137       Set the size of text in multiples of the default size.  "CHARSIZE =>
138       1.5" gives characters 1.5 times the normal size.
139
140       COLOR
141
142       Set the current color for plotting and character drawing.  Colors are
143       specified not as color indices but as RGB triples.  Some pre-defined
144       triples are included:
145
146         BLACK        GREEN        WHEAT        BLUE
147         RED          AQUAMARINE   GREY         BLUEVIOLET
148         YELLOW       PINK         BROWN        CYAN
149         TURQUOISE    MAGENTA      SALMON       WHITE
150         ROYALBLUE    DEEPSKYBLUE  VIOLET       STEELBLUE1
151         DEEPPINK     MAGENTA      DARKORCHID1  PALEVIOLETRED2
152         TURQUOISE1   LIGHTSEAGREEN SKYBLUE     FORESTGREEN
153         CHARTREUSE3  GOLD2        SIENNA1      CORAL
154         HOTPINK      LIGHTCORAL   LIGHTPINK1   LIGHTGOLDENROD
155
156        # These two are equivalent:
157        $pl->xyplot ($x, $y, COLOR => 'YELLOW');
158        $pl->xyplot ($x, $y, COLOR => [0,255,0]);
159
160       LINEWIDTH
161
162       Set the line width for plotting.  Values range from 1 to a device
163       dependent maximum.
164
165       LINESTYLE
166
167       Set the line style for plotting.  Pre-defined line styles use values 1
168       to 8, one being a solid line, 2-8 being various dashed patterns.
169
170       MAJTICKSIZE
171
172       Set the length of major ticks as a fraction of the default setting.
173       One (default) means leave these ticks the normal size.
174
175       MINTICKSIZE
176
177       Set the length of minor ticks (and error bar terminals) as a fraction
178       of the default setting.  One (default) means leave these ticks the
179       normal size.
180
181       NXSUB
182
183       The number of minor tick marks between each major tick mark on the X
184       axis.  Specify zero (default) to let PLplot compute this automatically.
185
186       NYSUB
187
188       The number of minor tick marks between each major tick mark on the Y
189       axis.  Specify zero (default) to let PLplot compute this automatically.
190
191       PALETTE
192
193       Load pre-defined color map 1 color ranges.  Currently, values include:
194
195         RAINBOW   -- from Red to Violet through the spectrum
196         REVERSERAINBOW   -- Violet through Red
197         GREYSCALE -- from black to white via grey.
198         REVERSEGREYSCALE -- from white to black via grey.
199         GREENRED  -- from green to red
200         REDGREEN  -- from red to green
201
202        # Plot x/y points with the z axis in color
203        $pl->xyplot ($x, $y, PALETTE => 'RAINBOW', PLOTTYPE => 'POINTS', COLORMAP => $z);
204
205       PLOTTYPE
206
207       Specify which type of XY plot is desired:
208
209         LINE       -- A line
210         POINTS     -- A bunch of symbols
211         LINEPOINTS -- both
212
213       SUBPAGE
214
215       Set which subpage to plot on.  Subpages are numbered 1 to N.  A zero
216       can be specified meaning 'advance to the next subpage' (just a call to
217       pladv()).
218
219         my $pl = PDL::Graphics::PLplot->new(DEV      => 'png',
220                                               FILE     => 'test.png',
221                                               SUBPAGES => [1,2]);
222         $pl->xyplot ($x, $y, SUBPAGE => 1);
223         $pl->xyplot ($a, $b, SUBPAGE => 2);
224
225       SYMBOL
226
227       Specify which symbol to use when plotting "PLOTTYPE => 'POINTS'".  A
228       large variety of symbols are available, see:
229       http://plplot.sourceforge.net/examples-data/demo07/x07.*.png, where *
230       is 01 - 17.
231
232       SYMBOLSIZE
233
234       Specify the size of symbols plotted in multiples of the default size
235       (1).  Value are real numbers from 0 to large.
236
237       TEXTPOSITION
238
239       Specify the placement of text.  Either relative to border, specified
240       as:
241
242        [$side, $disp, $pos, $just]
243
244       Where
245
246         side = 't', 'b', 'l', or 'r' for top, bottom, left and right
247         disp is the number of character heights out from the edge
248         pos  is the position along the edge of the viewport, from 0 to 1.
249         just tells where the reference point of the string is: 0 = left, 1 = right, 0.5 = center.
250
251       or inside the plot window, specified as:
252
253        [$x, $y, $dx, $dy, $just]
254
255       Where
256
257         x  = x coordinate of reference point of string.
258         y  = y coordinate of reference point of string.
259         dx   Together with dy, this specifies the inclination of the string.
260              The baseline of the string is parallel to a line joining (x, y) to (x+dx, y+dy).
261         dy   Together with dx, this specifies the inclination of the string.
262         just Specifies the position of the string relative to its reference point.
263              If just=0, the reference point is at the left and if just=1,
264              it is at the right of the string. Other values of just give
265              intermediate justifications.
266
267        # Plot text on top of plot
268        $pl->text ("Top label",  TEXTPOSITION => ['t', 4.0, 0.5, 0.5]);
269
270        # Plot text in plotting area
271        $pl->text ("Line label", TEXTPOSITION => [50, 60, 5, 5, 0.5]);
272
273       TITLE
274
275       Add a title on top of a plot.
276
277        # Plot text on top of plot
278        $pl->xyplot ($x, $y, TITLE => 'X vs. Y');
279
280       VIEWPORT
281
282       Set the location of the plotting window on the page.  Takes a four
283       element array ref specifying:
284
285        xmin -- The coordinate of the left-hand edge of the viewport. (0 to 1)
286        xmax -- The coordinate of the right-hand edge of the viewport. (0 to 1)
287        ymin -- The coordinate of the bottom edge of the viewport. (0 to 1)
288        ymax -- The coordinate of the top edge of the viewport. (0 to 1)
289
290        # Make a small plotting window in the lower left of the page
291        $pl->xyplot ($x, $y, VIEWPORT => [0.1, 0.5, 0.1, 0.5]);
292
293        # Also useful in creating color keys:
294        $pl->xyplot   ($x, $y, PALETTE => 'RAINBOW', PLOTTYPE => 'POINTS', COLORMAP => $z);
295        $pl->colorkey ($z, 'v', VIEWPORT => [0.93, 0.96, 0.15, 0.85]);
296
297       XBOX
298
299       Specify how to label the X axis of the plot as a string of option
300       letters:
301
302         a: Draws axis, X-axis is horizontal line (y=0), and Y-axis is vertical line (x=0).
303         b: Draws bottom (X) or left (Y) edge of frame.
304         c: Draws top (X) or right (Y) edge of frame.
305         f: Always use fixed point numeric labels.
306         g: Draws a grid at the major tick interval.
307         h: Draws a grid at the minor tick interval.
308         i: Inverts tick marks, so they are drawn outwards, rather than inwards.
309         l: Labels axis logarithmically. This only affects the labels, not the data,
310            and so it is necessary to compute the logarithms of data points before
311            passing them to any of the drawing routines.
312         m: Writes numeric labels at major tick intervals in the
313            unconventional location (above box for X, right of box for Y).
314         n: Writes numeric labels at major tick intervals in the conventional location
315            (below box for X, left of box for Y).
316         s: Enables subticks between major ticks, only valid if t is also specified.
317         t: Draws major ticks.
318
319       The default is 'BCNST' which draws lines around the plot, draws major
320       and minor ticks and labels major ticks.
321
322        # plot two lines in a box with independent X axes labeled
323        # differently on top and bottom
324        $pl->xyplot($x1, $y, XBOX  => 'bnst',  # bottom line, bottom numbers, ticks, subticks
325                             YBOX  => 'bnst'); # left line, left numbers, ticks, subticks
326        $pl->xyplot($x2, $y, XBOX => 'cmst', # top line, top numbers, ticks, subticks
327                             YBOX => 'cst',  # right line, ticks, subticks
328                             BOX => [$x2->minmax, $y->minmax]);
329
330       XERRORBAR
331
332       Used only with "xyplot".  Draws horizontal error bars at all points
333       ($x, $y) in the plot.  Specify a PDL containing the same number of
334       points as $x and $y which specifies the width of the error bar, which
335       will be centered at ($x, $y).
336
337       XLAB
338
339       Specify a label for the X axis.
340
341       XTICK
342
343       Interval (in graph units/world coordinates) between major x axis tick
344       marks.  Specify zero (default) to allow PLplot to compute this
345       automatically.
346
347       YBOX
348
349       Specify how to label the Y axis of the plot as a string of option
350       letters.  See "XBOX".
351
352       YERRORBAR
353
354       Used only for xyplot.  Draws vertical error bars at all points ($x, $y)
355       in the plot.  Specify a PDL containing the same number of points as $x
356       and $y which specifies the width of the error bar, which will be
357       centered at ($x, $y).
358
359       YLAB
360
361       Specify a label for the Y axis.
362
363       YTICK
364
365       Interval (in graph units/world coordinates) between major y axis tick
366       marks.  Specify zero (default) to allow PLplot to compute this
367       automatically.
368
369       ZRANGE
370
371       For "xyplot" (when "COLORMAP" is specified), for "shadeplot" and for
372       "colorkey".  Normally, the range of the Z variable (color) is taken as
373       "$z->minmax".  If a different range is desired, specify it in "ZRANGE",
374       like so:
375
376         $pl->shadeplot ($z, $nlevels, PALETTE => 'GREENRED', ZRANGE => [0,100]);
377
378       or
379
380         $pl->xyplot ($x, $y, PALETTE  => 'RAINBOW', PLOTTYPE => 'POINTS',
381                              COLORMAP => $z,        ZRANGE => [-90,-20]);
382         $pl->colorkey  ($z, 'v', VIEWPORT => [0.93, 0.96, 0.13, 0.85],
383                              ZRANGE => [-90,-20]);
384

FUNCTIONS

386   new
387       Create an object representing a plot.
388
389        Arguments:
390        none.
391
392        Supported options:
393        BACKGROUND
394        DEV
395        FILE
396        FRAMECOLOR
397        JUST
398        PAGESIZE
399        SUBPAGES
400
401         my $pl = PDL::Graphics::PLplot->new(DEV => 'png',  FILE => 'test.png');
402
403   setparm
404       Set options for a plot object.
405
406        Arguments:
407        none.
408
409        Supported options:
410        All options except:
411
412        BACKGROUND
413        DEV
414        FILE
415        FRAMECOLOR
416        JUST
417        PAGESIZE
418        SUBPAGES
419
420        (These must be set in call to 'new'.)
421
422         $pl->setparm (TEXTSIZE => 2);
423
424   xyplot
425       Plot XY lines and/or points.  Also supports color scales for points.
426       This function works with bad values.  If a bad value is specified for a
427       points plot, it is omitted.  If a bad value is specified for a line
428       plot, the bad value makes a gap in the line.  This is useful for
429       drawing maps; for example $x and $y can be the continent boundary
430       latitude and longitude.
431
432        Arguments:
433        $x, $y
434
435        Supported options:
436        All options except:
437
438        BACKGROUND
439        DEV
440        FILE
441        FRAMECOLOR
442        JUST
443        PAGESIZE
444        SUBPAGES
445
446        (These must be set in call to 'new'.)
447
448         $pl->xyplot($x, $y, PLOTTYPE => 'POINTS', COLOR => 'BLUEVIOLET', SYMBOL => 1, SYMBOLSIZE => 4);
449         $pl->xyplot($x, $y, PLOTTYPE => 'LINEPOINTS', COLOR => [50,230,30]);
450         $pl->xyplot($x, $y, PALETTE => 'RAINBOW', PLOTTYPE => 'POINTS', COLORMAP => $z);
451
452   stripplots
453       Plot a set of strip plots with a common X axis, but with different Y
454       axes.  Looks like a stack of long, thin XY plots, all line up on the
455       same X axis.
456
457        Arguments:
458        $x  -- 1D PDL with common X axis values, length = N
459        $ys -- 2D PDL with M Y-axis values: N x M
460        %opts -- Options hash
461
462        Supported options:
463        All options except:
464
465        BACKGROUND
466        DEV
467        FILE
468        FRAMECOLOR
469        JUST
470        PAGESIZE
471        SUBPAGES
472
473        (These must be set in call to 'new'.)
474
475         my $x  = sequence(20);
476         my $y1  = $x**2;
477         my $y2  = sqrt($x);
478         my $y3  = $x**3;
479         my $y4  = sin(($x/20) * 2 * $pi);
480         $ys  = cat($y1, $y2, $y3, $y4);
481         $pl->stripplots($x, $ys, PLOTTYPE => 'LINE', TITLE => 'functions',
482                                  YLAB     => ['x**2', 'sqrt(x)', 'x**3', 'sin(x/20*2pi)'],
483                                  COLOR    => ['GREEN', 'DEEPSKYBLUE', 'DARKORCHID1', 'DEEPPINK'], XLAB => 'X label');
484
485         In addition, COLOR may be specified as a reference to a list of colors.  If
486         this is done, the colors are applied separately to each plot.
487
488         Also, the options Y_BASE and Y_GUTTER can be specified.  Y_BASE gives the Y offset
489         of the bottom of the lowest plot (0-1, specified like a VIEWPORT, defaults to 0.1) and Y_GUTTER
490         gives the gap between the graphs (0-1, default = 0.02).
491
492   colorkey
493       Plot a color key showing which color represents which value
494
495        Arguments:
496        $range   : A PDL which tells the range of the color values
497        $orientation : 'v' for vertical color key, 'h' for horizontal
498
499        Supported options:
500        All options except:
501
502        BACKGROUND
503        DEV
504        FILE
505        FRAMECOLOR
506        JUST
507        PAGESIZE
508        SUBPAGES
509
510        (These must be set in call to 'new'.)
511
512         # Plot X vs. Y with Z shown by the color.  Then plot
513         # vertical key to the right of the original plot.
514         $pl->xyplot ($x, $y, PALETTE => 'RAINBOW', PLOTTYPE => 'POINTS', COLORMAP => $z);
515         $pl->colorkey ($z, 'v', VIEWPORT => [0.93, 0.96, 0.15, 0.85]);
516
517   shadeplot
518       Create a shaded contour plot of 2D PDL 'z' with 'nsteps' contour
519       levels.  Linear scaling is used to map the coordinates of Z(X, Y) to
520       world coordinates via the "BOX" option.
521
522        Arguments:
523        $z : A 2D PDL which contains surface values at each XY coordinate.
524        $nsteps : The number of contour levels requested for the plot.
525
526        Supported options:
527        All options except:
528
529        BACKGROUND
530        DEV
531        FILE
532        FRAMECOLOR
533        JUST
534        PAGESIZE
535        SUBPAGES
536
537        (These must be set in call to 'new'.)
538
539         # vertical key to the right of the original plot.
540         # The BOX must be specified to give real coordinate values to the $z array.
541         $pl->shadeplot ($z, $nsteps, BOX => [-1, 1, -1, 1], PALETTE => 'RAINBOW', ZRANGE => [0,100]);
542         $pl->colorkey  ($z, 'v', VIEWPORT => [0.93, 0.96, 0.15, 0.85], ZRANGE => [0,100]);
543
544   histogram
545       Create a histogram of a 1-D variable.
546
547        Arguments:
548        $x : A 1D PDL
549        $nbins : The number of bins to use in the histogram.
550
551        Supported options:
552        All options except:
553
554        BACKGROUND
555        DEV
556        FILE
557        FRAMECOLOR
558        JUST
559        PAGESIZE
560        SUBPAGES
561
562        (These must be set in call to 'new'.)
563
564         $pl->histogram ($x, $nbins, BOX => [$min, $max, 0, 100]);
565
566   bargraph
567       Simple utility to plot a bar chart with labels on the X axis.  The
568       usual options can be specified, plus one other:  MAXBARLABELS specifies
569       the maximum number of labels to allow on the X axis.  The default is
570       20.  If this value is exceeded, then every other label is plotted.  If
571       twice MAXBARLABELS is exceeded, then only every third label is printed,
572       and so on.
573
574        Arguments:
575        $labels -- A reference to a perl list of strings.
576        $values -- A PDL of values to be plotted.
577
578        Supported options:
579        All options except:
580
581        BACKGROUND
582        DEV
583        FILE
584        FRAMECOLOR
585        JUST
586        PAGESIZE
587        SUBPAGES
588
589        (These must be set in call to 'new'.)
590
591         $labels = ['one', 'two', 'three'];
592         $values = pdl(1, 2, 3);
593
594         # Note if TEXTPOSITION is specified, it must be in 4 argument mode (border mode):
595         # [$side, $disp, $pos, $just]
596         #
597         # Where side = 't', 'b', 'l', or 'r' for top, bottom, left and right
598         #              'tv', 'bv', 'lv' or 'rv' for top, bottom, left or right perpendicular to the axis.
599         #
600         #     disp is the number of character heights out from the edge
601         #     pos  is the position along the edge of the viewport, from 0 to 1.
602         #     just tells where the reference point of the string is: 0 = left, 1 = right, 0.5 = center.
603         #
604         # The '$pos' entry will be ignored (computed by the bargraph routine)
605         $pl->bargraph($labels, $values, MAXBARLABELS => 30, TEXTPOSITION => ['bv', 0.5, 1.0, 1.0]);
606
607   text
608       Write text on a plot.  Text can either be written with respect to the
609       borders or at an arbitrary location and angle (see the "TEXTPOSITION"
610       entry).
611
612        Arguments:
613        $t : The text.
614
615        Supported options:
616        All options except:
617
618        BACKGROUND
619        DEV
620        FILE
621        FRAMECOLOR
622        JUST
623        PAGESIZE
624        SUBPAGES
625
626        (These must be set in call to 'new'.)
627
628         $pl->text("Count", COLOR => 'PINK',
629                   TEXTPOSITION => ['t', 3, 0.5, 0.5]); # top, 3 units out, string ref. pt in
630                                                        # center of string, middle of axis
631
632   close
633       Close a PLplot object, writing out the file and cleaning up.
634
635       Arguments: None
636
637       Returns: Nothing
638
639       This closing of the PLplot object can be done explicitly though the
640       'close' method.  Alternatively, a DESTROY block does an automatic close
641       whenever the PLplot object passes out of scope.
642
643         $pl->close;
644

FUNCTIONS

646       The PDL low-level interface to the PLplot library closely mimics the C
647       API.  Users are referred to the PLplot User's Manual, distributed with
648       the source PLplot tarball.  This manual is also available on-line at
649       the PLplot web site (<http://www.plplot.org/>).
650
651       There are though two differences in way the functions are called.  The
652       first one is due to a limitation in the pp_def wrapper of PDL, which
653       forces all the non-piddle arguments to be at the end of the arguments
654       list.  It is the case of strings ("char *") arguments in the C API.
655       This affects the following functions [shown below with their prototypes
656       in PDL, with arguments preceded by "(pdl)" are piddle-convertible; see
657       the PLplot manual for the meaning of the arguments]:
658
659         plaxes ((pdl) x0, (pdl) y0, (pdl) xtick, (pdl) nxsub, (pdl) ytick,
660                 (pdl) nysub, (string) xopt, (string (yopt))
661         plbox ((pdl) xtick, (pdl) nxsub, (pdl) ytick, (pdl) nysub,
662                (string) xopt, (string) yopt)
663         plbox3 ((pdl) xtick, (pdl) nsubx, (pdl) ytick, (pdl) nsuby,
664                 (pdl) ztick, (pdl) nsubz, (string) xopt, (string) xlabel,
665                 (string) yopt, (string) ylabel, (string) zopt,
666                 (string) zlabel)
667         plmtex ((pdl) disp, (pdl) pos, (pdl) just, (string) side),
668                 (string) text);
669         plstart ((pdl) nx, (pdl) ny, (string) devname);
670
671       The second notable different between the C and the PDL APIs is that
672       many of the PDL calls do not need arguments to specify the size of the
673       the vectors and/or matrices being passed.  This size parameters are
674       deduced from the size of the piddles, when possible.  For now, the
675       following interfaces are affected:
676
677         plcont (f, kx, lx, ky, ly, clevel)
678         plfill (x, y)
679         plhist (data, datmin, datmax, nbin, oldwin)
680         plline (x, y)
681         plline3 (x, y, z)
682         plpoly3 (x, y, z, draw, ifcc)
683         plmesh (x, y, z, opt)
684         plmeshc (x, y, z, opt, clevel)
685         plot3d (x, y, z, opt, side)
686         plpoin (x, y, code)
687         plpoin3 (x, y, z, code)
688         plscmap1l (itype, intensity, coord1, coord2, coord3, rev)
689         plstyl (mark, space)
690         plsym (x, y, code)
691
692       Some of the API functions implemented in PDL have other specificities
693       in comparison with the C API and will be discussed below.
694
695   pladv
696         Signature: (int page())
697
698       info not available
699
700       pladv does not process bad values.  It will set the bad-value flag of
701       all output piddles if the flag is set for any of the input piddles.
702
703   plarrows
704         Signature: (double u(dima);double v(dima);double x(dima);double y(dima);int n();double scale();double dx();double dy())
705
706       info not available
707
708       plarrows does not process bad values.  It will set the bad-value flag
709       of all output piddles if the flag is set for any of the input piddles.
710
711   plaxes
712         Signature: (double xzero();double yzero();double xtick();int nxsub();double ytick();int nysub(); char *xopt;char *yopt)
713
714       info not available
715
716       plaxes does not process bad values.  It will set the bad-value flag of
717       all output piddles if the flag is set for any of the input piddles.
718
719   plbin
720         Signature: (int nbin();double x(dima);double y(dima);int center())
721
722       info not available
723
724       plbin does not process bad values.  It will set the bad-value flag of
725       all output piddles if the flag is set for any of the input piddles.
726
727   plbox
728         Signature: (double xtick();int nxsub();double ytick();int nysub(); char *xopt;char *yopt)
729
730       info not available
731
732       plbox does not process bad values.  It will set the bad-value flag of
733       all output piddles if the flag is set for any of the input piddles.
734
735   plbox3
736         Signature: (double xtick();int nsubx();double ytick();int nsuby();double ztick();int nsubz(); char *xopt;char *xlabel;char *yopt;char *ylabel;char *zopt;char *zlabel)
737
738       info not available
739
740       plbox3 does not process bad values.  It will set the bad-value flag of
741       all output piddles if the flag is set for any of the input piddles.
742
743   plcol0
744         Signature: (int icolzero())
745
746       info not available
747
748       plcol0 does not process bad values.  It will set the bad-value flag of
749       all output piddles if the flag is set for any of the input piddles.
750
751   plcol1
752         Signature: (double colone())
753
754       info not available
755
756       plcol1 does not process bad values.  It will set the bad-value flag of
757       all output piddles if the flag is set for any of the input piddles.
758
759   plcpstrm
760         Signature: (int iplsr();int flags())
761
762       info not available
763
764       plcpstrm does not process bad values.  It will set the bad-value flag
765       of all output piddles if the flag is set for any of the input piddles.
766
767   pldid2pc
768         Signature: (double xmin(dima);double ymin(dima);double xmax(dima);double ymax(dima))
769
770       info not available
771
772       pldid2pc does not process bad values.  It will set the bad-value flag
773       of all output piddles if the flag is set for any of the input piddles.
774
775   pldip2dc
776         Signature: (double xmin(dima);double ymin(dima);double xmax(dima);double ymax(dima))
777
778       info not available
779
780       pldip2dc does not process bad values.  It will set the bad-value flag
781       of all output piddles if the flag is set for any of the input piddles.
782
783   plenv
784         Signature: (double xmin();double xmax();double ymin();double ymax();int just();int axis())
785
786       info not available
787
788       plenv does not process bad values.  It will set the bad-value flag of
789       all output piddles if the flag is set for any of the input piddles.
790
791   plenv0
792         Signature: (double xmin();double xmax();double ymin();double ymax();int just();int axis())
793
794       info not available
795
796       plenv0 does not process bad values.  It will set the bad-value flag of
797       all output piddles if the flag is set for any of the input piddles.
798
799   plerrx
800         Signature: (int n();double xmin(dima);double xmax(dima);double y(dima))
801
802       info not available
803
804       plerrx does not process bad values.  It will set the bad-value flag of
805       all output piddles if the flag is set for any of the input piddles.
806
807   plerry
808         Signature: (int n();double x(dima);double ymin(dima);double ymax(dima))
809
810       info not available
811
812       plerry does not process bad values.  It will set the bad-value flag of
813       all output piddles if the flag is set for any of the input piddles.
814
815   plfill3
816         Signature: (int n();double x(dima);double y(dima);double z(dima))
817
818       info not available
819
820       plfill3 does not process bad values.  It will set the bad-value flag of
821       all output piddles if the flag is set for any of the input piddles.
822
823   plfont
824         Signature: (int ifont())
825
826       info not available
827
828       plfont does not process bad values.  It will set the bad-value flag of
829       all output piddles if the flag is set for any of the input piddles.
830
831   plfontld
832         Signature: (int fnt())
833
834       info not available
835
836       plfontld does not process bad values.  It will set the bad-value flag
837       of all output piddles if the flag is set for any of the input piddles.
838
839   plgchr
840         Signature: (double [o]p_def();double [o]p_ht())
841
842       info not available
843
844       plgchr does not process bad values.  It will set the bad-value flag of
845       all output piddles if the flag is set for any of the input piddles.
846
847   plgcompression
848         Signature: (int [o]compression())
849
850       info not available
851
852       plgcompression does not process bad values.  It will set the bad-value
853       flag of all output piddles if the flag is set for any of the input
854       piddles.
855
856   plgdidev
857         Signature: (double [o]p_mar();double [o]p_aspect();double [o]p_jx();double [o]p_jy())
858
859       info not available
860
861       plgdidev does not process bad values.  It will set the bad-value flag
862       of all output piddles if the flag is set for any of the input piddles.
863
864   plgdiori
865         Signature: (double [o]p_rot())
866
867       info not available
868
869       plgdiori does not process bad values.  It will set the bad-value flag
870       of all output piddles if the flag is set for any of the input piddles.
871
872   plgdiplt
873         Signature: (double [o]p_xmin();double [o]p_ymin();double [o]p_xmax();double [o]p_ymax())
874
875       info not available
876
877       plgdiplt does not process bad values.  It will set the bad-value flag
878       of all output piddles if the flag is set for any of the input piddles.
879
880   plgfam
881         Signature: (int [o]p_fam();int [o]p_num();int [o]p_bmax())
882
883       info not available
884
885       plgfam does not process bad values.  It will set the bad-value flag of
886       all output piddles if the flag is set for any of the input piddles.
887
888   plglevel
889         Signature: (int [o]p_level())
890
891       info not available
892
893       plglevel does not process bad values.  It will set the bad-value flag
894       of all output piddles if the flag is set for any of the input piddles.
895
896   plgpage
897         Signature: (double [o]p_xp();double [o]p_yp();int [o]p_xleng();int [o]p_yleng();int [o]p_xoff();int [o]p_yoff())
898
899       info not available
900
901       plgpage does not process bad values.  It will set the bad-value flag of
902       all output piddles if the flag is set for any of the input piddles.
903
904   plgspa
905         Signature: (double [o]xmin();double [o]xmax();double [o]ymin();double [o]ymax())
906
907       info not available
908
909       plgspa does not process bad values.  It will set the bad-value flag of
910       all output piddles if the flag is set for any of the input piddles.
911
912   plgvpd
913         Signature: (double [o]p_xmin();double [o]p_xmax();double [o]p_ymin();double [o]p_ymax())
914
915       info not available
916
917       plgvpd does not process bad values.  It will set the bad-value flag of
918       all output piddles if the flag is set for any of the input piddles.
919
920   plgvpw
921         Signature: (double [o]p_xmin();double [o]p_xmax();double [o]p_ymin();double [o]p_ymax())
922
923       info not available
924
925       plgvpw does not process bad values.  It will set the bad-value flag of
926       all output piddles if the flag is set for any of the input piddles.
927
928   plgxax
929         Signature: (int [o]p_digmax();int [o]p_digits())
930
931       info not available
932
933       plgxax does not process bad values.  It will set the bad-value flag of
934       all output piddles if the flag is set for any of the input piddles.
935
936   plgyax
937         Signature: (int [o]p_digmax();int [o]p_digits())
938
939       info not available
940
941       plgyax does not process bad values.  It will set the bad-value flag of
942       all output piddles if the flag is set for any of the input piddles.
943
944   plgzax
945         Signature: (int [o]p_digmax();int [o]p_digits())
946
947       info not available
948
949       plgzax does not process bad values.  It will set the bad-value flag of
950       all output piddles if the flag is set for any of the input piddles.
951
952   plhls
953         Signature: (double h();double l();double s())
954
955       info not available
956
957       plhls does not process bad values.  It will set the bad-value flag of
958       all output piddles if the flag is set for any of the input piddles.
959
960   pljoin
961         Signature: (double xone();double yone();double xtwo();double ytwo())
962
963       info not available
964
965       pljoin does not process bad values.  It will set the bad-value flag of
966       all output piddles if the flag is set for any of the input piddles.
967
968   pllightsource
969         Signature: (double x();double y();double z())
970
971       info not available
972
973       pllightsource does not process bad values.  It will set the bad-value
974       flag of all output piddles if the flag is set for any of the input
975       piddles.
976
977   pllsty
978         Signature: (int lin())
979
980       info not available
981
982       pllsty does not process bad values.  It will set the bad-value flag of
983       all output piddles if the flag is set for any of the input piddles.
984
985   plmtex
986         Signature: (double disp();double pos();double just(); char *side;char *text)
987
988       info not available
989
990       plmtex does not process bad values.  It will set the bad-value flag of
991       all output piddles if the flag is set for any of the input piddles.
992
993   plmtex3
994         Signature: (double disp();double pos();double just(); char *side;char *text)
995
996       info not available
997
998       plmtex3 does not process bad values.  It will set the bad-value flag of
999       all output piddles if the flag is set for any of the input piddles.
1000
1001   plpat
1002         Signature: (int nlin();int inc(dima);int del(dima))
1003
1004       info not available
1005
1006       plpat does not process bad values.  It will set the bad-value flag of
1007       all output piddles if the flag is set for any of the input piddles.
1008
1009   plprec
1010         Signature: (int setp();int prec())
1011
1012       info not available
1013
1014       plprec does not process bad values.  It will set the bad-value flag of
1015       all output piddles if the flag is set for any of the input piddles.
1016
1017   plpsty
1018         Signature: (int patt())
1019
1020       info not available
1021
1022       plpsty does not process bad values.  It will set the bad-value flag of
1023       all output piddles if the flag is set for any of the input piddles.
1024
1025   plptex
1026         Signature: (double x();double y();double dx();double dy();double just(); char *text)
1027
1028       info not available
1029
1030       plptex does not process bad values.  It will set the bad-value flag of
1031       all output piddles if the flag is set for any of the input piddles.
1032
1033   plptex3
1034         Signature: (double x();double y();double z();double dx();double dy();double dz();double sx();double sy();double sz();double just(); char *text)
1035
1036       info not available
1037
1038       plptex3 does not process bad values.  It will set the bad-value flag of
1039       all output piddles if the flag is set for any of the input piddles.
1040
1041   plrgb
1042         Signature: (double r();double g();double b())
1043
1044       info not available
1045
1046       plrgb does not process bad values.  It will set the bad-value flag of
1047       all output piddles if the flag is set for any of the input piddles.
1048
1049   plrgb1
1050         Signature: (int r();int g();int b())
1051
1052       info not available
1053
1054       plrgb1 does not process bad values.  It will set the bad-value flag of
1055       all output piddles if the flag is set for any of the input piddles.
1056
1057   plschr
1058         Signature: (double def();double scale())
1059
1060       info not available
1061
1062       plschr does not process bad values.  It will set the bad-value flag of
1063       all output piddles if the flag is set for any of the input piddles.
1064
1065   plscmap0n
1066         Signature: (int ncolzero())
1067
1068       info not available
1069
1070       plscmap0n does not process bad values.  It will set the bad-value flag
1071       of all output piddles if the flag is set for any of the input piddles.
1072
1073   plscmap1n
1074         Signature: (int ncolone())
1075
1076       info not available
1077
1078       plscmap1n does not process bad values.  It will set the bad-value flag
1079       of all output piddles if the flag is set for any of the input piddles.
1080
1081   plscol0
1082         Signature: (int icolzero();int r();int g();int b())
1083
1084       info not available
1085
1086       plscol0 does not process bad values.  It will set the bad-value flag of
1087       all output piddles if the flag is set for any of the input piddles.
1088
1089   plscolbg
1090         Signature: (int r();int g();int b())
1091
1092       info not available
1093
1094       plscolbg does not process bad values.  It will set the bad-value flag
1095       of all output piddles if the flag is set for any of the input piddles.
1096
1097   plscolor
1098         Signature: (int color())
1099
1100       info not available
1101
1102       plscolor does not process bad values.  It will set the bad-value flag
1103       of all output piddles if the flag is set for any of the input piddles.
1104
1105   plscompression
1106         Signature: (int compression())
1107
1108       info not available
1109
1110       plscompression does not process bad values.  It will set the bad-value
1111       flag of all output piddles if the flag is set for any of the input
1112       piddles.
1113
1114   plsdidev
1115         Signature: (double mar();double aspect();double jx();double jy())
1116
1117       info not available
1118
1119       plsdidev does not process bad values.  It will set the bad-value flag
1120       of all output piddles if the flag is set for any of the input piddles.
1121
1122   plsdimap
1123         Signature: (int dimxmin();int dimxmax();int dimymin();int dimymax();double dimxpmm();double dimypmm())
1124
1125       info not available
1126
1127       plsdimap does not process bad values.  It will set the bad-value flag
1128       of all output piddles if the flag is set for any of the input piddles.
1129
1130   plsdiori
1131         Signature: (double rot())
1132
1133       info not available
1134
1135       plsdiori does not process bad values.  It will set the bad-value flag
1136       of all output piddles if the flag is set for any of the input piddles.
1137
1138   plsdiplt
1139         Signature: (double xmin();double ymin();double xmax();double ymax())
1140
1141       info not available
1142
1143       plsdiplt does not process bad values.  It will set the bad-value flag
1144       of all output piddles if the flag is set for any of the input piddles.
1145
1146   plsdiplz
1147         Signature: (double xmin();double ymin();double xmax();double ymax())
1148
1149       info not available
1150
1151       plsdiplz does not process bad values.  It will set the bad-value flag
1152       of all output piddles if the flag is set for any of the input piddles.
1153
1154   pl_setcontlabelparam
1155         Signature: (double offset();double size();double spacing();int active())
1156
1157       info not available
1158
1159       pl_setcontlabelparam does not process bad values.  It will set the bad-
1160       value flag of all output piddles if the flag is set for any of the
1161       input piddles.
1162
1163   pl_setcontlabelformat
1164         Signature: (int lexp();int sigdig())
1165
1166       info not available
1167
1168       pl_setcontlabelformat does not process bad values.  It will set the
1169       bad-value flag of all output piddles if the flag is set for any of the
1170       input piddles.
1171
1172   plsfam
1173         Signature: (int fam();int num();int bmax())
1174
1175       info not available
1176
1177       plsfam does not process bad values.  It will set the bad-value flag of
1178       all output piddles if the flag is set for any of the input piddles.
1179
1180   plsmaj
1181         Signature: (double def();double scale())
1182
1183       info not available
1184
1185       plsmaj does not process bad values.  It will set the bad-value flag of
1186       all output piddles if the flag is set for any of the input piddles.
1187
1188   plsmin
1189         Signature: (double def();double scale())
1190
1191       info not available
1192
1193       plsmin does not process bad values.  It will set the bad-value flag of
1194       all output piddles if the flag is set for any of the input piddles.
1195
1196   plsori
1197         Signature: (int ori())
1198
1199       info not available
1200
1201       plsori does not process bad values.  It will set the bad-value flag of
1202       all output piddles if the flag is set for any of the input piddles.
1203
1204   plspage
1205         Signature: (double xp();double yp();int xleng();int yleng();int xoff();int yoff())
1206
1207       info not available
1208
1209       plspage does not process bad values.  It will set the bad-value flag of
1210       all output piddles if the flag is set for any of the input piddles.
1211
1212   plspause
1213         Signature: (int pause())
1214
1215       info not available
1216
1217       plspause does not process bad values.  It will set the bad-value flag
1218       of all output piddles if the flag is set for any of the input piddles.
1219
1220   plsstrm
1221         Signature: (int strm())
1222
1223       info not available
1224
1225       plsstrm does not process bad values.  It will set the bad-value flag of
1226       all output piddles if the flag is set for any of the input piddles.
1227
1228   plssub
1229         Signature: (int nx();int ny())
1230
1231       info not available
1232
1233       plssub does not process bad values.  It will set the bad-value flag of
1234       all output piddles if the flag is set for any of the input piddles.
1235
1236   plssym
1237         Signature: (double def();double scale())
1238
1239       info not available
1240
1241       plssym does not process bad values.  It will set the bad-value flag of
1242       all output piddles if the flag is set for any of the input piddles.
1243
1244   plstar
1245         Signature: (int nx();int ny())
1246
1247       info not available
1248
1249       plstar does not process bad values.  It will set the bad-value flag of
1250       all output piddles if the flag is set for any of the input piddles.
1251
1252   plstart
1253         Signature: (int nx();int ny(); char *devname)
1254
1255       info not available
1256
1257       plstart does not process bad values.  It will set the bad-value flag of
1258       all output piddles if the flag is set for any of the input piddles.
1259
1260   plstripa
1261         Signature: (int id();int pen();double x();double y())
1262
1263       info not available
1264
1265       plstripa does not process bad values.  It will set the bad-value flag
1266       of all output piddles if the flag is set for any of the input piddles.
1267
1268   plstripd
1269         Signature: (int id())
1270
1271       info not available
1272
1273       plstripd does not process bad values.  It will set the bad-value flag
1274       of all output piddles if the flag is set for any of the input piddles.
1275
1276   plsvpa
1277         Signature: (double xmin();double xmax();double ymin();double ymax())
1278
1279       info not available
1280
1281       plsvpa does not process bad values.  It will set the bad-value flag of
1282       all output piddles if the flag is set for any of the input piddles.
1283
1284   plsxax
1285         Signature: (int digmax();int digits())
1286
1287       info not available
1288
1289       plsxax does not process bad values.  It will set the bad-value flag of
1290       all output piddles if the flag is set for any of the input piddles.
1291
1292   plsxwin
1293         Signature: (int window_id())
1294
1295       info not available
1296
1297       plsxwin does not process bad values.  It will set the bad-value flag of
1298       all output piddles if the flag is set for any of the input piddles.
1299
1300   plsyax
1301         Signature: (int digmax();int digits())
1302
1303       info not available
1304
1305       plsyax does not process bad values.  It will set the bad-value flag of
1306       all output piddles if the flag is set for any of the input piddles.
1307
1308   plszax
1309         Signature: (int digmax();int digits())
1310
1311       info not available
1312
1313       plszax does not process bad values.  It will set the bad-value flag of
1314       all output piddles if the flag is set for any of the input piddles.
1315
1316   plvasp
1317         Signature: (double aspect())
1318
1319       info not available
1320
1321       plvasp does not process bad values.  It will set the bad-value flag of
1322       all output piddles if the flag is set for any of the input piddles.
1323
1324   plvpas
1325         Signature: (double xmin();double xmax();double ymin();double ymax();double aspect())
1326
1327       info not available
1328
1329       plvpas does not process bad values.  It will set the bad-value flag of
1330       all output piddles if the flag is set for any of the input piddles.
1331
1332   plvpor
1333         Signature: (double xmin();double xmax();double ymin();double ymax())
1334
1335       info not available
1336
1337       plvpor does not process bad values.  It will set the bad-value flag of
1338       all output piddles if the flag is set for any of the input piddles.
1339
1340   plw3d
1341         Signature: (double basex();double basey();double height();double xminzero();double xmaxzero();double yminzero();double ymaxzero();double zminzero();double zmaxzero();double alt();double az())
1342
1343       info not available
1344
1345       plw3d does not process bad values.  It will set the bad-value flag of
1346       all output piddles if the flag is set for any of the input piddles.
1347
1348   plwid
1349         Signature: (int width())
1350
1351       info not available
1352
1353       plwid does not process bad values.  It will set the bad-value flag of
1354       all output piddles if the flag is set for any of the input piddles.
1355
1356   plwind
1357         Signature: (double xmin();double xmax();double ymin();double ymax())
1358
1359       info not available
1360
1361       plwind does not process bad values.  It will set the bad-value flag of
1362       all output piddles if the flag is set for any of the input piddles.
1363
1364   plP_gpixmm
1365         Signature: (double p_x(dima);double p_y(dima))
1366
1367       info not available
1368
1369       plP_gpixmm does not process bad values.  It will set the bad-value flag
1370       of all output piddles if the flag is set for any of the input piddles.
1371
1372   plscolbga
1373         Signature: (int r();int g();int b();double a())
1374
1375       info not available
1376
1377       plscolbga does not process bad values.  It will set the bad-value flag
1378       of all output piddles if the flag is set for any of the input piddles.
1379
1380   plscol0a
1381         Signature: (int icolzero();int r();int g();int b();double a())
1382
1383       info not available
1384
1385       plscol0a does not process bad values.  It will set the bad-value flag
1386       of all output piddles if the flag is set for any of the input piddles.
1387
1388   plline
1389         Signature: (x(n); y(n))
1390
1391       info not available
1392
1393       plline does handle bad values.  It will set the bad-value flag of all
1394       output piddles if the flag is set for any of the input piddles.
1395
1396   plcolorpoints
1397         Signature: (x(n); y(n); z(n); int sym(); minz(); maxz())
1398
1399       info not available
1400
1401       plcolorpoints does handle bad values.  It will set the bad-value flag
1402       of all output piddles if the flag is set for any of the input piddles.
1403
1404   plsmem
1405         Signature: (int maxx();int maxy();image(3,x,y))
1406
1407       info not available
1408
1409       plsmem does not process bad values.  It will set the bad-value flag of
1410       all output piddles if the flag is set for any of the input piddles.
1411
1412   plfbox
1413         Signature: (xo(); yo())
1414
1415       info not available
1416
1417       plfbox does not process bad values.  It will set the bad-value flag of
1418       all output piddles if the flag is set for any of the input piddles.
1419
1420   plParseOpts
1421         Signature: (int [o] retval(); SV* argv; int mode)
1422
1423       FIXME: documentation here!
1424
1425       plParseOpts does not process bad values.  It will set the bad-value
1426       flag of all output piddles if the flag is set for any of the input
1427       piddles.
1428
1429   plpoin
1430         Signature: (x(n); y(n); int code())
1431
1432       info not available
1433
1434       plpoin does not process bad values.  It will set the bad-value flag of
1435       all output piddles if the flag is set for any of the input piddles.
1436
1437   plpoin3
1438         Signature: (x(n); y(n); z(n); int code())
1439
1440       info not available
1441
1442       plpoin3 does not process bad values.  It will set the bad-value flag of
1443       all output piddles if the flag is set for any of the input piddles.
1444
1445   plline3
1446         Signature: (x(n); y(n); z(n))
1447
1448       info not available
1449
1450       plline3 does not process bad values.  It will set the bad-value flag of
1451       all output piddles if the flag is set for any of the input piddles.
1452
1453   plpoly3
1454         Signature: (x(n); y(n); z(n); int draw(m); int ifcc())
1455
1456       info not available
1457
1458       plpoly3 does not process bad values.  It will set the bad-value flag of
1459       all output piddles if the flag is set for any of the input piddles.
1460
1461   plhist
1462         Signature: (data(n); datmin(); datmax(); int nbin(); int oldwin())
1463
1464       info not available
1465
1466       plhist does not process bad values.  It will set the bad-value flag of
1467       all output piddles if the flag is set for any of the input piddles.
1468
1469   plfill
1470         Signature: (x(n); y(n))
1471
1472       info not available
1473
1474       plfill does not process bad values.  It will set the bad-value flag of
1475       all output piddles if the flag is set for any of the input piddles.
1476
1477   plsym
1478         Signature: (x(n); y(n); int code())
1479
1480       info not available
1481
1482       plsym does not process bad values.  It will set the bad-value flag of
1483       all output piddles if the flag is set for any of the input piddles.
1484
1485   plsurf3d
1486         Signature: (x(nx); y(ny); z(nx,ny); int opt(); clevel(nlevel))
1487
1488       info not available
1489
1490       plsurf3d does not process bad values.  It will set the bad-value flag
1491       of all output piddles if the flag is set for any of the input piddles.
1492
1493   plstyl
1494         Signature: (int mark(nms); int space(nms))
1495
1496       info not available
1497
1498       plstyl does not process bad values.  It will set the bad-value flag of
1499       all output piddles if the flag is set for any of the input piddles.
1500
1501   plseed
1502         Signature: (int seed())
1503
1504       info not available
1505
1506       plseed does not process bad values.  It will set the bad-value flag of
1507       all output piddles if the flag is set for any of the input piddles.
1508
1509   plrandd
1510         Signature: (double [o]rand())
1511
1512       info not available
1513
1514       plrandd does not process bad values.  It will set the bad-value flag of
1515       all output piddles if the flag is set for any of the input piddles.
1516
1517   plAllocGrid
1518         Signature: (double xg(nx); double yg(ny); int [o] grid())
1519
1520       FIXME: documentation here!
1521
1522       plAllocGrid does not process bad values.  It will set the bad-value
1523       flag of all output piddles if the flag is set for any of the input
1524       piddles.
1525
1526   plAlloc2dGrid
1527         Signature: (double xg(nx,ny); double yg(nx,ny); int [o] grid())
1528
1529       FIXME: documentation here!
1530
1531       plAlloc2dGrid does not process bad values.  It will set the bad-value
1532       flag of all output piddles if the flag is set for any of the input
1533       piddles.
1534
1535   init_pltr
1536         Signature: (P(); C(); SV* p0; SV* p1; SV* p2)
1537
1538       FIXME: documentation here!
1539
1540       init_pltr does not process bad values.  It will set the bad-value flag
1541       of all output piddles if the flag is set for any of the input piddles.
1542
1543   plmap
1544         Signature: (minlong(); maxlong(); minlat(); maxlat(); SV* mapform; char* type)
1545
1546       info not available
1547
1548       plmap does not process bad values.  It will set the bad-value flag of
1549       all output piddles if the flag is set for any of the input piddles.
1550
1551   plmeridians
1552         Signature: (dlong(); dlat(); minlong(); maxlong(); minlat(); maxlat(); SV* mapform)
1553
1554       info not available
1555
1556       plmeridians does not process bad values.  It will set the bad-value
1557       flag of all output piddles if the flag is set for any of the input
1558       piddles.
1559
1560   plshades
1561         Signature: (z(x,y); xmin(); xmax(); ymin(); ymax();
1562                         clevel(l); int fill_width(); int cont_color();
1563                         int cont_width(); int rectangular(); SV* defined; SV* pltr; SV* pltr_data)
1564
1565       info not available
1566
1567       plshades does not process bad values.  It will set the bad-value flag
1568       of all output piddles if the flag is set for any of the input piddles.
1569
1570   plcont
1571         Signature: (f(nx,ny); int kx(); int lx(); int ky(); int ly(); clevel(nlevel); SV* pltr; SV* pltr_data)
1572
1573       FIXME: documentation here!
1574
1575       plcont does not process bad values.  It will set the bad-value flag of
1576       all output piddles if the flag is set for any of the input piddles.
1577
1578   plmesh
1579         Signature: (x(nx); y(ny); z(nx,ny); int opt())
1580
1581       FIXME: documentation here!
1582
1583       plmesh does not process bad values.  It will set the bad-value flag of
1584       all output piddles if the flag is set for any of the input piddles.
1585
1586   plmeshc
1587         Signature: (x(nx); y(ny); z(nx,ny); int opt(); clevel(nlevel))
1588
1589       FIXME: documentation here!
1590
1591       plmeshc does not process bad values.  It will set the bad-value flag of
1592       all output piddles if the flag is set for any of the input piddles.
1593
1594   plot3d
1595         Signature: (x(nx); y(ny); z(nx,ny); int opt(); int side())
1596
1597       FIXME: documentation here!
1598
1599       plot3d does not process bad values.  It will set the bad-value flag of
1600       all output piddles if the flag is set for any of the input piddles.
1601
1602   plot3dc
1603         Signature: (x(nx); y(ny); z(nx,ny); int opt(); clevel(nlevel))
1604
1605       FIXME: documentation here!
1606
1607       plot3dc does not process bad values.  It will set the bad-value flag of
1608       all output piddles if the flag is set for any of the input piddles.
1609
1610   plscmap1l
1611         Signature: (int itype(); isty(n); coord1(n); coord2(n); coord3(n); int rev(nrev))
1612
1613       FIXME: documentation here!
1614
1615       plscmap1l does not process bad values.  It will set the bad-value flag
1616       of all output piddles if the flag is set for any of the input piddles.
1617
1618   plshade1
1619         Signature: (a(nx,ny); left(); right(); bottom(); top(); shade_min();shade_max(); sh_cmap(); sh_color(); sh_width();min_color(); min_width(); max_color(); max_width();rectangular(); SV* defined; SV* pltr; SV* pltr_data)
1620
1621       FIXME: documentation here!
1622
1623       plshade1 does not process bad values.  It will set the bad-value flag
1624       of all output piddles if the flag is set for any of the input piddles.
1625
1626   plimage
1627         Signature: (idata(nx,ny); xmin(); xmax(); ymin(); ymax();zmin(); zmax(); Dxmin(); Dxmax(); Dymin(); Dymax())
1628
1629       info not available
1630
1631       plimage does not process bad values.  It will set the bad-value flag of
1632       all output piddles if the flag is set for any of the input piddles.
1633
1634   plimagefr
1635         Signature: (idata(nx,ny); xmin(); xmax(); ymin(); ymax();zmin(); zmax(); valuemin(); valuemax(); SV* pltr; SV* pltr_data)
1636
1637       info not available
1638
1639       plimagefr does not process bad values.  It will set the bad-value flag
1640       of all output piddles if the flag is set for any of the input piddles.
1641
1642   plxormod
1643         $status = plxormod ($mode)
1644
1645       See the PLplot manual for reference.
1646
1647   plGetCursor
1648         %gin = plGetCursor ()
1649
1650       plGetCursor waits for graphics input event and translate to world
1651       coordinates and returns a hash with the following keys:
1652
1653           type:      of event (CURRENTLY UNUSED)
1654           state:     key or button mask
1655           keysym:    key selected
1656           button:    mouse button selected
1657           subwindow: subwindow (alias subpage, alias subplot) number
1658           string:    translated string
1659           pX, pY:    absolute device coordinates of pointer
1660           dX, dY:    relative device coordinates of pointer
1661           wX, wY:    world coordinates of pointer
1662
1663       Returns an empty hash if no translation to world coordinates is
1664       possible.
1665
1666   plgstrm
1667         $strm = plgstrm ()
1668
1669       Returns the number of the current output stream.
1670
1671   plgsdev
1672         $driver = plgdev ()
1673
1674       Returns the current driver name.
1675
1676   plmkstrm
1677         $strm = plmkstrm ()
1678
1679       Creates a new stream and makes it the default.  Returns the number of
1680       the created stream.
1681
1682   plgver
1683         $version = plgver ()
1684
1685       See the PLplot manual for reference.
1686
1687   plstripc
1688         Signature: (xmin(); xmax(); xjump(); ymin(); ymax();xlpos(); ylpos(); int y_ascl(); int acc();int colbox(); int collab();int colline(n); int styline(n);  int [o] id(); char* xspec; char* yspec; SV* legline;char* labx; char* laby; char* labtop)
1689
1690       FIXME: documentation here!
1691
1692       plstripc does not process bad values.  It will set the bad-value flag
1693       of all output piddles if the flag is set for any of the input piddles.
1694
1695   plgriddata
1696         Signature: (x(npts); y(npts); z(npts); xg(nptsx); yg(nptsy);int type(); data(); [o] zg(nptsx,nptsy))
1697
1698       FIXME: documentation here!
1699
1700       plgriddata does not process bad values.  It will set the bad-value flag
1701       of all output piddles if the flag is set for any of the input piddles.
1702
1703   plvect
1704         Signature: (u(nx,ny); v(nx,ny); scale(); SV* pltr; SV* pltr_data)
1705
1706       FIXME: documentation here!
1707
1708       plvect does not process bad values.  It will set the bad-value flag of
1709       all output piddles if the flag is set for any of the input piddles.
1710
1711   plsvect
1712         Signature: (arrowx(npts); arrowy(npts); int fill())
1713
1714       info not available
1715
1716       plsvect does not process bad values.  It will set the bad-value flag of
1717       all output piddles if the flag is set for any of the input piddles.
1718
1719   plhlsrgb
1720         Signature: (double h();double l();double s();double [o]p_r();double [o]p_g();double [o]p_b())
1721
1722       info not available
1723
1724       plhlsrgb does not process bad values.  It will set the bad-value flag
1725       of all output piddles if the flag is set for any of the input piddles.
1726
1727   plgcol0
1728         Signature: (int icolzero(); int [o]r(); int [o]g(); int [o]b())
1729
1730       info not available
1731
1732       plgcol0 does not process bad values.  It will set the bad-value flag of
1733       all output piddles if the flag is set for any of the input piddles.
1734
1735   plgcolbg
1736         Signature: (int [o]r(); int [o]g(); int [o]b())
1737
1738       info not available
1739
1740       plgcolbg does not process bad values.  It will set the bad-value flag
1741       of all output piddles if the flag is set for any of the input piddles.
1742
1743   plscmap0
1744         Signature: (int r(n); int g(n); int b(n))
1745
1746       info not available
1747
1748       plscmap0 does not process bad values.  It will set the bad-value flag
1749       of all output piddles if the flag is set for any of the input piddles.
1750
1751   plscmap1
1752         Signature: (int r(n); int g(n); int b(n))
1753
1754       info not available
1755
1756       plscmap1 does not process bad values.  It will set the bad-value flag
1757       of all output piddles if the flag is set for any of the input piddles.
1758
1759   plgcol0a
1760         Signature: (int icolzero(); int [o]r(); int [o]g(); int [o]b(); double [o]a())
1761
1762       info not available
1763
1764       plgcol0a does not process bad values.  It will set the bad-value flag
1765       of all output piddles if the flag is set for any of the input piddles.
1766
1767   plgcolbga
1768         Signature: (int [o]r(); int [o]g(); int [o]b(); double [o]a())
1769
1770       info not available
1771
1772       plgcolbga does not process bad values.  It will set the bad-value flag
1773       of all output piddles if the flag is set for any of the input piddles.
1774
1775   plscmap0a
1776         Signature: (int r(n); int g(n); int b(n); double a(n))
1777
1778       info not available
1779
1780       plscmap0a does not process bad values.  It will set the bad-value flag
1781       of all output piddles if the flag is set for any of the input piddles.
1782
1783   plscmap1a
1784         Signature: (int r(n); int g(n); int b(n); double a(n))
1785
1786       info not available
1787
1788       plscmap1a does not process bad values.  It will set the bad-value flag
1789       of all output piddles if the flag is set for any of the input piddles.
1790
1791   plscmap1la
1792         Signature: (int itype(); isty(n); coord1(n); coord2(n); coord3(n); coord4(n); int rev(nrev))
1793
1794       FIXME: documentation here!
1795
1796       plscmap1la does not process bad values.  It will set the bad-value flag
1797       of all output piddles if the flag is set for any of the input piddles.
1798
1799   plgfont
1800         Signature: (int [o]p_family(); int [o]p_style(); int [o]p_weight())
1801
1802       info not available
1803
1804       plgfont does not process bad values.  It will set the bad-value flag of
1805       all output piddles if the flag is set for any of the input piddles.
1806
1807   plsfont
1808         Signature: (int family(); int style(); int weight())
1809
1810       info not available
1811
1812       plsfont does not process bad values.  It will set the bad-value flag of
1813       all output piddles if the flag is set for any of the input piddles.
1814
1815   plcalc_world
1816         Signature: (double rx(); double ry(); double [o]wx(); double [o]wy(); int [o]window())
1817
1818       info not available
1819
1820       plcalc_world does not process bad values.  It will set the bad-value
1821       flag of all output piddles if the flag is set for any of the input
1822       piddles.
1823

AUTHORS

1825         Doug Hunt <dhunt@ucar.edu>
1826         Rafael Laboissiere <rlaboiss@users.sourceforge.net>
1827

SEE ALSO

1829       perl(1), PDL(1), <http://www.plplot.org/>
1830
1831
1832
1833perl v5.12.0                      2010-06-05                         PLplot(3)
Impressum