1PLSURF3D(3plplot) PLplot API PLSURF3D(3plplot)
2
3
4
6 plsurf3d - Plot shaded 3-d surface plot
7
9 plsurf3d(x, y, z, nx, ny, opt, clevel, nlevel)
10
12 Plots a three-dimensional shaded surface plot within the environment
13 set up by plw3d(3plplot). The surface is defined by the two-dimen‐
14 sional matrix z[nx][ny], the point z[i][j] being the value of the func‐
15 tion at (x[i],y[j]). Note that the points in vectors x and y do not
16 need to be equally spaced, but must be stored in ascending order. For
17 further details see the PLplot documentation.
18
19 Redacted form: plsurf3d(x, y, z, opt, clevel)
20
21 This function is not used in any examples.
22
24 x (PLFLT_VECTOR(3plplot), input)
25 A vector containing the x coordinates at which the function is
26 evaluated.
27
28 y (PLFLT_VECTOR(3plplot), input)
29 A vector containing the y coordinates at which the function is
30 evaluated.
31
32 z (PLFLT_MATRIX(3plplot), input)
33 A matrix containing function values to plot. Should have dimen‐
34 sions of nx by ny.
35
36 nx (PLINT(3plplot), input)
37 Number of x values at which function is evaluated.
38
39 ny (PLINT(3plplot), input)
40 Number of y values at which function is evaluated.
41
42 opt (PLINT(3plplot), input)
43 Determines the way in which the surface is represented. To spec‐
44 ify more than one option just add the options, e.g. FACETED +
45 SURF_CONT opt=FACETED : Network of lines is drawn connecting
46 points at which function is defined. opt=BASE_CONT : A contour
47 plot is drawn at the base XY plane using parameters nlevel and
48 clevel. opt=SURF_CONT : A contour plot is drawn at the surface
49 plane using parameters nlevel and clevel. opt=DRAW_SIDES :
50 draws a curtain between the base XY plane and the borders of the
51 plotted function. opt=MAG_COLOR : the surface is colored ac‐
52 cording to the value of Z; if MAG_COLOR is not used, then the
53 surface is colored according to the intensity of the reflected
54 light in the surface from a light source whose position is set
55 using pllightsource(3plplot).
56
57
58 clevel (PLFLT_VECTOR(3plplot), input)
59 A vector containing the contour levels.
60
61 nlevel (PLINT(3plplot), input)
62 Number of elements in the clevel vector.
63
64
66 Many developers (who are credited at http://plplot.org/credits.php)
67 have contributed to PLplot over its long history.
68
70 PLplot documentation at http://plplot.org/documentation.php.
71
72
73
74 January, 2023 PLSURF3D(3plplot)