Go to file
Varun Agrawal dfa32e5020 lyx update 2021-10-09 22:51:48 -04:00
.github Merge pull request #570 from borglab/feature/system-metis-lib 2021-09-18 02:12:43 -04:00
.settings Merge remote-tracking branch 'origin/develop' into feature/Similarity 2015-01-23 08:10:21 -05:00
CppUnitLite Fix all new gcc warnings/errors: make explicit virtual/override methods. 2020-07-26 11:20:42 +02:00
cmake Merge branch 'develop' of https://github.com/borglab/gtsam into borglab-develop 2021-09-19 11:46:20 -04:00
doc lyx update 2021-10-09 22:51:48 -04:00
docker Fixed VNC docs for Mac 2021-09-06 22:35:58 -04:00
examples undo name change from 984a90 2021-09-30 09:05:22 -04:00
gtsam test passes 2021-09-30 09:06:13 -04:00
gtsam_unstable undo name change from 984a90 2021-09-30 09:05:22 -04:00
matlab Working CustomFactor 2021-05-14 16:24:31 -04:00
python update template to record correct name of cpp file 2021-09-10 11:53:41 -04:00
tests undo name change from 984a90 2021-09-30 09:05:22 -04:00
timing update timeLago.cpp with newer Sampler interface 2021-06-14 15:33:17 -04:00
wrap Merging 'master' into 'wrap' 2021-09-18 02:17:47 -04:00
.gitignore remove all Cython references 2020-10-01 19:56:35 -04:00
.project Fixed build command 2014-11-23 10:43:00 +01:00
CMakeLists.txt Merge branch 'develop' into feature/system-metis-lib 2021-08-26 00:25:41 -04:00
DEVELOP.md Link to GTSAM-EXPORT doc 2021-08-20 11:11:28 -04:00
GTSAM-Concepts.md Fixed conventions for Jacobians 2020-07-21 11:04:36 -04:00
INSTALL.md Add section about Boost version requirement 2021-08-23 13:05:26 -04:00
LICENSE Added Spectra 0.9.0 to 3rdparty 2020-08-10 22:56:43 -04:00
LICENSE.BSD Final cleanup of text files - README.md, LICENSE*, USAGE, and INSTALL. 2014-01-30 14:42:23 -05:00
README.md set lowest common boost version 2021-08-20 11:10:13 -04:00
THANKS.md make all top level docs as markdown files 2019-06-13 17:09:50 -04:00
USAGE.md renamed all READMEs to README.md and updated markdown syntax 2019-06-13 17:26:07 -04:00
Using-GTSAM-EXPORT.md Link to GTSAM-EXPORT doc 2021-08-20 11:11:28 -04:00
gtsam_extra.cmake.in remove all Cython references 2020-10-01 19:56:35 -04:00
makestats.sh Command line for generating svn stats, needs statsvn from statsvn.org 2012-06-11 14:31:32 +00:00
package.xml Bump version to 4.1.0 2020-08-21 21:36:15 -04:00
update_wrap.sh Add script to update the wrap subtree 2020-08-20 10:31:40 -04:00

README.md

README - Georgia Tech Smoothing and Mapping Library

Important Note

As of August 1 2020, the develop branch is officially in "Pre 4.1" mode, and features deprecated in 4.0 have been removed. Please use the last 4.0.3 release if you need those features.

However, most are easily converted and can be tracked down (in 4.0.3) by disabling the cmake flag GTSAM_ALLOW_DEPRECATED_SINCE_V4.

What is GTSAM?

GTSAM is a C++ library that implements smoothing and mapping (SAM) in robotics and vision, using Factor Graphs and Bayes Networks as the underlying computing paradigm rather than sparse matrices.

The current support matrix is:

Platform Compiler Build Status
Ubuntu 18.04 gcc/clang Linux CI
macOS clang macOS CI
Windows MSVC Windows CI

On top of the C++ library, GTSAM includes wrappers for MATLAB & Python.

Quickstart

In the root library folder execute:

#!bash
$ mkdir build
$ cd build
$ cmake ..
$ make check (optional, runs unit tests)
$ make install

Prerequisites:

  • Boost >= 1.65 (Ubuntu: sudo apt-get install libboost-all-dev)
  • CMake >= 3.0 (Ubuntu: sudo apt-get install cmake)
  • A modern compiler, i.e., at least gcc 4.7.3 on Linux.

Optional prerequisites - used automatically if findable by CMake:

GTSAM 4 Compatibility

GTSAM 4 introduces several new features, most notably Expressions and a Python toolbox. It also introduces traits, a C++ technique that allows optimizing with non-GTSAM types. That opens the door to retiring geometric types such as Point2 and Point3 to pure Eigen types, which we also do. A significant change which will not trigger a compile error is that zero-initializing of Point2 and Point3 is deprecated, so please be aware that this might render functions using their default constructor incorrect.

GTSAM 4 also deprecated some legacy functionality and wrongly named methods. If you are on a 4.0.X release, you can define the flag GTSAM_ALLOW_DEPRECATED_SINCE_V4 to use the deprecated methods.

GTSAM 4.1 added a new pybind wrapper, and removed the deprecated functionality. There is a flag GTSAM_ALLOW_DEPRECATED_SINCE_V41 for newly deprecated methods since the 4.1 release, which is on by default, allowing anyone to just pull version 4.1 and compile.

Wrappers

We provide support for MATLAB and Python wrappers for GTSAM. Please refer to the linked documents for more details.

The Preintegrated IMU Factor

GTSAM includes a state of the art IMU handling scheme based on

  • Todd Lupton and Salah Sukkarieh, "Visual-Inertial-Aided Navigation for High-Dynamic Motion in Built Environments Without Initial Conditions", TRO, 28(1):61-76, 2012. [link]

Our implementation improves on this using integration on the manifold, as detailed in

  • Luca Carlone, Zsolt Kira, Chris Beall, Vadim Indelman, and Frank Dellaert, "Eliminating conditionally independent sets in factor graphs: a unifying perspective based on smart factors", Int. Conf. on Robotics and Automation (ICRA), 2014. [link]
  • Christian Forster, Luca Carlone, Frank Dellaert, and Davide Scaramuzza, "IMU Preintegration on Manifold for Efficient Visual-Inertial Maximum-a-Posteriori Estimation", Robotics: Science and Systems (RSS), 2015. [link]

If you are using the factor in academic work, please cite the publications above.

In GTSAM 4 a new and more efficient implementation, based on integrating on the NavState tangent space and detailed in this document, is enabled by default. To switch to the RSS 2015 version, set the flag GTSAM_TANGENT_PREINTEGRATION to OFF.

Additional Information

There is a GTSAM users Google group for general discussion.

Read about important GTSAM-Concepts here. A primer on GTSAM Expressions, which support (superfast) automatic differentiation, can be found on the GTSAM wiki on BitBucket.

See the INSTALL file for more detailed installation instructions.

GTSAM is open source under the BSD license, see the LICENSE and LICENSE.BSD files.

Please see the examples/ directory and the USAGE file for examples on how to use GTSAM.

GTSAM was developed in the lab of Frank Dellaert at the Georgia Institute of Technology, with the help of many contributors over the years, see THANKS.