Conocer el espacio de trabajo
Empieza con un terreno preparado y aprende a leer los paneles antes de enviar órdenes al vehículo.
Entrar y abrir el primer mundo
- Crea una cuenta en WWW-POSIM, verifica el correo e inicia sesión. Si falta el mensaje, revisa el correo no deseado o solicita otro. La verificación también es necesaria en la aplicación instalada.
- En la aplicación, pulsa Iniciar simulador. En la web, abre tu espacio personal; puede haber una cola de acceso al servidor.
- Abre Espacio de trabajo, elige Terreno pregenerado y selecciona KMOU waterfront · 1 × 1 km.
- En Terreno regional → Vehículo, elige WAM-V, profundidad 0 m y Autopilot.
- Pulsa Iniciar mundo generado y espera a que aparezcan el vehículo y datos de posición recientes. La ventana inicial de la aplicación permanece abierta hasta que el mundo está funcionando.

| Entrada | Para qué sirve |
|---|---|
| Demostraciones | Abre WAM-V o BlueROV2; las demás vistas previas indican su disponibilidad. |
| Terreno pregenerado | Reúne terrenos preparados, descargables y generados que ya están listos. |
| Zona de práctica | Prepara el ejercicio cuando está disponible. |
| Mundo personalizado | Da acceso al terreno regional, editor de vehículos, herramientas RViz y almacenamiento. |
| Ubicación → Vehículo → Revisión | Selecciona el terreno, el vehículo y su posición inicial; revisa los ajustes antes de iniciar. |
Elige Autopilot o ROS 2 directo antes de iniciar el mundo. Para cambiar de tipo de control, inicia otro mundo con la opción deseada. Cambiar el modo de ArduPilot es una operación diferente. Las coordenadas y la profundidad deben respetar los límites indicados. La semilla de práctica admite enteros de 0 a 1 000 000; vacía genera una disposición automática. La exploración libre y las ejecuciones de referencia del administrador no usan esa semilla.
La aplicación Mac descarga cada terreno preparado cuando se selecciona por primera vez y muestra el progreso. Después queda disponible sin conexión, con la revisión de contenido fijada. Si falla, comprueba la conexión y vuelve a seleccionarlo. El ejemplo WAM-V utiliza Hong Kong, con una boya coral a 16 m por delante y 5 m a la izquierda, y otra lima a 30 m por delante y 8 m a la derecha. Obsérvalas con la cámara frontal y el LiDAR.
Orientarse en la interfaz

| Zona | Contenido |
|---|---|
| Barra superior | Vehículo, terreno, estado en directo, espacio de trabajo, idioma y botones para ampliar la escena u ocultar paneles. También muestra la sesión cuando hay control de tiempo de uso. |
| Centro | Escena con vistas del vehículo, del mundo y del mapa. |
| Izquierda | Entorno y visualización en Escena; mediciones en Sensores y temas ROS. |
| Derecha | Control ArduPilot o ROS 2; debajo, instrumentos y gráficas del vehículo. |
| Mapa inferior | Posición geográfica, puntos de ruta y órdenes de misión en Control terrestre. |
Expande las cabeceras o sus botones + / −. El contenido se desplaza dentro del espacio disponible; al abrir una sección puede compactarse otra. Paneles oculta o muestra los paneles. Enfocar escena amplía la escena y mantiene accesible el mapa. Estas acciones no detienen la simulación. En la entrada inicial también están las opciones para volver a la página principal y cerrar sesión.
| Vista o acción | Resultado |
|---|---|
| Vehículo | Sigue al vehículo; permite orbitar y acercar la cámara. |
| Mundo | Vista oblicua del entorno cercano, con límites de zoom y órbita. |
| Mapa | Mapa geográfico orientado al norte con la posición simulada; arrastra para desplazarte. |
| Arrastrar, botón derecho y rueda | Desplazamiento, órbita y zoom según las indicaciones de la vista. |
| Borrar recorrido | Borra de la vista la ruta prevista y la trayectoria recorrida. El registro continúa desde la posición actual y se conserva el informe de misión. |
La brújula inferior describe la cámara de observación, no el rumbo del vehículo. La flecha fija señala hacia delante y las letras giran para situar el norte. El tiempo mostrado es tiempo simulado. 1,00× significa que avanza al mismo ritmo que el tiempo real.
Las trazas usan amarillo para la ruta prevista y verde azulado para el recorrido medido. Conservan hasta 1 024 segmentos. Una nueva misión guiada borra la traza de Gazebo. Las líneas de 5 mm de la escena no aparecen en las imágenes de los sensores.
Escena, olas y corriente

