{"id":18623284,"url":"https://github.com/mrpt/srba","last_synced_at":"2025-06-29T06:05:08.232Z","repository":{"id":74180260,"uuid":"43430805","full_name":"MRPT/srba","owner":"MRPT","description":"[Prefer the newer MOLAorg/mola project] C++ framework for relative SLAM: Sparser Relative Bundle Adjustment (SRBA)","archived":false,"fork":false,"pushed_at":"2018-09-30T23:47:41.000Z","size":4939,"stargazers_count":74,"open_issues_count":6,"forks_count":37,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-25T09:01:35.323Z","etag":null,"topics":["bundle-adjustment","graph-slam","mobile-robotics","rba","slam"],"latest_commit_sha":null,"homepage":"http://mrpt.github.io/srba/","language":"C++","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/MRPT.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","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,"roadmap":null,"authors":null,"dei":null}},"created_at":"2015-09-30T12:09:52.000Z","updated_at":"2025-02-15T13:48:22.000Z","dependencies_parsed_at":"2024-01-31T01:03:31.990Z","dependency_job_id":"28d2f086-5063-4549-b082-98bc83e5ec9e","html_url":"https://github.com/MRPT/srba","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MRPT%2Fsrba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MRPT%2Fsrba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MRPT%2Fsrba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MRPT%2Fsrba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MRPT","download_url":"https://codeload.github.com/MRPT/srba/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248335460,"owners_count":21086597,"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":["bundle-adjustment","graph-slam","mobile-robotics","rba","slam"],"created_at":"2024-11-07T04:22:24.058Z","updated_at":"2025-04-11T03:31:35.872Z","avatar_url":"https://github.com/MRPT.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/MRPT/srba.png?branch=master)](https://travis-ci.org/MRPT/srba)\n\nTL;DR: **Sparser Relative Bundle Adjustment (SRBA)** is a header-only C++ library for solving SLAM/BA in relative coordinates with flexibility for different submapping strategies and aimed at constant time local graph update. BSD 3-Clause License.\n\nRelated papers: \n* Moreno, F.A. and Blanco, J.L. and Gonzalez, J. **A constant-time SLAM back-end in the continuum between global mapping and submapping: application to visual stereo SLAM**, International Journal of Robotics Research, 2016. ([DOI](http://dx.doi.org/10.1177/0278364915619238)), ([Draft PDF](http://ingmec.ual.es/~jlblanco/papers/moreno2016ssrba_DRAFT.pdf))\n* Blanco, J.L. and Gonzalez, J. and Fernandez-Madrigal, J.A. **Sparser Relative Bundle Adjustment (SRBA): constant-time maintenance and local optimization of arbitrarily large maps**, IEEE International Conference of Robotics and Automation (ICRA), 2013. ([PDF](http://ingmec.ual.es/~jlblanco/papers/blanco2013rba.pdf)), ICRA slides ([PDF](http://ingmec.ual.es/~jlblanco/papers/blanco2013rba_ICRA_slides.pdf)), [BibTeX](http://ingmec.ual.es/aigaion2/index.php/export/publication/233/bibtex)\n* Blanco, J.L. **User guide for libsrba: A generic C++ framework for Relative Bundle Adjustment (RBA)** ([PDF](http://mrpt.github.io/srba/srba-guide.pdf))\n\n# 1. Compile\n\nRequisites: \n* MRPT \u003e= 1.3.0  ([web](http://www.mrpt.org/), [github](https://github.com/MRPT/mrpt), [Ubuntu PPA](http://www.mrpt.org/MRPT_in_GNU/Linux_repositories))\n* gcc or clang (any version supported by Eigen 3) or MS Visual C++ 2008 or newer.\n* CMake \u003e=2.8\n\nIn Ubuntu, install requisites with:\n```\nsudo apt-get install build-essential cmake libmrpt-dev\n```\n\nClone, configure and build as usual with CMake:\n\n```\ngit clone https://github.com/MRPT/srba.git \ncd srba\nmkdir build \u0026\u0026 cd build\ncmake .. \nmake \nmake test\n```\n\n# 2. Theoretical bases\n\n[Bundle adjustment](http://en.wikipedia.org/wiki/Bundle_adjustment) is the name given to one solution to visual SLAM based on maximum-likelihood estimation (MLE) over the space of map features and camera poses. However, it is by no way limited to visual maps, since the same technique is also applicable to maps of pose constraints (graph-SLAM) or any other kind of feature maps not relying on visual information.\n\nThe framework of Relative Bundle Adjustment (RBA) was introduced in a series of works by G. Sibley and colleagues:\n* Sibley, G. **Relative bundle adjustment**. Department of Engineering Science, Oxford University, Tech. Rep, 2009. ([PDF](http://www.robots.ox.ac.uk/~gsibley/Personal/Papers/rba.pdf))\n* Sibley, G. and Mei, C. and Reid, I. and Newman, P. **Adaptive relative bundle adjustment**. Robotics Science and Systems Conference. 2009. ([PDF](http://homepages.laas.fr/~cmei/uploads/Main/gsibley-RSS2009.pdf))\n\n**Sparser RBA (SRBA)** is the name of the generic and extensible framework for RBA implemented in this C++ library, and introduced in the ICRA 2013 paper ([PDF](http://ingmec.ual.es/~jlblanco/papers/blanco2013rba.pdf), see full citation above).\n\n# 3. Programming guide and documentation\n\n* The official [user guide](http://mrpt.github.io/srba/srba-guide.pdf)\n* Doxygen C++ [API reference](http://mrpt.github.io/srba/), including explained examples.\n\n# 4. Run sample datasets\n\n## 4.1. Monocular visual SLAM with synthetic dataset\n\nhttps://www.youtube.com/watch?v=ZXti4GxqkUg\n\n\n## 4.2. Relative 2D graph-SLAM\n\n* Download and compile RWT, a small tool for generating synthetic datasets.\n* Create an empty directory and copy there the files:\n  * datasets/srba-demos/world-2d-30k-rel-graph-slam.cfg (The configuration file for the synthetic dataset)\n  * datasets/srba-demos/world-2d-30k-landmarks.wrl (The geometrical description of the synthetic scenario)\n* Generate the dataset, executing:\n```rwt-dataset-simulator world-2d-30k-rel-graph-slam-cfg```\n\nNow you can run RBA on the dataset with:\n```\nsrba-slam --se2 --graph-slam -d dataset_30k_rel_graph_slam_SENSOR.txt \\\\\n--submap-size 10 --max-spanning-tree-depth 3 --max-optimize-depth 3 \\\\\n--verbose 1 --noise 0.001 --noise-ang 0.2 --add-noise \\\\\n--gt-map dataset_30k_rel_graph_slam_GT_MAP.txt \\\\\n--gt-path dataset_30k_rel_graph_slam_GT_PATH.txt # --step-by-step\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrpt%2Fsrba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrpt%2Fsrba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrpt%2Fsrba/lists"}