Digplot
=======

Digplot is a simple program to extract data values from images of 2-D plots.


Using Digplot
~~~~~~~~~~~~~

    .. image:: images/toolbar.png

Loading an image
----------------

You can load an image by:

  * Opening an image file using :menuselection:`Open Image` 
  * Pasting an image from the clipboard with  :menuselection:`Paste Image` 
  * Dragging and image file into the window. 
  
PNG, JPG, GIF, BMP, TIFF files (and others) are supported.

Moving and selecting points
---------------------------

To move the cursor using the keyboard, use the arrow keys to move by 1 pixel. :kbd:`Home`/:kbd:`End`/:kbd:`PgUp`/:kbd:`PgDown` move by 10 pixels. Holding down :kbd:`Shift` and pressing the arrow keys moves by sub-pixel amounts (1/10 pixel) for better accuracy on low-resolution images.

To select a point, click on the plot or press :kbd:`Space`.

Defining axes
-------------

Choose :menuselection:`Define Axes` and select any three or more points with known X and Y, then press Enter. 

:menuselection:`Tools --> Log X Axis` or :menuselection:`Tools --> Log Y Axis` let you choose between linear and log scales.


Digitizing points
-----------------

Select the :menuselection:`Pick Points` tool to start digitizing points.

Click on the plot or press :kbd:`Space` to digitize a point. A blue marker will appear and the x and y values will be added to the table.

Digitizing lines
----------------

Select the :menuselection:`Follow Lines` tool to start digitizing lines.

When you move the mouse over a line that can be followed, a green line will appear. Click or press :kbd:`Space` to digitize the line.

In the :menuselection:`Settings` dialog you can set the parameters for the line following algorithm:

 * `curve color` and `background color`: a pixel is considered part of the curve if its color is >25% more similar to the curve color than the background color.
 * `horizontal gap` and `vertical gap`: the dimensions of a rectangle which is searched for the next point along the curve.
 * `follow direction`: can be right, left, up or down.

Masks
-----

Using the :menuselection:`Mask` tool you can direct the line following algorithm in difficult areas, for example where the curve intersects other curves or axes.  Any areas you mark will be considered to not be part of the curve regardless of their color.

You can change the brush size using the :kbd:`+` and :kbd:`-` keys.

To clear all masked areas select :menuselection:`Clear Masks`

Editing data
------------

You can change digitized X and Y values by editing the values in the table. You can also select data points (table rows) and delete them using :menuselection:`Delete Selected` or the :kbd:`Del` key.

Select :menuselection:`Delete data` to clear all the digitized data.

Saving or copying data
----------------------

When you are done, you can save all digitized X and Y values to an ASCII file using :menuselection:`Save data` or copy them to the clipboard using :menuselection:`Copy data`.