Skip to content

hahnec/plenoptisign

Repository files navigation

logo 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).

release License Downloads PyPI Downloads

arXiv link zenodo link

GUI-based executable

gui

Note

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

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

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