自定义载具
载具 SDF 描述连杆、几何、质量、惯性、关节、传感器和插件。请从所选载具的导出文件开始,以保持与当前引擎兼容的连接。
下载、编辑并应用
- 在工作区选择地形和载具,打开启动前检查页面。
- 在编辑 SDF 文件中选择下载载具 SDF。内置配置会先保存为生成载具的修订版。
- 编辑
model.sdf的副本。保留名称、连杆结构、插件标识、资源路径和话题。 - 选择上传修改后的载具 SDF。验证会创建并选中新修订版,原始版本仍可使用。
- 启动世界,先检查静止状态,再发送运动指令。修改已保存文件不会改变正在运行的世界。
生成 SDF 的编辑保留构建器选定的结构。添加或删除传感器、切换控制模式或提供程序时,请使用编辑副本。原生插件必须已安装在引擎中;上传 SDF 不会安装软件。
逐段阅读模型
| 段落 | 含义与编辑方式 |
|---|---|
model / pose |
模型参考位姿。工作区会把载具放在所选地理起点。 |
link / pose |
连杆相对父坐标系的位姿。平移以米计,横滚、俯仰、偏航以弧度计。 |
inertial / mass, pose |
质量(kg)和质心坐标系,应与实际尺寸一致。 |
inertia |
惯性张量的六个独立分量,单位 kg·m²。使用 CAD 或测得的质量分布;非正定或不满足物理条件的张量会被拒绝。 |
visual / geometry |
显示几何与网格缩放。修改显示形状不会自动修改碰撞几何和质量。 |
collision / geometry |
接触计算形状;尽量使用与船体一致的简单闭合形状。 |
joint / pose / axis |
关节位置与轴向。保留关节及父子连杆名称,以维持推进与控制连接。 |
| 水动力与浮力插件 | 排水、附加质量和阻力。符号约定见海洋动力学与渲染。 |
| 推进与控制插件 | 轴向、系数和控制通道。改变几何后应检查低速响应。 |
sensor 及传感器插件 |
安装位置、频率、光学、声学和噪声,见自定义传感器。 |
可在模板结构和传感器限制范围内修改数值与布尔值。启动检查页面的上传上限为 1 MB。验证失败时,修正指出的 SDF 路径后重试。
完整示例包含已安装模型的实际值,并非所有实物载具通用的标定结果。示例由 Linux 引擎导出;在 macOS 等其他主机上,应使用该主机自己的导出文件,并保存包含网格的 ZIP。插件库应与已安装的引擎匹配。
完整 WAM-V SDF
下载 WAM-V model.sdf。示例启用了前向和下视相机、DVL、二维激光雷达、Autopilot 和 GNSS。其他支持的选项以未启用的注释示例列出。
wamv.sdf
<?xml version='1.0' encoding='utf-8'?>
<sdf xmlns:gz="http://gazebosim.org" version="1.7">
<!--
模型结构:link 定义刚体,joint 连接刚体,plugin 提供仿真功能。模型、连杆和关节名称必须与导出的控制器配置保持一致。
-->
<model name="wamv">
<!--
导出的载具配置。此注释之后是启用的模型。请在载具编辑器中选择传感器和提供方,以保持话题连接与世界系统一致。安装范围:位置 ±10 m,旋转 ±2π rad。recipe.json:
{
"control_mode": "autopilot",
"gnss": true,
"schema_version": 1,
"sensors": [
"camera",
"camera_down",
"dvl",
"lidar_2d"
],
"settings": {
"camera": {
"height": 480,
"horizontal_fov": 1.4,
"pose": [
1.5,
0.0,
0.8,
0.0,
0.0,
0.0
],
"update_rate": 5,
"width": 640
},
"camera_down": {
"height": 600,
"horizontal_fov": 1.4,
"pose": [
0.0,
0.0,
-0.5,
0.0,
1.5707963267948966,
0.0
],
"update_rate": 5,
"width": 800
},
"dvl": {
"pose": [
0.0,
0.0,
-0.5,
0.0,
0.0,
0.0
],
"range_max": 20,
"update_rate": 1
},
"lidar_2d": {
"pose": [
0.0,
0.0,
2.5,
0.0,
0.0,
0.0
],
"range_max": 50,
"update_rate": 5
}
},
"vehicle": "wamv"
}
-->
<enable_wind>true</enable_wind>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="base_link">
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="visual">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/04f3ad2d4ac28cde0632b52f0ffaf7bb5f09da574a1a0b1402122ff2e1f2fbea.dae</uri>
</mesh>
</geometry>
</visual>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="collision">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/31b5b6c712bf5c02a523be90f933526bf7a53b6abd84e2e279d8daabec043807.stl</uri>
</mesh>
</geometry>
</collision>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 0 0 0</pose>
<mass>180</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>120</ixx>
<ixy>0</ixy>
<iyy>393</iyy>
<iyz>0</iyz>
<izz>446</izz>
</inertia>
</inertial>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_camera" type="camera">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/camera</topic>
<!--
相机配置:horizontal_fov 是水平视场角(弧度),width/height 是图像尺寸(像素)。clip 中 near/far
是渲染距离(米);camera_info_topic 发布标定信息。
-->
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>640</width>
<height>480</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera/camera_info</camera_info_topic>
</camera>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>1.5 0.0 0.8 0.0 0.0 0.0</pose>
<frame_id>vehicle/camera</frame_id>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_camera_down" type="camera">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/camera_down</topic>
<!--
相机配置:horizontal_fov 是水平视场角(弧度),width/height 是图像尺寸(像素)。clip 中 near/far
是渲染距离(米);camera_info_topic 发布标定信息。
-->
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>800</width>
<height>600</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera_down/camera_info</camera_info_topic>
</camera>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 0.0 -0.5 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/camera_down</frame_id>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_dvl" type="custom" gz:type="dvl">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 0.0 -0.5 0.0 0.0 0.0</pose>
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>1</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/dvl</topic>
<!--
DVL 波束布局与海底跟踪设置。arrangement 指定角度单位,距离和分辨率使用米。世界需启用 DopplerVelocityLogSystem,ROS
适配器发布速度与状态。
-->
<gz:dvl>
<type>phased_array</type>
<arrangement degrees="true">
<beam id="1">
<aperture>2</aperture>
<rotation>45</rotation>
<tilt>30</tilt>
</beam>
<beam id="2">
<aperture>2</aperture>
<rotation>135</rotation>
<tilt>30</tilt>
</beam>
<beam id="3">
<aperture>2</aperture>
<rotation>-45</rotation>
<tilt>30</tilt>
</beam>
<beam id="4">
<aperture>2</aperture>
<rotation>-135</rotation>
<tilt>30</tilt>
</beam>
</arrangement>
<tracking>
<bottom_mode>
<when>best</when>
<!--
测量噪声。高斯噪声的 mean 和 stddev 与被测量使用相同单位,stddev 控制随机波动幅度。
-->
<noise type="gaussian">
<stddev>0.002</stddev>
</noise>
<visualize>false</visualize>
</bottom_mode>
</tracking>
<resolution>0.01</resolution>
<maximum_range>20</maximum_range>
<minimum_range>0.1</minimum_range>
<reference_frame>0 0 0 0 0 0</reference_frame>
</gz:dvl>
<frame_id>vehicle/dvl</frame_id>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_lidar_2d" type="gpu_lidar">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/lidar_2d</topic>
<!--
基于射线的测距传感器。scan 设置水平和垂直采样数及角度(弧度),range 设置距离范围与分辨率(米)。Single Ping 也使用此 GPU 射线实现。
-->
<lidar>
<scan>
<horizontal>
<samples>360</samples>
<resolution>1</resolution>
<min_angle>-3.141592653589793</min_angle>
<max_angle>3.141592653589793</max_angle>
</horizontal>
</scan>
<range>
<min>0.1</min>
<max>50</max>
<resolution>0.01</resolution>
</range>
</lidar>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 0.0 2.5 0.0 0.0 0.0</pose>
<frame_id>vehicle/lidar_2d</frame_id>
</sensor>
<!--
可选传感器 camera 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
width: 64 … 1920 px
height: 64 … 1920 px
horizontal_fov: 0.1 … 3 rad
width * height * update_rate <= 30000000 px/s
Gazebo: /vehicle/sensors/camera
frame_id: vehicle/camera
ROS: /vehicle/sensors/camera (sensor_msgs/msg/Image)
ROS: /vehicle/sensors/camera/camera_info (sensor_msgs/msg/CameraInfo)
<sensor name="payload_camera" type="camera">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/camera</topic>
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>640</width>
<height>480</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera/camera_info</camera_info_topic>
</camera>
<pose>1.5 0.0 0.8 0.0 0.0 0.0</pose>
<frame_id>vehicle/camera</frame_id>
</sensor>
-->
<!--
可选传感器 camera_down 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
width: 64 … 1920 px
height: 64 … 1920 px
horizontal_fov: 0.1 … 3 rad
width * height * update_rate <= 30000000 px/s
Gazebo: /vehicle/sensors/camera_down
frame_id: vehicle/camera_down
ROS: /vehicle/sensors/camera_down (sensor_msgs/msg/Image)
ROS: /vehicle/sensors/camera_down/camera_info (sensor_msgs/msg/CameraInfo)
<sensor name="payload_camera_down" type="camera">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/camera_down</topic>
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>800</width>
<height>600</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera_down/camera_info</camera_info_topic>
</camera>
<pose>0.0 0.0 -0.5 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/camera_down</frame_id>
</sensor>
-->
<!--
可选传感器 ping_down 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
range_max: 1 … 100 m
Gazebo: /vehicle/sensors/ping_down
frame_id: vehicle/ping_down
ROS: /vehicle/sensors/ping_down (sensor_msgs/msg/LaserScan)
ROS: /vehicle/sensors/ping_down/range (sensor_msgs/msg/Range)
runtime: practice_ping.py
DVL 与 Single Ping 只能选择其一,不能同时启用。
<sensor name="payload_ping_down" type="gpu_lidar">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/ping_down</topic>
<lidar>
<scan>
<horizontal>
<samples>5</samples>
<resolution>1</resolution>
<min_angle>-0.00872665</min_angle>
<max_angle>0.00872665</max_angle>
</horizontal>
<vertical>
<samples>5</samples>
<resolution>1</resolution>
<min_angle>-0.00872665</min_angle>
<max_angle>0.00872665</max_angle>
</vertical>
</scan>
<range>
<min>0.1</min>
<max>30</max>
<resolution>0.01</resolution>
</range>
</lidar>
<pose>0.0 0.0 -0.5 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/ping_down</frame_id>
</sensor>
-->
<!--
可选传感器 multibeam_forward 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
Gazebo: /vehicle/sensors/multibeam_forward
frame_id: vehicle/multibeam_forward
ROS: /vehicle/sensors/multibeam_forward/sonar_image_raw (marine_acoustic_msgs/msg/ProjectedSonarImage)
需要兼容的 POSIM 声学声呐提供方及其世界系统。未安装提供方时仍可参考此示例。射线与声学字段为提供方默认值;载具编辑器提供更新频率和安装位姿设置。
<sensor xmlns:gz="http://gazebosim.org" name="payload_multibeam_forward" type="custom" gz:type="multibeam_sonar">
<always_on>true</always_on>
<update_rate>2</update_rate>
<topic>/vehicle/sensors/multibeam_forward</topic>
<visualize>true</visualize>
<gz:multibeam_sonar>
<ray degrees="false">
<scan>
<horizontal>
<beams>256</beams>
<min_angle>-1.0471975511965976</min_angle>
<max_angle>1.0471975511965976</max_angle>
</horizontal>
<vertical>
<rays>256</rays>
<min_angle>-0.17453292519943295</min_angle>
<max_angle>0.17453292519943295</max_angle>
</vertical>
</scan>
<range>
<min>0.2</min>
<max>15</max>
</range>
</ray>
<spec>
<verticalFOV>20</verticalFOV>
<sonarFreq>700e3</sonarFreq>
<bandwidth>29.9e3</bandwidth>
<soundSpeed>1500</soundSpeed>
<sourceLevel>220</sourceLevel>
<maxDistance>15</maxDistance>
<raySkips>1</raySkips>
<sensorGain>0.02</sensorGain>
<writeLog>false</writeLog>
<debugFlag>false</debugFlag>
<writeFrameInterval>5</writeFrameInterval>
<pointCloudTopicName>geometry/points</pointCloudTopicName>
<sonarImageRawTopicName>sonar_image_raw</sonarImageRawTopicName>
<sonarImageTopicName>sonar_image</sonarImageTopicName>
<frameName>vehicle/multibeam_forward</frameName>
<visibilityMask>3892314111</visibilityMask>
</spec>
</gz:multibeam_sonar>
<pose>1.5 0.0 -0.5 0.0 0.35 0.0</pose>
<frame_id>vehicle/multibeam_forward</frame_id>
</sensor>
-->
<!--
可选传感器 dvl 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
range_max: 1 … 100 m
Gazebo: /vehicle/sensors/dvl
frame_id: vehicle/dvl
ROS: /vehicle/sensors/dvl/velocity (geometry_msgs/msg/Vector3Stamped)
ROS: /vehicle/sensors/dvl/status (std_msgs/msg/String)
runtime: practice_dvl_bridge.py
DVL 与 Single Ping 只能选择其一,不能同时启用。
<sensor xmlns:gz="http://gazebosim.org" name="payload_dvl" type="custom" gz:type="dvl">
<pose>0.0 0.0 -0.5 0.0 0.0 0.0</pose>
<always_on>true</always_on>
<update_rate>1</update_rate>
<topic>/vehicle/sensors/dvl</topic>
<gz:dvl>
<type>phased_array</type>
<arrangement degrees="true">
<beam id="1">
<aperture>2</aperture>
<rotation>45</rotation>
<tilt>30</tilt>
</beam>
<beam id="2">
<aperture>2</aperture>
<rotation>135</rotation>
<tilt>30</tilt>
</beam>
<beam id="3">
<aperture>2</aperture>
<rotation>-45</rotation>
<tilt>30</tilt>
</beam>
<beam id="4">
<aperture>2</aperture>
<rotation>-135</rotation>
<tilt>30</tilt>
</beam>
</arrangement>
<tracking>
<bottom_mode>
<when>best</when>
<noise type="gaussian">
<stddev>0.002</stddev>
</noise>
<visualize>false</visualize>
</bottom_mode>
</tracking>
<resolution>0.01</resolution>
<maximum_range>20</maximum_range>
<minimum_range>0.1</minimum_range>
<reference_frame>0 0 0 0 0 0</reference_frame>
</gz:dvl>
<frame_id>vehicle/dvl</frame_id>
</sensor>
-->
<!--
可选传感器 lidar_2d 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
range_max: 1 … 100 m
Gazebo: /vehicle/sensors/lidar_2d
frame_id: vehicle/lidar_2d
ROS: /vehicle/sensors/lidar_2d (sensor_msgs/msg/LaserScan)
<sensor name="payload_lidar_2d" type="gpu_lidar">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/lidar_2d</topic>
<lidar>
<scan>
<horizontal>
<samples>360</samples>
<resolution>1</resolution>
<min_angle>-3.141592653589793</min_angle>
<max_angle>3.141592653589793</max_angle>
</horizontal>
</scan>
<range>
<min>0.1</min>
<max>50</max>
<resolution>0.01</resolution>
</range>
</lidar>
<pose>0.0 0.0 2.5 0.0 0.0 0.0</pose>
<frame_id>vehicle/lidar_2d</frame_id>
</sensor>
-->
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="left_engine_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-2.373776 1.027135 0.318237 0 0 0</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="visual">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/4fc1c298164ee6bb48d06e66af95a8eec7a63ffaf822b4226750043b316d4e2e.dae</uri>
</mesh>
</geometry>
</visual>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="engine_vertical_axis_collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.16 0 -0.215 0 0 0</pose>
<geometry>
<box>
<size>0.2 0.1 0.83</size>
</box>
</geometry>
</collision>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="engine_rear_end_collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.34 0 0.12 0 0 0</pose>
<geometry>
<box>
<size>0.12 0.15 0.12</size>
</box>
</geometry>
</collision>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>15</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.88924</ixx>
<ixy>0</ixy>
<iyy>0.911125</iyy>
<iyz>0</iyz>
<izz>0.078125</izz>
</inertia>
</inertial>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="left_engine_joint" type="fixed">
<parent>base_link</parent>
<child>left_engine_link</child>
</joint>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="right_engine_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-2.373776 -1.027135 0.318237 0 0 0</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="visual">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/4fc1c298164ee6bb48d06e66af95a8eec7a63ffaf822b4226750043b316d4e2e.dae</uri>
</mesh>
</geometry>
</visual>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="engine_vertical_axis_collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.16 0 -0.215 0 0 0</pose>
<geometry>
<box>
<size>0.2 0.1 0.83</size>
</box>
</geometry>
</collision>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="engine_rear_end_collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.34 0 0.12 0 0 0</pose>
<geometry>
<box>
<size>0.12 0.15 0.12</size>
</box>
</geometry>
</collision>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>15</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.88924</ixx>
<ixy>0</ixy>
<iyy>0.911125</iyy>
<iyz>0</iyz>
<izz>0.078125</izz>
</inertia>
</inertial>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="right_engine_joint" type="fixed">
<parent>base_link</parent>
<child>right_engine_link</child>
</joint>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="left_propeller_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="left_propeller_joint">0 0 0 0 0 0</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="visual">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/2c891453932798e772dab9792855c0ff84fc0315a662eb1c872f8e16bb692c25.dae</uri>
</mesh>
</geometry>
</visual>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.11 0 0 0 1.570796 0</pose>
<geometry>
<cylinder>
<length>0.08</length>
<radius>0.24</radius>
</cylinder>
</geometry>
</collision>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.5</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.008545</ixx>
<ixy>0</ixy>
<iyy>0.008545</iyy>
<iyz>0</iyz>
<izz>0.0144</izz>
</inertia>
</inertial>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="left_propeller_joint" type="revolute">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="left_engine_link">-0.278156 0 -0.509371 0 0 0</pose>
<parent>left_engine_link</parent>
<child>left_propeller_link</child>
<axis>
<xyz>1 0 0</xyz>
<dynamics>
<damping>0.01</damping>
</dynamics>
<limit>
<lower>-1e+16</lower>
<upper>1e+16</upper>
</limit>
</axis>
</joint>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="right_propeller_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="right_propeller_joint">0 0 0 0 0 0</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="visual">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/2c891453932798e772dab9792855c0ff84fc0315a662eb1c872f8e16bb692c25.dae</uri>
</mesh>
</geometry>
</visual>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.11 0 0 0 1.570796 0</pose>
<geometry>
<cylinder>
<length>0.08</length>
<radius>0.24</radius>
</cylinder>
</geometry>
</collision>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.5</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.008545</ixx>
<ixy>0</ixy>
<iyy>0.008545</iyy>
<iyz>0</iyz>
<izz>0.0144</izz>
</inertia>
</inertial>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="right_propeller_joint" type="revolute">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="right_engine_link">-0.278156 0 -0.509371 0 0 0</pose>
<parent>right_engine_link</parent>
<child>right_propeller_link</child>
<axis>
<xyz>1 0 0</xyz>
<dynamics>
<damping>0.01</damping>
</dynamics>
<limit>
<lower>-1e+16</lower>
<upper>1e+16</upper>
</limit>
</axis>
</joint>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="imu_link">
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 0 0 0</pose>
<mass>0.15</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.00001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.00002</iyy>
<iyz>0</iyz>
<izz>0.00002</izz>
</inertia>
</inertial>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="imu_sensor" type="imu">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 3.141593 0 0</pose>
<always_on>1</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>200</update_rate>
</sensor>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="imu_joint" type="fixed">
<child>imu_link</child>
<parent>base_link</parent>
</joint>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>wamv</namespace>
<joint_name>left_propeller_joint</joint_name>
<use_angvel_cmd>0</use_angvel_cmd>
<fluid_density>1000</fluid_density>
<propeller_diameter>0.48</propeller_diameter>
<thrust_coefficient>0.01</thrust_coefficient>
<velocity_control>1</velocity_control>
<max_thrust_cmd>2000.0</max_thrust_cmd>
<min_thrust_cmd>-2000.0</min_thrust_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>wamv</namespace>
<joint_name>right_propeller_joint</joint_name>
<use_angvel_cmd>0</use_angvel_cmd>
<fluid_density>1000</fluid_density>
<propeller_diameter>0.48</propeller_diameter>
<thrust_coefficient>0.01</thrust_coefficient>
<velocity_control>1</velocity_control>
<max_thrust_cmd>2000.0</max_thrust_cmd>
<min_thrust_cmd>-2000.0</min_thrust_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<plugin filename="/opt/wwos/competition_hydrodynamics/lib/libwwos-competition-hydrodynamics.so" name="gz::sim::systems::CompetitionHydrodynamics">
<enable>wamv::base_link</enable>
<!--
流体力系数。damping_on、viscous_drag_on 和 pressure_drag_on 分别启用阻尼、黏性阻力和压力阻力。cDampL/R
调整平动与转动阻尼;压力阻力系数须采用适用于此插件模型的数值。
-->
<hydrodynamics>
<damping_on>1</damping_on>
<viscous_drag_on>1</viscous_drag_on>
<pressure_drag_on>1</pressure_drag_on>
<cDampL1>1.0E-6</cDampL1>
<cDampL2>1.0E-6</cDampL2>
<cDampR1>1.0E-6</cDampR1>
<cDampR2>1.0E-6</cDampR2>
<cPDrag1>1.0E+2</cPDrag1>
<cPDrag2>1.0E+2</cPDrag2>
<fPDrag>0.4</fPDrag>
<cSDrag1>1.0E+2</cSDrag1>
<cSDrag2>1.0E+2</cSDrag2>
<fSDrag>0.4</fSDrag>
<vRDrag>1.0</vRDrag>
</hydrodynamics>
<current_user_configurable>true</current_user_configurable>
<current_session_tag>0</current_session_tag>
<current_start_enabled>false</current_start_enabled>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
ArduPilot 连接配置:网络端点、锁步同步、坐标变换和 IMU 名称。调整载具物理参数时请保留这些连接设置。
-->
<plugin name="ArduPilotPlugin" filename="libArduPilotPlugin.so">
<fdm_addr>127.0.0.1</fdm_addr>
<fdm_port_in>9002</fdm_port_in>
<connectionTimeoutMaxCount>5</connectionTimeoutMaxCount>
<lock_step>1</lock_step>
<modelXYZToAirplaneXForwardZDown>0 0 0 3.14159265359 0 0</modelXYZToAirplaneXForwardZDown>
<gazeboXYZToNED>0 0 0 3.14159265359 0 1.57079632679</gazeboXYZToNED>
<imuName>imu_sensor</imuName>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="0">
<jointName>left_propeller_joint</jointName>
<servo_min>1000</servo_min>
<servo_max>2000</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/wamv/joint/left_propeller_joint/cmd_thrust</cmd_topic>
<offset>-.5</offset>
<multiplier>500</multiplier>
</control>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="2">
<jointName>right_propeller_joint</jointName>
<servo_min>1000</servo_min>
<servo_max>2000</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/wamv/joint/right_propeller_joint/cmd_thrust</cmd_topic>
<offset>-.5</offset>
<multiplier>500</multiplier>
</control>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
按配置的坐标系和频率(Hz)发布仿真里程计数据。这些值描述仿真器状态;模拟传感器测量值请从传感器话题读取。
-->
<plugin filename="gz-sim-odometry-publisher-system" name="gz::sim::systems::OdometryPublisher">
<dimensions>3</dimensions>
<odom_frame>map</odom_frame>
<robot_base_frame>base_link</robot_base_frame>
<odom_publish_frequency>20</odom_publish_frequency>
<odom_topic>/model/wamv/odometry</odom_topic>
</plugin>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="gnss_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="base_link">0 0 1.8 0 0 0</pose>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>.001</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.000001</ixx>
<iyy>0.000001</iyy>
<izz>0.000001</izz>
</inertia>
</inertial>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="gnss" type="custom" gz:type="posim_gnss">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/model/wamv/gnss</topic>
</sensor>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="gnss_joint" type="fixed">
<parent>base_link</parent>
<child>gnss_link</child>
</joint>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
GNSS 接收机模型。update_rate 的单位为 Hz,latency 和 reacquire_seconds 为秒。位置噪声与 dry_margin
使用米,velocity_stddev 使用 m/s。link_name、topic 和 wave_topic 连接天线、输出及水面输入。
-->
<plugin name="posim::Gnss" filename="libposim_gnss.so">
<update_rate>5</update_rate>
<latency>0.2</latency>
<reacquire_seconds>3</reacquire_seconds>
<dry_margin>0.05</dry_margin>
<horizontal_stddev>0.7</horizontal_stddev>
<vertical_stddev>1.2</vertical_stddev>
<velocity_stddev>0.1</velocity_stddev>
<water_level>0</water_level>
<seed>42</seed>
<enabled>true</enabled>
<link_name>gnss_link</link_name>
<topic>/model/wamv/gnss</topic>
<wave_topic>/wwos/wave_surface</wave_topic>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<plugin filename="gz-sim-pose-publisher-system" name="gz::sim::systems::PosePublisher">
<publish_model_pose>true</publish_model_pose>
<publish_link_pose>true</publish_link_pose>
<publish_sensor_pose>true</publish_sensor_pose>
<publish_nested_model_pose>true</publish_nested_model_pose>
<publish_visual_pose>false</publish_visual_pose>
<publish_collision_pose>false</publish_collision_pose>
<use_pose_vector_msg>true</use_pose_vector_msg>
<update_frequency>20</update_frequency>
<topic>/model/wamv/wwos/poses</topic>
</plugin>
</model>
</sdf>
完整 BlueROV2 SDF
下载 BlueROV2 model.sdf。示例启用了两台相机、单波束 Ping、Autopilot 和 GNSS。DVL 与声学提供程序的配置保留在注释中。DVL 与 Ping 需二选一。
bluerov2.sdf
<?xml version='1.0' encoding='utf-8'?>
<sdf xmlns:gz="http://gazebosim.org" version="1.6">
<!--
模型结构:link 定义刚体,joint 连接刚体,plugin 提供仿真功能。模型、连杆和关节名称必须与导出的控制器配置保持一致。
-->
<model name="bluerov2">
<!--
导出的载具配置。此注释之后是启用的模型。请在载具编辑器中选择传感器和提供方,以保持话题连接与世界系统一致。安装范围:位置 ±10 m,旋转 ±2π rad。recipe.json:
{
"control_mode": "autopilot",
"gnss": true,
"schema_version": 1,
"sensors": [
"camera",
"camera_down",
"ping_down"
],
"settings": {
"camera": {
"height": 480,
"horizontal_fov": 1.4,
"pose": [
0.4,
0.0,
-0.1,
0.0,
0.0,
0.0
],
"update_rate": 5,
"width": 640
},
"camera_down": {
"height": 600,
"horizontal_fov": 1.4,
"pose": [
-0.1,
0.0,
0.0,
0.0,
1.5707963267948966,
0.0
],
"update_rate": 5,
"width": 800
},
"ping_down": {
"pose": [
-0.15,
0.0,
-0.095,
0.0,
1.5707963267948966,
0.0
],
"range_max": 30,
"update_rate": 5
}
},
"vehicle": "bluerov2"
}
-->
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 0 0 0</pose>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="base_link">
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 0.0 0.011 0 0 0</pose>
<mass>10.0</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.099</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.178</iyy>
<iyz>0</iyz>
<izz>0.269</izz>
</inertia>
</inertial>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="base_link_visual">
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/c73a7bc28f98fdcad54bf77d3ca61d26bb299e0d39be90cb56b77314d1499dde.dae</uri>
<scale>0.025 0.025 0.025</scale>
</mesh>
</geometry>
</visual>
<!--
物理引擎使用的碰撞几何体。尺寸和位置应与船体一致;简化形状可减少碰撞计算量。
-->
<collision name="base_link_collision">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 0.0 0.06 0 0 0</pose>
<geometry>
<box>
<size>0.457 0.338 0.065</size>
</box>
</geometry>
</collision>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="imu_sensor" type="imu">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 3.142 0 0</pose>
<always_on>1</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>1000.0</update_rate>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="wwos_magnetometer" type="magnetometer">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>20</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/model/bluerov2/magnetometer</topic>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_camera" type="camera">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/camera</topic>
<!--
相机配置:horizontal_fov 是水平视场角(弧度),width/height 是图像尺寸(像素)。clip 中 near/far
是渲染距离(米);camera_info_topic 发布标定信息。
-->
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>640</width>
<height>480</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera/camera_info</camera_info_topic>
</camera>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.4 0.0 -0.1 0.0 0.0 0.0</pose>
<frame_id>vehicle/camera</frame_id>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_camera_down" type="camera">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/camera_down</topic>
<!--
相机配置:horizontal_fov 是水平视场角(弧度),width/height 是图像尺寸(像素)。clip 中 near/far
是渲染距离(米);camera_info_topic 发布标定信息。
-->
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>800</width>
<height>600</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera_down/camera_info</camera_info_topic>
</camera>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.1 0.0 0.0 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/camera_down</frame_id>
</sensor>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="payload_ping_down" type="gpu_lidar">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/vehicle/sensors/ping_down</topic>
<!--
基于射线的测距传感器。scan 设置水平和垂直采样数及角度(弧度),range 设置距离范围与分辨率(米)。Single Ping 也使用此 GPU 射线实现。
-->
<lidar>
<scan>
<horizontal>
<samples>5</samples>
<resolution>1</resolution>
<min_angle>-0.00872665</min_angle>
<max_angle>0.00872665</max_angle>
</horizontal>
<vertical>
<samples>5</samples>
<resolution>1</resolution>
<min_angle>-0.00872665</min_angle>
<max_angle>0.00872665</max_angle>
</vertical>
</scan>
<range>
<min>0.1</min>
<max>30</max>
<resolution>0.01</resolution>
</range>
</lidar>
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.15 0.0 -0.095 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/ping_down</frame_id>
</sensor>
<!--
可选传感器 camera 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
width: 64 … 1920 px
height: 64 … 1920 px
horizontal_fov: 0.1 … 3 rad
width * height * update_rate <= 30000000 px/s
Gazebo: /vehicle/sensors/camera
frame_id: vehicle/camera
ROS: /vehicle/sensors/camera (sensor_msgs/msg/Image)
ROS: /vehicle/sensors/camera/camera_info (sensor_msgs/msg/CameraInfo)
<sensor name="payload_camera" type="camera">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/camera</topic>
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>640</width>
<height>480</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera/camera_info</camera_info_topic>
</camera>
<pose>0.4 0.0 -0.1 0.0 0.0 0.0</pose>
<frame_id>vehicle/camera</frame_id>
</sensor>
-->
<!--
可选传感器 camera_down 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
width: 64 … 1920 px
height: 64 … 1920 px
horizontal_fov: 0.1 … 3 rad
width * height * update_rate <= 30000000 px/s
Gazebo: /vehicle/sensors/camera_down
frame_id: vehicle/camera_down
ROS: /vehicle/sensors/camera_down (sensor_msgs/msg/Image)
ROS: /vehicle/sensors/camera_down/camera_info (sensor_msgs/msg/CameraInfo)
<sensor name="payload_camera_down" type="camera">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/camera_down</topic>
<camera>
<horizontal_fov>1.4</horizontal_fov>
<image>
<width>800</width>
<height>600</height>
</image>
<clip>
<near>.1</near>
<far>100</far>
</clip>
<camera_info_topic>/vehicle/sensors/camera_down/camera_info</camera_info_topic>
</camera>
<pose>-0.1 0.0 0.0 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/camera_down</frame_id>
</sensor>
-->
<!--
可选传感器 ping_down 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
range_max: 1 … 100 m
Gazebo: /vehicle/sensors/ping_down
frame_id: vehicle/ping_down
ROS: /vehicle/sensors/ping_down (sensor_msgs/msg/LaserScan)
ROS: /vehicle/sensors/ping_down/range (sensor_msgs/msg/Range)
runtime: practice_ping.py
DVL 与 Single Ping 只能选择其一,不能同时启用。
<sensor name="payload_ping_down" type="gpu_lidar">
<always_on>true</always_on>
<update_rate>5</update_rate>
<topic>/vehicle/sensors/ping_down</topic>
<lidar>
<scan>
<horizontal>
<samples>5</samples>
<resolution>1</resolution>
<min_angle>-0.00872665</min_angle>
<max_angle>0.00872665</max_angle>
</horizontal>
<vertical>
<samples>5</samples>
<resolution>1</resolution>
<min_angle>-0.00872665</min_angle>
<max_angle>0.00872665</max_angle>
</vertical>
</scan>
<range>
<min>0.1</min>
<max>30</max>
<resolution>0.01</resolution>
</range>
</lidar>
<pose>-0.15 0.0 -0.095 0.0 1.5707963267948966 0.0</pose>
<frame_id>vehicle/ping_down</frame_id>
</sensor>
-->
<!--
可选传感器 multibeam_forward 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
Gazebo: /vehicle/sensors/multibeam_forward
frame_id: vehicle/multibeam_forward
ROS: /vehicle/sensors/multibeam_forward/sonar_image_raw (marine_acoustic_msgs/msg/ProjectedSonarImage)
需要兼容的 POSIM 声学声呐提供方及其世界系统。未安装提供方时仍可参考此示例。射线与声学字段为提供方默认值;载具编辑器提供更新频率和安装位姿设置。
<sensor xmlns:gz="http://gazebosim.org" name="payload_multibeam_forward" type="custom" gz:type="multibeam_sonar">
<always_on>true</always_on>
<update_rate>2</update_rate>
<topic>/vehicle/sensors/multibeam_forward</topic>
<visualize>true</visualize>
<gz:multibeam_sonar>
<ray degrees="false">
<scan>
<horizontal>
<beams>256</beams>
<min_angle>-1.0471975511965976</min_angle>
<max_angle>1.0471975511965976</max_angle>
</horizontal>
<vertical>
<rays>256</rays>
<min_angle>-0.17453292519943295</min_angle>
<max_angle>0.17453292519943295</max_angle>
</vertical>
</scan>
<range>
<min>0.2</min>
<max>15</max>
</range>
</ray>
<spec>
<verticalFOV>20</verticalFOV>
<sonarFreq>700e3</sonarFreq>
<bandwidth>29.9e3</bandwidth>
<soundSpeed>1500</soundSpeed>
<sourceLevel>220</sourceLevel>
<maxDistance>15</maxDistance>
<raySkips>1</raySkips>
<sensorGain>0.02</sensorGain>
<writeLog>false</writeLog>
<debugFlag>false</debugFlag>
<writeFrameInterval>5</writeFrameInterval>
<pointCloudTopicName>geometry/points</pointCloudTopicName>
<sonarImageRawTopicName>sonar_image_raw</sonarImageRawTopicName>
<sonarImageTopicName>sonar_image</sonarImageTopicName>
<frameName>vehicle/multibeam_forward</frameName>
<visibilityMask>3892314111</visibilityMask>
</spec>
</gz:multibeam_sonar>
<pose>0.24 0.0 -0.1 0.0 0.35 0.0</pose>
<frame_id>vehicle/multibeam_forward</frame_id>
</sensor>
-->
<!--
可选传感器 dvl 的未启用默认示例。模型中启用的 payload_* 元素定义已选传感器。请在载具编辑器中修改选择,并将此示例保留在注释内。可编辑范围与输出路径:
update_rate: 0.1 … 30 Hz
range_max: 1 … 100 m
Gazebo: /vehicle/sensors/dvl
frame_id: vehicle/dvl
ROS: /vehicle/sensors/dvl/velocity (geometry_msgs/msg/Vector3Stamped)
ROS: /vehicle/sensors/dvl/status (std_msgs/msg/String)
runtime: practice_dvl_bridge.py
DVL 与 Single Ping 只能选择其一,不能同时启用。
<sensor xmlns:gz="http://gazebosim.org" name="payload_dvl" type="custom" gz:type="dvl">
<pose>0.0 0.0 -0.12 0.0 0.0 0.0</pose>
<always_on>true</always_on>
<update_rate>1</update_rate>
<topic>/vehicle/sensors/dvl</topic>
<gz:dvl>
<type>phased_array</type>
<arrangement degrees="true">
<beam id="1">
<aperture>2</aperture>
<rotation>45</rotation>
<tilt>30</tilt>
</beam>
<beam id="2">
<aperture>2</aperture>
<rotation>135</rotation>
<tilt>30</tilt>
</beam>
<beam id="3">
<aperture>2</aperture>
<rotation>-45</rotation>
<tilt>30</tilt>
</beam>
<beam id="4">
<aperture>2</aperture>
<rotation>-135</rotation>
<tilt>30</tilt>
</beam>
</arrangement>
<tracking>
<bottom_mode>
<when>best</when>
<noise type="gaussian">
<stddev>0.002</stddev>
</noise>
<visualize>false</visualize>
</bottom_mode>
</tracking>
<resolution>0.01</resolution>
<maximum_range>20</maximum_range>
<minimum_range>0.1</minimum_range>
<reference_frame>0 0 0 0 0 0</reference_frame>
</gz:dvl>
<frame_id>vehicle/dvl</frame_id>
</sensor>
-->
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="camera_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="camera_mount_link">0 0 0 0 0 0</pose>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.0001</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.0001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.0001</iyy>
<iyz>0</iyz>
<izz>0.0001</izz>
</inertia>
</inertial>
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="camera_mount_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="base_link">0.19 0 0.067 0 0 0</pose>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.0001</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.0001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.0001</iyy>
<iyz>0</iyz>
<izz>0.0001</izz>
</inertia>
</inertial>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="camera_joint" type="fixed">
<parent>camera_mount_link</parent>
<child>camera_link</child>
</joint>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="camera_mount_joint" type="fixed">
<parent>base_link</parent>
<child>camera_mount_link</child>
</joint>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="thruster1">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.14 -0.092 0.0 -1.571 1.571 -0.785</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="thruster_prop_visual">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 -1.571 0 0</pose>
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/4c4ae10284584339de36be62165caca9464a8df8ec1e81567d08180b3531d643.dae</uri>
</mesh>
</geometry>
</visual>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.002</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.001</iyy>
<iyz>0</iyz>
<izz>0.001</izz>
</inertia>
</inertial>
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="thruster2">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.14 0.092 0.0 -1.571 1.571 -2.356</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="thruster_prop_visual">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 -1.571 0 0</pose>
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/4c4ae10284584339de36be62165caca9464a8df8ec1e81567d08180b3531d643.dae</uri>
</mesh>
</geometry>
</visual>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.002</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.001</iyy>
<iyz>0</iyz>
<izz>0.001</izz>
</inertia>
</inertial>
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="thruster3">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.15 -0.092 0.0 -1.571 1.571 0.785</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="thruster_prop_visual">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 1.571 0 0</pose>
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/c4b609828a11b8387f2d49c1de4bd37e911767c38f948144f84a0fc9c29a9a54.dae</uri>
</mesh>
</geometry>
</visual>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.002</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.001</iyy>
<iyz>0</iyz>
<izz>0.001</izz>
</inertia>
</inertial>
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="thruster4">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>-0.15 0.092 0.0 -1.571 1.571 2.356</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="thruster_prop_visual">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 1.571 0 0</pose>
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/c4b609828a11b8387f2d49c1de4bd37e911767c38f948144f84a0fc9c29a9a54.dae</uri>
</mesh>
</geometry>
</visual>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.002</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.001</iyy>
<iyz>0</iyz>
<izz>0.001</izz>
</inertia>
</inertial>
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="thruster5">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 -0.109 0.077 0 0 0</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="thruster_prop_visual">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 -1.571 0 1.571</pose>
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/4c4ae10284584339de36be62165caca9464a8df8ec1e81567d08180b3531d643.dae</uri>
</mesh>
</geometry>
</visual>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.002</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.001</iyy>
<iyz>0</iyz>
<izz>0.001</izz>
</inertia>
</inertial>
</link>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="thruster6">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0.0 0.109 0.077 0 0 0</pose>
<!--
用于渲染和相机成像的可见表面。修改外观不会自动调整碰撞形状或质量。
-->
<visual name="thruster_prop_visual">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose>0 0 0 1.571 0 1.571</pose>
<geometry>
<!--
网格文件及可选的各轴缩放比例。请保留导出的资源路径和配套文件;scale 会乘到网格坐标上。
-->
<mesh>
<uri>assets/c4b609828a11b8387f2d49c1de4bd37e911767c38f948144f84a0fc9c29a9a54.dae</uri>
</mesh>
</geometry>
</visual>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>0.002</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.001</ixx>
<ixy>0</ixy>
<ixz>0</ixz>
<iyy>0.001</iyy>
<iyz>0</iyz>
<izz>0.001</izz>
</inertia>
</inertial>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="thruster1_joint" type="revolute">
<parent>base_link</parent>
<child>thruster1</child>
<axis>
<xyz>0 0 -1</xyz>
</axis>
</joint>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="thruster2_joint" type="revolute">
<parent>base_link</parent>
<child>thruster2</child>
<axis>
<xyz>0 0 -1</xyz>
</axis>
</joint>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="thruster3_joint" type="revolute">
<parent>base_link</parent>
<child>thruster3</child>
<axis>
<xyz>0 0 -1</xyz>
</axis>
</joint>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="thruster4_joint" type="revolute">
<parent>base_link</parent>
<child>thruster4</child>
<axis>
<xyz>0 0 -1</xyz>
</axis>
</joint>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="thruster5_joint" type="revolute">
<parent>base_link</parent>
<child>thruster5</child>
<axis>
<xyz>0 0 -1</xyz>
</axis>
</joint>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="thruster6_joint" type="revolute">
<parent>base_link</parent>
<child>thruster6</child>
<axis>
<xyz>0 0 -1</xyz>
</axis>
</joint>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>bluerov2</namespace>
<joint_name>thruster1_joint</joint_name>
<thrust_coefficient>0.02</thrust_coefficient>
<fluid_density>1025.0</fluid_density>
<propeller_diameter>0.1</propeller_diameter>
<velocity_control>true</velocity_control>
<use_angvel_cmd>False</use_angvel_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>bluerov2</namespace>
<joint_name>thruster2_joint</joint_name>
<thrust_coefficient>0.02</thrust_coefficient>
<fluid_density>1025.0</fluid_density>
<propeller_diameter>0.1</propeller_diameter>
<velocity_control>true</velocity_control>
<use_angvel_cmd>False</use_angvel_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>bluerov2</namespace>
<joint_name>thruster3_joint</joint_name>
<thrust_coefficient>-0.02</thrust_coefficient>
<fluid_density>1025.0</fluid_density>
<propeller_diameter>0.1</propeller_diameter>
<velocity_control>true</velocity_control>
<use_angvel_cmd>False</use_angvel_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>bluerov2</namespace>
<joint_name>thruster4_joint</joint_name>
<thrust_coefficient>-0.02</thrust_coefficient>
<fluid_density>1025.0</fluid_density>
<propeller_diameter>0.1</propeller_diameter>
<velocity_control>true</velocity_control>
<use_angvel_cmd>False</use_angvel_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>bluerov2</namespace>
<joint_name>thruster5_joint</joint_name>
<thrust_coefficient>0.02</thrust_coefficient>
<fluid_density>1025.0</fluid_density>
<propeller_diameter>0.1</propeller_diameter>
<velocity_control>true</velocity_control>
<use_angvel_cmd>False</use_angvel_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
螺旋桨推力模型:fluid_density 的单位为 kg/m^3,propeller_diameter 为米,thrust_coefficient
关联角速度与推力。use_angvel_cmd 为 true 时接收 rad/s 指令,为 false 时接收 N 单位的力指令。
-->
<plugin filename="gz-sim-thruster-system" name="gz::sim::systems::Thruster">
<namespace>bluerov2</namespace>
<joint_name>thruster6_joint</joint_name>
<thrust_coefficient>-0.02</thrust_coefficient>
<fluid_density>1025.0</fluid_density>
<propeller_diameter>0.1</propeller_diameter>
<velocity_control>true</velocity_control>
<use_angvel_cmd>False</use_angvel_cmd>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
ArduPilot 连接配置:网络端点、锁步同步、坐标变换和 IMU 名称。调整载具物理参数时请保留这些连接设置。
-->
<plugin name="ArduPilotPlugin" filename="libArduPilotPlugin.so">
<fdm_addr>127.0.0.1</fdm_addr>
<fdm_port_in>9002</fdm_port_in>
<connectionTimeoutMaxCount>5</connectionTimeoutMaxCount>
<lock_step>1</lock_step>
<modelXYZToAirplaneXForwardZDown>0 0 0 3.142 0 0</modelXYZToAirplaneXForwardZDown>
<gazeboXYZToNED>0 0 0 3.142 0 1.571</gazeboXYZToNED>
<imuName>imu_sensor</imuName>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="0">
<jointName>thruster1_joint</jointName>
<servo_min>1100</servo_min>
<servo_max>1900</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/bluerov2/joint/thruster1_joint/cmd_thrust</cmd_topic>
<offset>-0.5</offset>
<multiplier>100</multiplier>
</control>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="1">
<jointName>thruster2_joint</jointName>
<servo_min>1100</servo_min>
<servo_max>1900</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/bluerov2/joint/thruster2_joint/cmd_thrust</cmd_topic>
<offset>-0.5</offset>
<multiplier>100</multiplier>
</control>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="2">
<jointName>thruster3_joint</jointName>
<servo_min>1100</servo_min>
<servo_max>1900</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/bluerov2/joint/thruster3_joint/cmd_thrust</cmd_topic>
<offset>-0.5</offset>
<multiplier>100</multiplier>
</control>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="3">
<jointName>thruster4_joint</jointName>
<servo_min>1100</servo_min>
<servo_max>1900</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/bluerov2/joint/thruster4_joint/cmd_thrust</cmd_topic>
<offset>-0.5</offset>
<multiplier>100</multiplier>
</control>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="4">
<jointName>thruster5_joint</jointName>
<servo_min>1100</servo_min>
<servo_max>1900</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/bluerov2/joint/thruster5_joint/cmd_thrust</cmd_topic>
<offset>-0.5</offset>
<multiplier>100</multiplier>
</control>
<!--
将控制器通道映射到关节指令话题。servo_min/max 定义输入范围,offset 和 multiplier 设置输出转换的偏移与倍率。请保留通道与话题的映射。
-->
<control channel="5">
<jointName>thruster6_joint</jointName>
<servo_min>1100</servo_min>
<servo_max>1900</servo_max>
<type>COMMAND</type>
<cmd_topic>/model/bluerov2/joint/thruster6_joint/cmd_thrust</cmd_topic>
<offset>-0.5</offset>
<multiplier>100</multiplier>
</control>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
按配置的坐标系和频率(Hz)发布仿真里程计数据。这些值描述仿真器状态;模拟传感器测量值请从传感器话题读取。
-->
<plugin filename="gz-sim-odometry-publisher-system" name="gz::sim::systems::OdometryPublisher">
<odom_frame>map</odom_frame>
<robot_base_frame>base_link</robot_base_frame>
<dimensions>3</dimensions>
<odom_publish_frequency>100</odom_publish_frequency>
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<plugin filename="gz-sim-joint-state-publisher-system" name="gz::sim::systems::JointStatePublisher">
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu">
</plugin>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<plugin filename="gz-waves1-hydrodynamics-system" name="gz::sim::systems::Hydrodynamics">
<enable>bluerov2::base_link</enable>
<!--
流体力系数。damping_on、viscous_drag_on 和 pressure_drag_on 分别启用阻尼、黏性阻力和压力阻力。cDampL/R
调整平动与转动阻尼;压力阻力系数须采用适用于此插件模型的数值。
-->
<hydrodynamics>
<damping_on>1</damping_on>
<viscous_drag_on>0</viscous_drag_on>
<pressure_drag_on>0</pressure_drag_on>
<cDampL1>.1</cDampL1>
<cDampL2>40</cDampL2>
<cDampR1>.1</cDampR1>
<cDampR2>4</cDampR2>
</hydrodynamics>
</plugin>
<!--
刚体及其局部坐标系。该连杆的几何形状、质量属性和传感器作为整体运动。
-->
<link name="gnss_link">
<!--
位姿:x y z 的单位为米,随后 roll pitch yaw 的单位为弧度。未指定 relative_to 时,以父级坐标系为参考。
-->
<pose relative_to="base_link">0 0 0.3 0 0 0</pose>
<!--
质量属性:mass 的单位为 kg;pose 定义质心坐标系相对于连杆的位置和方向。请使用实测值或 CAD 计算结果。
-->
<inertial>
<mass>.001</mass>
<!--
质心处的惯性张量,单位为 kg*m^2。ixx/iyy/izz 是对角项,ixy/ixz/iyz 是交叉项。数值须与质量和形状在物理上保持一致。
-->
<inertia>
<ixx>0.000001</ixx>
<iyy>0.000001</iyy>
<izz>0.000001</izz>
</inertia>
</inertial>
<!--
安装在该连杆上的传感器。pose 设置安装位姿,type 选择测量实现。载具编辑器还会配置话题连接和所需的世界系统。
-->
<sensor name="gnss" type="custom" gz:type="posim_gnss">
<always_on>true</always_on>
<!--
请求的传感器更新频率,单位为 Hz。实际接收频率还取决于仿真速度和渲染负载。
-->
<update_rate>5</update_rate>
<!--
Gazebo Transport 输出话题。须与导出的传感器清单和 ROS 桥接配置保持一致。
-->
<topic>/model/bluerov2/gnss</topic>
</sensor>
</link>
<!--
连接 parent 和 child 连杆的关节。fixed 固定相对运动;revolute 允许绕 axis/xyz 旋转。请保留推进器和控制器插件引用的名称。
-->
<joint name="gnss_joint" type="fixed">
<parent>base_link</parent>
<child>gnss_link</child>
</joint>
<!--
引擎插件。filename 指定已安装的库,name 指定具体实现。上传数值修改时请保留这两个字段;SDF 文件本身不会安装插件。
-->
<!--
GNSS 接收机模型。update_rate 的单位为 Hz,latency 和 reacquire_seconds 为秒。位置噪声与 dry_margin
使用米,velocity_stddev 使用 m/s。link_name、topic 和 wave_topic 连接天线、输出及水面输入。
-->
<plugin name="posim::Gnss" filename="libposim_gnss.so">
<update_rate>5</update_rate>
<latency>0.2</latency>
<reacquire_seconds>3</reacquire_seconds>
<dry_margin>0.05</dry_margin>
<horizontal_stddev>0.7</horizontal_stddev>
<vertical_stddev>1.2</vertical_stddev>
<velocity_stddev>0.1</velocity_stddev>
<water_level>0</water_level>
<seed>42</seed>
<enabled>true</enabled>
<link_name>gnss_link</link_name>
<topic>/model/bluerov2/gnss</topic>
<wave_topic>/wwos/wave_surface</wave_topic>
</plugin>
</model>
</sdf>
将配置迁移到其他主机
导出 ZIP包含 SDF、网格、配置配方和传感器清单。导入载具会重建当前安装的模板并验证 SDF 修改,保留支持的数值变化。引擎版本不同或缺少提供程序时,可能需要重新生成。编辑副本、导出兼容模板后,再应用修改。
导入模型与自己的网格
在工作区的机器人区域上传 SDF,或包含 SDF 和网格的 ZIP。
| 限制 | 网页版 | 桌面版 |
|---|---|---|
| 上传文件 | 20 MB | 200 MB |
| 解压后总大小 | 50 MB | 500 MB |
| 根 SDF | 1 MB | 1 MB |
ZIP 内使用相对网格路径,并包含连杆、碰撞几何和惯性。系统检查归档路径和支持的插件,拒绝外部可执行程序。启动新世界时选择保存的修订版;传感器和安装位置的变化需要重启。
修改质量和惯性时,应一起检查质心、张量、碰撞形状和缩放。惯性张量过小可能导致快速运动,即使网格外观看起来正常。以下仅为语法示例:
<inertial>
<mass>12.0</mass>
<inertia>
<ixx>0.22</ixx><iyy>0.35</iyy><izz>0.40</izz>
<ixy>0</ixy><ixz>0</ixz><iyz>0</iyz>
</inertia>
</inertial>
应使用实测或 CAD 计算结果,确保张量正定并使用 kg·m²。长距离运行前先进行静止与低速测试。
从 CAD 导出闭合且已三角化的 STL:
my-robot.zip
model.sdf
meshes/hull.stl
STL 不包含单位。应以米导出,或显式设置缩放;毫米模型可使用 0.001 0.001 0.001。显示几何引用示例:
<visual name="hull_visual">
<geometry><mesh>
<uri>meshes/hull.stl</uri>
<scale>1 1 1</scale>
</mesh></geometry>
</visual>
碰撞可使用长方体、圆柱或简化的闭合网格,并在 <inertial> 中定义质量和惯性。传感器、执行器和水动力需要 SDF 与运行配置,控制器需要连接指令话题。传感器树会显示生成的话题。
浏览器会转换已验证的 STL 用于显示,Gazebo 使用原始几何。SDF 格式化会缩进 XML,并保留属性、路径和注释。XML 无效时,编辑器内容仍会保留。
存储与控制
模型、原始 ZIP 和归档修订版均计入存储额度。去除重复网格和无用资源以满足限制。归档只隐藏修订版,仍保留数据。使用该版本的运行中或排队会话结束后,才能归档。归档与恢复控件位于工作区存储面板。
通过控制桌面版工作区在本地运行自主控制代码和 ROS 依赖。原生插件或服务器节点需要包含兼容依赖的运行配置。修改 ArduPilot 参数前应上锁,修改后重新读取确认;见自动驾驶任务。
个人工作区一次运行一个载具。LIVE 全球航行中的双 WAM-V 使用专用配置,目前不提供通用的多载具编辑器。