NAME¶
plcont - Contour plot
SYNOPSIS¶
plcont(
z,
nx,
ny,
kx,
lx,
ky,
ly,
clevel,
nlevel,
pltr,
pltr_data)
DESCRIPTION¶
Draws a contour plot of the data in
z[
nx][
ny], using the
nlevel contour levels specified by
clevel. Only the region of
the array from
kx to
lx and from
ky to
ly is
plotted out. A transformation routine pointed to by
pltr with a pointer
pltr_data for additional data required by the transformation routine is
used to map indices within the array to the world coordinates. See the
following discussion of the arguments and the PLplot documentation for more
information.
Redacted form: [PLEASE UPDATE! ONLY PERL INFO IS LIKELY CORRECT!] F95:
plcont(z, kx, lx, ky, ly, clevel, tr?) or
plcont(z, kx, lx, ky, ly,
clevel, xgrid, ygrid) Java:
pls.cont(z, kx, lx, ky, ly, clevel, xgrid,
ygrid) Perl/PDL:
plcont(z, kx, lx, ky, ly, clevel, pltr, pltr_data)
Python:
plcont2(z, kx, lx, ky, ly, clevel)
This function is used in examples 9,14,16,22.
ARGUMENTS¶
- z (PLFLT **, input)
- Pointer to a vectored two-dimensional array containing data
to be contoured.
- nx, ny (PLINT, input)
- Physical dimensions of array z.
- kx, lx (PLINT, input)
- Range of x indices to consider.
- ky, ly (PLINT, input)
- Range of y indices to consider.
- clevel (PLFLT *, input)
- Pointer to array specifying levels at which to draw
contours.
- nlevel (PLINT, input)
- Number of contour levels to draw.
- pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *,
PLPointer) , input)
- Pointer to function that defines transformation between
indices in array z and the world coordinates (C only).
Transformation functions are provided in the PLplot library:
pltr0(3plplot) for identity mapping, and pltr1(3plplot) and
pltr2(3plplot) for arbitrary mappings respectively defined by one-
and two-dimensional arrays. In addition, user-supplied routines for the
transformation can be used as well. Examples of all of these approaches
are given in the PLplot documentation. The transformation function should
have the form given by any of pltr0(3plplot),
pltr1(3plplot), or pltr2(3plplot). Note that unlike
plshades(3plplot) and similar PLplot functions which have a
pltr argument, plcont requires that a transformation function be
provided in the C interface. Leaving pltr NULL will result in an
error.
- pltr_data (PLPointer, input)
- Extra parameter to help pass information to
pltr0(3plplot), pltr1(3plplot), pltr2(3plplot), or
whatever routine that is externally supplied.
AUTHORS¶
Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was
automatically generated from the DocBook source of the PLplot documentation,
maintained by Alan W. Irwin and Rafael Laboissiere.
SEE ALSO¶
PLplot documentation at
http://plplot.sourceforge.net/resources.