{"id":19380761,"url":"https://github.com/helleb0re/structured-light-python","last_synced_at":"2025-04-23T19:33:52.034Z","repository":{"id":41078804,"uuid":"508231687","full_name":"helleb0re/structured-light-python","owner":"helleb0re","description":null,"archived":true,"fork":false,"pushed_at":"2023-10-30T08:15:00.000Z","size":106,"stargazers_count":18,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-22T03:41:28.066Z","etag":null,"topics":["baumer","opencv","optics","physics","python","structured-light","structured-light-for-3d-scanning"],"latest_commit_sha":null,"homepage":"","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/helleb0re.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2022-06-28T09:16:48.000Z","updated_at":"2025-03-15T11:23:24.000Z","dependencies_parsed_at":"2023-10-11T16:10:58.556Z","dependency_job_id":"7d9eb6ff-696c-485c-a72d-0d60696c01ad","html_url":"https://github.com/helleb0re/structured-light-python","commit_stats":{"total_commits":88,"total_committers":2,"mean_commits":44.0,"dds":0.2727272727272727,"last_synced_commit":"5845910109116a146528dbb4e883e654077266ea"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helleb0re%2Fstructured-light-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helleb0re%2Fstructured-light-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helleb0re%2Fstructured-light-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helleb0re%2Fstructured-light-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helleb0re","download_url":"https://codeload.github.com/helleb0re/structured-light-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250499942,"owners_count":21440719,"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":["baumer","opencv","optics","physics","python","structured-light","structured-light-for-3d-scanning"],"created_at":"2024-11-10T09:14:44.252Z","updated_at":"2025-04-23T19:33:51.754Z","avatar_url":"https://github.com/helleb0re.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Structured light project**\n\nThis project is an attempt to create an easy-to-understand and flexible-to-use framework for implementing the Fringe Projection Profilometry (FPP) method in the Python.\n\n## **Implementation**\n\n* Ability to use any camera (modules with webcams through OpenCV and Baumer cameras through NeoAPI are implemented in the project)\n* The Phaseshift Projection Profilometry (PSP) method with sinusoidal fringes is implemented to obtain phase fields\n* Projection pattern generation supports an arbitrary number of phase shifts and an arbitrary number of periods \n* A hierarchical approach is used to unwrap the phase fields\n* Implemented automatic detection of the fringe projection area on the images (ROI)\n* A simple gamma correction method for projected images is implemented\n* Flexible adjustment of the experiment and hardware parameters with the help of config files\n\n## **How to use**\n\n1. Install depedicies\n```\npip install opencv-contrib-python numpy scipy matplotlib\n```\n2. Setting the parameters of the experiment and the hardware in the file `config.py`\n\n3. Launch main module\n```\npython main.py\n```\n\nIn the script `examples/test_plate_phasogrammetry.py` there is an example of processing the results of the experiment to determine the shape of the surface of a granite slab using the phasogrammetric approach. To date, the measurement accuracy of about **60 µm** has been achieved.\n\n## **References**\nThe following sources were used to implement the algorithms\n\n[Zuo C. et al. Phase shifting algorithms for fringe projection profilometry: A review // Optics and Lasers in Engineering. 2018. Vol. 109. P. 23-59.](https://doi.org/10.1016/j.optlaseng.2018.04.019)\n\n[Zuo C. et al. Temporal phase unwrapping algorithms for fringe projectionprofilometry: A comparative review // Optics and Lasers in Engineering. 2016. Vol. 85. P. 84-103.](https://doi.org/10.1016/j.optlaseng.2016.04.022)\n\n[Feng S. et al. Calibration of fringe projection profilometry: A comparative review // Optics and Lasers in Engineering. 2021. Vol. 143. P. 106622.](https://doi.org/10.1016/j.optlaseng.2021.106622)\n\n[Zhong K. et al. Pre-calibration-free 3D shape measurement method based on fringe projection // Optics Express. 2016. Vol. 24. №. 13. P. 14196-14207.](https://doi.org/10.1364/OE.24.014196)\n\n## **Authors**\nAnton Poroykov, Ph.D., associated professor \n\nNikita Sivov, graduate student \n\n## **Acknowledgements**\nThe research was carried out at the expense of the grant Russian Science Foundation No. 22-21-00550 (https://rscf.ru/project/22-21-00550/).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelleb0re%2Fstructured-light-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelleb0re%2Fstructured-light-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelleb0re%2Fstructured-light-python/lists"}