PLSURF3D(3plplot)

✨ PLSURF3D ✨ (that's plsurf3d from the PLplot API, bestie)

Okay so picture this: you want a shaded 3-D surface plot and you want it to slay. That's literally this function. It's the plsurf3d girlie from the PLplot crew 💅

---

🌸 SYNOPSIS 🌸

plsurf3d(x, y, z, nx, ny, opt, clevel, nlevel)

---

🦋 DESCRIPTION 🦋

So plsurf3d plots a three-dimensional shaded surface plot — but like, inside the environment you already set up with plw3d(3plplot). She doesn't build her own stage, she performs on yours, periodt.

The surface is defined by the two-dimensional matrix z[nx][ny], and the point z[i][j] is the value of the function at (x[i],y[j]). Note (and this is important, no cap) that the points in vectors x and y do not need to be equally spaced, but they must be stored in ascending order. For further details see the PLplot documentation.

Redacted form: plsurf3d(x, y, z, opt, clevel)

Lowkey iconic detail: this function is not used in any examples. She's a main character with no cameos. 🙈

---

🎀 ARGUMENTS 🎀

• x (PLFLT_VECTOR(3plplot), input) — A vector containing the x coordinates at which the function is evaluated.
• y (PLFLT_VECTOR(3plplot), input) — A vector containing the y coordinates at which the function is evaluated.
• z (PLFLT_MATRIX(3plplot), input) — A matrix containing function values to plot. Should have dimensions of nx by ny.
• nx (PLINT(3plplot), input) — Number of x values at which function is evaluated.
• ny (PLINT(3plplot), input) — Number of y values at which 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, e.g. FACETED + SURF_CONT. The options are:
  • opt=FACETED — Network of lines is drawn connecting points at which function is defined.
  • opt=BASE_CONT — A contour plot is drawn at the base XY plane using parameters nlevel and clevel.
  • opt=SURF_CONT — A contour plot is drawn at the surface plane using parameters nlevel and clevel.
  • opt=DRAW_SIDES — draws a curtain between the base XY plane and the borders of the plotted function.
  • opt=MAG_COLOR — the surface is colored according to the value of Z; if MAG_COLOR is not used, then the surface is colored according to the intensity of the reflected light in the surface from a light source whose position is set using pllightsource(3plplot).
• clevel (PLFLT_VECTOR(3plplot), input) — A vector containing the contour levels.
• nlevel (PLINT(3plplot), input) — Number of elements in the clevel vector.

---

👑 AUTHORS 👑

Many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. Fr fr, a whole village of legends 🫶

---

🌈 SEE ALSO 🌈

PLplot documentation at http://plplot.sourceforge.net/documentation.php.

---

And that's the whole vibe check, bestie ✨ This lil page is from the PLplot API docs, dated August, 2026, and you were reading PLSURF3D(3plplot) — go forth and shade those surfaces, you absolute icon 💖🎀