WWW-POSIM v0.6.16Documentación del simulador
Menú de documentación
WWW-POSIM / Documentación del simulador

Personalizar los mundos

El SDF del mundo define el entorno de simulación. Parte del archivo exportado para el terreno elegido: contiene sus referencias, el origen geográfico y los sistemas del motor necesarios.

Descargar y aplicar un mundo

  1. Selecciona un terreno de área fija ya preparado, elige el vehículo y abre la revisión de inicio.
  2. Abre Editar archivos SDF → Descargar SDF del mundo y guarda una copia de world.sdf.
  3. Modifica los campos compatibles de física e iluminación. Conserva modelos del terreno, rutas, nombre del mundo y origen geográfico.
  4. Pulsa Subir SDF del mundo editado. La revisión validada aparece en Configuración del mundo y queda seleccionada.
  5. Inicia el mundo. Los ajustes se aplican después de preparar terreno y vehículo. Comprueba el paso de física, la velocidad medida y la iluminación.

Cada archivo queda vinculado a su revisión de terreno. Para otro terreno, descarga su propio archivo y vuelve a aplicar los ajustes. Configuración predeterminada del terreno recupera los valores iniciales. Se aceptan archivos .world o .sdf de hasta 1 MB. El flujo está disponible en mundos fijos sin evaluación; el terreno bajo demanda y las pruebas evaluadas usan sus ajustes asignados.

Ajustes compatibles

Sección SDF Parámetros y unidades
physics / max_step_size Intervalo de integración: 0.001–0.03 s. Reducirlo aumenta el cálculo.
physics / real_time_factor Tiempo simulado solicitado por tiempo real: mayor que 0 y hasta 10. El resultado depende de CPU y GPU.
gravity Vector de aceleración en m/s²; valor estándar 0 0 -9.81.
magnetic_field Vector del campo magnético en teslas.
scene Luz ambiente, color de fondo, sombras, cuadrícula y origen. Los colores usan RGBA.
light Hasta 32 luces con nombre, direccionales, puntuales o focos: pose, dirección, color, atenuación y ángulos del foco en radianes.
wind / linear_velocity Velocidad del viento SDF en m/s. Los modelos marinos de oleaje y corriente tienen controles e interpretación física propios.

La especificación SDFormat describe el esquema completo. La importación conserva el terreno y los sistemas necesarios y aplica los ajustes compatibles; no instala plugins, descarga modelos externos ni sustituye el terreno geográfico. Configura olas y corriente en el panel de escena. Su efecto en el vehículo se explica en Dinámica marina y renderizado.

Plantilla con terreno preparado

Descargar KMOU world.sdf. El ejemplo completo utiliza el terreno KMOU y muestra las secciones compatibles. Mallas e imágenes permanecen en el paquete de terreno, que puedes descargar desde el espacio de trabajo.

