trusty (3) plot3dcl.3plplot.gz

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

NAME
       plot3dcl - Magnitude colored plot surface with contour for z[x][y] with y index limits


SYNOPSIS
       plot3dcl(x, y, z, nx, ny, opt, clevel, nlevel, indexxmin, indexxmax, indexymin, indexymax)


DESCRIPTION
       When  the implementation is completed this variant of plot3dc(3plplot) (see that function's documentation
       for more details) should be suitable for the case where the area of the x, y coordinate grid where  z  is
       defined  can  be  non-rectangular. The implementation is incomplete so the last 4 parameters of plot3dcl;
       indexxmin, indexxmax, indexymin, and indexymax; are currently ignored and the functionality is  otherwise
       identical to that of plot3dc(3plplot).

       Redacted  form:   General:  plot3dcl(x, y, z, opt, clevel, indexxmin, indexymin, indexymax) Perl/PDL: Not
       available?

       This function is not used in any example.


ARGUMENTS
       x (const PLFLT *, input)
              Pointer to set of x coordinate values at which the function is evaluated.

       y (const PLFLT *, input)
              Pointer to set of y coordinate values at which the function is evaluated.

       z (const PLFLT * const *, input)
              Pointer to a vectored two-dimensional array with set of function values.

       nx (PLINT, input)
              Number of x values at which the function is evaluated.

       ny (PLINT, input)
              Number of y values at which the function is evaluated.

       opt (PLINT, input)
              Determines the way in which the surface is represented. To specify more than one option  just  add
              the  options, e.g. DRAW_LINEXY + MAG_COLOR opt=DRAW_LINEX: Lines are drawn showing z as a function
              of x for each value of y[j].  opt=DRAW_LINEY: Lines are drawn showing z as a  function  of  y  for
              each  value  of  x[i].   opt=DRAW_LINEXY:  Network  of  lines  is drawn connecting points at which
              function is defined.  opt=MAG_COLOR: Each line in the mesh is colored according  to  the  z  value
              being  plotted.  The color is used from the current color map 1.  opt=BASE_CONT: A contour plot is
              drawn at the base XY plane using parameters nlevel and clevel.  opt=DRAW_SIDES:  draws  a  curtain
              between the base XY plane and the borders of the plotted function.

       clevel (const PLFLT *, input)
              Pointer to the array that defines the contour level spacing.

       nlevel (PLINT, input)
              Number of elements in the clevel array.

       indexxmin (PLINT, input)
              The index value (which must be ≥ 0) that corresponds to the first x index where z is defined.

       indexxmax (PLINT, input)
              The index value (which must be ≤ nx) which corresponds (by convention) to one more than the last x
              index value where z is defined.

       indexymin (const PLINT *, input)
              Array of y index values which all must be ≥ 0.  These values are the first  y  index  where  z  is
              defined  for  a particular x index in the range from indexxmin to indexxmax - 1.  The dimension of
              indexymin is indexxmax.

       indexymax (const PLINT *, input)
              Array of y index values which all must be ≤ ny.  These values correspond (by  convention)  to  one
              more than the last y index where z is defined for a particular x index in the range from indexxmin
              to indexxmax - 1.  The dimension of indexymax is indexxmax.


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                                PLOT3DCL(3plplot)