1PLCONT(3plplot)                   PLplot API                   PLCONT(3plplot)
2
3
4

NAME

6       plcont - Contour plot
7

SYNOPSIS

9       plcont(z, nx, ny, kx, lx, ky, ly, clevel, nlevel, pltr, pltr_data)
10

DESCRIPTION

12       Draws a contour plot of the data in z[nx][ny], using the nlevel contour
13       levels specified by clevel. Only the region of the array from kx to  lx
14       and  from ky to ly is plotted out.  A transformation routine pointed to
15       by pltr with a pointer pltr_data for additional data  required  by  the
16       transformation  routine  is used to map indices within the array to the
17       world coordinates.  See the following discussion of the  arguments  and
18       the PLplot documentation for more information.
19
20       Redacted  form: [PLEASE UPDATE! ONLY PERL INFO IS LIKELY CORRECT!] F95:
21       plcont(z, kx, lx, ky, ly, clevel, tr?) or plcont(z,  kx,  lx,  ky,  ly,
22       clevel,  xgrid, ygrid) Java: pls.cont(z, kx, lx, ky, ly, clevel, xgrid,
23       ygrid) Perl/PDL: plcont(z, kx, lx, ky,  ly,  clevel,  pltr,  pltr_data)
24       Python: plcont2(z, kx, lx, ky, ly, clevel)
25
26
27       This function is used in examples 9,14,16,22.
28

ARGUMENTS

30       z (PLFLT **, input)
31              Pointer  to  a vectored two-dimensional array containing data to
32              be contoured.
33
34       nx, ny (PLINT, input)
35              Physical dimensions of array z.
36
37       kx, lx (PLINT, input)
38              Range of x indices to consider.
39
40       ky, ly (PLINT, input)
41              Range of y indices to consider.
42
43       clevel (PLFLT *, input)
44              Pointer to array specifying levels at which to draw contours.
45
46       nlevel (PLINT, input)
47              Number of contour levels to draw.
48
49       pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer) , input)
50              Pointer to function that defines transformation between  indices
51              in  array  z and the world coordinates (C only).  Transformation
52              functions are provided in the PLplot library: pltr0(3plplot) for
53              identity  mapping,  and  pltr1(3plplot)  and  pltr2(3plplot) for
54              arbitrary mappings respectively defined by one-  and  two-dimen‐
55              sional  arrays.   In  addition,  user-supplied  routines for the
56              transformation can be used as well.  Examples of  all  of  these
57              approaches  are given in the PLplot documentation. The transfor‐
58              mation  function  should  have  the  form  given   by   any   of
59              pltr0(3plplot), pltr1(3plplot), or pltr2(3plplot).
60
61       pltr_data (PLPointer, input)
62              Extra  parameter  to  help  pass  information to pltr0(3plplot),
63              pltr1(3plplot), pltr2(3plplot),  or  whatever  routine  that  is
64              externally supplied.
65
66

AUTHORS

68       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
69       man page was automatically generated from the  DocBook  source  of  the
70       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
71       Laboissiere.
72

SEE ALSO

74       PLplot documentation at http://plplot.sourceforge.net/resources.
75
76
77
78                                  March, 2007                  PLCONT(3plplot)
Impressum