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
- Selecciona un terreno de área fija ya preparado, elige el vehículo y abre la revisión de inicio.
- Abre Editar archivos SDF → Descargar SDF del mundo y guarda una copia de
world.sdf. - Modifica los campos compatibles de física e iluminación. Conserva modelos del terreno, rutas, nombre del mundo y origen geográfico.
- Pulsa Subir SDF del mundo editado. La revisión validada aparece en Configuración del mundo y queda seleccionada.
- 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.