62
$\begingroup$

Anybody have any experience with software (preferably free, preferably open source) that will take an image of data plotted on cartesian coordinates (a standard, everyday plot) and extract the coordinates of the points plotted on the graph?

Essentially, this is a data-mining problem and a reverse data-visualization problem.

$\endgroup$
7
  • 2
    $\begingroup$ For one solution, see the comments to this reply. Open source solutions would include image processing or raster GIS software (GRASS is a likely candidate) or, perhaps, GNU Octave. I'm mentioning these as a comment because I haven't used either for this specific purpose, so please take them as possibilities, not as definite solutions. $\endgroup$
    – whuber
    Commented Aug 18, 2011 at 4:20
  • $\begingroup$ I'm hoping for code/software specifically for scraping graphs, and I remember such packages existed, at least they did 10 yrs ago, but I can't remember their names now, and don't know if they work on current operating systems. $\endgroup$ Commented Aug 18, 2011 at 4:56
  • $\begingroup$ @Alex, try googling "Graph Digitizer Open Source" $\endgroup$ Commented Aug 18, 2011 at 5:52
  • $\begingroup$ A short Mathematica program to get data from scans here. $\endgroup$ Commented Jun 6, 2015 at 14:29
  • 1
    $\begingroup$ See also the resource I point to in my answer to What is the relationship between Y and X in this plot?. $\endgroup$
    – Alexis
    Commented Oct 30, 2017 at 19:59

12 Answers 12

41
$\begingroup$

Check out the digitize package for R. Its designed to solve exactly this sort of problem.

$\endgroup$
2
  • 4
    $\begingroup$ There is a nice article / tutorial in R Journal, June 2011 $\endgroup$ Commented Aug 23, 2011 at 22:56
  • $\begingroup$ Does not appear to work in RStudio. $\endgroup$
    – Alexis
    Commented Jun 9, 2020 at 23:35
45
$\begingroup$

graph digitizing software

There are many different options, but all basically use the same workflow:

  1. upload an image
  2. set the x and y scales by indicating the values at two points on each axis
  3. indicate if the scale is linear, log, etc,
  4. click on the points.
    • Some of the programs automatically recognize lines or points. I am usually after points, and I find them too inconsistent to be helpful even with 100s of points. I have not found one that recognizes different symbols. This feature could be worth the trouble for digitizing lines, but I have never had to do this.

The program returns each point as an x-y matrix.

Often it helps selecting points if the image is zoomed, either by uploading a zoomed version of the image or using the zooming feature available in some of the programs.

There are many programs, and they vary in extra features, usability, licensing, and cost. I have listed them below.

All of the ones I have used work fine. Except in contexts where measurement error is very small, error from graph scraping is insignificant (e.g. error from digitization << size of error bars or uncertainty in the estimate). If have not tested the accuracy of any of these programs, but it would be interesting to compare among users, among programs, and against the results of reproduced statistical analyses.

Programs I have used:

  • Digitizer (free software, GPL) auto point / line recognition. Available in Ubuntu repository (engauge-digitizer)
  • Get Data (shareware) has zoom window, auto point / line recognition
  • DigitizeIt (shareware) auto point / line recognition
  • ImageJ (open source, most extensible after R digitize)
  • R digitize (free, open source), because it simplifies the processs of getting data from the graph into an analysis by keeping all of the steps in R. See the tutorial in R-Journal
  • GrabIt! (free demo, $69) Excel plug-in
  • WebPlotDigitzer (free, online). Browser based, extracts data from images. Reviewed here.

Programs I have not used:

  • GraphClick (Mac, $8)
  • g3data (open source - GNU GPL) Has zoom window, no auto-recognition. Available in Ubuntu repository.
  • GRABIT OpenSource (BSD) plugin that runs in a proprietary platform, Matlab

TL;DR: WebPlotDigitizer is available as a web application as well as a chrome plugin