| Sección | Uso |
|---|---|
| Olas | Selecciona un estado del mar de 0 a 4 y aplica los valores. Los ajustes avanzados permiten editar viento, dirección y pendiente. |
| Corriente oceánica | Activa la corriente, selecciona un flujo uniforme o un perfil de profundidad y pulsa Aplicar corriente. Espera la confirmación del solucionador. |
| Tráfico marítimo | Muestra embarcaciones a partir de informes AIS recientes. La disponibilidad depende de la cobertura y la velocidad de simulación. |
| Renderizador de escena | Elige Browser o Gazebo cuando estén disponibles y abre los efectos submarinos. |
| Visualización | Activa fondo, superficie, cuadrícula y ejes; ajusta iluminación, opacidad del agua y mapa cuando la vista lo permite. |
| Rendimiento gráfico | Muestra estadísticas medidas del renderizado del navegador. |
Los espacios libres empiezan con estado del mar 2. Los preajustes usan viento de 0, 1, 3, 6 y 8 m/s y pendiente 1; son aproximaciones, no alturas de ola garantizadas. El botón informativo muestra los intervalos WMO. En los ejercicios se mantienen las condiciones asignadas.
Detén la misión o el control ROS antes de cambiar la corriente. El perfil admite hasta ocho nodos, comienza a 0 m de profundidad y permite velocidades de 0–1 m/s. Arrastra los nodos horizontalmente para cambiar la velocidad; la tabla edita profundidad y dirección. 0° significa este y 90° norte, según hacia dónde fluye el agua. Los vectores se interpolan linealmente a la profundidad real de cada enlace en cada paso físico. Bajo el último nodo se conserva su corriente. La corriente modifica el arrastre relativo al agua; las olas mantienen su propio modelo.
La aplicación instalada abre Gazebo por defecto. Browser reduce el trabajo de la cámara de escena de Gazebo; la física, cámaras y LiDAR GPU siguen calculándose en Gazebo. La selección dura mientras esté abierta esa vista. La cámara de seguimiento de BlueROV2 suaviza el movimiento y muestra la superficie. Arrastrar verticalmente en las vistas compatibles permite observar desde debajo.
Apariencia submarina
Abre Escena → Renderizador de escena → Apariencia submarina. Los cambios afectan a la escena Gazebo y al color de las cámaras, incluido RGBD; conservan los valores de profundidad y la geometría de colisión.
- Textura de arena, neblina, absorción del color, atenuación solar y patrones de luz en el fondo: activados inicialmente.
- Cuadrícula, curvas de nivel y partículas: desactivados inicialmente; separaciones predeterminadas de 10 m y 5 m para cuadrícula y curvas.
- La demo BlueROV2 KMOU comienza con las partículas suspendidas activadas y la atenuación solar según la profundidad desactivada. Los ajustes guardados en la aplicación instalada tienen prioridad sobre estos valores predeterminados de la demo.
- El control de óptica del agua agrupa los efectos ópticos; textura y líneas se eligen por separado.
- La aplicación instalada guarda los ajustes confirmados; las sesiones del servidor empiezan con los valores predeterminados. No se pueden cambiar durante una evaluación.
Gazebo muestra los efectos completos; Browser comparte los detalles de arena y las líneas del fondo. El modelo visual usa un nivel medio del mar plano y superficies PBR. Los materiales sin iluminación y los sombreadores propios del agua tienen su apariencia particular. Partículas y patrones de luz son aproximaciones visuales. La visibilidad útil depende de neblina, atenuación y oclusión además del recorte geométrico. Consulta Especificaciones y Dinámica marina y renderizado.
Sensores y temas ROS

Selecciona el vehículo en Sensores y abre una cámara, LiDAR o IMU. La lista depende del modelo. La cámara de inspección orientada hacia abajo sirve para observar el fondo.
| Control | Acción |
|---|---|
| Iniciar/detener transmisión | Controla la recepción de esa imagen; la simulación sigue ejecutándose. |
| Ampliar / Guardar imagen | Amplía la imagen o guarda el fotograma recibido. |
| Frecuencia del sensor | Solicita una frecuencia de entrega; el indicador medido muestra la recepción real. |
| Zoom digital / Restablecer | Amplía la imagen recibida o recupera la escala inicial. |
| Temas ROS → buscar → tema | Abre un mensaje; suscribirse o cancelar la suscripción controla su recepción. |
| Campo / Gráfica / Datos sin procesar / Dibujar | Muestra campos numéricos o mensajes espaciales compatibles según el tipo y el marco de referencia. |
La cámara de escena es un observador externo. La cámara del sensor tiene la posición y orientación del vehículo. No tienen por qué mirar en la misma dirección.
Estados de la transmisión
Conectando o En espera indica que se prepara el sensor o el transporte. Comprueba la hora de recepción. Una imagen retenida marcada como desactualizada o en reconexión no es una medición reciente. Confirma primero que el mundo está listo y el sensor seleccionado es el correcto.
La demostración pública de Hong Kong usa vídeo H.264 compartido con un búfer inicial. Las cámaras personales solicitan imágenes JPEG; las imágenes ROS comprimidas siguen otra vía. Guardar un fotograma captura el vídeo mostrado en la demostración y el archivo de imagen recibido en el espacio personal. La frecuencia del sensor, los FPS de vídeo y el factor de tiempo real miden cosas distintas. Consulta Simulación, renderizado y sensores y Visualización con RViz y Foxglove.
ArduPilot y control manual


