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: Thursday Oct 30 22:19:30 2025

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

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

GRASS 8.4.1                                                                                  g.gui.tplot(1grass)