kmou.world
<?xml version='1.0' encoding='utf-8'?>
<sdf version="1.4">
  <!--
    Configuración del mundo para esta revisión del terreno. Conserva su nombre, recursos,
    origen geográfico y sistemas necesarios. Sube los ajustes de entorno admitidos desde
    la revisión de inicio.
  -->
  <world name="wwos_gebco">
    <!--
      Aspecto de la escena: ambient y background son colores RGBA. shadows, grid y
      origin_visual controlan su visualización. La tabla de ajustes del mundo indica qué
      campos, incluidos los del cielo, admite la carga.
    -->
    <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>
    <!--
      Tiempo de la física: max_step_size es el paso de integración en segundos;
      real_time_factor es la relación solicitada entre tiempo simulado y real. name es una
      etiqueta, no el paso. La velocidad efectiva depende de CPU/GPU.
    -->
    <physics name="1ms" type="ignored">
      <max_step_size>.02</max_step_size>
      <real_time_factor>1.0</real_time_factor>
    </physics>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <!--
      Ejecuta la dinámica de cuerpos rígidos y los cálculos de contacto. Mantén activado
      este sistema necesario.
    -->
    <plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics">
    </plugin>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <!--
      Proporciona comandos de Gazebo Transport para modificar la escena activa. Es necesario
      para las operaciones de escena del espacio de trabajo.
    -->
    <plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands">
    </plugin>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <!--
      Publica la estructura de la escena y las poses para que los visores sigan la
      simulación.
    -->
    <plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster">
    </plugin>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <!--
      Genera imágenes de cámara y datos de sensores GPU. render_engine selecciona el motor
      gráfico instalado; conserva el valor exportado por tu motor.
    -->
    <plugin filename="gz-sim-sensors-system" name="gz::sim::systems::Sensors">
      <render_engine>ogre2</render_engine>
    </plugin>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <!--
      Sistema del mundo necesario para sensores DVL personalizados. La configuración de
      haces y seguimiento está en el SDF del vehículo.
    -->
    <plugin filename="gz-sim-dvl-system" name="gz::sim::systems::DopplerVelocityLogSystem">
    </plugin>
    <!--
      Origen geográfico del terreno. Latitud, longitud y rumbo se expresan en grados;
      elevación, en metros. ENU significa este, norte, arriba. Conserva estos valores para
      alinear mapa, terreno y 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>
    <!--
      Fuente de luz. type elige luz direccional, puntual o focal; pose sitúa su marco y
      direction define el vector del haz. diffuse/specular son colores RGBA; cast_shadows
      controla las sombras.
    -->
    <light type="directional" name="sun1">
      <!--
        Pose: x y z en metros, seguidos de roll pitch yaw en radianes. Se usa el marco padre,
        salvo que relative_to indique otro.
      -->
      <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>
    <!--
      Fuente de luz. type elige luz direccional, puntual o focal; pose sitúa su marco y
      direction define el vector del haz. diffuse/specular son colores RGBA; cast_shadows
      controla las sombras.
    -->
    <light type="directional" name="sun_diffuse">
      <!--
        Pose: x y z en metros, seguidos de roll pitch yaw en radianes. Se usa el marco padre,
        salvo que relative_to indique otro.
      -->
      <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>
    <!--
      Fuente de luz. type elige luz direccional, puntual o focal; pose sitúa su marco y
      direction define el vector del haz. diffuse/specular son colores RGBA; cast_shadows
      controla las sombras.
    -->
    <light type="directional" name="sun_diffuse_1">
      <!--
        Pose: x y z en metros, seguidos de roll pitch yaw en radianes. Se usa el marco padre,
        salvo que relative_to indique otro.
      -->
      <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>
    <!--
      Fuente de luz. type elige luz direccional, puntual o focal; pose sitúa su marco y
      direction define el vector del haz. diffuse/specular son colores RGBA; cast_shadows
      controla las sombras.
    -->
    <light type="directional" name="sun_diffuse_2">
      <!--
        Pose: x y z en metros, seguidos de roll pitch yaw en radianes. Se usa el marco padre,
        salvo que relative_to indique otro.
      -->
      <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>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <plugin filename="gz-sim-buoyancy-system" name="gz::sim::systems::Buoyancy">
      <!--
        Densidad del fluido por capas para la flotabilidad, en kg/m^3. default_density se
        aplica bajo la transición; above_depth marca la altura del cambio. Aquí el límite está
        en z=0.
      -->
      <graded_buoyancy>
        <default_density>1025</default_density>
        <density_change>
          <above_depth>0</above_depth>
          <density>1</density>
        </density_change>
      </graded_buoyancy>
    </plugin>
    <!--
      Estructura del modelo: los eslabones definen cuerpos rígidos, las articulaciones los
      conectan y los plugins simulan su comportamiento. Conserva los nombres que utilizan
      los controladores exportados.
    -->
    <model name="gebco_terrain">
      <!--
        Los modelos estáticos permanecen fijos ante gravedad y contactos. El terreno es
        estático; los eslabones del vehículo son dinámicos.
      -->
      <static>true</static>
      <!--
        Cuerpo rígido y su sistema de coordenadas local. La geometría, las propiedades de masa
        y los sensores de este eslabón se desplazan juntos.
      -->
      <link name="terrain">
        <!--
          Geometría de contacto utilizada por la física. Ajusta sus dimensiones y posición al
          casco; una forma simplificada reduce el cálculo de colisiones.
        -->
        <collision name="gebco_collision">
          <geometry>
            <!--
              Recurso de malla y escala opcional por eje. Conserva la ruta exportada junto con sus
              archivos; la escala multiplica las coordenadas de la malla.
            -->
            <mesh>
              <uri>terrain.dae</uri>
            </mesh>
          </geometry>
        </collision>
        <!--
          Superficie visible para el renderizado y las cámaras. Cambiarla no ajusta
          automáticamente la colisión ni la masa.
        -->
        <visual name="seabed">
          <geometry>
            <!--
              Recurso de malla y escala opcional por eje. Conserva la ruta exportada junto con sus
              archivos; la escala multiplica las coordenadas de la malla.
            -->
            <mesh>
              <uri>terrain-visual.dae</uri>
            </mesh>
          </geometry>
          <!--
            Aspecto de la superficie. Los colores RGBA y mapas PBR afectan al renderizado.
            Conserva las texturas del terreno con los recursos exportados; el material no cambia
            automáticamente masa ni fricción.
          -->
          <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>
        <!--
          Superficie visible para el renderizado y las cámaras. Cambiarla no ajusta
          automáticamente la colisión ni la masa.
        -->
        <visual name="land">
          <geometry>
            <!--
              Recurso de malla y escala opcional por eje. Conserva la ruta exportada junto con sus
              archivos; la escala multiplica las coordenadas de la malla.
            -->
            <mesh>
              <uri>terrain-visual-land.dae</uri>
            </mesh>
          </geometry>
          <!--
            Aspecto de la superficie. Los colores RGBA y mapas PBR afectan al renderizado.
            Conserva las texturas del terreno con los recursos exportados; el material no cambia
            automáticamente masa ni fricción.
          -->
          <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>
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu" />
    <!--
      Plugin del motor. filename identifica una biblioteca instalada y name selecciona su
      implementación. Conserva ambos al subir cambios numéricos; el SDF no instala plugins.
    -->
    <plugin filename="gz-sim-magnetometer-system" name="gz::sim::systems::Magnetometer" />
    <!--
      Vector de gravedad mundial x y z en m/s^2. En este mundo ENU, z negativo apunta hacia
      abajo.
    -->
    <gravity>0 0 -9.81</gravity>
    <!--
      Vector del campo magnético mundial x y z en teslas, usado por la simulación del
      magnetómetro.
    -->
    <magnetic_field>5.64e-6 2.29e-5 -4.2e-5</magnetic_field>
    <!--
      Velocidad del viento estándar de SDF, en m/s. Un modelo de fuerzas debe usar este
      valor para afectar al movimiento. Configura olas y corrientes con sus controles de
      escena.
    -->
    <wind>
      <linear_velocity>0 0 0</linear_velocity>
    </wind>
  </world>
