winstxnhdw / autocarros2

A virtual simulation platform for autonomous vehicle sensing, mapping, control and behaviour methods using ROS 2 and Gazebo.

AUTONOMOUS VEHICLE: CONTROL AND BEHAVIOUR

AutoCarROS has migrated to ROS 2 Foxy Fitzroy

Abstract

This project contains the ROS 2 variant of the AutoCarROS repository. It is a template for the development of a robust non-holonomic autonomous vehicle platform in a simulated environment using ROS 2 and Gazebo 11.

The following GIF demonstrates a simulation built on top of AutoCarROS 2.

Installation

Create a workspace

$ mkdir -p PATH/TO/WORKSPACE/src
$ cd src

Clone the repository.

$ git clone https://github.com/winstxnhdw/AutoCarROS2.git
$ cd PATH/TO/WORKSPACE/src/AutoCarROS2

Install ROS 2 and the required dependencies.

sh ros-foxy-desktop-full-install.sh

If you only need to install the required dependencies, run the following. Otherwise, skip this step.

sh requirements.sh

Build the packages.

$ cd PATH/TO/WORKSPACE/
$ colcon build

Append the workspace to .bashrc.

$ echo "source PATH/TO/WORKSPACE/install/setup.bash" >> ~/.bashrc
$ source ~/.bashrc

Usage

When using this project for the first time, it is necessary that the user builds the packages before attempting to run the launch files.

# Change directory to your desired workspace
cd PATH/TO/WORKSPACE/

# Build packages
$ colcon build

There are two launch files the user can use. More details in the Launch Files section.

# Launch the default launch file
$ ros2 launch launches default_launch.py

# OR

# Launch the interactive launch file
$ ros2 launch launches click_launch.py

Launch Files

Launch File	Purpose
default_launch.py	Complete pipeline with preset waypoints
click_launch.py	Interactive pipeline for testing and fun

Packages

Package	Purpose
launches	Contains the main launch files for quick launching
autocar_description	Contains the model's URDF and RViz configuration files
autocar_gazebo	Contains the world files and model's SDF
autocar_map	Contains the Bayesian Occupancy Filter stack
autocar_msgs	Contains all custom messages used throughout every package
autocar_nav	Contains the navigation stack

Troubleshoot

There are occasions where colcon build does not properly rebuild the 'build' and 'install' folders, especially when one has made changes to the CMakeLists.txt. In the following, a simple quick fix can be performed.

# Remove build and install files
$ cd PATH/TO/WORKSPACE/
$ rm -rf build install

Renders

"Because the layman doesn't care unless it looks cool."

autocarros2's Issues

Build error please help

Hi,

_/_ Thanks a lot for the project. I am getting errors at the start of the colcon build. I am using Ubuntu 22 and ROS2 Humble.

I have attached the screenshots, will you please tell me what I should do? I installed all the dependencies and followed your instructions.

Is description missing launch & config?

Hi, I followed your instructions but colcon build errored in ngeeann_av_description because it is missing a launch directory (and files?) and config directory (and files).

If I add blank directories then the build proceeds but both launches get stuck loading rviz.

gazebo won't launch

Sorry for the dumb question, but gazebo won't start in click_launch.py, and there's no obstacles in rviz with default_launch.py. Any tips for running the simulation?

Provide gazebo plugins of animated box?

Thanks.

Is the code you used to generate the gif on README part of the repo?

Many thanks for this great work! It's given me a good idea on what I am trying to accomplish.

I am wondering if I have a problem in my setup or if you used a different repo to generate the gif in README.

When I launch the default_launch, the vehicle does move, however there are no obstacles visible in rviz, just the ground plane, and a gray area that represent the sensor zone.

There are no errors in the console, so I am curious if you've used a different simulation to generate that gif?

Build error again please help!

Hi there again,

/ Thanks a lot for the project. I am getting errors at the start of the colcon build. This time I am using ROS2 Foxy with Ubuntu 20 as you instructed.

I have attached the screenshots, will you please tell me what I should do? I installed all the dependencies and followed your instructions.