1PLSURF3DL(3plplot) PLplot API PLSURF3DL(3plplot)
2
6 plsurf3dl - Plot shaded 3-d surface plot for z[x][y] with y index lim‐
7 its
8
10 plsurf3dl(x, y, z, nx, ny, opt, clevel, nlevel, indexxmin, indexxmax,
11 indexymin, indexymax)
12
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 Redacted form: plsurf3dl(x, y, z, opt, clevel, indexxmin, indexymin,
21 indexymax)
22 This function is used in example 8.
24
26 x (PLFLT_VECTOR(3plplot), input)
27 A vector containing the x coordinates at which the function is
28 evaluated.
29 y (PLFLT_VECTOR(3plplot), input)
31 A vector containing the y coordinates at which the function is
32 evaluated.
33 z (PLFLT_MATRIX(3plplot), input)
35 A matrix containing function values to plot. Should have dimen‐
36 sions of nx by ny.
37 nx (PLINT(3plplot), input)
39 Number of x values at which function is evaluated.
40 ny (PLINT(3plplot), input)
42 Number of y values at which function is evaluated.
43 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 clevel (PLFLT_VECTOR(3plplot), input)
61 A vector containing the contour levels.
62 nlevel (PLINT(3plplot), input)
64 Number of elements in the clevel vector.
65 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 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 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 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
90 Many developers (who are credited at http://plplot.org/credits.php)
91 have contributed to PLplot over its long history.
92
94 PLplot documentation at http://plplot.org/documentation.php.
95 January, 2023 PLSURF3DL(3plplot)