WWW-POSIM v0.6.16시뮬레이터 문서
문서 메뉴
WWW-POSIM / 시뮬레이터 문서

커스텀 차량

차량 SDF는 링크, 형상, 질량, 관성, 조인트, 센서와 설치된 플러그인을 정의합니다. 선택한 차량에서 내려받은 SDF를 바탕으로 수정하면 현재 실행 환경의 제어기·센서 연결을 유지할 수 있습니다.

내려받고 수정해서 적용하기

  1. 작업공간 → 커스텀 월드에서 지형과 차량을 선택하고 시작 전 검토를 여세요.
  2. SDF 파일 편집을 펼쳐 차량 SDF 다운로드를 누르세요. 기본 차량은 저장된 차량 버전을 만든 뒤 내보냅니다.
  3. model.sdf의 사본에서 수치를 수정하세요. 이름, 링크 구성, 플러그인 식별자, 자료 경로와 토픽 경로는 유지하세요.
  4. 같은 화면에서 수정한 차량 SDF 올리기를 선택하세요. 검사가 끝나면 새 버전을 저장하고 선택합니다. 원본은 그대로 남습니다.
  5. 월드를 시작하고 정지 상태를 확인한 뒤 움직여 보세요. 저장된 파일을 수정해도 이미 실행 중인 월드는 바뀌지 않습니다.

생성된 차량의 SDF 업로드는 차량 편집기에서 선택한 구성을 유지합니다. 센서를 추가·삭제하거나 제어 방식과 공급자를 바꾸려면 복사 후 편집을 사용하세요. 새 네이티브 플러그인은 해당 플러그인이 설치된 엔진이 필요합니다. SDF 업로드만으로 소프트웨어가 설치되지는 않습니다.

SDF 구성별로 읽기

SDF 구성 의미와 수정 방법
model / pose 모델 기준 위치와 자세입니다. 작업공간은 선택한 지리 좌표에 차량을 배치합니다.
link / pose 상위 좌표계에 대한 링크 위치와 자세입니다. 위치는 m, 롤·피치·요는 rad입니다.
inertial / mass, inertial / pose 질량(kg)과 질량중심 좌표계입니다. 실제 크기와 맞게 설정하세요.
inertia 관성 텐서의 독립 성분 여섯 개이며 단위는 kg·m²입니다. CAD 계산값이나 측정한 질량 분포를 사용하세요. 양의 정부호가 아니거나 물리 조건을 만족하지 않는 값은 거부됩니다.
visual / geometry 화면에 표시하는 형상과 메시 배율입니다. 표시 형상만 키워도 충돌 형상이나 질량이 함께 바뀌지는 않습니다.
collision / geometry 접촉 계산에 쓰는 형상입니다. 가능하면 단순한 닫힌 형상을 사용하고 실제 선체에 맞추세요.
joint / pose / axis 조인트 위치와 축 방향입니다. 추진기와 제어기 연결을 유지하려면 상위·하위 링크와 조인트 이름을 유지하세요.
유체력·부력 플러그인 배수량, 부가 질량과 항력에 쓰는 모델 계수입니다. 해양 동역학과 렌더링에서 부호 규약을 확인하세요.
추진기·제어기 플러그인 추진축, 계수와 제어 채널입니다. 형상을 바꾼 뒤에는 저속 응답을 확인하세요.
sensor와 센서 플러그인 장착 위치, 주기, 광학·음향 설정과 잡음입니다. 커스텀 센서를 참고하세요.

아래 전체 파일은 설치된 모델의 실제 값을 담고 있습니다. 모든 실제 차량에 공통으로 적용할 보정값은 아닙니다. 템플릿 구조와 센서별 검증 범위 안에서 수치·불리언 값을 수정할 수 있습니다. 시작 전 검토의 업로드 한도는 1 MB입니다. 허용되지 않는 수정은 해당 SDF 경로와 함께 안내됩니다. 값을 고쳐 다시 업로드하세요.

WAM-V 전체 SDF

예제는 Linux 엔진의 플러그인 경로를 사용합니다. macOS 등 다른 호스트에서는 해당 호스트에서 직접 내보낸 SDF를 수정하세요. 메시와 자료가 함께 들어 있는 ZIP도 보관하세요.