$\endgroup$
12
  • $\begingroup$ g3data (open source - GNU GPL) has zoom window, no auto-recognition. Available in Ubuntu repository. I can't compare, as it's the only one I've tried; but I found it very easy to use. $\endgroup$
    – Scortchi
    Commented Oct 16, 2013 at 22:54
  • $\begingroup$ Why R digitize was removed from CRAN? $\endgroup$ Commented May 5, 2016 at 8:47
  • 1
    $\begingroup$ @Masi most of these don't work with pdf, with pdf files I make the figure large and then use a screen capture (eg cmd-shift-4 on Mac) to save a figure as jpg or png. $\endgroup$ Commented May 7, 2016 at 2:03
  • 1
    $\begingroup$ @Masi Maintaining a package on CRAN can be a lot of additional work. The package is available on GitHub github.com/tpoisot/digitize $\endgroup$ Commented May 7, 2016 at 2:10
  • 1
    $\begingroup$ @Masi what specifically do you mean by 'systematically'? Can you link to the figure(s) in question? When you say 'intersect', do you mean the point is contained within the axis and thus does not appear? $\endgroup$ Commented May 8, 2016 at 3:08
17
$\begingroup$

Other answerers assume that you deal with raster image of a graph. But nowadays the good practice is to publish graphs in vector form. In this case you can achieve much higher exactness of the recovered data and even estimate the recovery error if you work with the code of the vector graph directly, without converting it to raster image.

Since the papers are published online as PDF files, I assume that you have a PDF file which contains vector plot with data you wish to recover from it (get in numerical form) and estimate introduced recovery error.

First of all, PDF is a vector format which is basically textual (can be read by a text editor). The problem is that it can (and almost always) contain compressed data streams which require to be uncompressed in order to read them by a text editor. These compressed data streams usually contain the information we need.

There are several ways to uncompress data streams in order to convert PDF file to a textual document with readable PDF code. Probably the simplest way is to use free QPDF utility with --stream-data=uncompress option:

qpdf infile.pdf --stream-data=uncompress -- outfile.pdf

Some other ways are described here and here.

The generated outfile.pdf can be opened by a text editor. Now you need PDF Reference Manual 1.7 to understand what you see. Do not panic at this moment! You need to know only few operators described in the "TABLE 4.9 Path construction operators" on pages 226 - 227. The most important operators are (the first column contains coordinate specification for an operator, the second contains the operator and the third is operator name):

x y               m   moveto 

x y               l   lineto 

x y width height  re  rectangle

                  h   closepath

In most cases it is sufficient to know these four operators for recovering the data.

Now you need to import the outfile.pdf file as text into some program where you can manipulate the data. I'll show how to do it with Mathematica.

Importing the file:

pdfCode = Import["outfile.pdf", "Text"];

Now I assume the simplest case: the graph contains a line which consists of many two-point segments. In this case each segment of the line is encoded like this:

268.79999 408.92975 m
272.39999 408.92975 l

Extracting all such segments from the PDF code:

lines = StringCases[pdfCode, 
   StartOfLine ~~ x1 : NumberString ~~ " " ~~ y1 : NumberString ~~ " m\n" ~~ 
                  x2 : NumberString ~~ " " ~~ y2 : NumberString ~~ " l\n" 
                                        :> ToExpression@{{x1, y1}, {x2, y2}}]; 

Visualizing them:

Graphics[{Line[lines]}]

You get something like this (the paper I am working with contains four graphs):

plot

Each two adjacent segments share one point. So in this case you can turn the sequences of adjacent segments into paths:

