Haskell/Explore

From CORSIS

Revision as of 01:13, 21 March 2010 by WikiSysop (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

f1eh.png

Experimental Plot data Reconstructor

Very first prototype of a command line tool to extract pixel positions matching a given colour to help reconstruct plot data. See example.ods or example.xls, README and Main.hs on the project homepage to figure out its usage.

(Builds and runs fine on Windows and Linux, other systems not tested.)

Downloads

Help

ExPloRe 0.0.7 : Experimental Plot Reconstructor
================================================================================

SYNOPSIS

  explore image legend tolerance scan-area interval [translation]


DESCRIPTION


   image         the image file to scan, it should be a 32-bit PNG with an
                 alpha channel



   legend        the legend file that contains a list of names and base line
                 colors in this format

                  [("Frame", RGBA 255 0 0 255),("Line",  RGBA 0 0 255 255)]



   tolerance     how much color components can deviate from base colors

                  S            strict: allow no deviation        (= TC 0 0 0 0)

                  TA m         maximum delta for all components  (= TC m m m m)

                  TC r g b a   individiual maximum delta values
                               for corresponding components



   scan-area     which part of the image is to be scanned

                                            (w = image width, h = image height)

                  F            all image area                (= B 0 0 w h)

                  O l t        offset from left and top      (= B l t w h)

                  M l t r b    margins from left, top,       (= B l t w-r h-b)
                               right and bottom

                  B l t r b    a plot box; with left, top, right and bottom
                               positions in pixels



   step-size     horizontal step-size, this value is read as a floating point
                 number

                                                             (w = image width)

                   <s::DOUBLE> double-precision constant step size s

                  /<n::DOUBLE> double-precision step-size gained by dividing
                               the width of the image by n



   [translation]  2d translation to be applied to the output pixels

                  Identity     output pixels exactly as they are located
                               in the input image; old default with full
                               scan area

                  Box Bottom   output pixel positions relevant to the left
                               and bottom lines of the plot box; new default

                  Box Top      output pixel positions relevant to the left
                               and top lines of the plot box


HISTORY

  0.0.7
  - Support for invocation files
  - Support for calculating step sizes by dividing the scan area

  0.0.6.2
  - Fixed help output

  0.0.6
  - Added basic 2D translation support
  - Changed default 2D translation from Identity to "Box Bottom"
    To get old behaviour from previous versions: use Identity

  0.0.5
  - First version created in collaboration with An Le Thi Thanh


KNOWN ISSUES

  - It is only a very early hack ^__^"!!
  - Line occlusion causes matches to fail.
  - Supports only 32-bit PNGs (with an alpha/transparency channel).
  - No automatic recognition whatsoever of figures/plots given
    a full page. Lots of happy moments with Gimp and Inkscape!!


EXAMPLES

  - The example plots provided with this package are from:

      Incorporating Environmental factors in
      Modelling Malaria Transmission in under five
      children in Rural Burkina Faso

      Inaugural Dissertation to attain the degree of
      Doctor Scientiarum humanarum (Dr. Sc. Hum.)

      At the Medical Faculty of Ruprecht-Karls-University
      Heidelberg

      submitted by Yazoume Ye

      from Sayoro, Burkina Faso
      September 2005


  - To create the example outputs:

      explore 39-cisse-x.png 39-legend "TC 100 150 150 150" F 20.83 Identity
      explore 39-goni-x.png  39-legend "TC 100 150 150 150" F 20.83 Identity
      explore 39-nouna-x.png 39-legend "TC 100 150 150 150" F 20.83 Identity


CONTACT

  Cetin Sert, <cetin.sert@gmail.com>

License

Copyright (c) 2009, Cetin Sert

All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:

    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.

    * Redistributions in binary form must reproduce the above
      copyright notice, this list of conditions and the following
      disclaimer in the documentation and/or other materials provided
      with the distribution.

    * The names of contributors may not be used to endorse or promote
      products derived from this software without specific prior
      written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Personal tools