PLCONT(3)                         PLplot API                         PLCONT(3)



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(3) for
              identity mapping, and pltr1(3) and pltr2(3) 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(3), pltr1(3), or pltr2(3).

       pltr_data (PLPointer, input)
              Extra parameter to help pass information to pltr0(3), pltr1(3),
              pltr2(3), 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.



                                November, 2007                       PLCONT(3)
