---
name: "g.gui.tplot"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/g.gui.tplot"
---

# g.gui.tplot(1grass)

Plots the values of temporal datasets.

## 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 Feb 24 17:52:41 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