{"id":16320250,"url":"https://github.com/meyerls/colmap-wrapper","last_synced_at":"2025-10-25T02:13:45.339Z","repository":{"id":59395428,"uuid":"505856998","full_name":"meyerls/colmap-wrapper","owner":"meyerls","description":"Easily visualize, registrate and work with COLMAP reconstructions. ","archived":false,"fork":false,"pushed_at":"2025-06-11T21:03:05.000Z","size":5910,"stargazers_count":19,"open_issues_count":1,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-08-24T17:33:19.956Z","etag":null,"topics":["colmap","gps","python","registration","rtk-registration","visualization","wrapper"],"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/meyerls.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-06-21T13:32:51.000Z","updated_at":"2025-06-11T20:42:18.000Z","dependencies_parsed_at":"2024-10-28T09:07:38.906Z","dependency_job_id":"8df48955-d891-44de-97bb-fe2265941a15","html_url":"https://github.com/meyerls/colmap-wrapper","commit_stats":{"total_commits":83,"total_committers":5,"mean_commits":16.6,"dds":0.2530120481927711,"last_synced_commit":"64a293c21990606acbe02f84d7c77a653bc6a02c"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/meyerls/colmap-wrapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meyerls%2Fcolmap-wrapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meyerls%2Fcolmap-wrapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meyerls%2Fcolmap-wrapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meyerls%2Fcolmap-wrapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meyerls","download_url":"https://codeload.github.com/meyerls/colmap-wrapper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meyerls%2Fcolmap-wrapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273288051,"owners_count":25078641,"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","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["colmap","gps","python","registration","rtk-registration","visualization","wrapper"],"created_at":"2024-10-10T22:43:41.150Z","updated_at":"2025-10-25T02:13:45.254Z","avatar_url":"https://github.com/meyerls.png","language":"Python","readme":"# COLMAP Wrapper\n\n\u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/colmap-wrapper?label=PyPI\"\u003e \u003ca href=\"https://img.shields.io/pypi/pyversions/colmap-wrapper\"\u003e\u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/colmap-wrapper\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/meyerls/colmap_wrapper/blob/main/LICENSE\"\u003e\u003cimg alt=\"license\" src=\"https://img.shields.io/github/license/meyerls/colmap-wrapper\"\u003e\u003c/a\u003e\n\n\u003c!--a href=\"https://github.com/meyerls/colmap-wrapper/actions\"\u003e\u003cimg alt=\"GitHub Workflow Status\" src=\"https://img.shields.io/github/workflow/status/meyerls/colmap-wrapper/Python%20package\"\u003e\u003c/a--\u003e\n\n## About\n\nColmap wrapper is a library to work with colmap projects. The purpose is the simplification to read e.g. rgb images,\ndepth\nimages, camera poses, sparse point clouds etc. Additionally a visualization for a colmap project is provided.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg width=\"40%\" src=\"img/img_1.png\"\u003e\n    \u003cimg width=\"40%\" src=\"img/img_2.png\"\u003e\n\u003c/p\u003e\n\n## Installation\n\nMake sure that you have a Python version \u003e=3.8 installed.\n\nThis repository is tested on Python 3.8+ and can currently only be installed\nfrom [PyPi](https://pypi.org/project/colmap-wrapper/).\nuv run pytest\nuv sync\n\n ````bash\npip install dataloader-wrapper\n ````\n\n## Usage\n\n### Single Reconstruction\n\nTo visualize a single reconstruction from COLMAP, the following code reads all colmap elements and visualizes them. For\nthis case an example reconstruction project is provided as shown at the top of the readme.\n\n```python\nfrom colmap_wrapper.dataloader import COLMAPLoader\nfrom colmap_wrapper.visualization import ColmapVisualization\nfrom colmap_wrapper.data.download import Dataset\n\ndownloader = Dataset()\ndownloader.download_bunny_dataset()\n\nproject = COLMAPLoader(project_path=downloader.file_path)\n\ncolmap_project = project.project\n\n# Acess camera, images and sparse + dense point cloud\ncamera = colmap_project.cameras\nimages = colmap_project.images\nsparse = colmap_project.get_sparse()\ndense = colmap_project.get_dense()\n\n# Visualize COLMAP Reconstruction\nproject_vs = ColmapVisualization(colmap_project)\nproject_vs.visualization(frustum_scale=0.7, image_type='image', image_resize=0.4)\n```\n\n### Multiple Incomplete Reconstruction\n\nIn case of an incomplete reconstruction colmap creates partial reconstructions. In this case a list of\nreconstructions can be called as shown below.\n\n```python\nfrom colmap_wrapper.dataloader import COLMAPLoader\nfrom colmap_wrapper.visualization import ColmapVisualization\n\nproject = COLMAPLoader(project_path=\"[PATH2COLMAP_PROJECT]\", image_resize=0.3)\n\n# project.projects is a list containing single dataloader projects\nfor COLMAP_MODEL in project.projects:\n    project_vs = ColmapVisualization(colmap=COLMAP_MODEL)\n    project_vs.visualization(frustum_scale=0.7, image_type='image')\n```\n\n## References\n\n* [PyExifTool](https://github.com/sylikc/pyexiftool): A library to communicate with the [ExifTool](https://exiftool.org)\n  command- application. If you have trouble installing it please refer to the PyExifTool-Homepage.\n\n```bash\n# For Ubuntu users:\nwget https://exiftool.org/Image-ExifTool-12.51.tar.gz\ngzip -dc Image-ExifTool-12.51.tar.gz | tar -xf -\ncd Image-ExifTool-12.51\nperl Makefile.PL\nmake test\nsudo make install\n```\n\n* To Visualize the Reconstruction on an OSM-Map the implementation\n  from [GPS-visualization-Python](https://github.com/tisljaricleo/GPS-visualization-Python) is used. A guide to\n  visualize gps data can be found\n  on [Medium](https://towardsdatascience.com/simple-gps-data-visualization-using-python-and-open-street-maps-50f992e9b676)\n  .\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeyerls%2Fcolmap-wrapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeyerls%2Fcolmap-wrapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeyerls%2Fcolmap-wrapper/lists"}