No version for distro humble showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro jazzy showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro kilted showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro lyrical showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro rolling showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro galactic showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro iron showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro melodic showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file

No version for distro noetic showing github. Known supported distros are highlighted in the buttons above.

Repository Summary

Description
Checkout URI https://github.com/lge-ros2/cloisim_ros.git
VCS Type git
VCS Version main
Last Updated 2026-07-14
Dev Status UNKNOWN
Released UNRELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

README

cloisim_ros (jazzy version)

ROS2 simulation device packages to connect CLOiSim(the unity3D based multi-robot simulator).

Download CLOiSim Simulator

  • Latest version: link
  • All Releases: link

Install ROS2 jazzy

follow the guideline on below link.

https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debians.html

Prerequisite

mkdir -p ~/cloisim_ws/src
cd ~/cloisim_ws/src
git clone --recursive https://github.com/lge-ros2/cloisim_ros.git -b jazzy

sudo apt update
sudo apt install -y python3-rosdep

sudo rosdep init
rosdep update
rosdep install -y -r -q --from-paths src --ignore-src --rosdistro jazzy

Build

Set up ROS2 environment first

source /opt/ros2/jazzy/setup.bash
cd ~/cloisim_ws
colcon build --symlink-install --packages-up-to cloisim_ros_bringup

Test

Build with testing enabled and run tests:

cd ~/cloisim_ws
colcon build --cmake-args -DBUILD_TESTING=ON
colcon test --event-handlers console_direct+
colcon test-result --all

To test specific packages only:

colcon build --packages-select cloisim_ros_lidar cloisim_ros_camera --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_lidar cloisim_ros_camera --event-handlers console_direct+
colcon test-result --all

Pre-push hook

To block pushes when tests fail, enable the repo-local git hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

By default the hook runs in auto mode. It inspects the refs being pushed, maps changed files back to colcon packages, builds the changed packages plus their dependents, and runs tests only for the directly changed packages.

git config hooks.cloisimRosPrePushScope auto

To force a single package instead:

git config hooks.cloisimRosPrePushScope package
git config hooks.cloisimRosPrePushPackage cloisim_ros_base

That mode runs:

colcon build --packages-up-to cloisim_ros_base --cmake-args -DBUILD_TESTING=ON
colcon test --packages-select cloisim_ros_base --event-handlers console_direct+
colcon test-result --verbose --test-result-base build/cloisim_ros_base

To force full workspace validation:

git config hooks.cloisimRosPrePushScope workspace

That mode runs:

```bash colcon build –cmake-args -DBUILD_TESTING=ON colcon test –event-handlers console_direct+

File truncated at 100 lines see the full file