{"id":20507433,"url":"https://github.com/hahnec/depthy","last_synced_at":"2025-04-13T22:08:23.482Z","repository":{"id":107359144,"uuid":"289979230","full_name":"hahnec/depthy","owner":"hahnec","description":"depth map computation","archived":false,"fork":false,"pushed_at":"2023-01-05T20:29:39.000Z","size":4163,"stargazers_count":41,"open_issues_count":2,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-13T22:08:17.752Z","etag":null,"topics":["block-matching","depth","disparity","epi","epipolar","image","images","light-field","light-fields","lightfield","lightfields","map","semi-global-matching","sgbm","sgm","stereo","structure","tensor"],"latest_commit_sha":null,"homepage":"https://hahnec.github.io/depthy/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"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":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-24T16:22:40.000Z","updated_at":"2025-03-09T14:47:30.000Z","dependencies_parsed_at":"2023-03-13T14:36:49.235Z","dependency_job_id":null,"html_url":"https://github.com/hahnec/depthy","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%2Fdepthy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fdepthy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fdepthy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahnec%2Fdepthy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hahnec","download_url":"https://codeload.github.com/hahnec/depthy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248788924,"owners_count":21161727,"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":["block-matching","depth","disparity","epi","epipolar","image","images","light-field","light-fields","lightfield","lightfields","map","semi-global-matching","sgbm","sgm","stereo","structure","tensor"],"created_at":"2024-11-15T20:14:03.603Z","updated_at":"2025-04-13T22:08:23.469Z","avatar_url":"https://github.com/hahnec.png","language":"Python","readme":"======\ndepthy\n======\n\nDescription\n-----------\n\n*depthy* enables depth map generation from light-fields and stereo image pairs.\n\n|release| |license| |build_github| |coverage| |pypi_total| |pypi|\n\nLight-field Results\n-------------------\n\n|vspace|\n\n.. list-table::\n   :widths: 8 8 8 8\n   :header-rows: 0\n   :stub-columns: 1\n\n   * - Central view\n     - |photo_ref_1|\n     - |photo_ref_2|\n     - |photo_ref_3|\n   * - Depth map\n     - |depth_map_1|\n     - |depth_map_2|\n     - |depth_map_3|\n\nsource: `HCI data \u003chttps://lightfield-analysis.uni-konstanz.de/\u003e`__\n\n|\n\nStereo Results\n--------------\n\n|vspace|\n\n.. list-table::\n   :widths: 8 8 8 8\n   :header-rows: 1\n   :stub-columns: 0\n\n   * - Left Image\n     - Ground Truth\n     - Depthy (SGM)\n     - OpenCV\n   * - |photo_left_1|\n     - |depth_gtd_1|\n     - |depth_sgm_1|\n     - |depth_ocv_1|\n\nsource: `Middlebury data \u003chttps://vision.middlebury.edu/stereo/data/\u003e`__\n\n|\n\nInstallation\n------------\n\n* via pip:\n    1. install with ``pip3 install depthy``\n    2. type ``depthy -h`` to the command line once installation finished\n\n* from source:\n    1. install Python from https://www.python.org/\n    2. download the source_ using ``git clone https://github.com/hahnec/depthy.git``\n    3. go to the root directory ``cd depthy``\n    4. load dependencies ``$ pip3 install -r requirements.txt``\n    5. install with ``python3 setup.py install``\n    6. if installation ran smoothly, enter ``depthy -h`` to the command line\n\nCommand Line Usage\n------------------\n\nFrom the root directory of your downloaded repo, you can run the tool on the provided test data by\n\n``depthy -s './examples/data/pens/'``\n\non a UNIX system where the result is found at ``./examples/data/``. A windows equivalent of the above command is\n\n``depthy --src=\".\\\\examples\\\\data\\\\pens\\\\\"``\n\nTo infer light-field depth, you can specify the method or select your image folder manually with\n\n``depthy --win --method='epi'``\n\nFor stereo depth, you would use\n\n``depthy --win --method='stereo'``\n\nMore information on optional arguments, can be found using the help parameter\n\n``depthy -h``\n\nAPI Usage\n---------\n\nA documentation of the key functions is found at `https://hahnec.github.io/depthy/ \u003chttps://hahnec.github.io/depthy/\u003e`__.\nA reference integration using depthy's API can be found in `PlenoptiCam \u003chttps://github.com/hahnec/plenopticam/blob/master/plenopticam/lfp_extractor/lfp_depth.py\u003e`__.\n\nAuthor\n------\n\n`Christopher Hahne \u003chttp://www.christopherhahne.de/\u003e`__\n\nCitation\n--------\n\n.. code-block:: BibTeX\n\n    @misc{depthy,\n        title={Depthy},\n        author={Christopher Hahne},\n        year={2021},\n        publisher = {GitHub},\n        journal = {GitHub repository},\n        howpublished = {\\url{https://github.com/hahnec/depthy}}\n    }\n\n.. Hyperlink aliases\n\n.. _source: https://github.com/hahnec/depthy/archive/master.zip\n\n.. |photo_ref_1| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/pens_040.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |photo_ref_2| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/herbs_040.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |photo_ref_3| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/boxes_040.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |depth_map_1| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/pens.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |depth_map_2| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/herbs.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |depth_map_3| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/boxes.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |photo_left_1| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/im6.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |depth_gtd_1| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/disp6.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |depth_sgm_1| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/cones_sgm_l.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n.. |depth_ocv_1| raw:: html\n\n    \u003cimg src=\"https://raw.githubusercontent.com/hahnec/depthy/master/docs/img/cones_ocv_l.png\" width=\"200px\" max-width:\"100%\"\u003e\n\n\n.. |vspace| raw:: latex\n\n   \\vspace{1mm}\n\n.. Image substitutions\n\n.. |release| image:: https://img.shields.io/github/v/release/hahnec/depthy?style=square\n    :target: https://github.com/hahnec/depthy/releases/\n    :alt: Release\n\n.. |license| image:: https://img.shields.io/badge/License-GPL%20v3.0-orange.svg?style=square\n    :target: https://www.gnu.org/licenses/gpl-3.0.en.html\n    :alt: License\n\n.. |build_github| image:: https://img.shields.io/github/actions/workflow/status/hahnec/depthy/gh_actions.yml?master\u0026style=square\n    :target: https://github.com/hahnec/depthy/actions\n    :alt: GitHub Workflow Status\n\n.. |build_travis| image:: https://img.shields.io/travis/com/hahnec/depthy?style=square\n    :target: https://travis-ci.com/github/hahnec/depthy\n    :alt: Travis CI Status\n\n.. |coverage| image:: https://img.shields.io/coveralls/github/hahnec/depthy?style=square\n    :target: https://coveralls.io/github/hahnec/depthy\n    :alt: Coveralls Status\n\n.. |pypi| image:: https://img.shields.io/pypi/dm/depthy?label=PyPI%20downloads\u0026style=square\n    :target: https://pypi.org/project/depthy/\n    :alt: PyPI Downloads\n\n.. |pypi_total| image:: https://pepy.tech/badge/depthy?style=flat-square\n    :target: https://pepy.tech/project/depthy\n    :alt: PyPi Dl2","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhahnec%2Fdepthy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhahnec%2Fdepthy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhahnec%2Fdepthy/lists"}