manpages

g.gui.tplot(1grass)

g.gui.tplot(1grass) GRASS GIS User's Manual g.gui.tplot(1grass)

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)

Accessed: Monday Jun 01 16:59:23 2026

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

GRASS 8.4.2