Geografic-Information-System/gui/wxpython/tplot/g.gui.tplot.html

<!-- meta page description: wxGUI Temporal Plot Tool -->
<!-- meta page index: topic_gui|GUI -->
<h2>DESCRIPTION</h2>

The <b>Temporal Plot Tool</b> is a <em><a href="wxGUI.html">wxGUI</a></em>
component that queries and plots the values of a point, defined by a coordinate
pair, in one or more temporal datasets (strds, stvds, str3ds).

<p>
Supported features:
<ul>
  <li>temporal datasets with interval/point and absolute/relative time,</li>
  <li>show simple linear regression model line with calculated formula
    <pre>y = a + b*x (y is dependent variable, a is intercept, b is slope, x is explanatory variable)</pre> and
    <pre>r-squared (parameter of goodness-of-fit measure for linear regression model)</pre></li>
  <li>pop-up annotations with values information,</li>
  <li>query and plot multiple points via the command line,</li>
  <li>zoom and pan,</li>
  <li>change labels to x and y axes,</li>
  <li>add title to the plot, and</li>
  <li>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
    <a href="https://www.r-project.org/">R environment<a>,
    <a href="https://www.libreoffice.org/">LibreOffice</a>
    etc., you will obtain a different calculated formula <pre>y = a + b*x</pre>
    because these software packages use a reference date other than
    the UNIX Epoch time (00:00:00 UTC on 1 January 1970)).
  </li>
</ul>

<div align="center" style="margin: 10px">
<a href="g_gui_tplot_labels.png">
<img src="tplot.png" width="600" height="367" alt="Temporal Plot Tool" border="0" >
</a><br>
<i>Figure: Temporal Plot Tool</i>
</div>

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 <em>Draw</em> as
showed below.

<div align="center" style="margin: 10px">
<a href="g_gui_tplot_labels.png">
<img src="g_gui_tplot_labels.png" width="600" height="482" alt="g.gui.tplot add title and axes labels" border="0">
</a><br>
<i>Figure: Add title and labels to a time series plot</i>
</div>

To export the time series data to a text file (date and data values), type a
name for the file and click <em>Draw</em> again. Optionally, set the
check-box to print headers, as well.

<div align="center" style="margin: 10px">
<a href="g_gui_tplot_export_csv.png">
<img src="g_gui_tplot_export_csv.png" width="600" height="481" alt="g.gui.tplot export time series as csv file" border="0">
</a><br>
<i>Figure: Export time series values to a text file</i>
</div>

<h2>NOTES</h2>

<em>g.gui.tplot</em> requires the Python plotting library
<a href="http://matplotlib.org/">Matplotlib</a>.

<h2>SEE ALSO</h2>

<em>
  <a href="temporal.html">Temporal data processing</a><br>
  <a href="wxGUI.html">wxGUI</a><br>
  <a href="wxGUI.components.html">wxGUI components</a>
</em>

<h2>AUTHOR</h2>

Luca Delucchi,
<a href="http://www.gis.cri.fmach.it">Fondazione Edmund Mach</a>, Italy