{"id":18889073,"url":"https://github.com/naver/kapture-localization","last_synced_at":"2025-04-13T04:58:37.633Z","repository":{"id":37456513,"uuid":"303869351","full_name":"naver/kapture-localization","owner":"naver","description":"Provide mapping and localization pipelines based on kapture format","archived":false,"fork":false,"pushed_at":"2024-03-28T13:55:53.000Z","size":24705,"stargazers_count":277,"open_issues_count":1,"forks_count":42,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-13T04:58:29.538Z","etag":null,"topics":["colmap","image-retrieval","localization","r2d2","sfm","structure-from-motion","visual-localization"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/naver.png","metadata":{"files":{"readme":"README.adoc","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}},"created_at":"2020-10-14T01:22:56.000Z","updated_at":"2025-03-14T09:25:05.000Z","dependencies_parsed_at":"2024-03-28T15:12:38.244Z","dependency_job_id":null,"html_url":"https://github.com/naver/kapture-localization","commit_stats":{"total_commits":306,"total_committers":12,"mean_commits":25.5,"dds":0.5032679738562091,"last_synced_commit":"f3bbdcdfc49f3626e5dca3ffb6d3d9596f0b42d9"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naver%2Fkapture-localization","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naver%2Fkapture-localization/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naver%2Fkapture-localization/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naver%2Fkapture-localization/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/naver","download_url":"https://codeload.github.com/naver/kapture-localization/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665761,"owners_count":21142123,"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":["colmap","image-retrieval","localization","r2d2","sfm","structure-from-motion","visual-localization"],"created_at":"2024-11-08T07:47:25.921Z","updated_at":"2025-04-13T04:58:37.591Z","avatar_url":"https://github.com/naver.png","language":"Python","readme":"= kapture-localization: toolbox\n:sectnums:\n:sectnumlevels: 1\n:toc: macro\n:toclevels: 2\n\ntoc::[]\n\n== Overview\n\nkapture-localization is a **toolbox** in which you will find implementations for various localization related algorithms.\nIt strongly relies on the https://github.com/naver/kapture[kapture] format for data representation and manipulation.\n\nThe localization algorithms include:\n\n . **mapping**,\n . **localization**, and\n . **benchmarking** (image retrieval for visual localization).\n\nIt works on Ubuntu, Windows, and MacOS.\n\n== Structure\n\nThe directories are organised as follow:\n\n----\n├── kapture_localization/  # package (library)\n├── pipeline/              # main programs executing all steps of the localization pipelines\n├── samples/               # some sample data\n├── tests/                 # unit tests\n└── tools/                 # sub programs involved in the pipeline\n----\n\n\nThe __kapture-localization__ toolbox is available as:\n\n - Python *package* (`kapture_localization/`),\n - Python *executable scripts* (`pipeline/` \u0026 `tools/`).\n\nThere are 3 pipelines available:\n\n . mapping,\n . localization, and\n . image retrieval benchmark (global sfm, local sfm, pose approximation).\n\n\n== Installation\n\nIt can be installed using docker, pip or from manually from source code.\nAfter installing python (\u003e=3.8) and COLMAP (\u003e=3.6), this toolbox can be installed with:\n\n[source,bash]\n----\npip install kapture-localization\n----\n\nSee link:doc/installation.adoc[] for more details.\n\n== Tutorial\n\nSee link:doc/tutorial.adoc[doc/tutorial] for a short introduction and examples of the provided processing pipelines.\n\n== Image Retrieval Benchmark\n\nlink:doc/benchmark.adoc[Benchmark pipeline]\n\nlink:doc/benchmark_results.adoc[Benchmark results]\n\n== Contributing\n\nThere are many ways to contribute to the __kapture-localization__ project:\n\n* provide feedback and suggestion,\n* submit bug reports in the project bug tracker,\n* implement a feature or bug-fix for an outstanding issue,\n* provide scripts to create data in kapture format (e.g. local/global feature extraction),\n* propose a new feature and implement it.\n\n// TODO individual page for kapture-localization ?\nIf you wish to contribute, please refer to the\nlink:https://github.com/naver/kapture/blob/main/CONTRIBUTING.adoc[CONTRIBUTING] page.\n\n== License\nSoftware license is detailed in the link:LICENSE[LICENSE] file.\n\n== References\nIf you use this work for your research, please cite the respective paper(s):\n\n.Structure-based localization or kapture format\n----\n@misc{kapture2020,\n      title={Robust Image Retrieval-based Visual Localization using Kapture},\n      author={Martin Humenberger and Yohann Cabon and Nicolas Guerin and Julien Morat and Jérôme Revaud and Philippe Rerole and Noé Pion and Cesar de Souza and Vincent Leroy and Gabriela Csurka},\n      year={2020},\n      eprint={2007.13867},\n      archivePrefix={arXiv},\n      primaryClass={cs.CV}\n}\n----\n\n.Image retrieval benchmark\n----\n@inproceedings{benchmarking_ir3DV2020,\n      title={Benchmarking Image Retrieval for Visual Localization},\n      author={Noé Pion, Martin Humenberger, Gabriela Csurka, Yohann Cabon, Torsten Sattler},\n      year={2020},\n      booktitle={International Conference on 3D Vision}\n}\n\n@article{humenberger2022investigating,\n  title={Investigating the Role of Image Retrieval for Visual Localization},\n  author={Humenberger, Martin and Cabon, Yohann and Pion, No{\\'e} and Weinzaepfel, Philippe and Lee, Donghwan and Gu{\\'e}rin, Nicolas and Sattler, Torsten and Csurka, Gabriela},\n  journal={International Journal of Computer Vision},\n  year={2022},\n  publisher={Springer}\n}\n----\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaver%2Fkapture-localization","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaver%2Fkapture-localization","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaver%2Fkapture-localization/lists"}