Skip to content

Commit bf21f1f

Browse files
nkoenigNate Koenig
and
Nate Koenig
authored
[15] Acropolis ign (gazebosim#271)
* Rename Ignition to Gazebo in ci.md Signed-off-by: Nate Koenig <[email protected]> * Rename Ignition to Gazebo in contributing.md Signed-off-by: Nate Koenig <[email protected]> * Rename Ignition to Gazebo in release_features.md Signed-off-by: Nate Koenig <[email protected]> * Rename ignition to gazebo in release.md Signed-off-by: Nate Koenig <[email protected]> * Rename ignition in readme, and yaml files Signed-off-by: Nate Koenig <[email protected]> * Update releases.md Signed-off-by: Nate Koenig <[email protected]> * Rename ign in acropolis Signed-off-by: Nate Koenig <[email protected]> Co-authored-by: Nate Koenig <[email protected]>
1 parent 2b61d8d commit bf21f1f

File tree

5 files changed

+53
-53
lines changed

5 files changed

+53
-53
lines changed

acropolis/comparison.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Please refer to the latest supported version.**
55
# Feature comparison
66

77
A list of features present in [Gazebo-classic](https://github.com/osrf/gazebo/) and
8-
the status of their migration to [Ignition](https://gazebosim.org/).
8+
the status of their migration to [Gazebo](https://gazebosim.org/).
99

1010
## Sensors
1111

@@ -139,21 +139,21 @@ Position, resize and configure widgets | ✕ | ✓
139139

140140
## Physics
141141

142-
In Ignition Physics, physics engines are integrated as plugins, so any engine
142+
In Gazebo Physics, physics engines are integrated as plugins, so any engine
143143
can be integrated without changing the core source code, as it was the case
144144
in Gazebo.
145145

146146
Feature | Gazebo-classic | Gazebo Sim
147147
-- | -- | --
148148
ODE engine | ✓ |
149149
Bullet engine | ✓ |
150-
DART engine | ✓ | ✓ Plugin shipped with ign-physics
150+
DART engine | ✓ | ✓ Plugin shipped with gz-physics
151151
Simbody engine | ✓ |
152152
Custom engine plugins | ✕ | ✓
153153

154154
## Rendering
155155

156-
In Ignition Rendering, render engines are integrated as plugins, so any engine
156+
In Gazebo Rendering, render engines are integrated as plugins, so any engine
157157
can be integrated without changing the core source code.
158158

159159
Feature | Gazebo-classic | Gazebo Sim
@@ -167,11 +167,11 @@ Fog | ✓ |
167167

168168
## ROS integration
169169

170-
ROS integration with Ignition will be done primarily via a
170+
ROS integration with Gazebo will be done primarily via a
171171
transport bridge instead of plugins, contained in the
172-
[ros_ign](https://github.com/osrf/ros1_ign) package.
172+
[ros_gz](https://github.com/osrf/ros1_ign) package.
173173

174-
* **ROS 1**: See full message list at [ros_ign](https://github.com/osrf/ros_ign)
174+
* **ROS 1**: See full message list at [ros_gz](https://github.com/osrf/ros_ign)
175175
* **ROS 2**: Available from Blueprint
176176

177177
## Others
@@ -195,10 +195,10 @@ World plugins | ✓ | ✓ Now called System plugin
195195
Model plugins | ✓ | ✓ Now called System plugin
196196
Sensor plugins | ✓ |
197197
Visual plugins | ✓ |
198-
GUI plugins | ✓ | ✓ Ignition GUI plugins
198+
GUI plugins | ✓ | ✓ Gazebo GUI plugins
199199
System plugins | ✓ |
200200
Distribute simulation across processes | ✕ | (coming up)
201201
Incrementally load levels | ✕ | ✓
202-
Online model database | [gazebo_models repository](https://github.com/osrf/gazebo_models/) | [Ignition Fuel](https://app.gazebosim.org/fuel/models)
202+
Online model database | [gazebo_models repository](https://github.com/osrf/gazebo_models/) | [Gazebo Fuel](https://app.gazebosim.org/fuel/models)
203203
SDF frame semantics | |
204204
Saved simulation states | ✓ |

acropolis/index.yaml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# This file is an index of the pages to display on the documentation website
2-
# (https://ignitionrobotics.org/docs). The order of the pages in this file
2+
# (https://gazebosim.org/docs). The order of the pages in this file
33
# is reflected on the website's left sidebar.
44
#
55
# Components of the index:
@@ -26,4 +26,4 @@ pages:
2626
- name: comparison
2727
title: Feature Comparison
2828
file: comparison.md
29-
description: A list of features present in Gazebo-classic and the status of their migration to Ignition.
29+
description: A list of features present in Gazebo-classic and the status of their migration to Gazebo.

acropolis/install.md

+31-31
Original file line numberDiff line numberDiff line change
@@ -10,46 +10,46 @@ Acropolis supports the following platforms:
1010
* MacOS Mojave
1111

1212
Windows support is still experimental although most of the packages should work
13-
as expected. There are no binaries for Windows at this moment. The `ign-gazebo`
13+
as expected. There are no binaries for Windows at this moment. The `gz-sim`
1414
package is still not available for Windows, the installation should be done from
1515
source code.
1616

1717
## Acropolis Libraries
1818

19-
The Acropolis collection is composed by many different Ignition libraries. The
19+
The Acropolis collection is composed by many different Gazebo libraries. The
2020
collection assures that all libraries all compatible and can be used together.
2121

2222
| Library name | Version |
2323
| ------------------ |:-------------:|
24-
| ign-cmake | 2.x |
25-
| ign-common | 3.x |
26-
| ign-fuel-tools | 3.x |
27-
| ign-gazebo | 1.x |
28-
| ign-gui | 1.x |
29-
| ign-launch | 0.x |
30-
| ign-math | 6.x |
31-
| ign-msgs | 3.x |
32-
| ign-physics | 1.x |
33-
| ign-plugin | 1.x |
34-
| ign-rendering | 1.x |
35-
| ign-sensors | 1.x |
36-
| ign-tools | 0.x |
37-
| ign-transport | 6.x |
24+
| gz-cmake | 2.x |
25+
| gz-common | 3.x |
26+
| gz-fuel-tools | 3.x |
27+
| gz-sim | 1.x |
28+
| gz-gui | 1.x |
29+
| gz-launch | 0.x |
30+
| gz-math | 6.x |
31+
| gz-msgs | 3.x |
32+
| gz-physics | 1.x |
33+
| gz-plugin | 1.x |
34+
| gz-rendering | 1.x |
35+
| gz-sensors | 1.x |
36+
| gz-tools | 0.x |
37+
| gz-transport | 6.x |
3838
| sdformat | 8.x |
3939

4040
# Option 1: Installation on Ubuntu Bionic
4141

4242
All of the Acropolis binaries are hosted in the osrfoundation repository. To install
43-
all of them, the metapackage `ignition-acropolis` can be installed:
43+
all of them, the metapackage `gazebo-acropolis` can be installed:
4444

4545
```bash
4646
sudo sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list'
4747
wget http://packages.osrfoundation.org/gazebo.key -O - | sudo apt-key add -
4848
sudo apt-get update
49-
sudo apt-get install ignition-acropolis
49+
sudo apt-get install gazebo-acropolis
5050
```
5151

52-
All libraries should be ready to use and the `ign-gazebo` app ready to be executed.
52+
All libraries should be ready to use and the `gz-sim` app ready to be executed.
5353

5454
# Option 2: Install on MacOS Mojave (10.14)
5555

@@ -60,14 +60,14 @@ The homebrew tool can easily be installed using:
6060
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
6161
```
6262

63-
After installing the homebrew package manager, ignition acropolis can be installed running:
63+
After installing the homebrew package manager, Gazebo Acropolis can be installed running:
6464

6565
```bash
6666
brew tap osrf/simulation
67-
brew install ignition-acropolis
67+
brew install gazebo-acropolis
6868
```
6969

70-
All libraries should be ready to use and the `ign-gazebo` app ready to be executed.
70+
All libraries should be ready to use and the `gz-sim` app ready to be executed.
7171

7272
# Option 3: Source Installation (any platform)
7373

@@ -86,7 +86,7 @@ in all platforms:
8686
pip install vcstool
8787
```
8888

89-
To compile all the different libraries and ign-gazebo in the right order
89+
To compile all the different libraries and gz-sim in the right order
9090
it is recommended to use [colcon](https://colcon.readthedocs.io/en/released/).
9191
The colcon tool is available in all platforms using pip:
9292

@@ -121,14 +121,14 @@ mkdir -p ~/workspace/src
121121
cd ~/workspace/src
122122
```
123123

124-
All the sources of ignition-acropolis are declared in a yaml file. Download
124+
All the sources of gazebo-acropolis are declared in a yaml file. Download
125125
it to the workspace.
126126

127127
```bash
128-
wget https://raw.githubusercontent.com/ignition-tooling/gazebodistro/master/collection-acropolis.yaml
128+
wget https://raw.githubusercontent.com/gazebo-tooling/gazebodistro/master/collection-acropolis.yaml
129129
```
130130

131-
Use `vcstool` to automatically retrieve all the Ignition libraries sources from
131+
Use `vcstool` to automatically retrieve all the Gazebo libraries sources from
132132
their repositories:
133133

134134
```bash
@@ -156,9 +156,9 @@ install all dependencies in Ubuntu Bionic:
156156
sudo apt-get install cmake freeglut3-dev libavcodec-dev libavdevice-dev libavformat-dev libavutil-dev libdart6-collision-ode-dev libdart6-dev libdart6-utils-urdf-dev libfreeimage-dev libgflags-dev libglew-dev libgts-dev libogre-1.9-dev libogre-2.1-dev libprotobuf-dev libprotobuf-dev libprotoc-dev libqt5core5a libswscale-dev libtinyxml2-dev libtinyxml-dev pkg-config protobuf-compiler qml-module-qt-labs-folderlistmodel qml-module-qt-labs-settings qml-module-qtquick2 qml-module-qtquick-controls qml-module-qtquick-controls2 qml-module-qtquick-dialogs qml-module-qtquick-layouts qtbase5-dev qtdeclarative5-dev qtquickcontrols2-5-dev ruby ruby-ronn uuid-dev libgtest-dev curl libcurl4-gnutls-dev libcurl4-openssl-dev libsqlite3-dev
157157
```
158158

159-
## Building the Ignition Libraries
159+
## Building the Gazebo Libraries
160160

161-
The Ignition Libraries require the following compilers on each platform:
161+
The Gazebo Libraries require the following compilers on each platform:
162162

163163
* Ubuntu Bionic: gcc 8
164164
* MacOS Mojave: Xcode 10
@@ -197,7 +197,7 @@ cd ~/workspace/
197197
colcon list -g
198198
```
199199

200-
`colcon` should list the Ignition libraries with their
200+
`colcon` should list the Gazebo libraries with their
201201
interdependencies. If that is the case, then you are ready
202202
to build the whole set of libraries:
203203

@@ -209,8 +209,8 @@ If there are no errors, all the binaries should be ready to use.
209209

210210
## Using the workspace
211211

212-
The workspace binaries are ready but every time that `ign-gazebo` needs to be
213-
executed or third party code is going to be developed using the Ignition
212+
The workspace binaries are ready but every time that `gz-sim` needs to be
213+
executed or third party code is going to be developed using the Gazebo
214214
libraries, one command is needed:
215215

216216
```bash

acropolis/ros_integration.md

+11-11
Original file line numberDiff line numberDiff line change
@@ -4,20 +4,20 @@ Please refer to the latest supported version.**
44

55
# ROS Integration
66

7-
Most of the Ignition libraries use [Ignition Transport](https://github.com/gazebosim/gz-transport)
7+
Most of the Gazebo libraries use [Gazebo Transport](https://github.com/gazebosim/gz-transport)
88
to exchange data between different software components. This tutorial details
99
how to interface with [ROS](http://www.ros.org/), enabling the ability to use
1010
tools such as [Rviz](http://wiki.ros.org/rviz) for robot or sensor
1111
visualization.
1212

13-
# ros1_ign_bridge to the rescue
13+
# ros1_gz_bridge to the rescue
1414

15-
ros1_ign_bridge provides a network bridge which enables the exchange of messages
16-
between ROS 1 and Ignition Transport. Its support is limited to only certain
15+
ros1_gz_bridge provides a network bridge which enables the exchange of messages
16+
between ROS 1 and Gazebo Transport. Its support is limited to only certain
1717
message types. Please, read this [README](https://github.com/osrf/ros1_ign_bridge)
1818
to verify if your message type is supported by the bridge.
1919

20-
# How to install ros1_ign_bridge
20+
# How to install ros1_gz_bridge
2121

2222
## Binary install
2323

@@ -37,7 +37,7 @@ sudo apt install ros-melodic-desktop ros-melodic-rqt-image-view libignition-comm
3737

3838
# Run the bridge and exchange images
3939

40-
In this example, we're going to generate Ignition Transport images using Gazebo, that will be converted into ROS 1 images, and visualized with rqt_viewer.
40+
In this example, we're going to generate Gazebo Transport images using Gazebo, that will be converted into ROS 1 images, and visualized with rqt_viewer.
4141

4242
First we start a ROS 1 `roscore`:
4343

@@ -51,15 +51,15 @@ Then we start Gazebo.
5151

5252
```bash
5353
# Shell B:
54-
ign-gazebo -r -f camera_sensor.sdf
54+
gz sim -r -f camera_sensor.sdf
5555
```
5656

5757
Gazebo should be running and publishing images over the `/camera` topic.
5858
Let's verify it:
5959

6060
```bash
6161
# Shell C:
62-
ign topic -l | grep "^/camera"
62+
gz topic -l | grep "^/camera"
6363
/camera
6464
```
6565

@@ -68,7 +68,7 @@ Then we start the parameter bridge with the previous topic.
6868
```bash
6969
# Shell D:
7070
. ~/bridge_ws/install/setup.bash
71-
rosrun ros1_ign_bridge parameter_bridge /camera@sensor_msgs/[email protected]
71+
rosrun ros1_gz_bridge parameter_bridge /camera@sensor_msgs/[email protected]
7272
```
7373

7474
Now we start the ROS 1 GUI:
@@ -80,10 +80,10 @@ rqt_image_view /camera
8080
```
8181

8282
You should see the current images in `rqt_image_view` which are coming from
83-
Gazebo (published as Ignition Msgs over Ignition Transport).
83+
Gazebo (published as Gazebo Msgs over Gazebo Transport).
8484

8585
The screenshot shows all the shell windows and their expected content
8686
(it was taken using ROS Melodic):
8787

8888

89-
![Ignition Transport images and ROS 1 rqt](images/bridge_image_exchange_ign-gazebo.png)
89+
![Gazebo Transport images and ROS 1 rqt](images/bridge_image_exchange_gz-sim.png)

0 commit comments

Comments
 (0)