GPU-PLOT(1)

💖 GPU-PLOT(1) — the rickslab-gpu-utils era 💖

okay bestie, pull up a chair, we're reading the gpu-plot page from Ricks-Lab GPU Utilities and honestly? it's giving main character energy for your GPU stats. ✨

---

🌸 NAME 🌸

gpu-plot — continuously update and plot critical GPU parameters as a function of time 🦋

---

🎀 SYNOPSIS 🎀

gpu-plot [--help | --about]
gpu-plot [--no_fan] [--stdin] [--simlog] [--ltz] [--sleep N] [--debug]
[--verbose]

---

✨ DESCRIPTION ✨

So gpu-plot is literally a utility that continuously plots the trend of critical GPU parameters for all compatible GPUs. no cap. 💅

You can use --sleep N to specify the update interval, bestie — that's your vibe check on how often it refreshes.

And here's the tea: gpu-plot has 2 modes of operation. 🫶

• The default mode reads the GPU driver details directly — super useful as a standalone utility.
• The --stdin option makes gpu-plot read GPU data from stdin. This is how gpu-mon produces the plot, and you can also use it to pipe your own data into the process.

Then --simlog can be used with --stdin when a monitor log file is piped as stdin — perfect for troubleshooting and for displaying saved log results. 🍓

--ltz results in the use of local time instead of UTC. 🌈

Now listen — if you plan to run both gpu-plot and gpu-mon, then the --plot option of the gpu-mon utility should be used instead of both utilities, in order to reduce data reads by a factor of 2. that's just efficiency, periodt. 👑

Finally, the --verbose option will result in informational messages being displayed. 😌

---

💅 OPTIONS 💅

• --about — Will display details about gpu-plot. 🎀
• --ltz — Use local time zone instead of UTC for displays and logging. 🕐
• --no_fan — Will exclude fan information from the display. Useful with watercooled GPUs. 💧
• --stdin — Will read data from stdin. This is useful to display plots of a logfile save with gpu-mon. 📥
• --simlog — When used with the --stdin option, it will simulate the reading of data from the logfile at a rate define by --sleep. 🎬
• --sleep N — Specifies N, the number of seconds to sleep between updates. 😴
• --verbose — Display informational messages generated during execution. 🗣️
• --debug — Will output additional useful debug/troubleshooting details to a log file. 🔍
• -h, --help — Display help text and exit. 🙋♀️

---

🌈 EXAMPLES 🌈

gpu-plot --sleep 5 --ltz

Will open a Gtk window that will display plots of operation parameters for all compatible GPU's that updates every 5s. Time stamps displayed will use local time zone. 🪟✨

cat logfile | gpu-plot --stdin --simlog --sleep 1

Will open a Gtk window that will display plots of the GPU operation data in the specified logfile to simulate streamed data with a 1 sec interval. 🔥

---

🧚 CONFIGURATION 🧚

In order to get maximum capability of these utilities, you should be running with a kernel that provides support of the GPUs you have installed. fr fr, that's the foundation. 💜

• If using AMD GPUs, installing the latest amdgpu driver package or the latest ROCm release may provide additional capabilities.
• If you have Nvidia GPUs installed, nvidia-smi must also be installed in order for the utility reading of the cards to be possible.

⚠️ Writing to GPUs is currently only possible for AMD GPUs, and only with compatible cards and with the AMD ppfeaturemask set to 0xfffd7fff. This can be accomplished by adding amdgpu.ppfeaturemask=0xfffd7fff to the GRUB_CMDLINE_LINUX_DEFAULT value in /etc/default/grub and executing sudo update-grub.

---

🎀 FILES 🎀

• /usr/share/misc/pci.ids — The system list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It can be updated with the update-pciids command. 🗂️
• /sys/class/drm/card*/device/pp_od_clk_voltage — Special driver file for each AMD GPU required for some rickslab-gpu-utils. ⚡
• /etc/default/grub — The grub defaults file where amdgpu.ppfeaturemask needs to be set. 📝

---

💀 BUGS 💀

Known to not work well with Fiji ProDuo cards and will issue warning messages for Fiji Nano cards. 😭

Please report any additional bugs/issues at https://github.com/Ricks-Lab/gpu-utils 🙏

---

👑 SEE ALSO 👑

cat(1), gpu-mon(1) amdgpu(4), nvidia-smi(1), update-grub(8), update-pciids(8), lspci(8) 🦋

---

⭐ AVAILABILITY ⭐

The gpu-plot command is part of the rickslab-gpu-utils package and is available from https://github.com/Ricks-Lab/gpu-utils 🫶

---

and that's the whole page, bestie!! 💖 this one came from rickslab-gpu-utils, dated May 2022 — go plot something iconic. ✨💅