Skip to content

maximilian-nitsch/Navigation-Utilities

C++/ROS 2 Utilities Utilities

Build License Last Commit ROS2 Humble Release Open Issues Contributors

Author:

Affiliation: Institute of Automatic Control - RWTH Aachen University

Maintainer:

Description

Dedicated Repo for Navigation Utility Functions.

Table of Contents

Dependencies

This project depends on:

  • ROS 2 Humble: ROS 2 is a set of software libraries and tools for building robot applications: ROS 2 Installation page.

Installation

To install the navigation utilities, you need to follow these steps:

  1. Install ROS 2 Humble: Ensure you have ROS 2 (Humble) installed. You can follow the official installation instructions provided by ROS 2. Visit ROS 2 Humble Installation page for detailed installation instructions tailored to your platform.

  2. Clone the Package: Clone the package repository to your ROS 2 workspace. If you don't have a ROS 2 workspace yet, you can create one using the following commands:

    mkdir -p /path/to/ros2_workspace/src
    cd /path/to/ros2_workspace/src

    Now, clone the package repository:

    git clone <repository_url>

    Replace <repository_url> with the URL of your package repository.

  3. Build the Package: Once the package is cloned, you must build it using colcon, the default build system for ROS 2. Navigate to your ROS 2 workspace and run the following command:

    cd /path/to/ros2_workspace
    colcon build

    This command will build all the packages in your workspace, including the newly added package.

  4. Using Navigation-Utilities in Your ROS 2 Package

    To use the navigation utilities function provided by Navigation-Utilities in your own ROS 2 package, follow these steps:

    In your package's package.xml, add:

      <depend>navigation_utilities_package</depend>

    In your package's CMakeLists.txt, add:

    find_package(navigation_utilities_package REQUIRED)
    
      target_link_libraries(...  navigation_utilities_package::navigation_utilities_package)

That's it! Your navigation utilities should now be installed and ready to use in your ROS 2 environment.

Contributing

If you'd like to contribute to the project, please take a look at the CONTRIBUTING file for details.

License

This project is licensed under the BSD-3-Clause License. Please look at the LICENSE file for details.