


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 iden-
              tity  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).



                          November, 2007                        1





PLCONT(3)                   PLplot API                  PLCONT(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                        2


