Graphs
=======

.. image:: images/toolbar-graph.png

Plotting data
-------------

Create a graph from :menuselection:`File --> New Graph` or the new graph button on the toolbar.

Click the Add Data button on the toolbar and select the worksheet(s) and columns to plot, then click "Add" and close.

.. image:: images/adddata.png
   :scale: 80

You can also plot data by dragging a worksheet on to the graph. If no columns are set as 'x' or 'y', the default is to use the first column as x all the rest as y.


.. note::
   
   You can also plot by right clicking a columns and selecting :menuselection:`Plot`

Zooming
-------

To zoom in a graph, select the zoom tool on the toolbar.

 * **To zoom in**: drag with the left mouse button
 * **To zoom out**: :kbd:`Shift` + drag with the left mouse button
 * **To auto zoom to fit the data**, double click in the graph, or press :kbd:`Z`

With the right mouse button, you can pan around (if you click and drag near the middle of the plot) or push/pull the axes (click and drag near an axis).

.. note::
   You can also zoom in and out by pressing the :kbd:`+` and :kbd:`-` keys


Setting data range
------------------

.. sidebar:: Masking data

	.. image:: images/mask_graph.png
	   :scale: 80
	
	You can mask and unmask points using the range tool. 
	
	Hold :kbd:`Control` and drag a rectangle to mask points in the selected curves, or :kbd:`Shift` to unmask.

Choose the range tool on the toolbar. Then, you can set the visible range of the selected datasets using the mouse:

 * **set minimum x**: left mouse button
 * **set maximum x**: right mouse button
 * **reset to full range**: double click on plot

You can show and hide curves from the context menu, or using the keyboard shortcuts :kbd:`S` (Show), :kbd:`H` (Hide), and :kbd:`O` (show Only).

.. image:: images/range.png
   :scale: 80


Changing curve styles
---------------------

.. image:: images/datasetprops.png

Axis and graph properties
-------------------------

.. image:: images/graphprops_axes.png

.. image:: images/graphprops_format.png

Keyboard Shortcuts in Graphs
----------------------------


+-------------------------------+------------------------------------------------+
| Key                           | Action                                         |
+===============================+================================================+
| :kbd:`1`, :kbd:`2`, :kbd:`3`  | Select, Zoom, Range tools                      |
+-------------------------------+------------------------------------------------+
| :kbd:`A`                      | Select all curves                              |
+-------------------------------+------------------------------------------------+
| :kbd:`I`                      | Invert selection                               |
+-------------------------------+------------------------------------------------+
| :kbd:`H`                      | Hide curve(s)                                  |
+-------------------------------+------------------------------------------------+
| :kbd:`S`                      | Show curve(s)                                  |
+-------------------------------+------------------------------------------------+
| :kbd:`O`                      | Show Only                                      |
+-------------------------------+------------------------------------------------+
| :kbd:`M`                      | Mark                                           |
+-------------------------------+------------------------------------------------+
| :kbd:`Z`                      | Auto Zoom (:kbd:`Shift+Z` :                    |
|                               | auto zoom to selected curves)                  |
+-------------------------------+------------------------------------------------+
| :kbd:`+` / :kbd:`-`           | Zoom in / out                                  |
+-------------------------------+------------------------------------------------+
| :kbd:`K` / :kbd:`L`           | Change x / y axis between linear and log       |
+-------------------------------+------------------------------------------------+


Shortcuts for setting curve properties

+-------------------------------+------------------------------------------------+
| Key                           | Action                                         |
+===============================+================================================+
| :kbd:`C` + number (0-9)       |   Set color of selected curves                 |
+-------------------------------+------------------------------------------------+
| :kbd:`C` + right arrow        |   Set series of colors for selected curves     |
+-------------------------------+------------------------------------------------+
| :kbd:`C` + up/down arrow      |   Next/previous color                          |
+-------------------------------+------------------------------------------------+
| :kbd:`B` + number (0-9)       |   Set symbol                                   |
+-------------------------------+------------------------------------------------+
| :kbd:`B` + right arrow        |   Set series of symbols                        |
+-------------------------------+------------------------------------------------+
| :kbd:`B` + up/down arrow      |   Next/previous symbol                         |
+-------------------------------+------------------------------------------------+
| :kbd:`X` + number (0-9)       |   Set symbol size                              |
+-------------------------------+------------------------------------------------+
| :kbd:`X` + up/down arrow      |   Increase/decrease symbol size                |
+-------------------------------+------------------------------------------------+