oracular (3) plot3dcl.3plplot.gz

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)

       This function is not used in any example.

ARGUMENTS

       x (PLFLT_VECTOR(3plplot), input)
              A vector containing the x coordinates at which the function is evaluated.

       y (PLFLT_VECTOR(3plplot), input)
              A vector containing the y coordinates at which the function is evaluated.

       z (PLFLT_MATRIX(3plplot), input)
              A matrix containing function values to plot.  Should have dimensions of nx by ny.

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

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

       opt (PLINT(3plplot), 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 cmap1.  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 (PLFLT_VECTOR(3plplot), input)
              A vector containing the contour levels.

       nlevel (PLINT(3plplot), input)
              Number of elements in the clevel vector.

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

       indexxmax (PLINT(3plplot), 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 (PLINT_VECTOR(3plplot), input)
              A  vector  containing  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 (PLINT_VECTOR(3plplot), input)
              A vector containing 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.org/credits.php) have contributed to PLplot over its
       long history.

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                                  August, 2024                                 PLOT3DCL(3plplot)