paths = Split[lines, #1[[2]] == #2[[1]] &];

Now you can visualize all the paths separately:

Graphics[{Line /@ paths}]

From this figure you can select (by double-clicking) the path you are looking for, copy graphics selection and paste as new Graphics. For converting it backward to list of points you take the element {1, 1, 1}. Now we have the points not in the coordinate system of the graph but in the coordinate system of the PDF file. We need to establish relationship between them.

From the above plot you select ticks by hand (holding Shift for multiple selection), then copy them and paste as new Graphics. Here is how you can extract coordinates of horizontal ticks:

screenshot

Now check the differences between ticks:

Differences[reHorTicks]

From these differences you can see how precise is positioning of the ticks in the PDF file. It gives an estimate of error introduced by converting original datapoints into vector graph included in the PDF file. If there are appreciable errors in ticks positioning you can reduce the error by fitting the coordinates of ticks to a linear model. This linear function now can be used to get original coordinates of points of the path (that is in the coordinate system of the plot).

$\endgroup$
4
  • 2
    $\begingroup$ Alexey, you wrote But nowadays the good practice is to publish graphs in vector form. Do you have a good reference for best practices around which vector format(s)? (I.e. ought I use an eps encapsulation of an svg file in my LaTeX manuscripts, or am I supposed to output graph to LaTeX directly?) Cheers. $\endgroup$
    – Alexis
    Commented Sep 7, 2014 at 17:49
  • 2
    $\begingroup$ @Alexis I refer to the modern journal's recommendations to provide graphs in vector form. Different journals accept different subsets of vector formats. In general I expect better quality when there are lesser transformations from one format to another. $\endgroup$ Commented Sep 8, 2014 at 0:49
  • $\begingroup$ @Alexis So basically I expect that providing graphs in one of the PostScript formats (EPS or PDF) should be the best option. But exact answer depends on software used by the publisher. Note also that usually journals recommend against any conversions of the graphs produced by your graphing software. So if you can export as EPS it is probably the best option. If you can only export SVG then provide SVG if the journal accept it, do not convert yourself into other format. $\endgroup$ Commented Sep 8, 2014 at 1:24
  • $\begingroup$ Strongly related answer with detailed description of the procedure for Mathematica. $\endgroup$ Commented Jun 6, 2015 at 16:37
4
$\begingroup$

I haven't used it, but UWA CogSci lab recommend DataThief (shareware).

$\endgroup$
4
$\begingroup$

Check out engauge. Its free and open source http://digitizer.sourceforge.net/

$\endgroup$
0
3
$\begingroup$

Un-Scan-It http://www.silkscientific.com/graph-digitizer.htm

$\endgroup$
2
$\begingroup$

Try scanit: http://amsterchem.com/scanit.html

It is free of charge, runs on Windows

$\endgroup$
2
$\begingroup$

You can also try im2graph (http://www.im2graph.co.il) to convert graphs to data. Works in Linux and Windows.

$\endgroup$
2
$\begingroup$

'g3data' is a software which can be used to serve your purpose. It's a free software and I have used it. You can download it from here: http://www.frantz.fi/software/g3data.php

$\endgroup$
2
$\begingroup$

I had to do this so many times in my career I eventually put together a javascript program which is available here:

http://kdusling.github.io/projects/DataGrab/index.html

Sorry, but you will still need to click on every single point. Though you can use the arrow keys which does save some wrist strain.

$\endgroup$
1
$\begingroup$

STIPlotDigitizer has been newly released.

http://stiwww.com/product/software-techniques-plot-digitizer

$\endgroup$
1
$\begingroup$

For R users, the package grImport (on CRAN) can import vector graphics and convert them into objects that R can interpret. It assumes that one can convert PDF (or other vector format of interest) to PostScript format. This can be done for example with Inkscape: import (File > Import) your PDF page with your figure into Inkspace and File > Save As > Save as type: > PostScript *.ps. Once you have your *.ps file fallow the grImport vignette Importing Vector Graphics, more relevant being section '4.1. Scraping data from images'.

You will need ghostscript on your Operating System - try to download it from here.

Note, if you run somehow into ghostscript error 'status 127' when you call grImport::PostScriptTrace, then fallow the recommendation from here, which says to manually set the path to ghostscript on your machine.

Here is some sample R code to import PostScript file into R:

install.packages("grImport")
require(grImport)
# if you get the ghostscript error 'status 127' then set the path to ghostscript, e.g.:
Sys.setenv(R_GSCMD = normalizePath("C:/Program Files/gs/gs9.22/bin/gswin64c.exe")) 
PostScriptTrace(file = "graph.ps", outfilename = "graph.ps.xml")
my_fig <- readPicture(rgmlFile = "graph.ps.xml")
grid.picture(my_fig)

Note, if your graph is on a page in a multi page PDF file, then you can split the multi-page document with PDFTK builder. Import your one page PDF file in Ikscape and delete any extra elements (extra text, extra graph elements). This wil ease your work in R when trying to catch the coordinates of the graph elements you are interested in.

$\endgroup$

Not the answer you're looking for? Browse other questions tagged or ask your own question.