{"id":13750977,"url":"https://github.com/SBCV/Blender-Addon-Photogrammetry-Importer","last_synced_at":"2025-05-09T17:33:24.074Z","repository":{"id":37271566,"uuid":"99435028","full_name":"SBCV/Blender-Addon-Photogrammetry-Importer","owner":"SBCV","description":"Addon to import different photogrammetry formats into Blender","archived":false,"fork":false,"pushed_at":"2024-03-19T17:53:18.000Z","size":31427,"stargazers_count":836,"open_issues_count":7,"forks_count":76,"subscribers_count":42,"default_branch":"master","last_synced_at":"2024-03-19T18:59:45.853Z","etag":null,"topics":["agisoft-metashape","blender","blender-addon","colmap","meshroom","mve","open3d","openmvg","opensfm","photogrammetry","sfm","structure-from-motion"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SBCV.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2017-08-05T16:35:11.000Z","updated_at":"2024-04-14T23:51:48.327Z","dependencies_parsed_at":"2024-03-19T19:04:08.206Z","dependency_job_id":null,"html_url":"https://github.com/SBCV/Blender-Addon-Photogrammetry-Importer","commit_stats":{"total_commits":591,"total_committers":14,"mean_commits":"42.214285714285715","dds":"0.42639593908629436","last_synced_commit":"e5899f4759bef99c7c6d9a0ae4cf9a9ba8e2f338"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SBCV%2FBlender-Addon-Photogrammetry-Importer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SBCV%2FBlender-Addon-Photogrammetry-Importer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SBCV%2FBlender-Addon-Photogrammetry-Importer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SBCV%2FBlender-Addon-Photogrammetry-Importer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SBCV","download_url":"https://codeload.github.com/SBCV/Blender-Addon-Photogrammetry-Importer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253295844,"owners_count":21885709,"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":["agisoft-metashape","blender","blender-addon","colmap","meshroom","mve","open3d","openmvg","opensfm","photogrammetry","sfm","structure-from-motion"],"created_at":"2024-08-03T09:00:24.193Z","updated_at":"2025-05-09T17:33:20.654Z","avatar_url":"https://github.com/SBCV.png","language":"Python","funding_links":[],"categories":["🔮Add-ons [^](#table)","Tools, Pipeline \u0026 Utilities"],"sub_categories":["🪀Misc [^](#table)","Photogrammetry \u0026 3D Scanning"],"readme":"# Blender Photogrammetry Importer\nThis repository contains a Blender addon to import results of several reconstruction libraries. In addition it allows to perform novel view synthesis using Neural Radiance Fields (NeRF).\n\n## Compatibility\n\nThe latest release of the addon is currently compatible with **Blender 4.0.2 onwards**. For older Blender versions you might find a suitable release [here](https://github.com/SBCV/Blender-Addon-Photogrammetry-Importer/releases). \n\n## Supported Reconstruction Libraries and Point Cloud Data Formats\n\nSupported photogrammetry libraries (data formats):\n\n- [x] [Agisoft Metashape](https://www.agisoft.com/) (VisualSfM NVM) \u003csup\u003e1\u003c/sup\u003e\n- [x] [Colmap](https://github.com/colmap/colmap) (Model folders (BIN and TXT), dense workspaces, NVM, PLY)  \n- [x] [Meshroom](https://alicevision.github.io/) (MG, JSON, SfM, PLY)\n- [x] [MVE](https://github.com/simonfuhrmann/mve) (Workspaces) \u003csup\u003e1\u003c/sup\u003e\n- [x] [Open3D](http://www.open3d.org/) (JSON, LOG, PLY) \u003csup\u003e1\u003c/sup\u003e\n- [x] [OpenSfM](https://github.com/mapillary/OpenSfM) (JSON)\n- [x] [OpenMVG](https://github.com/openMVG/openMVG) (JSON, NVM, PLY)\n- [x] [Regard3D](https://www.regard3d.org/) (OpenMVG JSON)\n- [x] [VisualSFM](http://ccwu.me/vsfm/) (NVM) \u003csup\u003e1\u003c/sup\u003e\n\nSupported view synthesis libraries (data formats):\n- [x] [Instant NGP](https://github.com/NVlabs/instant-ngp) (JSON)\n\nIn addition, the addon supports some common point cloud data formats:\n\n- [x] [Polygon files](http://paulbourke.net/dataformats/ply/) (PLY) \u003csup\u003e2\u003c/sup\u003e\n- [x] [Point Cloud Library files](https://github.com/PointCloudLibrary/pcl) (PCD) \u003csup\u003e2\u003c/sup\u003e\n- [x] [LASer files](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) (LAS) \u003csup\u003e2,3\u003c/sup\u003e\n- [x] [LASzip files](https://laszip.org/) (LAZ) \u003csup\u003e2,3,4\u003c/sup\u003e\n- [x] [Simple ASCII point files](https://www.cloudcompare.org/doc/wiki/index.php?title=FILE_I/O) (ASC, PTS, CSV) \u003csup\u003e2\u003c/sup\u003e\n\n\u003csup\u003e1\u003c/sup\u003e Requires [Pillow](https://pypi.org/project/Pillow/) to read image sizes from disk.\n\u003csup\u003e2\u003c/sup\u003e Requires [Pyntcloud](https://pypi.org/project/pyntcloud/) for parsing.\n\u003csup\u003e3\u003c/sup\u003e Requires [Laspy](https://pypi.org/project/laspy/) for parsing.\n\u003csup\u003e4\u003c/sup\u003e Requires [Lazrs](https://pypi.org/project/lazrs/) for parsing.\n\n## Getting Started\n- [Documentation](https://blender-photogrammetry-importer.readthedocs.io/en/latest) \n- [Installation Instructions](https://blender-photogrammetry-importer.readthedocs.io/en/latest/installation.html)\n- [Troubleshooting](https://blender-photogrammetry-importer.readthedocs.io/en/latest/troubleshooting.html)\n- [Customize Import/Export Options](https://blender-photogrammetry-importer.readthedocs.io/en/latest/customize.html)\n- [Examples](https://blender-photogrammetry-importer.readthedocs.io/en/latest/examples.html)\n- [Import Data](https://blender-photogrammetry-importer.readthedocs.io/en/latest/import.html)\n- [Export Data](https://blender-photogrammetry-importer.readthedocs.io/en/latest/export.html)\n- [Adjust Results (Scale Cameras and Points)](https://blender-photogrammetry-importer.readthedocs.io/en/latest/adjustment.html)\n- [Ensure Camera and Point Alignment](https://blender-photogrammetry-importer.readthedocs.io/en/latest/alignment.html)\n- [Point Cloud Visualization and Rendering](https://blender-photogrammetry-importer.readthedocs.io/en/latest/point_cloud.html)\n- [Addon Usage with Python](https://blender-photogrammetry-importer.readthedocs.io/en/latest/python.html)\n- [Read and Apply Calibration/Transformation Matrices](https://github.com/SBCV/Blender-Matrix-World-Addon)\n- [Extending the Addon](https://blender-photogrammetry-importer.readthedocs.io/en/latest/extension.html)\n- [Contribution](https://blender-photogrammetry-importer.readthedocs.io/en/latest/contribution.html)\n- [Recent features / Changelog](https://blender-photogrammetry-importer.readthedocs.io/en/latest/changelog.html)\n\n## Paper\nIf you use this library for scientific purposes, please consider to cite the following paper.\n\n\u003ca href=\"https://arxiv.org/pdf/2012.01044.pdf\"\u003e\u003cimg class=\"image\" align=\"left\" width=\"150px\" src=\"https://github.com/SBCV/Blender-Addon-Photogrammetry-Importer/blob/master/doc/images/paper_preview0p15.png\"\u003e\u003c/a\u003e\n\u003ca href=\"https://doi.org/10.5220/0010319801060112\"\u003e[paper]\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u003ca href=\"https://arxiv.org/abs/2012.01044\"\u003e[arxiv]\u003c/a\u003e\u003cbr\u003e\n```bibtex\n@article{PhotogrammetryForModeling2021,\ntitle={A Photogrammetry-based Framework to Facilitate Image-based Modeling and Automatic Camera Tracking},\nauthor={Bullinger, Sebastian and Bodensteiner, Christoph and Arens, Michael},\nbooktitle={International Conference on Computer Graphics Theory and Applications},\nyear={2021}\n}\n```\n\u003cbr clear=\"left\"/\u003e\n\n## View Synthesis Examples\nThis addon allows to peform novel view synthesis for arbitrary cameras using NeRF (e.g. [Instant NGP](https://github.com/NVlabs/instant-ngp)). The left image shows a plain NeRF result and the right image an overlay with the corresponding point cloud.\n\u003cp float=\"left\" align=\"middle\"\u003e\n  \u003cimg src=\"doc/images/view_synthesis_nerf.jpg\" width=\"48%\" /\u003e\n  \u003cimg src=\"doc/images/view_synthesis_nerf_point_cloud.jpg\" width=\"48%\" /\u003e \n\u003c/p\u003e\n\n## Reconstruction Examples\nThis repository contains an example Colmap model. The following image shows the imported camera poses, image planes and point cloud in Blender's 3D view.\n![alt text](doc/images/import_result.jpg)\nThe input images of the Colmap model are located here: [https://github.com/openMVG/ImageDataset_SceauxCastle](https://github.com/openMVG/ImageDataset_SceauxCastle).\n\nThe addon computes an animated camera with corresponding background images from the reconstructed camera poses.\n![alt text](doc/images/camera_animation_background.gif)\n\nThere is also an import option that allows to interpolate the reconstructed camera poses.\n![alt text](doc/images/camera_animation.gif)\n\nIn addition, the addon allows to import meshes contained in the workspaces of specific libraries. Manually imported meshes can also be aligned with the corresponding reconstruction by following the instructions [here](https://blender-addon-photogrammetry-importer.readthedocs.io/en/latest/import.html#meshes). \n![alt text](doc/images/mesh_3d_view.jpg)\n\nThe addon offers two options to represent the point clouds (OpenGL and Geometry Nodes). The addon provides different panels to adjust the appearance and to render these point clouds - see [Point Cloud Visualization and Rendering](https://blender-addon-photogrammetry-importer.readthedocs.io/en/latest/point_cloud.html). The following images show an example represented with OpenGL (top) and Geometry Nodes (bottom). \n\n![alt text](doc/images/import_result_opengl.jpg)\n![alt text](doc/images/import_result_geometry_nodes.jpg)\n\nIn addition, the addon allows to visualize depth maps (reconstructed with Colmap or MVE) as point clouds.\n\u003cp float=\"left\" align=\"middle\"\u003e\n  \u003cimg src=\"doc/images/depth_map_3d_view.jpg\" width=\"48%\" /\u003e\n  \u003cimg src=\"doc/images/depth_map_from_camera.jpg\" width=\"48%\" /\u003e \n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSBCV%2FBlender-Addon-Photogrammetry-Importer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSBCV%2FBlender-Addon-Photogrammetry-Importer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSBCV%2FBlender-Addon-Photogrammetry-Importer/lists"}