1PLOT3DCL(3plplot) PLplot API PLOT3DCL(3plplot)
2
6 plot3dcl - Magnitude colored plot surface with contour for z[x][y] with
7 y index limits
8
10 plot3dcl(x, y, z, nx, ny, opt, clevel, nlevel, indexxmin, indexxmax,
11 indexymin, indexymax)
12
14 When the implementation is completed this variant of plot3dc(3plplot)
15 (see that function's documentation for more details) should be suitable
16 for the case where the area of the x, y coordinate grid where z is de‐
17 fined can be non-rectangular. The implementation is incomplete so the
18 last 4 parameters of plot3dcl; indexxmin, indexxmax, indexymin, and in‐
19 dexymax; are currently ignored and the functionality is otherwise iden‐
20 tical to that of plot3dc(3plplot).
21 Redacted form: General: plot3dcl(x, y, z, opt, clevel, indexxmin, in‐
23 dexymin, indexymax)
24 This function is not used in any example.
27
29 x (PLFLT_VECTOR(3plplot), input)
30 A vector containing the x coordinates at which the function is
31 evaluated.
32 y (PLFLT_VECTOR(3plplot), input)
34 A vector containing the y coordinates at which the function is
35 evaluated.
36 z (PLFLT_MATRIX(3plplot), input)
38 A matrix containing function values to plot. Should have dimen‐
39 sions of nx by ny.
40 nx (PLINT(3plplot), input)
42 Number of x values at which the function is evaluated.
43 ny (PLINT(3plplot), input)
45 Number of y values at which the function is evaluated.
46 opt (PLINT(3plplot), input)
48 Determines the way in which the surface is represented. To spec‐
49 ify more than one option just add the options, e.g. DRAW_LINEXY
50 + MAG_COLOR opt=DRAW_LINEX : Lines are drawn showing z as a
51 function of x for each value of y[j] . opt=DRAW_LINEY : Lines
52 are drawn showing z as a function of y for each value of x[i] .
53 opt=DRAW_LINEXY : Network of lines is drawn connecting points at
54 which function is defined. opt=MAG_COLOR : Each line in the
55 mesh is colored according to the z value being plotted. The
56 color is used from the current cmap1. opt=BASE_CONT : A contour
57 plot is drawn at the base XY plane using parameters nlevel and
58 clevel. opt=DRAW_SIDES : draws a curtain between the base XY
59 plane and the borders of the plotted function.
60 clevel (PLFLT_VECTOR(3plplot), input)
63 A vector containing the contour levels.
64 nlevel (PLINT(3plplot), input)
66 Number of elements in the clevel vector.
67 indexxmin (PLINT(3plplot), input)
69 The index value (which must be ≥ 0) that corresponds to the
70 first x index where z is defined.
71 indexxmax (PLINT(3plplot), input)
73 The index value (which must be ≤ nx) which corresponds (by con‐
74 vention) to one more than the last x index value where z is de‐
75 fined.
76 indexymin (PLINT_VECTOR(3plplot), input)
78 A vector containing y index values which all must be ≥ 0. These
79 values are the first y index where z is defined for a particular
80 x index in the range from indexxmin to indexxmax - 1. The dimen‐
81 sion of indexymin is indexxmax.
82 indexymax (PLINT_VECTOR(3plplot), input)
84 A vector containing y index values which all must be ≤ ny. These
85 values correspond (by convention) to one more than the last y
86 index where z is defined for a particular x index in the range
87 from indexxmin to indexxmax - 1. The dimension of indexymax is
88 indexxmax.
89
92 Many developers (who are credited at http://plplot.org/credits.php)
93 have contributed to PLplot over its long history.
94
96 PLplot documentation at http://plplot.org/documentation.php.
97 January, 2023 PLOT3DCL(3plplot)