Skip to content
Light field photography application
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs docs(readme): update on readme May 16, 2019
plenopticam Merge branch 'develop' of https://github.com/hahnec/plenopticam into … May 15, 2019
source
.gitignore docs(readme): update on user instructions May 15, 2019
LICENSE.rst initial commit Mar 31, 2019
Manifest.in initial commit Mar 31, 2019
README.rst docs(readme): update on readme May 16, 2019
py2app.sh
py2exe.bat docs(help): insert help button linking to documentation May 14, 2019
setup.py

README.rst

Plenopticam

Description

Plenopticam is an open-source software (macOS or Win) for scientific light field computation with cross-platform compatibility, few dependencies and a lean graphical user interface. Raw exposures from a plenoptic camera require four-dimensional image alignment in order to be decoded as a light field. Provided software addresses this by its ability to extract depth by means of sub-aperture images or synthetically focused photographs. This application is meant for researchers, developers, beginners and other fiddlers who like to experiment with light field technology. It comprises custom-types of plenoptic cameras and is thus not limited to Lytro's image data.

release License Code size Repo size Downloads

Installation

  • executable:
    1. download bundled apps for macOS or Win
    2. extract archive
    3. run app to open up the lean user interface (see below)

  • from source:
    1. install Python from https://www.python.org/
    2. download the source using $ git clone https://github.com/hahnec/plenopticam.git
    3. go to the root directory $ cd plenopticam
    4. install with $ sudo python setup.py install from the root directory
    5. if installation ran smoothly, enter $ sudo plenopticam -g to the command line after which a lean user interface will pop up (see below)

Usage

Note

"Pick folder" checkbox is useful to point to a directory containing calibration archive files of Lytro Illum cameras. In such case, the white image calibration file corresponding to the Illum image is found automatically.


  1. Download a dataset if you don't call a plenoptic camera your own, e.g.:

  1. Choose your light field photograph using upper Browse button. Supported file types are:
    • lfr, lfp and raw files from Lytro Illum
    • bmp, jpg or png file from custom-built plenoptic camera
    • Lytro 1st Generation (to come)

  1. Choose calibration source data using lower Browse button. Supported file types are:
    • tar archive or respective raw file from Lytro Illum
    • bmp, jpg or png file from custom-built plenoptic camera
    • Lytro 1st Generation (to come)

  1. Adjust configuration using Settings button:
    • Micro image patch size: default is estimated maximum
    • Refocusing range: range for shift and sum synthesis
    • Force re-calibration: option to re-run calibration
    • Automatic white balance: option for white balancing
    • Refocus refinement: option for sub-pixel precise refocusing
    • Scheimpflug: option to mimic tilted sensor

  1. Press Process to start the computation.

Results

OpEx dataset INRIA dataset
plenoptic camera built at Univ. of Bedfordshire Lytro Illum camera image from raw capture

Credits

Contributors

Christopher Hahne

Sponsors


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

Citation

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

Further information

  • check out Plenopticam's partner project Plenoptisign capable of estimating metric light field geometries
  • visit plenoptic.info for technical details, animated figures and theoretical background
You can’t perform that action at this time.