WAM-V model.sdf 다운로드. 전방·하향 카메라, DVL, 2D LiDAR와 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 수평 화각(rad), width/height는 영상 크기(pixel)입니다. clip의 near/far는 표시
          거리(m)입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 수평 화각(rad), width/height는 영상 크기(pixel)입니다. clip의 near/far는 표시
          거리(m)입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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 속성에, 거리와 해상도는 m로 지정합니다. 월드에
          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은 수평·수직 샘플 수와 각도(rad), range는 거리 범위와 해상도(m)를 지정합니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m이며 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는 m이며 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 연결 설정입니다. 네트워크 주소, 시간 동기화(lock-step), 좌표 변환, 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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은
      m, 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
    -->
    <pose>0 0 0 0 0 0</pose>
    <!--
      강체와 그 로컬 좌표계입니다. 이 링크의 형상, 질량 특성, 센서는 함께 움직입니다.
    -->
    <link name="base_link">
      <!--
        질량 특성: mass의 단위는 kg입니다. pose는 링크 기준 질량중심 좌표계의 위치와 방향입니다. 실측값이나 CAD 계산값을 사용하세요.
      -->
      <inertial>
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 수평 화각(rad), width/height는 영상 크기(pixel)입니다. clip의 near/far는 표시
          거리(m)입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 수평 화각(rad), width/height는 영상 크기(pixel)입니다. clip의 near/far는 표시
          거리(m)입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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은 수평·수직 샘플 수와 각도(rad), range는 거리 범위와 해상도(m)를 지정합니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>0.14 -0.092 0.0 -1.571 1.571 -0.785</pose>
      <!--
        화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
      -->
      <visual name="thruster_prop_visual">
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>0.14 0.092 0.0 -1.571 1.571 -2.356</pose>
      <!--
        화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
      -->
      <visual name="thruster_prop_visual">
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>-0.15 -0.092 0.0 -1.571 1.571 0.785</pose>
      <!--
        화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
      -->
      <visual name="thruster_prop_visual">
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>-0.15 0.092 0.0 -1.571 1.571 2.356</pose>
      <!--
        화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
      -->
      <visual name="thruster_prop_visual">
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>0.0 -0.109 0.077 0 0 0</pose>
      <!--
        화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
      -->
      <visual name="thruster_prop_visual">
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>0.0 0.109 0.077 0 0 0</pose>
      <!--
        화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
      -->
      <visual name="thruster_prop_visual">
        <!--
          위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. 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는 m이며 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는 m이며 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는 m이며 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는 m이며 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는 m이며 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는 m이며 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 연결 설정입니다. 네트워크 주소, 시간 동기화(lock-step), 좌표 변환, 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는 m, 뒤의 roll pitch yaw는 rad입니다. 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은
      m, 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 안의 상대 경로로 작성합니다. 링크·충돌 형상·관성 정보를 포함하세요. 검사기는 압축 경로와 지원 플러그인을 확인하며, 외부 실행 파일은 허용하지 않습니다.

새 월드를 시작할 때 업로드한 버전을 선택합니다. 센서 배치가 바뀌었다면 월드를 다시 실행해야 합니다. 해당 버전을 사용하는 대기·실행 중인 세션이 끝나면 보관할 수 있습니다. 보관한 버전은 목록에서 숨겨지며 데이터는 유지됩니다.

질량과 관성 바꾸기

로봇 편집기에서 SDF를 수정합니다. 질량, 무게중심, 관성 텐서, 충돌 형상, 메시 크기를 함께 확인하세요. 새 버전으로 저장한 뒤 정지 상태와 저속 이동부터 시험합니다. 관성이 지나치게 작으면 외형이 정상이어도 회전이 급격해지거나 시뮬레이션이 불안정해질 수 있습니다.

<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²이며 텐서가 양의 정부호인지 확인해야 합니다.

센서와 ROS 패키지 추가하기

센서 위치와 설정을 SDF에 작성한 뒤 새 세션을 시작합니다. 센서 트리는 생성된 토픽을 표시합니다. Autopilot·추진기 연결은 실행 프로필에 설정하세요.

자율운항 코드와 ROS 의존성은 내 컴퓨터에서 실행하고 설치형 작업공간에서 제어로 연결합니다. 전용 플러그인이나 서버 ROS 노드는 의존성이 준비된 런타임 프로필이 필요합니다.

저장 공간 관리하기

모델·원본 ZIP·저장한 버전은 계정의 저장 한도에 포함됩니다. 보관된 파일도 사용량에 포함됩니다. 업로드 한도에 맞춰 중복 메시와 불필요한 자산을 줄이세요.

저장한 지형·차량 관리의 보관 / 복원으로 계정 지형·로봇 항목의 표시 상태를 바꿀 수 있습니다. 다른 호스트로 옮기려면 보관 대신 내보내기·가져오기를 사용하세요.

Autopilot 파라미터

시동을 해제한 뒤 ArduPilot 매개변수에서 Autopilot 값을 바꾸고 다시 읽어 확인합니다. Autopilot 파라미터 바꾸기를 참고하세요.

STL 모델 사용하기

CAD에서 표면이 닫힌 삼각형 메시를 STL로 내보낸 뒤, model.sdf와 함께 ZIP 파일로 묶습니다. 메시 파일은 다음과 같이 상대 경로로 배치합니다.

my-robot.zip
  model.sdf
  meshes/hull.stl

STL에는 길이 단위가 저장되지 않습니다. 미터 단위로 내보내거나 SDF에 배율을 지정하세요. 밀리미터로 내보낸 모델은 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와 실행 프로필에 정의하고 명령 토픽에 제어기를 연결합니다.

작업 공간 → 사용자 로봇에서 업로드하고 검증 결과를 확인합니다. 새 월드에서 저장한 버전을 선택하세요.

여러 차량 실행

개인 작업공간은 한 번에 차량 한 대를 실행합니다. LIVE 세계 항해의 WAM-V 두 대는 전용 구성으로 동작하며, 작업공간에는 범용 다중 차량 편집기가 없습니다.

문서 검색