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

커스텀 월드

월드 SDF는 시뮬레이션 환경을 설정합니다. 선택한 지형에서 내보낸 파일을 사용하세요. 해당 지형의 자료 경로, 지리 원점과 필수 엔진 시스템이 들어 있습니다.

월드 파일 내려받고 적용하기

  1. 준비된 고정 영역 지형과 차량을 선택하고 시작 전 검토를 여세요.
  2. SDF 파일 편집 → 월드 SDF 다운로드를 펼쳐 world.sdf의 사본을 저장하세요.
  3. 아래에서 설명하는 물리, 조명 등의 설정을 수정하세요. 지형 모델, 경로, 월드 이름과 지리 원점은 유지하세요.
  4. 월드 SDF 업로드를 선택하세요. 검사가 끝난 새 버전이 월드 설정에 추가되고 자동으로 선택됩니다.
  5. 월드 시작을 누르세요. 지형·차량 준비가 끝난 뒤 저장한 설정이 적용됩니다. 실제 적용된 물리 시간 간격, 측정 배속과 장면 조명을 확인하세요.

월드 파일은 내보낼 때 선택한 지형 버전과 연결됩니다. 다른 지형을 선택했다면 그 지형의 파일을 내려받아 설정을 다시 적용하세요. 기본값을 쓰려면 기본 월드 설정을 선택하세요. 업로드는 1 MB 이하의 .world 또는 .sdf 파일을 받습니다. 고정 지형을 사용하는 비채점 월드에서 지원하며, 주문형 지형과 채점 과제는 지정된 설정을 사용합니다.

수정할 수 있는 설정

SDF 구성 설정과 단위
physics / max_step_size 적분 시간 간격으로 0.001–0.03초입니다. 짧게 설정할수록 계산량이 늘어납니다.
physics / real_time_factor 요청하는 시뮬레이션 시간 / 실제 시간 비율입니다. 0보다 크고 10 이하여야 합니다. 측정 배속은 CPU·GPU 여유에 따라 달라집니다.
gravity 중력 가속도 벡터(m/s²)입니다. 표준 중력은 0 0 -9.81입니다.
magnetic_field 월드 자기장 벡터이며 단위는 T입니다.
scene 주변광, 배경색, 그림자, 격자와 원점 표시입니다. 색은 RGBA 값을 사용합니다.
light 이름이 서로 다른 방향광·점광원·스포트라이트를 최대 32개 설정합니다. 위치, 방향, 색, 감쇠와 스폿 각도를 지정하며 각도는 rad입니다.
wind / linear_velocity 표준 SDF 바람 속도(m/s)입니다. 해양 파도·해류 모델은 별도의 조작 항목과 물리적 의미를 가집니다.

전체 형식은 SDFormat 명세를 참고하세요. 업로드는 지형과 필수 시스템을 보존하고 지원되는 월드 설정을 적용합니다. 플러그인을 설치하거나 외부 모델을 가져오거나 지리 지형을 교체하지는 않습니다. 파도와 해류는 장면 패널에서 설정하세요. 차량에 미치는 영향은 해양 동역학과 렌더링에서 설명합니다.

준비된 지형을 사용하는 템플릿

한국해양대학교 월드 SDF 다운로드. 준비된 한국해양대학교 지형을 사용하며 지원되는 월드 설정을 모두 포함한 예제입니다. 지형 메시와 영상은 지형 묶음에 들어 있습니다. 작업공간에서 해당 지형을 다운로드하면 자료 파일도 받을 수 있습니다.