Comprueba la telemetría, el armado y el modo indicado en la cabecera. Centra las entradas manuales y termina o cancela la misión antes de cambiar de modo. Selecciona Modo de vuelo, aplica y verifica el valor recibido: el desplegable expresa una solicitud.
Armar habilita la propulsión tras las comprobaciones previas. Desarmar la deshabilita y cancela la misión. Seleccionar un modo no arma el vehículo. Si se rechaza una orden, lee el error y los detalles de conexión; una imagen de cámara por sí sola no confirma que el control esté listo.
| Vehículo | Modos del menú |
|---|---|
| WAM-V · ArduRover | MANUAL: aceleración y giro directos. HOLD: propulsión neutra, con posible deriva por inercia, olas o corriente. STEERING: control asistido de velocidad y giro. |
| BlueROV2 · ArduSub | MANUAL: control directo. STABILIZE: estabiliza la actitud, con profundidad manual. ALT_HOLD: añade mantenimiento de profundidad; no mantiene la posición horizontal. |
Las misiones comprobadas solicitan GUIDED y arman el controlador durante el inicio. Ese modo lo gestiona la misión; no aparece como opción manual. Consulta Misiones con piloto automático.

Activa la entrada de joystick y elige ratón/táctil o mando. WAM-V ofrece aceleración y giro; BlueROV2 añade desplazamiento lateral y vertical. Empieza con entradas centradas y ganancia baja. Detener entrada cancela la pulsación actual; suelta y vuelve a pulsar para reanudar. Perder el foco, desarmar, cambiar la fuente o recibir un rechazo también termina esa pulsación.
Con mando, mantén LB/L1 mientras accionas las palancas. Soltarlo envía una entrada neutra; no desarma ni detiene de inmediato un vehículo en movimiento. En BlueROV2, Y/Triángulo solicita ALT_HOLD y A/Cruz, STABILIZE. Comprueba el modo recibido. Las asignaciones completas están en Control manual y con mando.
Mapa y misiones
Los puntos submarinos nuevos empiezan a 2 m. El intervalo normal es de 0–10 m; en las escenas de inspección compatibles, consulte el Límites de profundidad de misión que muestra el servidor.

Completa coordenadas y profundidad antes de comprobar la ruta. Los puntos de superficie usan 0 m y cada punto del mapa espera un segundo. Al editar, los campos vacíos permanecen vacíos.
| Acción | Resultado |
|---|---|
| Clic / clic derecho | Añade un punto / elimina uno cercano. Arrastrar, rueda o gesto de pinza desplazan y amplían el mapa. |
| Volver al inicio / Borrar | Configura el regreso / borra los puntos editables. |
| Comprobar ruta | Calcula la vista previa con comprobación del terreno. Revisa recorrido, margen y posibles bloqueos. |
| Ejecutar ruta | Inicia la ruta validada y arma tras las comprobaciones. |
| Detener / Continuar / Abortar | Mantiene un objetivo de espera / reanuda / cancela y desarma. |
Comprueba de nuevo antes de otra ejecución, porque el vehículo puede haberse movido. Los puntos del mapa tienen prioridad sobre los escenarios predefinidos; bórralos para usar un escenario. La comprobación evalúa terreno y margen del casco, sin garantizar evasión de barcos en movimiento ni cumplimiento de COLREG. Consulta Misiones con piloto automático.
Instrumentos del vehículo

