plcont(3plplot)

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).  Note that
60              unlike plshades(3plplot) and similar PLplot functions which have
61              a  pltr argument, plcont requires that a transformation function
62              be provided in the C interface.  Leaving  pltr NULL will  result
63              in an error.
64
65       pltr_data (PLPointer, input)
66              Extra  parameter  to  help  pass  information to pltr0(3plplot),
67              pltr1(3plplot), pltr2(3plplot),  or  whatever  routine  that  is
68              externally supplied.
69
70

AUTHORS

72       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
73       man page was automatically generated from the  DocBook  source  of  the
74       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
75       Laboissiere.
76

NAME

SYNOPSIS

DESCRIPTION

ARGUMENTS

AUTHORS

SEE ALSO