kmou.world
<?xml version='1.0' encoding='utf-8'?>
<sdf version="1.4">
  <!--
    이 지형 리비전의 월드 설정입니다. 월드 이름, 지형 리소스, 지리적 원점, 필수 시스템을 유지하세요. 시작 전 확인 화면에서 지원되는 환경 설정을
    업로드할 수 있습니다.
  -->
  <world name="wwos_gebco">
    <!--
      장면 표시 설정입니다. ambient와 background는 RGBA 색상이며 shadows, grid, origin_visual은 해당 표시를
      제어합니다. 내보낸 하늘 설정을 포함해 업로드 가능한 항목은 월드 설정 표를 참고하세요.
    -->
    <scene>
      <ambient>0.01 0.01 0.01 1.0</ambient>
      <sky>
        <clouds>
          <speed>12</speed>
        </clouds>
      </sky>
      <shadows>1</shadows>
      <background>0.7 0.8 0.9 1</background>
      <grid>false</grid>
      <origin_visual>false</origin_visual>
    </scene>
    <!--
      물리 시간 설정입니다. max_step_size는 적분 시간 간격(초), real_time_factor는 요청한 시뮬레이션 시간/실제 시간 비율입니다.
      name은 이름일 뿐 시간 간격을 정하지 않습니다. 실제 배속은 CPU/GPU 여유에 따라 달라집니다.
    -->
    <physics name="1ms" type="ignored">
      <max_step_size>.02</max_step_size>
      <real_time_factor>1.0</real_time_factor>
    </physics>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <!--
      강체 동역학과 접촉을 계산하는 필수 월드 시스템입니다. 활성 상태를 유지하세요.
    -->
    <plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics">
    </plugin>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <!--
      실행 중인 장면을 변경하는 Gazebo Transport 명령을 제공합니다. 작업공간의 장면 조작에 사용됩니다.
    -->
    <plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands">
    </plugin>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <!--
      뷰어가 시뮬레이션을 표시할 수 있도록 장면 구조와 위치·자세를 발행합니다.
    -->
    <plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster">
    </plugin>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <!--
      카메라 영상과 GPU 광선 센서 데이터를 렌더링합니다. render_engine은 설치된 렌더링 백엔드를 선택합니다. 해당 엔진에서 내보낸 값을
      유지하세요.
    -->
    <plugin filename="gz-sim-sensors-system" name="gz::sim::systems::Sensors">
      <render_engine>ogre2</render_engine>
    </plugin>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <!--
      커스텀 DVL 센서에 필요한 월드 시스템입니다. 빔과 추적 설정은 차량 SDF에서 지정합니다.
    -->
    <plugin filename="gz-sim-dvl-system" name="gz::sim::systems::DopplerVelocityLogSystem">
    </plugin>
    <!--
      지형의 지리적 원점입니다. 위도·경도·방위각은 도, 고도는 m입니다. ENU는 동쪽·북쪽·위쪽 축을 뜻합니다. 지도·지형·GNSS가 일치하도록 값을
      유지하세요.
    -->
    <spherical_coordinates>
      <surface_model>EARTH_WGS84</surface_model>
      <world_frame_orientation>ENU</world_frame_orientation>
      <latitude_deg>35.077175</latitude_deg>
      <longitude_deg>129.085815</longitude_deg>
      <elevation>0</elevation>
      <heading_deg>0</heading_deg>
    </spherical_coordinates>
    <!--
      광원입니다. type은 방향광·점광원·스포트라이트를 선택합니다. pose는 위치·자세, direction은 빛의 방향 벡터입니다.
      diffuse/specular는 RGBA 색상이며 cast_shadows는 그림자 생성을 제어합니다.
    -->
    <light type="directional" name="sun1">
      <!--
        위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>50 0 150 0 0 0</pose>
      <diffuse>1 1 1 1</diffuse>
      <specular>.1 .1 .1 1</specular>
      <direction>0.3 0.3 -1</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      광원입니다. type은 방향광·점광원·스포트라이트를 선택합니다. pose는 위치·자세, direction은 빛의 방향 벡터입니다.
      diffuse/specular는 RGBA 색상이며 cast_shadows는 그림자 생성을 제어합니다.
    -->
    <light type="directional" name="sun_diffuse">
      <!--
        위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>-50 0 -150 0 0 0</pose>
      <diffuse>0.6 0.6 0.6 1</diffuse>
      <specular>0 0 0 1</specular>
      <direction>-0.3 -0.3 -1</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      광원입니다. type은 방향광·점광원·스포트라이트를 선택합니다. pose는 위치·자세, direction은 빛의 방향 벡터입니다.
      diffuse/specular는 RGBA 색상이며 cast_shadows는 그림자 생성을 제어합니다.
    -->
    <light type="directional" name="sun_diffuse_1">
      <!--
        위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>-100 500 -20 0 0 0</pose>
      <diffuse>0.8 0.8 0.8 1</diffuse>
      <specular>1 1 1 1</specular>
      <direction>-1 -1 0</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      광원입니다. type은 방향광·점광원·스포트라이트를 선택합니다. pose는 위치·자세, direction은 빛의 방향 벡터입니다.
      diffuse/specular는 RGBA 색상이며 cast_shadows는 그림자 생성을 제어합니다.
    -->
    <light type="directional" name="sun_diffuse_2">
      <!--
        위치·자세: x y z는 m, 뒤의 roll pitch yaw는 rad입니다. relative_to가 없으면 상위 요소의 좌표계를 기준으로 합니다.
      -->
      <pose>-150 -130 50 0 0 0</pose>
      <diffuse>0.6 0.6 0.6 1</diffuse>
      <specular>0.2 0.2 0.2 1</specular>
      <direction>0.5 0.5 -1</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <plugin filename="gz-sim-buoyancy-system" name="gz::sim::systems::Buoyancy">
      <!--
        부력 계산에 쓰는 층별 유체 밀도이며 단위는 kg/m^3입니다. default_density는 경계 아래에 적용되고 above_depth는 밀도가 바뀌는
        높이입니다. 이 예제의 경계는 z=0입니다.
      -->
      <graded_buoyancy>
        <default_density>1025</default_density>
        <density_change>
          <above_depth>0</above_depth>
          <density>1</density>
        </density_change>
      </graded_buoyancy>
    </plugin>
    <!--
      모델 구성: link는 강체, joint는 강체 사이의 연결을 정의합니다. plugin은 시뮬레이션 기능을 제공합니다. 모델·링크·관절 이름은 내보낸 제어
      설정과 일치해야 합니다.
    -->
    <model name="gebco_terrain">
      <!--
        정적 모델은 중력이나 접촉력으로 움직이지 않습니다. 지형은 정적으로 두고 차량 링크는 동적으로 계산합니다.
      -->
      <static>true</static>
      <!--
        강체와 그 로컬 좌표계입니다. 이 링크의 형상, 질량 특성, 센서는 함께 움직입니다.
      -->
      <link name="terrain">
        <!--
          물리 계산에 쓰는 충돌 형상입니다. 크기와 위치를 선체에 맞추세요. 단순한 형상은 충돌 계산량을 줄입니다.
        -->
        <collision name="gebco_collision">
          <geometry>
            <!--
              메시 파일과 축별 배율입니다. 내보낸 경로와 리소스 파일을 함께 보관하세요. scale은 메시 좌표에 곱하는 값입니다.
            -->
            <mesh>
              <uri>terrain.dae</uri>
            </mesh>
          </geometry>
        </collision>
        <!--
          화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
        -->
        <visual name="seabed">
          <geometry>
            <!--
              메시 파일과 축별 배율입니다. 내보낸 경로와 리소스 파일을 함께 보관하세요. scale은 메시 좌표에 곱하는 값입니다.
            -->
            <mesh>
              <uri>terrain-visual.dae</uri>
            </mesh>
          </geometry>
          <!--
            표면의 시각적 재질입니다. RGBA 색상과 PBR 텍스처가 렌더링에 적용됩니다. 지형 텍스처 경로와 내보낸 리소스를 함께 유지하세요. 재질 설정으로
            질량이나 마찰이 자동 변경되지는 않습니다.
          -->
          <material>
            <ambient>0.6 0.6 0.6 1</ambient>
            <diffuse>1 1 1 1</diffuse>
            <specular>0.03 0.03 0.03 1</specular>
            <pbr>
              <metal>
                <albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-diff-1803d7e2861b304b.jpg</albedo_map>
                <roughness>1</roughness>
                <normal_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-nor_gl-0f35185b7225fe20.jpg</normal_map>
                <roughness_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-rough-318b440c109de741.jpg</roughness_map>
                <metalness>0</metalness>
              </metal>
            </pbr>
          </material>
        </visual>
        <!--
          화면과 카메라에 보이는 형상입니다. 시각 형상을 바꿔도 충돌 형상이나 질량이 자동으로 바뀌지는 않습니다.
        -->
        <visual name="land">
          <geometry>
            <!--
              메시 파일과 축별 배율입니다. 내보낸 경로와 리소스 파일을 함께 보관하세요. scale은 메시 좌표에 곱하는 값입니다.
            -->
            <mesh>
              <uri>terrain-visual-land.dae</uri>
            </mesh>
          </geometry>
          <!--
            표면의 시각적 재질입니다. RGBA 색상과 PBR 텍스처가 렌더링에 적용됩니다. 지형 텍스처 경로와 내보낸 리소스를 함께 유지하세요. 재질 설정으로
            질량이나 마찰이 자동 변경되지는 않습니다.
          -->
          <material>
            <ambient>0.6 0.6 0.6 1</ambient>
            <diffuse>1 1 1 1</diffuse>
            <specular>0.03 0.03 0.03 1</specular>
            <pbr>
              <metal>
                <albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/land-satellite-eb6fd1423859d847a276a4db49db6db51a61fe8965171639c94f8d3df66e0199.png</albedo_map>
                <roughness>1</roughness>
                <metalness>0</metalness>
              </metal>
            </pbr>
          </material>
        </visual>
      </link>
    </model>
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu" />
    <!--
      엔진 플러그인입니다. filename은 설치된 라이브러리, name은 구현 이름을 가리킵니다. 수치 설정을 업로드할 때 두 값을 유지하세요. SDF
      파일만으로 플러그인이 설치되지는 않습니다.
    -->
    <plugin filename="gz-sim-magnetometer-system" name="gz::sim::systems::Magnetometer" />
    <!--
      월드 중력 벡터 x y z이며 단위는 m/s^2입니다. 이 ENU 월드에서 z의 음수 방향이 아래쪽입니다.
    -->
    <gravity>0 0 -9.81</gravity>
    <!--
      자력계 시뮬레이션에 쓰는 월드 자기장 벡터 x y z입니다. 단위는 테슬라(T)입니다.
    -->
    <magnetic_field>5.64e-6 2.29e-5 -4.2e-5</magnetic_field>
    <!--
      표준 SDF 바람 속도이며 단위는 m/s입니다. 운동에 영향을 주려면 힘 모델이 이 값을 사용해야 합니다. 파도와 해류는 각각의 장면 설정에서 조정하세요.
    -->
    <wind>
      <linear_velocity>0 0 0</linear_velocity>
    </wind>
  </world>
