Installing Decapod Stereo Dewarping Notes

Dewarp

Download the dewarp code here: https://bitbucket.org/mkraemer/decapod-dewarping

Installation Notes

DECAPOD STEREO DEWARPING
========================

required
------------------
- numpy
- scipy
- python-matplotlib
- git (to download pyflann from source)
- opencv
- pyflann
- build-essential

git

  • Required for downloading pyflann from source.

numpy

  • Note numpy should be installed prior to pyVLFeat
  • Install sudo apt-get install python-numpy
  • Version assuming v1.6.2?

scipy

  • Install sudo apt-get install python-scipy
  • Version assuming 0.11.0rc2?

python-setuptools

  • Note Python Setuptools is required to install pyflann from source.
  • Install sudo apt-get install python-setuptools
  • Version ?

opencv

pyflann

vlfeat

example usage - calibration
---------------------------
./calibrate.py calibration-images 9 6 calibration-data

This uses the chessboard images in directory calibration-images. Each
chessboard has 9x6 inner corners. The resulting camera matrices are
persisted into directory calibration-data.

example usage - dewarping
-------------------------
./dewarp.py calibration-data left.jpg right.jpg dewarped.png

This uses the calibration matrices from directory calibration-data to
perform stereo dewarping of the image pair given by left.jpg and right.jpg.
The dewarped output is then persisted to dewarped.png

Calibration notes

  • 6 minutes to run calibration on 2 cores, 2 GB VM.
  • 6 minutes to run calibration on 4 cores, 2 GB VM.