PLOT3DCL(3plplot)

💅 PLOT3DCL — plot3dcl 💅

okay so bestie, welcome to the PLplot API page for plot3dcl, and honestly? it's giving "aspirational". like, the idea is iconic, the execution is... a work in progress. we'll get there. 🫶

---

✨ NAME ✨

plot3dcl — a magnitude-colored plot surface with contour for z[x][y], except with y index limits. yes, the y index limits are the whole personality here. 🌸

---

🦋 SYNOPSIS 🦋

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

---

👑 DESCRIPTION 👑

so when the implementation is completed — and that's a big "when", bestie — this variant of plot3dc(3plplot) (go read that function's docs for more deets, iykyk) should be suitable for the case where the area of the x, y coordinate grid where z is defined can be non-rectangular. non-rectangular grid representation?? main character energy honestly. ✨

💀 but listen: the implementation is incomplete. the last 4 parameters of plot3dcl — indexxmin, indexxmax, indexymin, and indexymax — are currently ignored, and the functionality is otherwise identical to that of plot3dc(3plplot). so it's the same thing wearing a slightly different outfit. periodt.

Redacted form: General: plot3dcl(x, y, z, opt, clevel, indexxmin, indexymin, indexymax)

and ngl, this function is not used in any example. not one. she's mysterious. 🙈

---

🎀 ARGUMENTS 🎀

• x (PLFLT_VECTOR(3plplot), input) — a vector holding the x coordinates at which the function is evaluated. 💜
• y (PLFLT_VECTOR(3plplot), input) — a vector holding the y coordinates at which the function is evaluated. 💜
• z (PLFLT_MATRIX(3plplot), input) — a matrix holding the function values to plot. should have dimensions of nx by ny. (yes, dimensions matter, bestie. 🍓)
• nx (PLINT(3plplot), input) — the number of x values at which the function is evaluated.
• ny (PLINT(3plplot), input) — the number of y values at which the function is evaluated.
• opt (PLINT(3plplot), input) — determines the way in which the surface is represented. to specify more than one option, just add the options together, e.g. DRAW_LINEXY + MAG_COLOR. here's the tea on each one:
  • opt=DRAW_LINEX : lines are drawn showing z as a function of x for each value of y[j] .
  • opt=DRAW_LINEY : lines are drawn showing z as a function of y for each value of x[i] .
  • opt=DRAW_LINEXY : a network of lines is drawn connecting points at which the function is defined. 🌈
  • opt=MAG_COLOR : each line in the mesh is colored according to the z value being plotted. the color is used from the current cmap1. 💅
  • opt=BASE_CONT : a contour plot is drawn at the base XY plane using parameters nlevel and clevel.
  • opt=DRAW_SIDES : draws a curtain between the base XY plane and the borders of the plotted function. (a curtain!! dramatic much? love that for us. 🎭)
• clevel (PLFLT_VECTOR(3plplot), input) — a vector holding the contour levels.
• nlevel (PLINT(3plplot), input) — the number of elements in the clevel vector.
• indexxmin (PLINT(3plplot), input) — the index value (which must be ≥ 0) that corresponds to the first x index where z is defined. ✨
• indexxmax (PLINT(3plplot), input) — the index value (which must be ≤ nx) which corresponds (by convention) to one more than the last x index value where z is defined.
• indexymin (PLINT_VECTOR(3plplot), input) — a vector holding y index values which all must be ≥ 0. these values are the first y index where z is defined for a particular x index in the range from indexxmin to indexxmax - 1. the dimension of indexymin is indexxmax. 🦋
• indexymax (PLINT_VECTOR(3plplot), input) — a vector holding y index values which all must be ≤ ny. these values correspond (by convention) to one more than the last y index where z is defined for a particular x index in the range from indexxmin to indexxmax - 1. the dimension of indexymax is indexxmax. 🦋

💀 friendly reminder that all four of those index parameters are currently ignored. i know. i know. we're all processing it.

---

🌟 AUTHORS 🌟

many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. legends, all of them. 👑

---

🔥 SEE ALSO 🔥

PLplot documentation at http://plplot.sourceforge.net/documentation.php. go read it, bestie, it's free and it's slay. 📚

---

and that's the page!! August, 2026, source/version vibes courtesy of PLplot — mwah, catch you in the next man page, PLOT3DCL(3plplot) signing off 💖✨