Skip to content

joansola/slamtb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b4767f6 · Jun 21, 2022
Jul 4, 2015
Jul 5, 2015
Jun 12, 2015
Dec 25, 2018
Oct 19, 2018
Oct 19, 2018
Oct 19, 2018
Mar 1, 2017
Jun 12, 2015
Jun 21, 2022
Apr 6, 2017
Jul 12, 2015
Jul 5, 2015
Oct 19, 2018
Jul 15, 2015
Jul 17, 2009
Oct 17, 2018
Feb 25, 2016
Jun 12, 2015
Apr 22, 2012
Jan 22, 2014
Jul 11, 2015

Repository files navigation

SLAM Toolbox for Matlab.
========================

This git repository provides EKF-SLAM and graph-SLAM toolboxes.


I. Copyright and license.
=========================
(c) 2007, 2008, 2009, 2010  Joan Sola  @ LAAS-CNRS; 
(c) 2010, 2011, 2012, 2013  Joan Sola
(c) 2014, 2015, 2016--2018  Joan Sola  @ IRI-UPC-CSIC; 
(c) 2009  Joan Sola, David Marquez, Jean Marie Codol,
          Aurelien Gonzalez and Teresa Vidal-Calleja, @ LAAS-CNRS;
(c) 2018  Marija Popovic @ ETH, thanks for the ellipse drawing in graph SLAM 

Maintained by Joan Sola
Please write feedback, suggestions and bugs to:

    [email protected]

or use the GitHub web tools.

Published under GPL license. See COPYING.txt. 


II. Giving credit
=================

In addition to the GPL license, users should consider, in their scientific 
communications :

A. acknowledging the use of this toolbox.

B. citing one of the papers of the authors: 

  - SOLA-ETAL-IJCV-11 "Impact of landmark parametrization on monocular EKF-SLAM with points and lines"
  - SOLA-ETAL-IROS-09 "Undelayed initialization of line segments in monocular SLAM"
  - SOLA-ETAL-TRO-08  "Fusing monocular information in multi-camera SLAM"
  - SOLA-ETAL-IROS-05 "Undelayed initialization in bearing only SLAM" 

appearing in the References section in the documentation.


III. Installation and quick usage.
==================================

To make it work, (1) open a terminal (for example, a linux terminal) and (2) start Matlab. Then follow these steps:

To use EKF-SLAM
-------------------

A. In the [Linux / MacOSX] terminal: 

  A.1. Get the source code,

        git clone git://github.com/joansola/slamtb.git

  A.2. Go to the toolbox 
        
        cd slamtb

  A.3. Select the EKF-SLAM project.

        git checkout ekf

B. In the Matlab command window:  

  B.1. Go to the toolbox 
        
        >> cd slamtb

  B.2. Add all subdirectories in slamtb/ to your Matlab path using the provided script: 
        
        >> slamrc

  B.3. Edit user data file, and enter the data of your experiment.

        >> edit userData.m.

  B.4. Run the main script
        
        >> slamtb.

  B.5. To develop methods, read first slamToolbox.pdf and guidelines.pdf. 


To use graph-SLAM
-------------------

A. In the [Linux / MacOSX] terminal: 

  A.1. Get the source code,

        git clone git://github.com/joansola/slamtb.git

  A.2. Go to the toolbox 
        
        cd slamtb

  A.3. Select the graph-SLAM project.

        git checkout graph

B. In the Matlab prompt:  

  B.1. Go to the toolbox 
        
        >> cd slamtb

  B.2. Add all subdirectories in slamtb/ to your Matlab path using the provided script: 
        
        >> slamrc

  B.3. Edit user data file, and enter the data of your experiment.

        >> edit userDataGraph.m

  B.4. Run the main script

        >> slamtb_graph

  B.5. To develop methods, read first slamToolbox.pdf and guidelines.pdf. 
     For graph-SLAM, read also courseSLAM.pdf.

Enjoy!