g.gui.tplot(1)

📦
version 8.4.2 · 10 versions
, in fedora 44

💖 g.gui.tplot — the temporal plot tool 💖

okay bestie, welcome to g.gui.tplot, straight out of the GRASS GIS User's Manual. she plots the values of temporal datasets and honestly? she ate. 🎀

✨ NAME ✨

g.gui.tplot — plots the values of temporal datasets. periodt. 📈

🔑 KEYWORDS 🔑

general, GUI, temporal, plot — the whole vibe check in four words, iykyk. ✨

🌸 SYNOPSIS 🌸

g.gui.tplot
g.gui.tplot --help
g.gui.tplot [-hl]  [stvds=name[,name,...]]   [strds=name[,name,...]]
[coordinates=east,north]   [cats=string]   [attr=string]   [output=name]
[csv=name]   [title=string]   [xlabel=string]   [ylabel=string]
[size=string]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags 🚩

  • -h — sets the header of the CSV file, to be used with the csv option 🎀
  • -l — shows the simple linear regression model line 🔥
  • --overwrite — lets your output files overwrite files that already exist (yes, it will absolutely do that, consent is the whole point here 💅)
  • --help — prints the usage summary
  • --verbose — verbose module output
  • --quiet — quiet module output
  • --ui — forces the GUI dialog to launch

🎛️ Parameters 🎛️

  • stvds=name[,name,...] — name of the input space time vector datasets
  • strds=name[,name,...] — name of the input space time raster datasets
  • coordinates=east,north — coordinates 🧭
  • cats=string — categories of vectors features. to be used only with stvds, ok bestie? 🙈
  • attr=string — name of attribute. like, the name of the attribute that represents the data you're plotting ✨
  • output=name — name for the output graphical file. full path for the output file containing the plot, and the ddd extension is what specifies the format (.png, .pdf, .svg) 🖼️
  • csv=name — name for the output CSV file. full path for the CSV file containing the plotted data 📄
  • title=string — title for the plot. this is literally the title for the output plot 👑
  • xlabel=string — label for the x axis. the x axis label for the output plot ➡️
  • ylabel=string — label for the y axis. the y axis label for the output plot ⬆️
  • size=string — size of the output image as width,height in pixels. it works only with the output parameter, noted 🫶

💅 DESCRIPTION 💅

The Temporal Plot Tool is a wxGUI component that queries and plots the values of a point — defined by a coordinate pair — in one or more temporal datasets (strds, stvds, str3ds). main character energy fr fr 💜

✨ Supported features ✨

  • temporal datasets with interval/point and absolute/relative time ⏰
  • show simple linear regression model line with calculated formula y = a + b*x (y is dependent variable, a is intercept, b is slope, x is explanatory variable) and r-squared (parameter of goodness-of-fit measure for linear regression model) 📐
  • pop-up annotations with values information 💬
  • query and plot multiple points via the command line 🖥️
  • zoom and pan 🔍
  • change labels to x and y axes 🏷️
  • add title to the plot, and 👑
  • export the time series values to a CSV file (x axis data has date time string format, if you want to use for calculating simple regression model in the R environment, LibreOffice etc., you will obtain a different calculated formula y = a + b*x because these software packages use a reference date other than the UNIX Epoch time (00:00:00 UTC on 1 January 1970)). ⚠️
bestie this one is a whole thing — the CSV x axis data is a date time string, and if you take it somewhere else (R, LibreOffice, etc.) you get a different calculated formula than y = a + b*x, because those packages use a reference date that is NOT the UNIX Epoch time (00:00:00 UTC on 1 January 1970). no cap. 😭

Figure: Temporal Plot Tool — to optionally add a title to the temporal plot and/or change the x and y axes labels, first type the desired text and then click Draw as showed below.

Figure: Add title and labels to a time series plot — to export the time series data to a text file (date and data values), type a name for the file and click Draw again. Optionally, set the check-box to print headers, as well. 🌸

Figure: Export time series values to a text file

📝 NOTES 📝

g.gui.tplot requires the Python plotting library Matplotlib. that's the one dependency, don't come for her 💖

👀 SEE ALSO 👀

Temporal data processing, wxGUI, wxGUI components

🫶 AUTHOR 🫶

Luca Delucchi, Fondazione Edmund Mach, Italy — iconic. 👑

🔗 SOURCE CODE 🔗

Available at: wxGUI Temporal Plot Tool source code (history)

Accessed: Saturday Jan 17 05:42:35 2026

Main index | GUI index | Topics index | Keywords index | Graphical index | Full index

and that's the whole page bestie!! 💖 this was GRASS 8.4.2 (GRASS 8.4.2), © 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual, accessed Saturday Jan 17 05:42:35 2026. slay, bye 🦋✨

📦 where this page comes from