ros2_rover

A version of Sawppy the Rover for ROS 2

https://github.com/mgonzs13/ros2_rover

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 1 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (6.0%) to scientific vocabulary

Keywords

gazebo ros2 rover swappy
Last synced: 7 months ago · JSON representation ·

Repository

A version of Sawppy the Rover for ROS 2

Basic Info
  • Host: GitHub
  • Owner: mgonzs13
  • License: mit
  • Language: Python
  • Default Branch: humble
  • Homepage:
  • Size: 25.3 MB
Statistics
  • Stars: 72
  • Watchers: 5
  • Forks: 10
  • Open Issues: 0
  • Releases: 10
Topics
gazebo ros2 rover swappy
Created over 4 years ago · Last pushed 12 months ago
Metadata Files
Readme License Citation

README.md

ros2_rover

This is a ROS 2 (Humble) version of the Sawppy the Rover. A C++ version and a Python version of the lx16a controller are included. Besides, a PS3 joy controller and a hokuyo laser can be used.

[![License: MIT](https://img.shields.io/badge/GitHub-MIT-informational)](https://opensource.org/license/mit) [![GitHub release](https://img.shields.io/github/release/mgonzs13/ros2_rover.svg)](https://github.com/mgonzs13/ros2_rover/releases) [![Code Size](https://img.shields.io/github/languages/code-size/mgonzs13/ros2_rover.svg?branch=humble)](https://github.com/mgonzs13/ros2_rover?branch=humble) [![Last Commit](https://img.shields.io/github/last-commit/mgonzs13/ros2_rover.svg)](https://github.com/mgonzs13/ros2_rover/commits/maihumblen) [![GitHub issues](https://img.shields.io/github/issues/mgonzs13/ros2_rover)](https://github.com/mgonzs13/ros2_rover/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr/mgonzs13/ros2_rover)](https://github.com/mgonzs13/ros2_rover/pulls) [![Contributors](https://img.shields.io/github/contributors/mgonzs13/ros2_rover.svg)](https://github.com/mgonzs13/ros2_rover/graphs/contributors) [![Python Formatter Check](https://github.com/mgonzs13/ros2_rover/actions/workflows/python-formatter.yml/badge.svg?branch=humble)](https://github.com/mgonzs13/ros2_rover/actions/workflows/python-formatter.yml?branch=humble) [![C++ Formatter Check](https://github.com/mgonzs13/ros2_rover/actions/workflows/cpp-formatter.yml/badge.svg?branch=humble)](https://github.com/mgonzs13/ros2_rover/actions/workflows/cpp-formatter.yml?branch=humble) | ROS 2 Distro | Branch | Build status | Docker Image | Documentation | | :----------: | :------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Humble** | [`humble`](https://github.com/mgonzs13/ros2_rover/tree/humble) | [![Humble Build](https://github.com/mgonzs13/ros2_rover/actions/workflows/humble-docker-build.yml/badge.svg?branch=humble)](https://github.com/mgonzs13/ros2_rover/actions/workflows/humble-docker-build.yml?branch=humble) | [![Docker Image](https://img.shields.io/badge/Docker%20Image%20-humble-blue)](https://hub.docker.com/r/mgons/rover/tags?name=humble) | [![Doxygen Deployment](https://github.com/mgonzs13/ros2_rover/actions/workflows/doxygen-deployment.yml/badge.svg)](https://mgonzs13.github.io/ros2_rover/latest) | | **Iron** | [`humble`](https://github.com/mgonzs13/ros2_rover/tree/humble) | [![Iron Build](https://github.com/mgonzs13/ros2_rover/actions/workflows/iron-docker-build.yml/badge.svg?branch=humble)](https://github.com/mgonzs13/ros2_rover/actions/workflows/iron-docker-build.yml?branch=humble) | [![Docker Image](https://img.shields.io/badge/Docker%20Image%20-iron-blue)](https://hub.docker.com/r/mgons/rover/tags?name=iron) | [![Doxygen Deployment](https://github.com/mgonzs13/ros2_rover/actions/workflows/doxygen-deployment.yml/badge.svg)](https://mgonzs13.github.io/ros2_rover/latest) |

Table of Contents

  1. Installation
  2. Usage
  3. Docker
  4. Gazebo Simulation
  5. Citations

Installation

shell cd ~/ros2_ws/src git clone https://github.com/mgonzs13/ros2_rover cd ~/ros2_ws rosdep install --from-paths src -r -y colcon build

Docker

You can create a docker image to test this repo. Use the following common inside the directory of ros2_rover.

shell docker build -t rover .

After the image is created, run a docker container with the following command.

shell docker run -it --rm rover

Usage

shell ros2 launch rover_bringup rover.launch.py

Linux Service

A Linux service can be created to control the execution and launch everything at boot time. To create the rover service, the following commands are used:

shell cd ~/ros2_ws/src/ros2_rover/rover_service sudo ./install.sh

Check rover service:

shell sudo service rover status

Gazebo Simulation

Moon

shell ros2 launch rover_gazebo moon.launch.py

Mars

shell ros2 launch rover_gazebo mars.launch.py

Forest

shell ros2 launch rover_gazebo forest.launch.py

Citations

The v0.7 version has been used in the work Comparison of Concentric Surface Planetary Explorations Using an Ackerman Rover in a Lunar Simulation from the 2024 International Conference on Space Robotics (iSpaRo).

bibtex @INPROCEEDINGS{10685849, author={González-Santamarta, Miguel Á. and Rodríguez-Lera, Francisco J.}, booktitle={2024 International Conference on Space Robotics (iSpaRo)}, title={Comparison of Concentric Surface Planetary Explorations Using an Ackerman Rover in a Lunar Simulation}, year={2024}, volume={}, number={}, pages={239-244}, keywords={Spirals;Navigation;Moon;Cameras;Sensors;Visual odometry;Testing}, doi={10.1109/iSpaRo60631.2024.10685849} }

Owner

  • Name: Miguel Ángel González Santamarta
  • Login: mgonzs13
  • Kind: user
  • Location: León
  • Company: University of León

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: "González-Santamarta"
    given-names: "Miguel Á."
title: "ros2_rover"
date-released: 2021-07-28
url: "https://github.com/mgonzs13/ros2_rover"

GitHub Events

Total
  • Create event: 7
  • Issues event: 7
  • Release event: 4
  • Watch event: 13
  • Issue comment event: 34
  • Push event: 31
  • Pull request event: 3
  • Fork event: 4
Last Year
  • Create event: 7
  • Issues event: 7
  • Release event: 4
  • Watch event: 13
  • Issue comment event: 34
  • Push event: 31
  • Pull request event: 3
  • Fork event: 4

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 180
  • Total Committers: 1
  • Avg Commits per committer: 180.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 37
  • Committers: 1
  • Avg Commits per committer: 37.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Miguel Ángel González Santamarta m****s@u****s 180
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 7 months ago

All Time
  • Total issues: 15
  • Total pull requests: 2
  • Average time to close issues: 3 months
  • Average time to close pull requests: 1 day
  • Total issue authors: 9
  • Total pull request authors: 1
  • Average comments per issue: 3.67
  • Average comments per pull request: 0.5
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 5
  • Pull requests: 2
  • Average time to close issues: 15 days
  • Average time to close pull requests: 1 day
  • Issue authors: 5
  • Pull request authors: 1
  • Average comments per issue: 6.0
  • Average comments per pull request: 0.5
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • samuk (6)
  • ROSRider (2)
  • Wwanghao1 (1)
  • Feedback02 (1)
  • marapakabannudeepak (1)
  • er1c-cartman (1)
  • knickels (1)
  • 2vin2vin (1)
  • Mechazo11 (1)
Pull Request Authors
  • knickels (2)
Top Labels
Issue Labels
stale (2)
Pull Request Labels

Dependencies

rover_motor_controller/setup.py pypi
  • setuptools *
rover_teleop/setup.py pypi
  • setuptools *
.github/workflows/close-inactive-issues.yml actions
  • actions/stale v5 composite
.github/workflows/cpp-formatter.yml actions
  • DoozyX/clang-format-lint-action v0.18.1 composite
  • actions/checkout v4 composite
.github/workflows/create-release.yml actions
  • actions/checkout v4 composite
  • actions/create-release latest composite
.github/workflows/doxygen-deployment.yml actions
  • actions/checkout v4 composite
  • mattnotmitt/doxygen-action edge composite
  • peaceiris/actions-gh-pages v4 composite
.github/workflows/humble-docker-build.yml actions
  • actions/checkout v4 composite
  • docker/build-push-action v6 composite
  • docker/setup-buildx-action v3 composite
.github/workflows/humble-docker-push.yml actions
  • actions/checkout v4 composite
  • docker/build-push-action v6 composite
  • docker/login-action v3 composite
  • docker/setup-buildx-action v3 composite
.github/workflows/iron-docker-build.yml actions
  • actions/checkout v4 composite
  • docker/build-push-action v6 composite
  • docker/setup-buildx-action v3 composite
.github/workflows/iron-docker-push.yml actions
  • actions/checkout v4 composite
  • docker/build-push-action v6 composite
  • docker/login-action v3 composite
  • docker/setup-buildx-action v3 composite
.github/workflows/python-formatter.yml actions
  • actions/checkout v4 composite
  • lgeiger/black-action master composite
Dockerfile docker
  • deps latest build
  • ros ${ROS_DISTRO} build