plcont: Contour plot

The PLplot Plotting Library: Programmer's Reference Manual
Prev	Chapter 19. The Common API for PLplot	Next

`plcont`: Contour plot

	    plcont

(z, nx, ny, kx, lx, ky, ly, clevel, nlevel, pltr, pltr_data);

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 Section called Contour and Shade Plots in Chapter 3 for more information.

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 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 in Chapter 3. 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 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, pltr1, pltr2, or whatever routine that is externally supplied.

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.

Prev	Home	Next
`plcol1`: Set color, map1	Up	`plcpstrm`: Copy state parameters from the reference stream to the current stream