PLENV(3plplot)

📦
version 5.15.0 · 12 versions
, in ubuntu stonking

💖 PLENV — set up a standard window and draw a box 💖

okay bestie, welcome to PLENV(3plplot), which lives in the PLplot API and is genuinely one of the most "just set it up for me" functions in the whole library. it's giving main character energy for plot setup, fr fr. 🎀

✨ NAME ✨

plenv — set up a standard window and draw a box. that's it, that's the vibe. 🦋

🌸 SYNOPSIS 🌸

plenv(xmin, xmax, ymin, ymax, just, axis)

💜 DESCRIPTION 💜

so here's the tea: plenv sets up your plotter environment for simple graphs by calling pladv(3plplot) and then setting up the viewport and window to sensible default values. it literally does the boring part for you. 👑

and it leaves a standard margin around most graphs — a left-hand margin of eight character heights, and a margin around the other three sides of five character heights — so your axis labels and your title have somewhere cute to sit. no cap, that's the whole point of the margin. 🌈

when these defaults are not the move for you, bestie, go use the individual routines instead, iykyk:

lowkey the redacted form is just plenv(xmin, xmax, ymin, ymax, just, axis) — same thing, no mystery. 🙈

this function is used in example 1,3,9,13,14,19-22,29. icon behavior honestly. 💅

🎀 ARGUMENTS 🎀

  • xmin (PLFLT(3plplot), input) — the value of x at the left-hand edge of the window, in world coordinates. left edge, bestie. ⬅️
  • xmax (PLFLT(3plplot), input) — the value of x at the right-hand edge of the window, in world coordinates. ➡️
  • ymin (PLFLT(3plplot), input) — the value of y at the bottom edge of the window, in world coordinates. ⬇️
  • ymax (PLFLT(3plplot), input) — the value of y at the top edge of the window, in world coordinates. ⬆️

💫 just — how the axes get scaled 💫

it's a PLINT(3plplot) input, and it controls how the axes will be scaled. pick your fighter:

  • -1 — the scales will not be set, so you have to set up the scale before calling plenv(3plplot), using plsvpa(3plplot), plvasp(3plplot) or other. you're on your own, girlboss. 🫡
  • 0 — the x and y axes are scaled independently to use as much of the screen as possible. maximal screen usage, periodt.
  • 1 — the scales of the x and y axes are made equal.
  • 2 — the axis of the x and y axes are made equal, and the plot box will be square. square box supremacy 🔲✨

🔥 axis — what gets drawn around the plot 🔥

also a PLINT(3plplot) input. this one is the big one, so buckle up bestie, we're going through every single value 💀

the base numbers 🍓

  • -2 — draw no box, no tick marks, no numeric tick labels, no axes. literally nothing. a ghost plot. 👻
  • -1 — draw box only.
  • 0 — draw box, ticks, and numeric tick labels.
  • 1 — same as 0, and also draw coordinate axes at x=0 and y=0.
  • 2 — same as 0, and also draw a grid at major tick positions in both coordinates.
  • 3 — same as 0, and also draw a grid at minor tick positions in both coordinates.

the 10s: logarithmic x tick marks 💅

  • 10 — same as 0 except logarithmic x tick marks. (the x data have to be converted to logarithms separately.)
  • 11 — same as 1 except logarithmic x tick marks. (the x data have to be converted to logarithms separately.)
  • 12 — same as 2 except logarithmic x tick marks. (the x data have to be converted to logarithms separately.)
  • 13 — same as 3 except logarithmic x tick marks. (the x data have to be converted to logarithms separately.)

the 20s: logarithmic y tick marks 🦋

  • 20 — same as 0 except logarithmic y tick marks. (the y data have to be converted to logarithms separately.)
  • 21 — same as 1 except logarithmic y tick marks. (the y data have to be converted to logarithms separately.)
  • 22 — same as 2 except logarithmic y tick marks. (the y data have to be converted to logarithms separately.)
  • 23 — same as 3 except logarithmic y tick marks. (the y data have to be converted to logarithms separately.)

the 30s: logarithmic x and y tick marks 🌈

  • 30 — same as 0 except logarithmic x and y tick marks. (the x and y data have to be converted to logarithms separately.)
  • 31 — same as 1 except logarithmic x and y tick marks. (the x and y data have to be converted to logarithms separately.)
  • 32 — same as 2 except logarithmic x and y tick marks. (the x and y data have to be converted to logarithms separately.)
  • 33 — same as 3 except logarithmic x and y tick marks. (the x and y data have to be converted to logarithms separately.)

the 40s: date / time x labels 🎀

  • 40 — same as 0 except date / time x labels.
  • 41 — same as 1 except date / time x labels.
  • 42 — same as 2 except date / time x labels.
  • 43 — same as 3 except date / time x labels.

the 50s: date / time y labels 🌸

  • 50 — same as 0 except date / time y labels.
  • 51 — same as 1 except date / time y labels.
  • 52 — same as 2 except date / time y labels.
  • 53 — same as 3 except date / time y labels.

the 60s: date / time x and y labels 💖

  • 60 — same as 0 except date / time x and y labels.
  • 61 — same as 1 except date / time x and y labels.
  • 62 — same as 2 except date / time x and y labels.
  • 63 — same as 3 except date / time x and y labels.

the 70s: custom x and y labels 🧚

  • 70 — same as 0 except custom x and y labels.
  • 71 — same as 1 except custom x and y labels.
  • 72 — same as 2 except custom x and y labels.
  • 73 — same as 3 except custom x and y labels.
okay and just so we're clear on the log ones: you convert the data to logarithms separately. plenv is not doing that for you, bestie, it's not a mind reader. 😭

👑 AUTHORS 👑

many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. legends only, honestly. 🫶

⭐ SEE ALSO ⭐

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

and that's the page, bestie! this one's from source/version PLENV(3plplot), dated August, 2026 — go forth and set up your environment 💅💖✨

📦 where this page comes from