plcont
( | f, |
nx, | |
ny, | |
kx, | |
lx, | |
ky, | |
ly, | |
clevel, | |
nlevel, | |
pltr, | |
pltr_data) ; |
Draws a contour plot of the data in
,
using the f
[nx
][ny
]
contour
levels specified by nlevel
.
Only the region of the array from
clevel
to
kx
and from
lx
to
ky
is plotted out. A
transformation routine pointed to by ly
with a pointer pltr
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 section called “Contour and Shade Plots” for
more information.
pltr_data
f
(const PLFLT * const *
, input)
Pointer to a vectored two-dimensional array containing data to be contoured.
nx, ny
(PLINT
, input)
Physical dimensions of array
.
f
kx, lx
(PLINT
, input)
Range of x
indices to consider.
ky, ly
(PLINT
, input)
Range of y
indices to consider.
clevel
(const 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
and the
world coordinates (C only). Transformation functions are
provided in the PLplot library:
f
pltr0
for identity mapping, and pltr1
and pltr2
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 section called “Contour Plots from C”.
The transformation function should
have the form given by any of pltr0
, pltr1
, or pltr2
.
Note that unlike plshades
and similar PLplot functions
which have a
argument, plcont requires that a transformation function be
provided in the C interface. Leaving
pltr
NULL will result
in an error.
pltr
pltr_data
(PLPointer
, input)
Extra parameter to help
pass information to pltr0
, pltr1
, pltr2
, or whatever routine
that is externally supplied.
Redacted form: [PLEASE UPDATE! ONLY PERL INFO IS LIKELY CORRECT!]
F95: plcont(f, kx, lx, ky, ly, clevel, tr?)
or
plcont(f, kx, lx, ky, ly, clevel, xgrid, ygrid)
Java: pls.cont(f, kx, lx, ky, ly, clevel, xgrid, ygrid)
Perl/PDL: plcont(f, kx, lx, ky, ly, clevel, pltr, pltr_data)
Python: plcont2(f, kx, lx, ky, ly, clevel)
This function is used in examples 9,14,16,22.