˜ÿÿÿÿCjHH;RÿøBRõ{ÞýÄËÌÀ´- ^ì&'dCPCVÿòÿòìÿòºÿÿÿÿÿÿÿÿB¢PBòÿòÿòìÿòºÿÿÿÿÿÿÿÿ6 €@B`ÿÿÿÿ°        °$Hh        ÿðÒ$HhDataThief v. 1.0.8   ÿðÒ$HhWhat is DataThief  eDataThief is a program to reverse engineer a set of data from a given plot in a magazine or journal. This program gives you the opportunity to incorporate somebody else's data points in your plots. This comes in very handy when f.i. you would like to compare your data with the data in a published article for which you don't have the data in table format.    What do I need  ÌYou need access to an Apple Scanner with the HyperScan HyperCard Stack, or some other scanner/program combination that lets you scan an image of a plot and save it as a MacPaint or as a PICT format file.    How does it work   Ò$Hh¿¥ Scan the plot at the highest magnification possible on your screen; i.e. make the image fit the whole screen if possible. The screen resolution is the limiting factor in stealing the data.  E¥ Save the image as a MacPaint or as a PICT format (preferred) file.  7¥ Open DataThief. You will be prompted to open a file.  < Select the image you would like to steal data points from.  ¥ The plot will appear on the screen. Now move the mouse pointer to the leftmost point of the horizontal axis in your plot and click the mouse.  \ A dialog box will show, in which you can fill in the real X coordinate of this axis point.  í¥ Then move the mouse pointer to the rightmost position of the horizontal axis and click the mouse once. You will get another dialog box; fill in the appropriate value. Do the same for the lowest and highest points on the vertical axis.  º¥ You will now be prompted for an optional correction in the axes coordinates and additional options; e.g. error bars, logaritmic axes & markers to make your datapoint-clicking visible.  t¥ Don't be afraid if the plot appears skewed on the screen. DataThief will correct for skewness in the output file.  þ¥ This is the time to investigate the options in the menu bar. You can click each datapoint separately or perform an automatic scan. In the latter case you can set several variables to make the scan fit your wishes. Try it out and find your preferences.  ¥ Now move the mouse pointer to the first data point you want to steal and click the mouse once. Repeat this for all data points or watch the scan going on.  ¢¥ In single data mode, if you have selected error bars, click on either the upper or the lower extremity of the error bar, then click on the remaining extremity.  ~ DataThief is smart enough to realize which end of the error bar has the highest value, and will save that value accordingly.  R¥ When you have clicked all data points, select Save or Close from the File menu. This will save your data points in a TEXT file which can be read by any word processor, spreadsheet or plotting program. If you like, you can set the 'creator'. This enables your favorite program for further processing to open the data file automagically.  ÿðÒ$Hh  Changing Cursors  ÞThe shape of the cursor in DataThief changes according to the mode you are in. First of all is the normal arrow cursor. You will see it when you move the cursor to the menu bar or when a dialog is presented on the screen.  Second is the crosshair cursor. This is the cursor which you see when you are expected to do something with a point on the plot you want to scan. The Crosshair cursor has different indicators in the upper right corner of the cross. These indicators are explained below:   Ò$HhJXÐ indicates you have to click on the leftmost X coordinate of your plot.  KX+ indicates you have to click on the rightmost X coordinate of your plot.  HYÐ indicates you have to click on the lowest Y coordinate of your plot.  IY+ indicates you have to click on the highest Y coordinate of your plot.  ID indicates you are in manual data stealing mode. Click on a data point.  ^E indicates you are expected to click on an error point (only when error bars are selected).  fT indicates you are in autoTracing mode. Click on the beginning of the curve to start the auto trace.  ÿðÒ$Hh  The last cursor you might see is the spinning beach ball. This one shows during time consuming operations like auto tracing or saving a file to disk. As long as the ball is spinning, the Mac is working for you. Sit back, relax, take a deep breath and think of something beautiful.    DataThief Menus   File Menu  EÒ$HhLOpen This opens a MacPaint or PICT type file and displays it on the screen.  sClose This closes the present window. If you have stolen data, you will be asked wether you would like to save it.  bSave This saves the stolen data in a file with default name 'Stolen Data'. Change it if you like.  eSave As This saves the stolen data in a file with default name 'Stolen Data'. Change it if you like.  †Quit This closes the present window and exits DataThief. If you have stolen data, you will be asked wether you would like to save it.     Edit Menu  vUndo Hit this repeatedly to undo clicks on either data or error bars. Cut, Copy, Paste and Clear only work with DA's.     Options Menu  “Auto Tracing This option toggles between auto tracing on and off. With tracing on, just click on the first point of the curve and watch it GoooooÉ  bTrace Specs In this dialog you can set some values that change the behaviour of the auto tracing.  p Trace width enables you to set the maximum gap in pixels the tracer will jump over without stopping the trace.   Trace height sets the number of pixels the tracer will look up and down a data point to find the slope of the curve. If you increase this number, more pixels will be looked at; i.e. you can trace a steeper slope. The default values are the ones we found to work best in most cases.  ‚Data Options In this dialog you can change some of the behaviour of DataThief. It contains one checkbox and three radio buttons.  B The checkbox Enable Markers does just that. When selected, DataThief will show markers on the spots you've clicked on. The markers are a circle for data points and a square box dor an error bar point. This only works in manual data taking. The three radio buttons control the behaviour of the way error bars are handled:  VÒE$HhV¥ No error bars means the plot has no error bars (Did I really have to explain this?)  ¢¥ Asymetric error bars are error bars which are not of equal length. In the output file you will get Ñapart from X and Y valuesÑ a Delta-Y+ and a Delta-Y- value.  }¥ Symetric error bars have an equal length on both sides of the data point. In the output file you get just a Delta-Y value.  ÿðÒ$HhËWhen either asymetric or symetric error bars are selected, you don't have to worry about which point to click first. DataThief is smart enough to know which of the two error point has the highest value.  EÒ$Hh  íFile Options In this dialog you can set the creator of the output file. The default is dief, the DataThief file format. If you change this to e.g. XCEL, the file will be owned by Microsoft Excel, and can be opened by double-clicking it.  • Another option here is skip headers. When selected, this will skip all text in the output file, i.e. it will only put the numeric data in the file.  § The last option here is compression factor. When you change this to n > 1, the output file will contain only every n-th number. This only works for auto-traced data!  h The file options are not saved when you exit DataThief; you will have to set them manually every time.  ÖZap Data Use this and the clicked or scanned data is gone! You can use this to when scanning a multiple curve plot; first scan the first curve, save the data, zap the data and then scan the second curve, etcetera.  ‰Zap Axes Use this to remove all entered values for the X and Y axes when you have made a mistake. This includes zapping of the data too.  VSound This option toggles sound on and off. Use it if our "fun" sounds make you sickÉ  ÀCoordinates This option toggles on and off a floating window containing the coordinates of the current point the cursor is pointing at and the coordinates of the last clicked or traced point.  ÿðÒ$Hh  What does it cost  Nothing, this program was developed as an aid to the physicists at NIKHEF-K and it was decided to let it roam the world for free as a help to all who need to steal data from others :-) However, it is not public domain:this program is ©1991,1992 by Kees Huyser & Jan van der Laan.  mThe program is written in THINK C version 5.0.2, therefore parts of this program are ©1990 by Symantec Corp.  *You are encouraged to share this program with your friends and collegues provided you do not charge anything above reasonable copying and media costs. If this program is of any use to you, we'd appreciate a picture postcard from your home town. Please send them to the address in the next section.     Availability  ”The program is available by email from the authors and by anonynous ftp from SUMEX and sun4nl.nl. This version is also posted to comp.binaries.mac.     Who wrote it  €The program was written by Kees Huyser and Jan van der Laan of the Computer Systems Group of the Nuclear Physics Section at the    KNational Institute for Nuclear Physics and High Energy Physics (NIKHEF-K),   PO Box 4395  1009 AJ Amsterdam  The Netherlands    Phone:  +31 20 592 21 32  email:  #keeshu@paramount.nikhefk.nikhef.nl  !jan@ paramount.nikhefk.nikhef.nl     Defaults  The various default values are the ones we found to work best in most cases. However, some of them can be changed with an appropriate resource editor as Resedit. If this doesn't sound not familiar to you, ask some more experienced Macintosh user to fulfill your wishes.  ` .ž .ª .Ä& .ê* / /Ö" /ø< 042 0f` 0Æ( 0î" 1$ 14D 1x* 1¢" 1Ä0 1ô$ 2> 2V. 2„2 2¶( 2Þ" 3N 3N> 3Œ 3˜R 3ê 3ö 4, 4: 4Tf 4º 4Æ 4â> 5 R 5rV 5ȼ 6„>                                                                                                                                          *& P \ h t     €& ¦ ² ¾ Ê     Cr