hahnec/plenoptisign

Light field geometry estimator for plenoptic cameras

PlenoptiSign

Description

PlenoptiSign is an open-source app for geometry estimation of a light field captured by a Standard Plenoptic Camera (SPC). This software treats a pair of light field rays as a system of linear functions whose solution yields ray intersections indicating distances to refocused object planes or virtual camera positions of perspective views (so-called sub-aperture images).

GUI-based executable

• Installation:

  1. download as an app (macOS, Windows and Linux)
  2. extract the archive to obtain the executable

• Usage:

  run extracted app (macOS, Windows and Linux)

Note

Insightful description of the parameter terminology and experimental validation can be found in the author's publications:

• Refocusing distance of a standard plenoptic camera, Hahne et al., OpticsExpress, [BibTeX]
• Baseline and triangulation geometry in a standard plenoptic camera, Hahne et al., Int. J. of Comp. Vis., [BibTeX]
• PlenoptiSign paper, Hahne and Aggoun, SoftwareX, Volume 10, 2019

If you find this work helpful for your research, please cite as appropriate.

Command-line interface

• Installation:

  For ease of use, you can install with pip:

  • $ pip install plenoptisign

  Alternatively, installation is possible from source via:

  1. download the source using $ git clone https://github.com/hahnec/plenoptisign.git
  2. go to the root directory $ cd plenoptisign
  3. install with $ python setup.py install from the root directory

• Usage:

  Run $ plenoptisign from the command line with optional arguments:

  • -g, --gui: open graphical user interface
  • -p, --plot: plot paraxial rays
  • -r, --refo: refocusing results only
  • -t, --tria: triangulation results only
  • -h, --help: print help message

  Unit testing is done with $ python plenoptisign/tests/plenoptisign_unittest.py -v

CGI server

• Installation:

  1. download the source
  2. place extracted plenoptisign-master folder on the ftp next to your *.html that you want to embed it in
  3. rename plenoptisign-master to plenoptisign

  4. include cgi.html into your *.html with includeCGI as the id of the desired div container

     <script>
         $(function(){
             $("#includeCGI").load("plenoptisign/plenoptisign/bin/cgi.html");
         });
     </script>
     .
     .
     .
     <div id="includeCGI"></div>

  5. give sufficient permission (chmod 750) to the file plenoptisign/plenoptisign/bin/cgi_script.py

• Usage:

  website demo: http://www.plenoptic.info/pages/software.html

Tested on macOS 10.14.2 and Windows 10 w/ Python 2.7 & Python 3.6

Credits

Citation

@article{Hahne_2019,
   title={PlenoptiSign: An optical design tool for plenoptic imaging},
   volume={10},
   ISSN={2352-7110},
   url={http://dx.doi.org/10.1016/j.softx.2019.100259},
   DOI={10.1016/j.softx.2019.100259},
   journal={SoftwareX},
   publisher={Elsevier BV},
   author={Hahne, Christopher and Aggoun, Amar},
   year={2019},
   month={Jul},
   pages={100259}
}

Contributors

Christopher Hahne

Sponsors

• Grant EU-FP7 ICT-2010-248420
• Institute for Research in Applicable Computing (IRAC)

Further information

• check out PlenoptiSign's partner project PlenoptiCam capable of rendering light field images from scratch.
• visit plenoptic.info for technical details, animated figures and theoretical background