</sdf>

La plantilla procede del motor Linux. Para tu host, especialmente macOS, utiliza su propia exportación; las bibliotecas de plugins deben corresponder a la instalación.

Usar un terreno generado por ti

Genera y selecciona el terreno y descarga su SDF en la revisión de inicio. Así obtienes sus rutas y origen geográfico correctos. Repite las modificaciones de física o luz en ese archivo.

Para conservar una copia transportable, descarga el ZIP del terreno y guarda el mundo junto a sus recursos relativos. El control SDF aplica ajustes al terreno guardado correspondiente; no importa el terreno de un ZIP. Primero crea o restaura el terreno mediante su flujo de preparación.

Comparar antes de una sesión larga

Usa el mismo vehículo, posición inicial y sensores en ambas pruebas. Comprueba paso temporal, relación de tiempo real, dirección de la luz, cámaras y movimiento. Un factor solicitado mayor no garantiza más velocidad de renderizado o de recepción de sensores. Conserva el original para recuperar los valores predeterminados o volver a importar una copia anterior.

Rendimiento y visualización

El factor de tiempo real (RTF) mide segundos simulados por segundo real. La velocidad solicitada es un objetivo; un RTF inferior a 1 indica una ejecución más lenta que el tiempo real. El paso afecta contactos, olas, sensores y estabilidad del control; el retardo de red afecta órdenes e imágenes. Por encima de 1× se oculta AIS en directo. La frecuencia de cámara limita la actualización visual.

Tras cambiar el paso, prueba reposo, giros, distancia libre, inmersión y regreso con ambos vehículos incluidos.

Vista Renderizador
Imágenes de sensores Gazebo en el host del motor
Vehículo/mundo personal con navegador GPU del navegador
Vehículo/mundo personal con Gazebo Gazebo en el host; predeterminado en la aplicación
Vehículo/mundo de LIVE público Cámaras de observación de Gazebo

Reduce primero las cámaras innecesarias, su frecuencia y resolución. La iluminación del navegador controla cielo, reflejos, mapeo tonal y normales del agua; la geometría de las olas usa muestras del modelo físico.

Compara diagnósticos gráficos en la misma escena: FPS, tiempo de fotograma p95, llamadas de dibujo, triángulos, texturas y geometría. El terreno móvil simplifica la geometría visual lejana mediante Algoritmos de generación del terreno. Las colisiones y los sensores tienen costes propios. El renderizador del navegador sigue necesitando Gazebo para cámaras y LiDAR GPU: compara por separado FPS de vídeo, Hz de sensores y RTF.

Para dimensionar hardware, usa el mismo mundo, vehículo, frecuencias y velocidad. Empieza con una sesión, aumenta la concurrencia e incluye los picos de preparación de terreno. Mide RTF mediano y percentil 5, tiempo del paso físico, recepción y antigüedad de imágenes, CPU, memoria, GPU y VRAM. La física depende del rendimiento por núcleo; terreno y sensores también usan varios núcleos. Más cámaras y resolución aumentan la carga GPU. Los espectadores de LIVE comparten un mundo.

Apple Silicon usa Metal. Los motores Docker de Ubuntu y Windows/WSL requieren controladores y runtimes compatibles con sus imágenes. LIVE no consume tiempo personal; modelos, archivos y cachés tienen límites de almacenamiento. Reserva espacio para el motor y los modelos. Véase Cuentas y tiempo de uso.

Buscar en la documentación