g.gui.tplot - GRASS manual
Author: GRASS Development Team
Description: g.gui.tplot: Plots the values of temporal datasets.
Keywords: general, GUI, temporal, plot

## NAME

g.gui.tplot - Plots the values of temporal datasets.

## KEYWORDS

general, GUI, temporal, plot

## 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
  Set the header of CSV file, to be used with csv option
-l
  Show simple linear regression model line
--overwrite
  Allow output files to overwrite existing files
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### 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 use only with stvds
attr=string
  Name of attribute
  Name of attribute which represent data for plotting
output=name
  Name for output graphical file
  Full path for output file containing the plot, ddd extension to specify format (.png, .pdf, .svg)
csv=name
  Name for output CSV file
  Full path for the CSV file containing the plotted data
title=string
  Title for plot
  The title for the output plot
xlabel=string
  Label for x axis
  The x axis label for the output plot
ylabel=string
  Label for y axis
  The y axis label for the output plot
size=string
  Size of output image as width,height in pixels
  It works only with output parameter

## 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).

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)).

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.

## SEE ALSO

Temporal data processing, wxGUI, wxGUI components

## AUTHOR

Luca Delucchi, Fondazione Edmund Mach, Italy

## SOURCE CODE

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

Latest change: Wednesday Jan 28 08:16:26 2026 in commit: 0a9db34657dc4900ba35d6476b890c13d118c669

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

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual