POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Guías avanzadas

Añadir un robot

Parte de un robot POSIM con una distribución parecida. El SDF describe la mecánica y los sistemas; la configuración ROS conecta medidas y comandos.

Entorno de trabajo

Usa las terminales Linux preparadas en Ubuntu nativo, WSL o Docker. En macOS, trabaja en la terminal del escritorio RDP. Edita y compila allí; POSIM_WS es la ruta de ese espacio de trabajo.

1. Copiar un modelo de referencia

REXROV usa propulsores Gazebo. BlueROV2 integra ArduSub/MAVROS. Slocum muestra otra disposición.

Desde $POSIM_WS, crea una copia completa de REXROV para conservar mallas, configuración del puente y nombres de tópicos:

cd "$POSIM_WS"

Guarda el siguiente programa como copy_robot.py y ejecuta python3 copy_robot.py. Se detiene si ya existe my_robot.

from pathlib import Path
import shutil

root = Path('src/posim/models/posim_robot_models')
directories = ('description', 'config', 'meshes')
if any((root / directory / 'my_robot').exists() for directory in directories):
    raise SystemExit('my_robot already exists; choose another model name.')
for directory in directories:
    shutil.copytree(root / directory / 'rexrov', root / directory / 'my_robot')
for relative in ('description/my_robot/model.sdf',
                 'description/my_robot/model.config',
                 'config/my_robot/robot_config.py'):
    target = root / relative
    target.write_text(target.read_text().replace('rexrov', 'my_robot'))

La estructura resultante incluye:

models/posim_robot_models/
  description/my_robot/model.sdf
  description/my_robot/model.config
  meshes/my_robot/RexROV_no_props.dae
  config/my_robot/robot_config.py

my_robot es el identificador elegido. El lanzamiento busca description/<namespace>/model.sdf y su configuración correspondiente.

2. Definir mecánica y recursos

Conserva la mecánica copiada para el primer lanzamiento. Al modificar el casco, revisa en conjunto:

Ruta SDF Unidad Comprobación
model/@name, nombres de eslabones y articulaciones identificador Coincidir con plugins y configuración ROS
link/inertial/mass kg Masa positiva de cada eslabón móvil
link/inertial/pose m, rad Centro de masa y orientación del sistema de inercia
link/inertial/inertia/ixx, iyy, izz kg·m² Momentos respecto a sus ejes
link/inertial/inertia/ixy, ixz, iyz kg·m² Términos cruzados; tensor completo físicamente válido
link/visual, link/collision m, rad Escala y alineación de geometrías
joint/axis, ajustes de propulsores según el plugin Dirección del actuador y distribución de fuerzas

STL aporta geometría. Define masa y dinámica en SDF y comprueba unidades y escala de la malla. Sigue las URI instaladas de los ejemplos existentes. Usa una geometría de colisión sencilla si el detalle visual encarece innecesariamente el cálculo de contactos.

3. Conectar sistemas y ROS

Adapta hidrodinámica, flotabilidad, ejes de propulsión y poses de sensores al vehículo. Los coeficientes deben representar sus propiedades físicas.

Consulta Corrientes, Añadir sensores y las referencias de cada plugin. Si necesitas latitud y longitud, configura el origen con Coordenadas esféricas.

Adapta config/<namespace>/robot_config.py: cambia de forma coherente nombres de entidades y articulaciones, tópicos, sistemas de referencia y puertos. El paquete ya instala description, meshes, config y los ajustes de búsqueda de recursos. Edita los archivos fuente, no los archivos generados en install/.

4. Compilar y probar

Desde el espacio de trabajo con su entorno cargado:

colcon build --merge-install --executor sequential --symlink-install
source install/setup.bash
ros2 launch posim_demos posim_robot.launch.py --show-args
ros2 launch posim_demos posim_robot.launch.py \
  namespace:=my_robot world_name:=posim_ocean_waves z:=-2 paused:=false \
  gui:=true headless:=false use_teleop:=false use_web_joystick:=false

Prueba cada eje con comandos de pequeña magnitud. Comprueba también el lanzamiento desde fuera del repositorio:

En otra terminal preparada, consulta el modelo renombrado:

ros2 topic echo --no-daemon /model/my_robot/odometry nav_msgs/msg/Odometry --once

Debes recibir posición y velocidad. Primero haz funcionar la copia, después cambia la mecánica y finalmente sensores o propulsión. Compara ejecuciones con Datos de sensores y consulta Solución de problemas si faltan recursos.