Der Umgang mit ROS2 - Versionsgeschichte

Marius Kuepper: /* Workspace bearbeiten */

2023-02-12T20:47:52Z

Workspace bearbeiten

← Nächstältere Version		Version vom 12. Februar 2023, 20:47 Uhr
Zeile 57:		Zeile 57:

	Zum Bearbeiten der unterschiedlichen Dateien und Dateiformate empfiehlt sich Visual Studio Code. Zudem erleichtert der integrierte Datei-Explorer das Navigieren in den Verzeichnissen des workspace's.<br>		Zum Bearbeiten der unterschiedlichen Dateien und Dateiformate empfiehlt sich Visual Studio Code. Zudem erleichtert der integrierte Datei-Explorer das Navigieren in den Verzeichnissen des workspace's.<br>
	Installation: <code>sudo apt install code</code><br>		Installation: <code>sudo apt snap install code</code>, oder durch eine manuelle Installation in den Anwendungen.<br>

	Visual Studio Code starten: <code>code</code><br>		Visual Studio Code starten: <code>code</code><br>

Marius Kuepper: /* Die erste Anwendung ausführen */

2023-02-12T20:45:04Z

Die erste Anwendung ausführen

← Nächstältere Version		Version vom 12. Februar 2023, 20:45 Uhr
Zeile 37:		Zeile 37:

	'''2.'''		'''2.'''
	Verwenden Sie "colcon build" im Verzeichnis "ros2_ws" um die Anwendung zu komprimieren.		Verwenden Sie "colcon build" im Verzeichnis "ros2_ws" um die Anwendung zu komprimieren.<br>
	<code>cd</code>		<code>cd</code><br>
	<code>cd ros2_ws</code>		<code>cd ros2_ws</code><br>
	<code>colcon build</code><br>		<code>colcon build</code><br>

Marius Kuepper am 3. Februar 2023 um 13:24 Uhr

2023-02-03T13:24:46Z

← Nächstältere Version		Version vom 3. Februar 2023, 13:24 Uhr
Zeile 56:		Zeile 56:
	'''Visual Studio Code'''		'''Visual Studio Code'''

	Zum Bearbeiten der unterschiedlichen Dateien und Dateiformate empfiehlt sich ~~Vidual~~ Studio Code. Zudem erleichtert der integrierte Datei-Explorer das Navigieren in den Verzeichnissen des workspace's.<br>		Zum Bearbeiten der unterschiedlichen Dateien und Dateiformate empfiehlt sich Visual Studio Code. Zudem erleichtert der integrierte Datei-Explorer das Navigieren in den Verzeichnissen des workspace's.<br>
	Installation: <code>sudo apt install code</code><br>		Installation: <code>sudo apt install code</code><br>

Marius Kuepper am 2. Februar 2023 um 22:19 Uhr

2023-02-02T22:19:57Z

← Nächstältere Version		Version vom 2. Februar 2023, 22:19 Uhr
Zeile 53:		Zeile 53:

	=== Workspace bearbeiten ===		=== Workspace bearbeiten ===
	[[Datei:MK-VSC.png\|right\|mini\|300px\|Abb.: Visual Studio Code<nowiki></nowiki>]]		[[Datei:MK-VSC.png\|right\|mini\|300px\|Abb.1: Visual Studio Code<nowiki></nowiki>]]
	'''Visual Studio Code'''		'''Visual Studio Code'''

Zeile 63:		Zeile 63:
	Jetzt können Sie den Workspace in Visual Studio Code öffnen.		Jetzt können Sie den Workspace in Visual Studio Code öffnen.
	<br clear = all>		<br clear = all>
	[[Datei:MK-packagexml.png\|right\|mini\|300px\|Abb.: package.xml<nowiki></nowiki>]]		[[Datei:MK-packagexml.png\|right\|mini\|300px\|Abb.2: package.xml<nowiki></nowiki>]]

	'''package.xml'''<br>		'''package.xml'''<br>
