trusty (3) plcont.3plplot.gz

Provided by: plplot-doc_5.10.0-0ubuntu5_all bug

NAME

       plcont - Contour plot

SYNOPSIS

       plcont(f, nx, ny, kx, lx, ky, ly, clevel, nlevel, pltr, pltr_data)

DESCRIPTION

       Draws  a contour plot of the data in f[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(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.

ARGUMENTS

       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  f  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

       Many  developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php) have contributed to
       PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                                 February, 2014                                  PLCONT(3plplot)