</sdf>

이 예제는 Linux 엔진에서 내보낸 파일입니다. 특히 macOS에서는 사용하는 호스트에서 직접 내려받은 파일로 수정하세요. 플러그인 라이브러리가 설치된 실행 환경과 맞아야 합니다.

직접 생성한 지형에 적용하기

원하는 지형을 생성하고 선택한 뒤 시작 전 검토에서 월드 SDF를 내려받으세요. 그 지형에 맞는 모델 경로와 지리 원점이 내보내집니다. 한국해양대학교 예제의 지형 경로를 바꾸기보다, 내려받은 파일에 같은 물리·조명 설정을 적용하세요.

파일을 옮겨 보관하려면 선택한 지형의 ZIP을 내려받고 월드 파일과 상대 경로의 자료를 함께 유지하세요. 앱의 월드 SDF 업로드는 저장된 해당 지형에 설정을 적용합니다. 이 입력란으로 ZIP의 지형 자체를 업로드하지는 않습니다. 먼저 지형 준비 과정으로 지형을 생성하거나 복원하세요.

긴 실험 전에 결과 비교하기

같은 차량, 출발 위치와 센서를 사용해 변경 전후를 비교하세요. 적용된 시간 간격, 측정 배속, 조명 방향, 카메라와 차량 움직임을 확인하세요. 요청 배속을 높여도 렌더링과 센서 전송이 반드시 빨라지지는 않습니다. 원본을 보관하면 기본 설정을 선택하거나 이전 사본을 다시 업로드할 수 있습니다.

