DECA-346: Update the README for the Decapod 0.7 release

Description

Comments

• Jonathan Hung commented 2012-11-30T18:40:40.433-0500

  Decapod 0.7
  ============

  Main Project Site: http://sites.google.com/site/decapodproject/
  Documentation: http://wiki.fluidproject.org/display/fluid/Decapod+0.7+Release
  Source Code: http://wiki.fluidproject.org/display/fluid/Decapod+Source+Code

  Highlights of the 0.7 Release
  ==============================

  Decapod 0.7 adds the following features and enhancements:

  • Ability to capture using cameras connected via USB
  • Create stereo 3D calibration data and dewarp stereo images based on that calibration data
  • Ubuntu 12.04 64-bit (32-bit no longer supported)
  • Fully internationalizable UI strings
  • In-application Help documentation

  Installing Decapod 0.7

  ======================

  For full installation and configuration instructions, visit:
  http://wiki.fluidproject.org/display/fluid/Download+and+Install+Decapod+0.7

  Tested Platform
  ===============

  Decapod 0.7 is tested and supported in the following configurations:

  • Operating System: Ubuntu 12.04 64-bit
  • Web Browser: Firefox 17

  
  Other configurations may work, but haven't been tested. The Decapod community welcomes
  contributions, including testing various combinations of operating systems and browsers.

  What's in this Release?
  =======================

  In General:

  • Image formats supported in this release are: JPEG, TIFF, and PNG.

  Calibrate UI & Server:

  The calibrate interface allows users to upload a zip file with all the calibration images
  into decapod calibrate server. The server generates the calibration data that can be exported
  as a zip file.

  • Uploading images:
    • The zip file for calibration images must contain no less than 23 stereo images.
    • The maximum image file size is unlimited, but configurable to any custom file size.

  Capture UI & Server:

  The capture interface allows users to control cameras to take pictures for calibration,
  dewarping or other purposes. The pictures can be exported as a zip file.

  • Capturing images:
    • The list of supported cameras: http://gphoto.org/proj/libgphoto2/support.php
    • No more than 2 cameras can be connected to the computer.
    • If any connected camera is disconnected, the capture server needs to be restarted to
      work with cameras that are still connected or re-connected.

  Dewarp UI & Server:

  • Steps to use:
    • Upload the zip file that contains all the images to be dewarped.
    • Upload the calibration zip file exported from the "Calibrate UI & Server".
    • Launch the color picker to pick the colors of the page separator string and background.
    • Start dewarping.
    • Export the dewarped images as a zip file.

  Export UI & Server:

  • Interface:
    • A simple import interface for uploading images to Decapod.
    • Status messages indicating how many files are queued and how many have errors are provided.
    • Four PDF, and two image export formats to select from.
  • Importing images:
    • Image formats supported in this release are: JPEG, TIFF, and PNG.
    • Default maximum image file size is 100MB, but configurable to any custom file size.
  • Exporting:
    • Export the collection of images as a greyscale PDF. Four PDF formats include:
      1. Image PDF.
      2. A PDF with electable OCR'd text underlaid.
      3. A PDF with contents traced by computer.
      4. A PDF with matched TrueType font.
  • python-matplotlib: http://matplotlib.sourceforge.net/ (PSF License)
  • python-nose: http://readthedocs.org/docs/nose/en/latest/ (LGPL License)
  • python-numpy: http://numpy.scipy.org/ (BSD License)
  • python-reportlab: http://www.reportlab.com/ (BSD License)
  • python-scipy: http://www.scipy.org/SciPy (BSD License)
  • python-scipy-dbg: http://www.scipy.org/SciPy (BSD License)
  • python-simplejson: http://simplejson.readthedocs.org/en/latest/ (MIT License)
  • Qunit: http://qunitjs.com/ (MIT License)
  • scons: http://www.scons.org/ (MIT License)
  • gphoto2: http://gphoto.org/ (GPL License)
  • cmake: http://www.cmake.org/cmake/project/project.html (CMake License)
  • git: http://git-scm.com/ (GNU General Public License)
  • python-wxgtk2.8: http://packages.ubuntu.com/search?keywords=python-wxgtk2.8 (Ubuntu License)
  • OpenCV: http://opencv.org/ (BSD license)
  • pyflann: https://github.com/mariusmuja/flann (BSD license)
  • vlfeat: http://www.vlfeat.org/ (BSD license)

  See: http://wiki.fluidproject.org/display/fluid/Decapod+Dependencies

  *Note: GPL licensed code is not used directly, but only interfaced through calls to the shell*

  Known Issues
  ============

  Bugs and other known issues in Decapod 0.7 are documented in the Release Page:

  http://wiki.fluidproject.org/display/fluid/Decapod+0.7+Release

  Decapod is actively being developed and improved. We welcome your feedback, bug reports, and
  feature requests. Decapod uses JIRA to track bugs and issues: http://issues.fluidproject.org/browse/DECA