{"id":20507407,"url":"https://github.com/hahnec/plenoptisign","last_synced_at":"2025-10-06T13:04:32.719Z","repository":{"id":57453432,"uuid":"126895033","full_name":"hahnec/plenoptisign","owner":"hahnec","description":"Light field geometry estimator for plenoptic cameras","archived":false,"fork":false,"pushed_at":"2025-03-11T13:49:04.000Z","size":12769,"stargazers_count":40,"open_issues_count":0,"forks_count":13,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-13T21:52:47.252Z","etag":null,"topics":["baseline","field","geometry","lens","lens-design","light","lightfield","micro","microlensing","mla","plenoptic","ray-tracing","raytracer","refocusing","stereo","sub-aperture"],"latest_commit_sha":null,"homepage":"http://www.plenoptic.info","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hahnec.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.rst","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/CHahne"]}},"created_at":"2018-03-26T22:00:03.000Z","updated_at":"2025-03-11T13:49:07.000Z","dependencies_parsed_at":"2022-08-29T08:41:35.122Z","dependency_job_id":null,"html_url":"https://github.com/hahnec/plenoptisign","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fplenoptisign","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fplenoptisign/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fplenoptisign/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fplenoptisign/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hahnec","download_url":"https://codeload.github.com/hahnec/plenoptisign/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248788867,"owners_count":21161726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["baseline","field","geometry","lens","lens-design","light","lightfield","micro","microlensing","mla","plenoptic","ray-tracing","raytracer","refocusing","stereo","sub-aperture"],"created_at":"2024-11-15T20:13:56.565Z","updated_at":"2025-10-06T13:04:27.669Z","avatar_url":"https://github.com/hahnec.png","language":"Python","funding_links":["https://paypal.me/CHahne"],"categories":[],"sub_categories":[],"readme":"===================\n|logo| PlenoptiSign\n===================\n\nDescription\n-----------\n\n*PlenoptiSign* is an open-source app_ for geometry estimation of a light field captured by a Standard Plenoptic Camera (SPC).\nThis 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).\n\n|release| |license| |downloads| |pypi|\n\n|paper| |zenodo|\n\n\nGUI-based executable\n====================\n\n* **Installation**:\n    1. download as an app_ (macOS_, Windows_ and Linux_)\n    2. extract the archive to obtain the executable\n\n* **Usage**:\n    run extracted app_ (macOS_, Windows_ and Linux_)\n\n|gui|\n\n.. note::\n    Insightful description of the parameter terminology and experimental validation can be found in the author's publications:\n\n    * `Refocusing distance of a standard plenoptic camera`_, Hahne et al., *OpticsExpress*, `[BibTeX] \u003chttp://www.plenoptic.info/bibtex/HAHNE-OPEX.2016.bib\u003e`__\n\n    * `Baseline and triangulation geometry in a standard plenoptic camera`_, Hahne et al., *Int. J. of Comp. Vis.*, `[BibTeX] \u003chttp://plenoptic.info/bibtex/HAHNE-IJCV.2017.bib\u003e`__\n\n    * `PlenoptiSign paper`_, Hahne and Aggoun, *SoftwareX*, Volume 10, 2019\n\n    If you find this work helpful for your research, please cite as appropriate.\n\n\nCommand-line interface\n======================\n\n* **Installation**:\n    For ease of use, you can install with pip:\n\n    * ``$ pip install plenoptisign``\n\n    Alternatively, installation is possible from source via:\n\n    1. download the source_ using ``$ git clone https://github.com/hahnec/plenoptisign.git``\n    2. go to the root directory ``$ cd plenoptisign``\n    3. install with ``$ python setup.py install`` from the root directory\n\n\n* **Usage**:\n    Run ``$ plenoptisign`` from the command line with optional arguments:\n\n    * -g, --gui: open graphical user interface\n    * -p, --plot: plot paraxial rays\n    * -r, --refo: refocusing results only\n    * -t, --tria: triangulation results only\n    * -h, --help: print help message\n\n\n    Unit testing is done with ``$ python plenoptisign/tests/plenoptisign_unittest.py -v``\n\nCGI server\n==========\n\n* **Installation**:\n    1. download the source_\n    2. place extracted ``plenoptisign-master`` folder on the ftp next to your ``*.html`` that you want to embed it in\n    3. rename ``plenoptisign-master`` to ``plenoptisign``\n    4. include ``cgi.html`` into your ``*.html`` with ``includeCGI`` as the ``id`` of the desired ``div`` container\n\n        .. code-block:: html\n\n            \u003cscript\u003e\n                $(function(){\n                    $(\"#includeCGI\").load(\"plenoptisign/plenoptisign/bin/cgi.html\");\n                });\n            \u003c/script\u003e\n            .\n            .\n            .\n            \u003cdiv id=\"includeCGI\"\u003e\u003c/div\u003e\n\n\n    5. give sufficient permission (chmod 750) to the file ``plenoptisign/plenoptisign/bin/cgi_script.py``\n\n* **Usage**:\n\n    website demo: http://www.plenoptic.info/pages/software.html\n\nTested on macOS 10.14.2 and Windows 10 w/ Python 2.7 \u0026 Python 3.6\n\nCredits\n-------\n\nCitation\n========\n\n.. code-block:: BibTeX\n\n    @article{Hahne_2019,\n       title={PlenoptiSign: An optical design tool for plenoptic imaging},\n       volume={10},\n       ISSN={2352-7110},\n       url={http://dx.doi.org/10.1016/j.softx.2019.100259},\n       DOI={10.1016/j.softx.2019.100259},\n       journal={SoftwareX},\n       publisher={Elsevier BV},\n       author={Hahne, Christopher and Aggoun, Amar},\n       year={2019},\n       month={Jul},\n       pages={100259}\n    }\n\nContributors\n============\n\n`Christopher Hahne \u003chttp://www.christopherhahne.de/\u003e`__\n\nSponsors\n========\n\n   * `Grant EU-FP7 ICT-2010-248420 \u003chttps://cordis.europa.eu/project/rcn/94148_en.html\u003e`__\n   * `Institute for Research in Applicable Computing (IRAC) \u003chttps://www.beds.ac.uk/research-ref/irac/about\u003e`__\n\nFurther information\n-------------------\n\n* check out PlenoptiSign's partner project PlenoptiCam_ capable of rendering light field images from scratch.\n* visit `plenoptic.info \u003chttp://www.plenoptic.info\u003e`__ for technical details, animated figures and theoretical background\n\n.. Image substitutions\n\n.. |release| image:: https://img.shields.io/github/release/hahnec/plenoptisign.svg?style=flat-square\n    :target: https://github.com/hahnec/plenoptisign/releases\n    :alt: release\n\n.. |license| image:: https://img.shields.io/badge/License-GPL%20v3.0-orange.svg?style=flat-square\n    :target: https://www.gnu.org/licenses/gpl-3.0.en.html\n    :alt: License\n\n.. |code| image:: https://img.shields.io/github/languages/code-size/hahnec/plenoptisign.svg?style=flat-square\n    :target: https://github.com/hahnec/plenoptisign/archive/v1.1.3.zip\n    :alt: Code size\n\n.. |repo| image:: https://img.shields.io/github/repo-size/hahnec/plenoptisign.svg?style=flat-square\n    :target: https://github.com/hahnec/plenoptisign/archive/v1.1.3.zip\n    :alt: Repo size\n\n.. |downloads| image:: https://img.shields.io/github/downloads/hahnec/plenoptisign/total.svg?label=Release%20downloads\u0026style=flat-square\n    :target: https://github.com/hahnec/plenoptisign/archive/v1.1.3.zip\n    :alt: Downloads\n\n.. |pypi_total| image:: https://pepy.tech/badge/plenoptisign?label=PyPI%20total\u0026style=flat-square\n    :target: https://pepy.tech/project/plenoptisign\n    :alt: PyPi Dl2\n\n.. |pypi| image:: https://img.shields.io/pypi/dm/plenoptisign?label=PyPI%20downloads\u0026style=flat-square\n    :target: https://pypi.org/project/plenoptisign/\n    :alt: PyPI Downloads\n\n.. |zenodo| image:: https://zenodo.org/badge/126895033.svg?style=flat-square\n    :target: https://zenodo.org/badge/latestdoi/126895033\n    :alt: zenodo link\n\n.. |paper| image:: http://img.shields.io/badge/paper-arxiv.2006.01015-red.svg?style=flat-square\n    :target: https://arxiv.org/pdf/2006.01015.pdf\n    :alt: arXiv link\n\n.. |logo| image:: https://raw.githubusercontent.com/hahnec/plenoptisign/master/plenoptisign/gui/misc/circlecompass_1055093_24x24.png\n\n.. |gui| image:: https://raw.githubusercontent.com/hahnec/plenoptisign/develop/docs/img/screenshot_2d_refo.png\n\n.. |UoB| raw:: html\n\n    \u003cimg src=\"https://3tkh0x1zl0mb1ta92c2mrvv2-wpengine.netdna-ssl.com/wp-content/uploads/2015/12/LO_KukriGB_Universities_Bedfordshire.png\" width=\"70px\"\u003e\n\n.. |EUFramework| raw:: html\n\n    \u003cimg src=\"http://www.gsa.europa.eu/sites/default/files/Seventh_Framework_Programme_logo.png\" width=\"100px\"\u003e\n\n.. |Hahne| raw:: html\n\n    \u003cimg src=\"http://www.christopherhahne.de/images/about_alt.jpg\" width=\"100px\"\u003e\n\n.. Hyperlink aliases\n\n.. _source: https://github.com/hahnec/plenoptisign/archive/master.zip\n.. _app: https://github.com/hahnec/plenoptisign/releases/\n.. _macOS: https://github.com/hahnec/plenoptisign/releases/download/v1.1.3/plenoptisign_1.1.3_macOS.zip\n.. _Windows: https://github.com/hahnec/plenoptisign/releases/download/v1.1.3/plenoptisign_1.1.3_win.zip\n.. _Linux: https://github.com/hahnec/plenoptisign/releases/download/v1.1.3/plenoptisign_1.1.3_linux.zip\n.. _PlenoptiCam: https://github.com/hahnec/plenopticam/\n.. _CGI demo: http://www.plenoptic.info/pages/software.html\n\n.. _Optics, Eugene Hecht:  https://www.pearson.com/us/higher-education/program/Hecht-Optics-5th-Edition/PGM45350.html\n.. _Refocusing distance of a standard plenoptic camera: https://doi.org/10.1364/OE.24.021521\n.. _Baseline and triangulation geometry in a standard plenoptic camera: http://www.plenoptic.info/files/IJCV_Hahne17_final.pdf\n.. _PlenoptiSign paper: https://doi.org/10.1016/j.softx.2019.100259","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhahnec%2Fplenoptisign","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhahnec%2Fplenoptisign","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhahnec%2Fplenoptisign/lists"}