{"id":13500123,"url":"https://github.com/osrf/mbzirc","last_synced_at":"2025-07-07T17:03:51.378Z","repository":{"id":36982146,"uuid":"436454448","full_name":"osrf/mbzirc","owner":"osrf","description":"Simulator for the MBZIRC Maritime Grand Challenge","archived":false,"fork":false,"pushed_at":"2022-08-31T23:20:21.000Z","size":16779,"stargazers_count":73,"open_issues_count":39,"forks_count":46,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-31T18:38:38.466Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/osrf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-09T02:14:26.000Z","updated_at":"2024-10-30T07:18:13.000Z","dependencies_parsed_at":"2022-07-11T12:30:32.724Z","dependency_job_id":null,"html_url":"https://github.com/osrf/mbzirc","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osrf%2Fmbzirc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osrf%2Fmbzirc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osrf%2Fmbzirc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osrf%2Fmbzirc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osrf","download_url":"https://codeload.github.com/osrf/mbzirc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246145012,"owners_count":20730494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T22:00:51.512Z","updated_at":"2025-03-29T05:33:05.041Z","avatar_url":"https://github.com/osrf.png","language":"C++","funding_links":[],"categories":["Simulation environments"],"sub_categories":["Gazebo"],"readme":"# MBZIRC Maritime Grand Challenge Simulator\n\nThis repository contains simulation software created for the\nMBZIRC Maritime Grand Challenge.\n\nThis simulator will be enhanced with additional features throughout the simulation phase of the MBZIRC Maritime Grand Challenge.\n\n## Installation\n\n### Prerequsite\n\n* Platform: Ubuntu 20.04 (Focal)\n* Ignition Fortress\n* ROS2 Galactic\n\nSee Installation instructions for:\n\n* Ignition Fortress: https://ignitionrobotics.org/docs/fortress\n\n* ROS2 Galactic:  https://docs.ros.org/en/galactic/Installation/Ubuntu-Install-Debians.html\n\n\n### Installation from Source\n\n1. Create a colcon workspace and clone the mbzirc repo\n\n    ```\n    mkdir -p ~/mbzirc_ws/src\n    cd ~/mbzirc_ws/src\n    git clone https://github.com/osrf/mbzirc.git\n    ```\n\n1. Clone the `ros_ign` repo and check out the `galactic` branch\n\n    ```\n    cd ~/mbzirc_ws/src\n    git clone https://github.com/ignitionrobotics/ros_ign.git -b galactic\n    ```\n\n1. Install dependencies using [rosdep](https://docs.ros.org/en/galactic/Installation/Ubuntu-Install-Binary.html#installing-and-initializing-rosdep)\n\n    ```\n    cd ~/mbzirc_ws\n    rosdep update\n    rosdep install -r --from-paths src -i -y --rosdistro galactic\n    ```\n\n    Make sure the `ros-galactic-mavros-msgs` package is installed, e.g.\n\n    ```\n    dpkg -l | grep ros-galactic-mavros-msgs\n    ```\n\n    If not, install it:\n\n    ```\n    sudo apt install ros-galactic-mavros-msgs\n    ```\n\n1. Build the workspace\n\n    ```\n    cd ~/mbzirc_ws\n    IGNITION_VERSION=fortress colcon build --merge-install\n    ```\n\n    Note: Make sure to set the `IGNITION_VERSION` to `fortress`. This is needed for building the `ros_ign` package.\n\n### Docker setup\n\nDocker images are available on Docker Hub: https://hub.docker.com/repository/docker/osrf/mbzirc\n\n1. Pull the latest version of the docker image\n\n    ```\n    docker pull osrf/mbzirc:mbzirc_sim_latest\n    ```\n\n1. Clone the repo and launch a Docker container from the image using the `run.bash` script. Note: requires `nvidia-docker2`\n\n    ```\n    git clone https://github.com/osrf/mbzirc.git\n    cd mbzirc/docker\n    bash run.bash osrf/mbzirc:mbzirc_sim_latest  /bin/bash\n    ```\n\nTo build a docker image of the simulator locally:\n\n\n1. Navigate to the `docker` directory and build the `mbzirc_sim` Docker image\n\n    ```\n    cd mbzirc\n    bash docker/build.bash mbzirc_sim\n    ```\n\n1.  The process can take a few minutes. Once it is done, you can launch the\n Docker container:\n\n    ```\n    cd docker\n    bash run.bash mbzirc_sim\n    ```\n\n## Running the simulator\n\nPlease see the wiki:  https://github.com/osrf/mbzirc/wiki\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosrf%2Fmbzirc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosrf%2Fmbzirc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosrf%2Fmbzirc/lists"}