Zeile 69:		Zeile 69:
	Das Dokument ist eine XML-Datei, die zur Beschreibung eines ROS-Pakets verwendet wird. Sie gibt den Namen, die Version und die Abhängigkeiten des Pakets sowie die Dateien an, die in dem Paket enthalten sind. Kann mit Visual Studio Code bearbeitet werden.<br>		Das Dokument ist eine XML-Datei, die zur Beschreibung eines ROS-Pakets verwendet wird. Sie gibt den Namen, die Version und die Abhängigkeiten des Pakets sowie die Dateien an, die in dem Paket enthalten sind. Kann mit Visual Studio Code bearbeitet werden.<br>
	<br clear = all>		<br clear = all>
	[[Datei:MK-setuppy.png\|right\|mini\|300px\|Abb.: setup.py<nowiki></nowiki>]]		[[Datei:MK-setuppy.png\|right\|mini\|300px\|Abb.3: setup.py<nowiki></nowiki>]]
	'''setup.py'''<br>		'''setup.py'''<br>

	Die Datei setup.py ist ein Skript, das zur Installation von Python-Paketen verwendet wird. Es wird in der Regel mit dem Paketmanager [https://pypi.org/project/pip/ pip] verwendet, um Pakete aus dem [https://pypi.org/ Python Package Index (PyPI)] oder aus einem lokalen Quellcodeverzeichnis zu installieren.		Die Datei setup.py ist ein Skript, das zur Installation von Python-Paketen verwendet wird. Es wird in der Regel mit dem Paketmanager [https://pypi.org/project/pip/ pip] verwendet, um Pakete aus dem [https://pypi.org/ Python Package Index (PyPI)] oder aus einem lokalen Quellcodeverzeichnis zu installieren.
	<br clear = all>		<br clear = all>
	[[Datei:MK-launchpy.png\|right\|mini\|300px\|Abb.: launch.py<nowiki></nowiki>]]		[[Datei:MK-launchpy.png\|right\|mini\|300px\|Abb.4: launch.py<nowiki></nowiki>]]

	'''launch.py'''<br>		'''launch.py'''<br>
Zeile 85:		Zeile 85:
	<br clear = all>		<br clear = all>

	[[Datei:MK-world.png\|right\|mini\|300px\|Abb.: world.wbt<nowiki></nowiki>]]		[[Datei:MK-world.png\|right\|mini\|300px\|Abb.5: world.wbt<nowiki></nowiki>]]
	'''world.wbt'''<br>		'''world.wbt'''<br>

Marius Kuepper am 2. Februar 2023 um 16:53 Uhr

2023-02-02T16:53:15Z

← Nächstältere Version		Version vom 2. Februar 2023, 16:53 Uhr
Zeile 100:		Zeile 100:

	<br clear = all>		<br clear = all>

			'''[[Anleitung zum einfachen Einstieg in ROS2\|<- Zurück zum Hauptartikel]]'''

Marius Kuepper: Die Seite wurde neu angelegt: „=== Workspace erstellen === Um mit ROS2 ein Projekt zu bearbeiten, muss als Erstes ein workspace erstellt werden. Dazu liefert ROS2 einige praktische Befehle, um die Erstellung zu vereinfachen. Ein workspace ist ein Verzeichnis mit Unterordnern. In dem Verzeichnis werden die Pakete (package) erstellt. '''1.''' Zunächst muss wieder das Environment gesourcet werden. Im Fall von Ubuntu 22.04 (Humble): `source /opt/ros/humble/setup.bash` Im Fal…“

2023-02-02T13:07:42Z

Die Seite wurde neu angelegt: „=== Workspace erstellen === Um mit ROS2 ein Projekt zu bearbeiten, muss als Erstes ein workspace erstellt werden. Dazu liefert ROS2 einige praktische Befehle, um die Erstellung zu vereinfachen. Ein workspace ist ein Verzeichnis mit Unterordnern. In dem Verzeichnis werden die Pakete (package) erstellt. '''1.''' Zunächst muss wieder das Environment gesourcet werden. Im Fall von Ubuntu 22.04 (Humble): <code>source /opt/ros/humble/setup.bash</code> Im Fal…“

Neue Seite

=== Workspace erstellen ===
Um mit ROS2 ein Projekt zu bearbeiten, muss als Erstes ein workspace erstellt werden. Dazu liefert ROS2 einige praktische Befehle, um die Erstellung zu vereinfachen. Ein workspace ist ein Verzeichnis mit Unterordnern. In dem Verzeichnis werden die Pakete (package) erstellt.

'''1.'''
Zunächst muss wieder das Environment gesourcet werden.

Im Fall von Ubuntu 22.04 (Humble):
<code>source /opt/ros/humble/setup.bash</code>

Im Fall von Ubuntu 20.04 (Galactic):
<code>source /opt/ros/galactic/setup.bash</code>

'''2.'''
Erstellen Sie nun das Verzeichnis vom workspace.
<code>mkdir -p ~/ros2_ws/src</code> In diesem Fall heißt das Verzeichnis "ros2_ws". Außerdem wurde in dem Verzeichnis der Unterordner "src" erstellt. Dieser dient später der Übersichtlichkeit, da die Pakete in "src" abgelegt werden und mehrere Pakete im workspace vorliegen können.

'''3.'''
Navigieren Sie ins src-Verzeichnis.
<code>cd ~/ros2_ws/src</code>

'''4.'''
Erstellen Sie das erste Paket im workspace.
<code>ros2 pkg create --build-type ament_python (Paketname)</code>
Wählen Sie einen (Paketnamen) für sich aus.

Beispiel: <code>ros2 pkg create --build-type ament_python mein_paket</code>

Das Terminal sollte nun folgendes ausgeben:
[Bild]
Sollten Sie bei der Bearbeitung ihrer Pakete C++ bevorzugen, können Sie den Befehl <code>ros2 pkg create --build-type ament_cmake (Paketname)</code> verwenden.
Das Paket enthält alle zunächst benötigten Verzeichnisse und Dateien.

=== Die erste Anwendung ausführen ===
'''1.'''
Wenn Sie den Befehl mit dem Zusatz "--node-name (Knoten-Name)" verwenden, erstellen Sie außerdem noch eine einfache Anwendung, welche "Hello Word" ins Terminal ausgibt.
<code>ros2 pkg create --build-type ament_python --node-name mein_node mein_paket</code> 

'''2.'''
Verwenden Sie "colcon build" im Verzeichnis "ros2_ws" um die Anwendung zu komprimieren.
<code>cd</code>
<code>cd ros2_ws</code>
<code>colcon build</code> 

(Falls der workspace viele Pakete enthällt ist es sinvoll nur die benötigten Pakte mit "colcon build" zu generieren: <code>colcon build --packages-select mein_paket</code> Andernfalls kann es zu längeren Wartezeiten führen.) 

'''3.'''
Anwendung und ROS2-Installation im Verzeichnis "ros2_ws" verknüpfen.
<code>source install/local_setup.bash</code> 

'''4.'''
Anwendung ausführen.
<code>ros2 run mein_paket mein_node</code> 

=== Workspace bearbeiten ===
[[Datei:MK-VSC.png|right|mini|300px|Abb.: Visual Studio Code<nowiki></nowiki>]]
'''Visual Studio Code'''

Zum Bearbeiten der unterschiedlichen Dateien und Dateiformate empfiehlt sich Vidual Studio Code. Zudem erleichtert der integrierte Datei-Explorer das Navigieren in den Verzeichnissen des workspace's. 
Installation: <code>sudo apt install code</code> 

Visual Studio Code starten: <code>code</code> 

Jetzt können Sie den Workspace in Visual Studio Code öffnen.
 
[[Datei:MK-packagexml.png|right|mini|300px|Abb.: package.xml<nowiki></nowiki>]]

'''package.xml''' 

Das Dokument ist eine XML-Datei, die zur Beschreibung eines ROS-Pakets verwendet wird. Sie gibt den Namen, die Version und die Abhängigkeiten des Pakets sowie die Dateien an, die in dem Paket enthalten sind. Kann mit Visual Studio Code bearbeitet werden. 
 
[[Datei:MK-setuppy.png|right|mini|300px|Abb.: setup.py<nowiki></nowiki>]]
'''setup.py''' 

Die Datei setup.py ist ein Skript, das zur Installation von Python-Paketen verwendet wird. Es wird in der Regel mit dem Paketmanager [https://pypi.org/project/pip/ pip] verwendet, um Pakete aus dem [https://pypi.org/ Python Package Index (PyPI)] oder aus einem lokalen Quellcodeverzeichnis zu installieren.
 
[[Datei:MK-launchpy.png|right|mini|300px|Abb.: launch.py<nowiki></nowiki>]]

'''launch.py''' 

Die Datei launch.py ist ein Python-Skript, das zum Starten eines ROS2-Knoten oder einer Gruppe von Knoten verwendet wird. Es ist Teil des Launch-Frameworks, einem Werkzeug zur Organisation und Verwaltung des Starts mehrerer ROS2-Knoten und wird nicht beim Erstellen eines workspaces generiert. Die Funktion "generate_launch_description()" ist der Haupteinstiegspunkt in der Datei launch.py. Sie gibt eine LaunchDescription-Funktion zurück, welche eine Liste von Funktionen ist, die die Knoten und andere Ressourcen definieren, die gestartet werden sollen.

Die LaunchDescription kann auch andere Arten von Funktionen enthalten, wie "IncludeLaunchDescription" und "ExecuteProcess", die es ermöglichen, den Inhalt anderer launch.py-Dateien einzuschließen oder externe Prozesse zu starten.

Für eine genaue Aufschlüsselung der Funktionen empfehle ich den Artikel [https://roboticscasual.com/tutorial-ros2-launch-files-all-you-need-to-know/ "ROS2 launch files"] von roboticscasual.com. Dort wird erklärt, wie man von Grund auf eine Launch-Datei erstellt.
 

[[Datei:MK-world.png|right|mini|300px|Abb.: world.wbt<nowiki></nowiki>]]
'''world.wbt''' 

Die world-Datei definiert das Layout der Simulationsumgebung in Webots. Sie enthält Informationen über die Objekte, Materialien und Eigenschaften in der Umgebung sowie die Startposition und Ausrichtung des Roboters.

'''Geometrie:''' Die Form, Größe und Position von Objekten in der Umgebung.
'''Materialien:''' Die physikalischen Eigenschaften von Objekten, wie z. B. ihre Dichte, Reibung und Rückprallverhalten.
'''Beleuchtung:''' Die Position und Intensität von Lichtquellen in der Umgebung.
'''Roboter:''' Die Form, Größe und Ausgangsposition des Roboters.
'''Sensoren:''' Art, Position und Ausrichtung der Sensoren am Roboter, z. B. Kameras und Laser.
'''Aktuatoren:''' Typ, Position und Ausrichtung der Aktoren am Roboter, z. B. Räder oder Gelenke.

Das spezifische Format und die Syntax einer Weltdatei hängen von der verwendeten Physik-Engine ab. Webots verwendet ".wbt", ein proprietäres XML-basiertes Format für seine Welt-Dateien.