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

NAME

6       plot3dcl - Magnitude colored plot surface with contour for z[x][y] with
7       y index limits
8

SYNOPSIS

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

DESCRIPTION

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
22       Redacted  form:  General: plot3dcl(x, y, z, opt, clevel, indexxmin, in‐
23       dexymin, indexymax)
24
25
26       This function is not used in any example.
27

ARGUMENTS

29       x (PLFLT_VECTOR(3plplot), input)
30              A vector containing the x coordinates at which the  function  is
31              evaluated.
32
33       y (PLFLT_VECTOR(3plplot), input)
34              A  vector  containing the y coordinates at which the function is
35              evaluated.
36
37       z (PLFLT_MATRIX(3plplot), input)
38              A matrix containing function values to plot.  Should have dimen‐
39              sions of nx by ny.
40
41       nx (PLINT(3plplot), input)
42              Number of x values at which the function is evaluated.
43
44       ny (PLINT(3plplot), input)
45              Number of y values at which the function is evaluated.
46
47       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
61
62       clevel (PLFLT_VECTOR(3plplot), input)
63              A vector containing the contour levels.
64
65       nlevel (PLINT(3plplot), input)
66              Number of elements in the clevel vector.
67
68       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
72       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
77       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
83       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
90

AUTHORS

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

SEE ALSO

96       PLplot documentation at http://plplot.org/documentation.php.
97
98
99
100                                 January, 2023               PLOT3DCL(3plplot)
Impressum