{"id":13528432,"url":"https://github.com/stella-cv/stella_vslam","last_synced_at":"2025-04-01T13:32:52.500Z","repository":{"id":37716594,"uuid":"334317360","full_name":"stella-cv/stella_vslam","owner":"stella-cv","description":"This is a unofficial fork of OpenVSLAM (https://github.com/xdspacelab/openvslam)","archived":false,"fork":false,"pushed_at":"2024-05-11T04:11:58.000Z","size":4343,"stargazers_count":839,"open_issues_count":21,"forks_count":365,"subscribers_count":35,"default_branch":"main","last_synced_at":"2024-05-21T11:47:03.832Z","etag":null,"topics":["visual-slam"],"latest_commit_sha":null,"homepage":"https://stella-cv.rtfd.io/en/latest/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stella-cv.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}},"created_at":"2021-01-30T03:16:19.000Z","updated_at":"2024-06-12T14:10:39.165Z","dependencies_parsed_at":"2023-10-15T10:54:09.466Z","dependency_job_id":"706db88f-267f-4f49-98e1-fd70feef664c","html_url":"https://github.com/stella-cv/stella_vslam","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stella-cv%2Fstella_vslam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stella-cv%2Fstella_vslam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stella-cv%2Fstella_vslam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stella-cv%2Fstella_vslam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stella-cv","download_url":"https://codeload.github.com/stella-cv/stella_vslam/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246647738,"owners_count":20811372,"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":["visual-slam"],"created_at":"2024-08-01T07:00:19.105Z","updated_at":"2025-04-01T13:32:52.045Z","avatar_url":"https://github.com/stella-cv.png","language":"C++","funding_links":[],"categories":["2. Visual SLAM","🗺️ SLAM \u0026 Localization"],"sub_categories":["2.1 Framework"],"readme":"# stella_vslam\n\n[![CI](https://github.com/stella-cv/stella_vslam/actions/workflows/main.yml/badge.svg)](https://github.com/stella-cv/stella_vslam/actions/workflows/main.yml)\n[![Documentation Status](https://readthedocs.org/projects/stella-cv/badge/?version=latest)](https://stella-cv.readthedocs.io/en/latest/?badge=latest)\n[![License](https://img.shields.io/badge/License-BSD%202--Clause-orange.svg)](https://opensource.org/licenses/BSD-2-Clause)\n\n---\n\n\u003e *NOTE:* This is a community fork of [xdspacelab/openvslam](https://github.com/xdspacelab/openvslam). It was created to continue active development of OpenVSLAM on Jan 31, 2021. The original repository is no longer available. Please read the [official statement of termination](https://github.com/xdspacelab/openvslam/wiki/Termination-of-the-release) carefully and understand it before using this. The similarities with ORB_SLAM2 in the original version have been removed by [#252](https://github.com/stella-cv/stella_vslam/pull/252). If you find any other issues with the license, please point them out. See [#37](https://github.com/stella-cv/stella_vslam/issues/37) and [#249](https://github.com/stella-cv/stella_vslam/issues/249) for discussion so far.\n\n*Versions earlier than 0.3 are deprecated. If you use them, please use them as a derivative of ORB_SLAM2 under the GPL license.*\n\n---\n\n## Overview\n\n[\u003cimg src=\"https://raw.githubusercontent.com/stella-cv/docs/main/docs/img/teaser.png\" width=\"640px\"\u003e](https://arxiv.org/abs/1910.01122)\n\n\u003cimg src=\"https://j.gifs.com/81m1QL.gif\" width=\"640px\"\u003e\n\n[**[PrePrint]**](https://arxiv.org/abs/1910.01122)\n\nstella_vslam is a monocular, stereo, and RGBD visual SLAM system.\n\n### Features\n\nThe notable features are:\n\n- It is compatible with **various type of camera models** and can be easily customized for other camera models.\n- Created maps can be **stored and loaded**, then stella_vslam can **localize new images** based on the prebuilt maps.\n- The system is fully modular. It is designed by encapsulating several functions in separated components with easy-to-understand APIs.\n- We provided **some code snippets** to understand the core functionalities of this system.\n\nOne of the noteworthy features of stella_vslam is that the system can deal with various type of camera models, such as perspective, fisheye, and equirectangular.\nIf needed, users can implement extra camera models (e.g. dual fisheye, catadioptric) with ease.\nFor example, visual SLAM algorithm using **equirectangular camera models** (e.g. RICOH THETA series, insta360 series, etc) is shown above.\n\nWe provided [documentation](https://stella-cv.readthedocs.io/) for installation and tutorial.\nThe repository for the ROS wrapper is [stella_vslam_ros](https://github.com/stella-cv/stella_vslam_ros).\n\n### Acknowledgements\n\nOpenVSLAM is based on an indirect SLAM algorithm with sparse features, such as [ORB-SLAM](https://arxiv.org/abs/1502.00956)/[ORB-SLAM2](https://arxiv.org/abs/1610.06475), [ProSLAM](https://arxiv.org/abs/1709.04377), and [UcoSLAM](https://arxiv.org/abs/1902.03729).\nThe core architecture is based on ORB-SLAM/ORB-SLAM2 and the code has been redesigned and written from scratch to improve scalability, readability, performance, etc.\nUcoSLAM has implemented the parallelization of feature extraction, map storage and loading earlier.\nProSLAM has implemented a highly modular and easily understood system earlier.\n\n### Examples\n\nSome code snippets to understand the core functionalities of the system are provided.\nYou can employ these snippets for in your own programs.\nPlease see the `*.cc` files in `./example` directory or check [Simple Tutorial](https://stella-cv.readthedocs.io/en/latest/simple_tutorial.html) and [Example](https://stella-cv.readthedocs.io/en/latest/example.html).\n\n## Installation\n\nPlease see [**Installation**](https://stella-cv.readthedocs.io/en/latest/installation.html) chapter in the [documentation](https://stella-cv.readthedocs.io/).\n\n[**The instructions for Docker users**](https://stella-cv.readthedocs.io/en/latest/docker.html) are also provided.\n\n## Tutorial\n\nPlease see [**Simple Tutorial**](https://stella-cv.readthedocs.io/en/latest/simple_tutorial.html) chapter in the [documentation](https://stella-cv.readthedocs.io/).\n\nA sample ORB vocabulary file can be downloaded from [here](https://github.com/stella-cv/FBoW_orb_vocab/raw/main/orb_vocab.fbow).\nSample datasets are also provided at [here](https://drive.google.com/open?id=1A_gq8LYuENePhNHsuscLZQPhbJJwzAq4).\n\nIf you would like to run visual SLAM with standard benchmarking datasets (e.g. KITTI Odometry dataset), please see [**SLAM with standard datasets**](https://stella-cv.readthedocs.io/en/latest/example.html#slam-with-standard-datasets) section in the [documentation](https://stella-cv.readthedocs.io/).\n\n## Community\n\nPlease contact us via [GitHub Discussions](https://github.com/stella-cv/stella_vslam/discussions) if you have any questions or notice any bugs about the software.\n\n## Currently working on\n\n- Refactoring\n- Algorithm changes and parameter additions to improve performance\n- Add tests\n- Marker integration\n- Implementation of extra camera models\n- Python bindings\n- IMU integration\n\nThe higher up the list, the higher the priority.\nFeedbacks, feature requests, and contribution are welcome!\n\n## License\n\n**2-clause BSD license** (see [LICENSE](./LICENSE))\n\nThe following files are derived from third-party libraries.\n\n- `./3rd/json` : [nlohmann/json \\[v3.6.1\\]](https://github.com/nlohmann/json) (MIT license)\n- `./3rd/spdlog` : [gabime/spdlog \\[v1.3.1\\]](https://github.com/gabime/spdlog) (MIT license)\n- `./3rd/tinycolormap` : [yuki-koyama/tinycolormap](https://github.com/yuki-koyama/tinycolormap) (MIT license)\n- `./3rd/FBoW` : [stella-cv/FBoW](https://github.com/stella-cv/FBoW) (MIT license) (forked from [rmsalinas/fbow](https://github.com/rmsalinas/fbow))\n- `./src/stella_vslam/solver/essential_5pt.h` : part of [libmv/libmv](https://github.com/libmv/libmv) (MIT license)\n- `./src/stella_vslam/solver/pnp_solver.cc` : part of [laurentkneip/opengv](https://github.com/laurentkneip/opengv) (3-clause BSD license)\n- `./src/stella_vslam/feature/orb_extractor.cc` : part of [opencv/opencv](https://github.com/opencv/opencv) (3-clause BSD License)\n- `./src/stella_vslam/feature/orb_point_pairs.h` : part of [opencv/opencv](https://github.com/opencv/opencv) (3-clause BSD License)\n\nPlease use `g2o` as the dynamic link library because `csparse_extension` module of `g2o` is LGPLv3+.\n\n## Authors of the original version of OpenVSLAM\n\n- Shinya Sumikura ([@shinsumicco](https://github.com/shinsumicco))\n- Mikiya Shibuya ([@MikiyaShibuya](https://github.com/MikiyaShibuya))\n- Ken Sakurada ([@kensakurada](https://github.com/kensakurada))\n\n## Citation of original version of OpenVSLAM\n\nOpenVSLAM **won first place** at **ACM Multimedia 2019 Open Source Software Competition**.\n\nIf OpenVSLAM helps your research, please cite the paper for OpenVSLAM. Here is a BibTeX entry:\n\n```\n@inproceedings{openvslam2019,\n  author = {Sumikura, Shinya and Shibuya, Mikiya and Sakurada, Ken},\n  title = {{OpenVSLAM: A Versatile Visual SLAM Framework}},\n  booktitle = {Proceedings of the 27th ACM International Conference on Multimedia},\n  series = {MM '19},\n  year = {2019},\n  isbn = {978-1-4503-6889-6},\n  location = {Nice, France},\n  pages = {2292--2295},\n  numpages = {4},\n  url = {http://doi.acm.org/10.1145/3343031.3350539},\n  doi = {10.1145/3343031.3350539},\n  acmid = {3350539},\n  publisher = {ACM},\n  address = {New York, NY, USA}\n}\n```\n\nThe preprint can be found [here](https://arxiv.org/abs/1910.01122).\n\n## Reference\n\n- Raúl Mur-Artal, J. M. M. Montiel, and Juan D. Tardós. 2015. ORB-SLAM: a Versatile and Accurate Monocular SLAM System. IEEE Transactions on Robotics 31, 5 (2015), 1147–1163.\n- Raúl Mur-Artal and Juan D. Tardós. 2017. ORB-SLAM2: an Open-Source SLAM System for Monocular, Stereo and RGB-D Cameras. IEEE Transactions on Robotics 33, 5 (2017), 1255–1262.\n- Dominik Schlegel, Mirco Colosi, and Giorgio Grisetti. 2018. ProSLAM: Graph SLAM from a Programmer’s Perspective. In Proceedings of IEEE International Conference on Robotics and Automation (ICRA). 1–9.\n- Rafael Muñoz-Salinas and Rafael Medina Carnicer. 2019. UcoSLAM: Simultaneous Localization and Mapping by Fusion of KeyPoints and Squared Planar Markers. arXiv:1902.03729.\n- Mapillary AB. 2019. OpenSfM. \u003chttps://github.com/mapillary/OpenSfM\u003e.\n- Giorgio Grisetti, Rainer Kümmerle, Cyrill Stachniss, and Wolfram Burgard. 2010. A Tutorial on Graph-Based SLAM. IEEE Transactions on Intelligent Transportation SystemsMagazine 2, 4 (2010), 31–43.\n- Rainer Kümmerle, Giorgio Grisetti, Hauke Strasdat, Kurt Konolige, and Wolfram Burgard. 2011. g2o: A general framework for graph optimization. In Proceedings of IEEE International Conference on Robotics and Automation (ICRA). 3607–3613.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstella-cv%2Fstella_vslam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstella-cv%2Fstella_vslam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstella-cv%2Fstella_vslam/lists"}