Basic │ FullView │ Shortcuts │ Rapid │ Scaling │ Grid│ ptLines │ Shapes │ Other
traceFigure can be used to manually digitize points on an image. For example, if you have an image of a line graph, you can digitize selected points. By digitize, we mean create a set of x,y coordinate pairs. These pairs can be saved as a CSV file, for use in a spreadsheet, etc.
traceFigure is best used when the number of points to be digitized numbers is in the 100s. While a larger number (i.e.; a few thousand) can be handled, processing will be noticeably slow (it can take several seconds to perform bulk operations).

 Displaying an image . Although you can don't need to have an image to digitize, the ability to trace (and otherwise locate) points on an image is what makes traceFigure useful!
There are two ways of drawing an image onto the work area.

  1. Use the at the top of the screen. This allows you to upload an image file from your computer -- which will then be drawn onto the working area.
  2. Use the button in the Other specs menu. This allows you to use an image currently on the server. This image file must be in (or under) the directory that contains traceFigure. So this is only useful if you have some control of the contents of your server (or are running traceFigure in standalone mode -- in which case files on your hard drive can be loaded).
 The basics. Digitizing points is done by moving the cursor (displayed as a large +) over a spot on the image, and then recording the location.  Full view. You can switch between a full view, or a regular view. To enter (and exit) full view, click the button on the top line.
While in full view mode, you can display options menu by ..
  • clicking on the button.
    After making your changes (i.e.; clicking on Add points, or changing tt>Move options), you can hide the menu by
  • clicking on the again.
  • Note: is only displayed in full view mode).

    Hint: see the shortcuts for a mouse movement sequence that will bring up the options menu!

     Shortcuts Keyboard & mouse shortcuts: These shortcuts work when Add points is active.

     Rapid Entry. For quick entry of many points, you can select (under the MoveOptions menu) ...  Scaling. Points are recorded using the location on the image: in percent of width and height of image. This location is zoom and image resolution independent. Thus, a location of 50.00 is in the middle of the image regardless of how much it is zoomed in (or out), and regardless of how much of the image is outsize of the viewport (i.e.; if you must use the scrollbars).

    You might find it useful to scale these into image location values into real-world values; say that correspond to values in a line graph.

    This is done using the Scale Specs menu

     Grid. Display a reference grid on top of the image.
    Note: before displaying a grid, you must specify the Scale Specs

    Clicking the Grid button will bring up a box showing grid specification options.
    After setting these options, click the button!

      Grid options:

    Note: place the mouse cursor over a grid line to view its X (or Y) location (in scaled values, not in pixels)

     Working with ptLines. You can delete, modify, or view the digitized results stored in a ptLine... by clicking on the ⤷ icon . A box will open showing a menu of actions.
    Delete ptLine Upload ptLineMenu Copy ptLine Add to Remove points Tweak points
    Display points (all or none) Show point values Fill-in/remove duplicates Merge ptLines Add connecting lines Vertices

     Shapes: As a convenience, you can use the Shapes menu to enter the following shapes (as ptLines): lines (any angle, or vertical or horizontal), rectangles, circles, and polygons. Points along the edge of these shapes are recorded and displayed (the Resolution option under MoveOptions controls how dense these points will be).

    To enter a shape, first select the desired shape, and then enter vertices (i.e.; by moving the cursor, and then hitting space)

     Miscellaneous specs: