Plot Digitizer

Description

Plot Digitizer is a Java program used to digitize scanned plots of functional data. Often data is found presented in reports and references as functional X-Y type scatter or line plots. In order to use this data, it must somehow be digitized. This program will allow you to take a scanned image of a plot (in GIF, JPEG, or PNG format) and quickly digitize values off the plot just by clicking the mouse on each data point. The numbers can then be saved to a text file and used where ever you need them. Plot Digitizer works with both linear and logarithmic axis scales.  Besides digitizing points off of data plots, this program can be used to digitize other types of scanned data (such as scaled drawings or orthographic photos).

Plot Digitizer includes a special "semi-auto" digitizing feature.  For plotted data that trends from left to right, you can simply indicate what data you want digitized with a thick paint brush and the program will automatically sort out grid lines, noise, etc, and will attempt to digitize the line for you.  This feat is accomplished with the help of the open source autotrace image vectorization program (version 0.31.1).  Currently this feature is available for MacOS X, MS Windows, and Linux running on x86 architectures, but if you are willing to port the autotrace program yourself, it could be made to run on other platforms.

Will the auto-digitizing feature digitize any plot?  Short answer:  no.  Long answer:  The auto-digitizing feature works best with black and white, 300 dpi images of continuous data which does not run vertically (vertical lines give it fits), does not repeatedly cross other data lines, is not close to and parallel to grid lines, is not extremely noisy and which does not have plot symbols.  After using the program a while you begin to learn what it can and can't auto-digitize.  However, even in cases where it doesn't auto-digitize the entire line, you can sometimes do a piece of it automatically, then manually digitize a piece, and then do another piece automatically, etc.  I've found this feature to be pretty useful on digitizing plots of experimental test time histories, but your mileage may vary.

To make the digitizing task easier, this program includes many handy features.  For example:  You can recalibrate the Y axis without having to recalibrate the X axis (multiple sets of data are commonly plotted with the same X axis).  You can insert points between two already digitized points by right clicking and choosing "Insert" from the pop-up menu.  You can delete points by right-clicking on the points and choosing "Delete".  You can move points by clicking and dragging them.  You can calculate the length of a digitized line and the area enclosed by a digitized polygon of nearly arbitrary shape.  Finally, there is also unlimited undo/redo.

Installation

First go to the downloads area and download the appropriate executable version of the program for your platform, and/or it's full source code, from there.

MacOS X:
You should have received this application as a compressed disk image file (PlotDigitizer_#.#.#_MacOSX.dmg).  This disk image file, when mounted (by double-clicking on it), should contain the application icon (Plot Digitizer.app, this readme file (README.txt) and some documents containing legalese.

To install this program, simply drag the Plot Digitizer.app icon to a convenient location on your hard drive.  In MacOS X this is usually the "Applications" directory, but you are free to put it anywhere you want (aren't Macs great!).

The application file should work properly on MacOS X 10.2 or later right out of the box.  No additional software required.


Windows:
You will first have to make sure that you have the J2SE 1.3 or later installed on your computer.  If you do not, you can get it from:  http://java.sun.com

You should have received this application as a executable installer file (PlotDigitizer_#.#.#_Windows_installer.exe).  Run this installer.  It will make sure that everything gets put where it belongs.  If you have a previous version of this program installed, you need to "uninstall" the old version first.  You can find the uninstaller program in the same directory that you originally installed the program into or you can use "Start-Settings-Control Panels-Add/Remove Programs.

Linux (and many flavors of UNIX):
You will first have to make sure that you have the J2SE 1.3 or later installed on your computer and on your search path.  If you do not, you can get it from:  http://java.sun.com

You should have received this application as a executable shell script installer file (PlotDigitizer_#.#.#_Linux_installer.bin).  After you have downloaded the installer, you will need to make it executable by changing it's permissions:

chmod a+x PlotDigitizer_*_Linux_installer.bin

If you have a previous version of this program installed, you should "uninstall" the old version first.  You can find the uninstaller program in the same directory that you originally installed the program into.

If you want to install Plot Digitizer into your account only, simply run the installer script.  It will make sure that everything gets put where it belongs.  If you want to install this program outside of your account, you can use the sudo utility to get super-user access:

sudo ./PlotDigitizer_*_Linux_installer.bin

If running under Linux on an x86 platform, you should be able to use the auto-digitizing feature.  I do not have the autotrace program compiled for other platforms, and so the auto-digitizing feature will not be available on those.  However, if you can get autotrace to compile on your platform, then it can be made to work with Plot Digitizer.

Usage Notes

Quick Instructions:  To use this program, first scan a plot with your favorite scanning system, then save the plot as a GIF, PNG, or JPEG format file. Run Plot Digitizer, open the scanned image file from the "Open" command in the "File" menu. Then follow the instructions at the bottom of the window to calibrate the plot and then digitize the points.

If you want to compute the length of a digitized line or the area enclosed by a digitized polygon, then you will need to pick those options from the Analysis menu before clicking on the "Done" button.

Hint:  If you want to digitize plots from published technical reports that are available electronically in PDF format, you can skip the "print and then scan" step and keep everything digital.  On Windows or MacOS X, you can use Acrobat Reader to select a rectangular area and copy it to the clipboard (at screen resolution, so zoom in first).  Then use a graphics program to paste in the image and save it to a GIF or PNG file.  Then you can use the file with Plot Digitizer.  Under Linux, you can use the PDF Toolkit to extract the page you want and then use ImageMagic to convert it to GIF or PNG at any resolution you want.  Then you can use the file with Plot Digitizer.