Go to file
Jonathan Huber dcbd9d10df
Make publishing tf optional, enable publishing PoseStamped (#1099)
If the output of cartographer should be used as an input to an additional sensor fusion method,
using the published TF transform is inconvenient or in our specific use case even harmful
because we don't want to add the raw cartographer output to our TF tree.

With this change it becomes optional to broadcast to /tf.
Morever there is an option to publish the tracked frame pose as a PoseStamped message.
We add two new optional parameters:
- `publish_to_tf` if false no tf transform is broadcasted
-  `publish_tracked_pose` If set `true` a PoseStamped representing the position of the
tracked pose w.r.t. map frame is published.

If default launchers and settings are used this PR causes no change in the behavior.
2020-10-21 14:03:15 +02:00
.github/ISSUE_TEMPLATE Use distinct issue templates for bugs, tuning and general things. (#1521) 2020-10-07 12:56:54 +02:00
cartographer_ros Make publishing tf optional, enable publishing PoseStamped (#1099) 2020-10-21 14:03:15 +02:00
cartographer_ros_msgs Fix build status on front page. (#1483) 2020-06-24 10:55:03 +02:00
cartographer_rviz Build Abseil dependency in CI. (#1485) 2020-06-25 13:04:21 +02:00
docs Make publishing tf optional, enable publishing PoseStamped (#1099) 2020-10-21 14:03:15 +02:00
scripts Prepare GMock support for Noetic. (#1499) 2020-07-27 19:45:40 +02:00
.dockerignore Adds Kinetic to build matrix. (#222) 2016-12-09 15:24:06 +01:00
.travis.yml Changes for ROS Noetic support (#1494) 2020-07-28 14:39:55 +02:00
AUTHORS Initial import of Cartographer codebase. 2016-08-03 12:45:08 +02:00
CONTRIBUTING.md Change Google CLA to DCO in CONTRIBUTING.md (#1482) 2020-06-17 16:16:26 +02:00
Dockerfile.kinetic Follow cartographer-project/cartographer#1750. (#1518) 2020-09-24 12:26:31 +02:00
Dockerfile.melodic Follow cartographer-project/cartographer#1750. (#1518) 2020-09-24 12:26:31 +02:00
Dockerfile.noetic Follow cartographer-project/cartographer#1750. (#1518) 2020-09-24 12:26:31 +02:00
LICENSE Initial import of Cartographer codebase. 2016-08-03 12:45:08 +02:00
README.rst Fix build status on front page. (#1483) 2020-06-24 10:55:03 +02:00
azure-pipelines.yml Fix build status on front page. (#1483) 2020-06-24 10:55:03 +02:00
cartographer_ros.rosinstall Fix build status on front page. (#1483) 2020-06-24 10:55:03 +02:00

README.rst

.. Copyright 2016 The Cartographer Authors

.. Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

..      http://www.apache.org/licenses/LICENSE-2.0

.. Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

============================
Cartographer ROS Integration
============================

|build| |docs| |license|

Purpose
=======

`Cartographer`_ is a system that provides real-time simultaneous localization
and mapping (`SLAM`_) in 2D and 3D across multiple platforms and sensor
configurations. This project provides Cartographer's ROS integration.

.. _Cartographer: https://github.com/cartographer-project/cartographer
.. _SLAM: https://en.wikipedia.org/wiki/Simultaneous_localization_and_mapping

Getting started
===============

* Learn to use Cartographer with ROS at `our Read the Docs site`_.
* You can ask a question by `creating an issue`_.

.. _our Read the Docs site: https://google-cartographer-ros.readthedocs.io
.. _creating an issue: https://github.com/cartographer-project/cartographer_ros/issues/new?labels=question

Contributing
============

You can find information about contributing to Cartographer's ROS integration
at `our Contribution page`_.

.. _our Contribution page: https://github.com/cartographer-project/cartographer_ros/blob/master/CONTRIBUTING.md

.. |build| image:: https://travis-ci.org/cartographer-project/cartographer_ros.svg?branch=master
    :alt: Build Status
    :scale: 100%
    :target: https://travis-ci.org/cartographer-project/cartographer_ros
.. |docs| image:: https://readthedocs.org/projects/google-cartographer-ros/badge/?version=latest
    :alt: Documentation Status
    :scale: 100%
    :target: https://google-cartographer-ros.readthedocs.io/en/latest/?badge=latest
.. |license| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
     :alt: Apache 2 license.
     :scale: 100%
     :target: https://github.com/cartographer-project/cartographer_ros/blob/master/LICENSE