1PLSURF3DL(3plplot)                PLplot API                PLSURF3DL(3plplot)
2
3
4

NAME

6       plsurf3dl  - Plot shaded 3-d surface plot for z[x][y] with y index lim‐
7       its
8

SYNOPSIS

10       plsurf3dl(x, y, z, nx, ny, opt, clevel, nlevel,  indexxmin,  indexxmax,
11       indexymin, indexymax)
12

DESCRIPTION

14       This  variant  of  plsurf3d(3plplot) (see that function's documentation
15       for more details) should be suitable for the case where the area of the
16       x,  y  coordinate  grid where z is defined can be non-rectangular.  The
17       limits of that grid are  provided  by  the  parameters  indexxmin,  in‐
18       dexxmax, indexymin, and indexymax.
19
20       Redacted  form:  plsurf3dl(x,  y, z, opt, clevel, indexxmin, indexymin,
21       indexymax)
22
23       This function is used in example 8.
24

ARGUMENTS

26       x (PLFLT_VECTOR(3plplot), input)
27              A vector containing the x coordinates at which the  function  is
28              evaluated.
29
30       y (PLFLT_VECTOR(3plplot), input)
31              A  vector  containing the y coordinates at which the function is
32              evaluated.
33
34       z (PLFLT_MATRIX(3plplot), input)
35              A matrix containing function values to plot.  Should have dimen‐
36              sions of nx by ny.
37
38       nx (PLINT(3plplot), input)
39              Number of x values at which function is evaluated.
40
41       ny (PLINT(3plplot), input)
42              Number of y values at which function is evaluated.
43
44       opt (PLINT(3plplot), input)
45              Determines the way in which the surface is represented. To spec‐
46              ify more than one option just add the options,  e.g.  FACETED  +
47              SURF_CONT  opt=FACETED  :  Network  of lines is drawn connecting
48              points at which function is defined.  opt=BASE_CONT : A  contour
49              plot  is  drawn at the base XY plane using parameters nlevel and
50              clevel.  opt=SURF_CONT : A contour plot is drawn at the  surface
51              plane  using  parameters  nlevel  and  clevel.  opt=DRAW_SIDES :
52              draws a curtain between the base XY plane and the borders of the
53              plotted  function.   opt=MAG_COLOR  : the surface is colored ac‐
54              cording to the value of Z; if MAG_COLOR is not  used,  then  the
55              surface  is  colored according to the intensity of the reflected
56              light in the surface from a light source whose position  is  set
57              using pllightsource(3plplot).
58
59
60       clevel (PLFLT_VECTOR(3plplot), input)
61              A vector containing the contour levels.
62
63       nlevel (PLINT(3plplot), input)
64              Number of elements in the clevel vector.
65
66       indexxmin (PLINT(3plplot), input)
67              The  index  value  (which  must  be ≥ 0) that corresponds to the
68              first x index where z is defined.
69
70       indexxmax (PLINT(3plplot), input)
71              The index value (which must be ≤ nx) which corresponds (by  con‐
72              vention)  to one more than the last x index value where z is de‐
73              fined.
74
75       indexymin (PLINT_VECTOR(3plplot), input)
76              A vector containing the y index values which all must  be  ≥  0.
77              These values are the first y index where z is defined for a par‐
78              ticular x index in the range from indexxmin to  indexxmax  -  1.
79              The dimension of indexymin is indexxmax.
80
81       indexymax (PLINT_VECTOR(3plplot), input)
82              A  vector  containing the y index values which all must be ≤ ny.
83              These values correspond (by convention) to  one  more  than  the
84              last  y index where z is defined for a particular x index in the
85              range from indexxmin to indexxmax - 1.  The dimension of indexy‐
86              max is indexxmax.
87
88

AUTHORS

90       Many  developers  (who  are  credited at http://plplot.org/credits.php)
91       have contributed to PLplot over its long history.
92

SEE ALSO

94       PLplot documentation at http://plplot.org/documentation.php.
95
96
97
98                                  July, 2022                PLSURF3DL(3plplot)
Impressum