El marcador azul fijo representa el vehículo. El horizonte móvil muestra balanceo y cabeceo. El rumbo usa 0° norte, 90° este, 180° sur y 270° oeste. La profundidad es −Z respecto al nivel cero del mar: positiva bajo él, negativa por encima; no es la distancia al fondo.
La gráfica conserva las últimas 100 muestras de posición. Elige profundidad, rumbo, cabeceo, balanceo, velocidad o empuje solicitado. Profundidad, actitud y velocidad proceden del simulador. La velocidad muestra X hacia delante, Y a la izquierda y Z hacia arriba, en m/s. El empuje representa órdenes en newtons, no fuerza medida. Los datos ausentes o antiguos producen huecos o —. Profundidad y actitud comparten muestra y tiempo; la demostración las sincroniza con el vídeo.
Velocidad y paso físico
Los cambios se envían al seleccionar un valor; espera la confirmación.
| Ajuste | Valores |
|---|---|
| Velocidad solicitada | 0,25×, 0,5×, 1×, 2× y 4× |
| Paso físico | 5, 10 o 20 ms; también aparece 30 ms si el mundo ya lo usa |
| Real | Tiempo simulado dividido por tiempo real; puede ser inferior al objetivo |
Es necesario que el vehículo esté desarmado, no haya misión ni entradas manuales/ROS activas y el terreno esté listo. Por encima de 1×, AIS no está disponible. Windows y Linux empiezan con 20 ms; Mac nativo, con 10 ms. Los ejercicios mantienen sus 10 ms obligatorios. Consulta Personalizar los mundos.
Posición y conexiones
N/E/D expresa norte, este y abajo en metros respecto al origen local. Las coordenadas geográficas son latitud y longitud en grados. R/P/Y · ENU son ángulos brutos: guiñada 0° al este y 90° al norte. El instrumento presenta cabeceo −P y rumbo (90 − Y + 360) % 360.
Los detalles de conexión muestran secuencia, antigüedad y marco ENU de la posición. Una secuencia creciente y datos recientes confirman nuevas muestras. El panel de control tiene sus propios diagnósticos. RViz abre el visor compatible: RViz2 nativo en la aplicación y visor web en el navegador. Requiere un mundo listo y, en la aplicación, el servicio RViz disponible. Consulta Visualización con RViz y Foxglove. Los parámetros de ArduPilot se leen, exportan y editan en su propio panel; las modificaciones permitidas se aplican desarmado y se verifican por lectura posterior.
Control ROS 2 directo

Habilita ROS para aceptar órdenes acotadas del controlador conectado. Detener ROS mantiene una salida neutra hasta que vuelvas a habilitarla. Los diagnósticos muestran motivo, secuencia aplicada, confirmación y empujes. El temporizador de vigilancia devuelve la salida a neutro si dejan de llegar órdenes. Sigue Terminales ROS y conexión, Controlar un espacio de trabajo web o Controlar un espacio de trabajo local.
Guardar y transferir recursos
En Espacio de trabajo → Mundo personalizado → Almacenamiento, revisa terrenos, revisiones de vehículos, configuraciones de mundo, cachés y espacio libre. Archivar oculta un recurso, pero conserva sus archivos y no libera espacio. Restaurar vuelve a mostrarlo. Espera a que terminen las sesiones que lo utilizan.
Exportar/importar ZIP transfiere un vehículo con sus recursos. Editar una copia crea una revisión nueva. Antes de iniciar, puedes descargar el SDF del vehículo y del mundo, modificarlos y cargar una revisión compatible. Consulta Preparar un vehículo, Personalizar el vehículo y Personalizar los mundos.
Pantallas pequeñas y estados de espera
En el móvil, los botones inferiores abren un solo panel desplazable. Ciérralo con × o Escape para volver a la escena. En horizontal, el panel queda junto a los controles. La vista de escritorio de la demostración pública escala la disposición completa; en vertical pide girar el teléfono. La pantalla completa depende del navegador y de una acción del usuario.
Un botón deshabilitado suele indicar preparación incompleta, terreno pendiente, una misión activa o una orden en curso. Lee el estado antes de reintentar. Ocultar paneles, borrar trazas, detener imágenes o cancelar una suscripción no detiene el vehículo. Al terminar, finaliza la sesión. Cerrar la aplicación instalada detiene los servicios locales y la generación de terreno; conserva los datos guardados.
Credenciales AIS
Las demostraciones usan la credencial AISStream del servidor. Sin ella, las demostraciones instaladas usan el servicio AIS público de Open Waters. El panel indica proveedor y estado; los barcos visibles dependen de informes recientes.
En un mundo personalizado, introduce tu propia clave en Escena → Tráfico marítimo y guárdala localmente. Se almacena en este navegador y se envía al servidor de simulación seleccionado. Eliminar la clave local la borra del navegador. Activa el tráfico para conectar. Consulta Simulación, renderizado y sensores.
Controlar con QGC
Para un vehículo con Autopilot, selecciona Open QGC en el panel ArduPilot. Mantén abiertas la aplicación instalada y la sesión del espacio de trabajo. El diálogo prepara el vehículo y entrega el control a QGroundControl. Consulta Controlar con QGC para instalar, conectar y liberar el control.
- Controlar un espacio de trabajo local
- Controlar un espacio de trabajo web
- Controlar ArduPilot con Python
Luces delanteras BlueROV2
Use Luces delanteras en el joystick para cambiar ambas lámparas BlueROV2 a ON/OFF. La lectura confirma su estado real; un comando fallido o no disponible no aparece como éxito. La iluminación del vehículo es independiente del día/noche de la escena y la cámara.