성능과 표시 설정

시뮬레이션 시간 이해하기

실측 배속(RTF)은 실제 1초 동안 진행한 시뮬레이션 시간입니다. 요청 배속은 목표이며, RTF가 1 미만이면 현재 부하에서 실시간보다 느리게 실행됩니다.

물리 간격을 바꾸면 두 기본 로봇의 정지·회전·충돌 여유·잠수·귀환을 확인하세요.

카메라와 그래픽 조정하기

불필요한 카메라의 주기와 해상도부터 낮추세요.

화면 렌더링 위치
센서 영상 엔진 컴퓨터의 Gazebo
개인 Vehicle / World · Browser 선택 브라우저 GPU
개인 Vehicle / World · Gazebo 선택 엔진 컴퓨터의 Gazebo · 설치형 앱의 기본값
공개 LIVE Vehicle / World Gazebo 관측 카메라

브라우저 조명은 하늘·반사·톤 매핑·수면 법선에 적용합니다. 파도 형상은 물리 계산의 표본을 사용합니다.

그래픽 진단에서 같은 장면의 값을 비교하세요.

이동형 지형은 지형 LOD: 차량 가까이는 자세하게로 먼 시각 메시를 자동으로 줄입니다. 충돌 격자·센서 처리 비용은 별도로 남습니다. 브라우저 장면을 선택해도 로봇 카메라와 GPU LiDAR는 Gazebo를 사용합니다. 영상 FPS, 센서 Hz, 물리 RTF를 따로 비교하세요.

하드웨어 용량 측정하기

같은 월드·로봇·센서 주기·목표 배속으로 장비를 비교합니다. 한 세션부터 시작해 세션 수를 늘리며, 지형 준비의 순간 부하도 확인하세요.

Gazebo 물리는 코어당 성능, 지형·센서는 여러 코어의 처리량에 영향을 받습니다. 카메라 수와 해상도가 늘면 GPU 부하도 커집니다. 공개 항해 관람자는 같은 월드를 공유합니다.

Apple Silicon 앱은 Metal을 사용합니다. Ubuntu·Windows/WSL의 Docker 엔진은 이미지에 맞는 그래픽 드라이버와 런타임이 필요합니다.

사용 시간과 저장 공간

공개 LIVE 관람은 개인 실행 시간에 포함되지 않습니다. 모델·원본·캐시는 계정별 저장 한도를 적용합니다. 엔진·모델 다운로드에 필요한 디스크 공간을 확보하세요. 이용시간은 계정과 사용 시간을 참고하세요.

문서 검색