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).
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.
- Installation:
For ease of use, you can install with pip:
$ pip install plenoptisign
Alternatively, installation is possible from source via:
- download the source using
$ git clone https://github.com/hahnec/plenoptisign.git
- go to the root directory
$ cd plenoptisign
- 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
- Installation:
download the source
place extracted
plenoptisign-master
folder on the ftp next to your*.html
that you want to embed it inrename
plenoptisign-master
toplenoptisign
include
cgi.html
into your*.html
withincludeCGI
as theid
of the desireddiv
container<script> $(function(){ $("#includeCGI").load("plenoptisign/plenoptisign/bin/cgi.html"); }); </script> . . . <div id="includeCGI"></div>
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
@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}
}
- 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