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

Modelos y parámetros de sensores

Este catálogo describe cómo se generan las medidas: sensores de renderizado y cinemáticos de Gazebo, complementos acústicos de POSIM y adaptadores de la aplicación. Integrado identifica el robot suministrado; generador, un vehículo recién creado; proveedor, una función que requiere su complemento compatible. El SDF final y sensor-manifest.json definen la configuración guardada.

De la simulación a la medida

  1. Estado físico o geometría renderizada

    Gazebo aporta movimiento, campos del mundo o intersecciones de rayos. Cada sensor tiene transformación de montaje y reloj de adquisición.

  2. Modelo de medida

    El complemento proyecta imágenes, forma medidas inerciales, resuelve velocidades por haces o calcula retornos acústicos. Aquí se aplican ruido y validez.

  3. Mensajes y sistemas de coordenadas

    Los puentes ROS–Gazebo y adaptadores POSIM conservan las medidas, asignan marcos, convierten unidades e indican datos no disponibles.

  4. Algoritmo o visualización

    El controlador o estimador usa medidas con marca de tiempo. La interfaz puede comprimir imágenes, almacenarlas en búfer o entregarlas a menor frecuencia.

Configuración y tiempo compartidos

Parámetro Significado
sensor/@type, gz:type Seleccionan camera, rgbd_camera, gpu_lidar, imu, magnetometer o GNSS/DVL/multihaz personalizado. El mundo también debe cargar el sistema correspondiente.
pose x/y/z en metros, alabeo/cabeceo/guiñada en radianes respecto al enlace padre. Generador: posiciones ±10 m, cada ángulo ±2π.
update_rate Adquisiciones solicitadas por segundo simulado; generador 0,1–30 Hz. Paso físico, renderizado y transporte pueden reducir la frecuencia observada. Subirla no crea estados físicos entre pasos.
always_on, conexiones Controlan la activación. Las cámaras integradas se solicitan bajo demanda; los sensores del generador usan always_on=true. Un proveedor o renderizador que no arranque puede dejar el sensor sin datos.
topic, frame_id, TF El generador usa /vehicle/sensors/{id}. Montajes relativos a vehicle/base_link. Ejes ópticos: derecha/abajo/adelante; ejes del cuerpo: adelante/izquierda/arriba.
Marca de adquisición Tiempo simulado de la medida. Debe conservarse al registrar y fusionar. Tiempo de reproducción HLS y recepción del navegador describen transporte.
noise Depende del complemento. La IMU admite ruido blanco, sesgo y sesgo dinámico por eje; la cámara usa media y desviación típica. La misma etiqueta XML no implica el mismo modelo de error.

Los sensores de Gazebo definen los modelos base. Los parámetros del motor no están todos disponibles en el generador. La carga de SDF de WWW-POSIM permite modificar valores admitidos de bloques existentes y conserva su estructura; añade los sensores disponibles desde el generador. Los bloques opcionales de Gazebo que se mencionan aquí describen capacidad del motor, no una promesa de que cualquier XML se pueda cargar.

Cámaras RGB: frontal e inferior

CameraSensor proyecta geometría mediante una cámara estenopeica sobre un destino Ogre2. Publica imagen y calibración. Materiales, luz, oclusión y Dinámica marina y renderizado determinan el color. Las cámaras suministradas no modelan obturador rodante, electrónica de exposición ni suciedad de lente.

Parámetro Selección
camera/image/width, height Frontal integrada y del generador: 640×480; inferior del generador: 800×600. Dimensiones editables 64–1920; ancho × alto × frecuencia ≤30 millones de píxeles/s por cámara.
camera/horizontal_fov Frontal integrada: 1,05 rad; generador: 1,4 rad, intervalo 0,1–3. Resolución y campo de visión determinan muestreo angular y calibración.
camera/clip/near, far Frontal integrada: 0,1–5000 m; generador: 0,1–100 m. Es recorte geométrico, no visibilidad útil bajo el agua.
update_rate Inicialmente 5 Hz; el transporte tiene límites independientes.
camera/noise, distortion, lens/intrinsics Gazebo admite ruido gaussiano de imagen, distorsión radial/tangencial de Brown (k1, k2, k3, p1, p2) e intrínsecos suministrados. Las definiciones generadas no añaden bloques de ruido o distorsión. Registra SDF y CameraInfo.

Salidas: sensor_msgs/Image y sensor_msgs/CameraInfo. JPEG es una representación de transporte. Las vistas Mundo/Vehículo del observador no son sensores del robot. Implementación.

El adaptador se suscribe mientras haya demanda de imágenes. Una suscripción aceptada no demuestra recepción: tras 10 s reales sin fotograma, la renueva si sigue habiendo demanda. El estado en directo requiere una imagen nueva decodificada. Esto no modifica frecuencia simulada, marcas de adquisición ni controles de frescura de navegación.

Cámara RGB-D de inspección

RgbdCameraSensor genera color, profundidad en coma flotante y nube de puntos desde la misma geometría, usando el búfer de profundidad. No simula correspondencia estéreo ni un instrumento físico de luz estructurada/ToF. La atenuación del color del agua no añade incertidumbre al canal numérico.

Parámetro BlueROV2 integrado
pose (0.4, 0, −0.25) m en base_link, cabeceo π/4; lente inferior independiente.
Imagen y FOV 640×480, horizontal 1,05 rad.
Recorte 0,1–80 m. Gazebo admite límites depth_camera/clip separados; aquí no se sobrescriben por separado.
Frecuencia y activación 5 Hz solicitados, bajo demanda.

ROS puede exponer Image, CameraInfo y PointCloud2 mediante sus puentes. Conserva profundidades inválidas o fuera de alcance; un mapa de colores no sustituye los números. La nube es una observación, no un mapa SLAM acumulado. Implementación.

LiDAR planar

GpuLidarSensor renderiza rayos GPU contra geometría visible y aplica alcance/ruido configurados. Mide distancia geométrica, sin calcular potencia óptica recibida ni propagación láser submarina. Los objetos fuera de su altura y plano de barrido pueden quedar sin detectar.

Parámetro WAM-V integrado / generador
lidar/scan/horizontal/samples 360, resolution=1 angular.
min_angle, max_angle −π a +π rad, un plano horizontal.
lidar/range/min, max, resolution Integrado: 0,2 / 50 / 0,02 m; generador: 0,1 / 50 / 0,01 m. Alcance máximo editable 1–100 m. La resolución configurada no garantiza exactitud medida.
Frecuencia y montaje Normalmente 5 Hz. Integrado: 2,5 m sobre la base; demo compartida: proa (3.5, 0, 1.0) m para interceptar boyas. El generador guarda la pose.
lidar/noise El escáner generado no añade un bloque de ruido. Gazebo dispone de modelos de ruido de distancia.

Salida sensor_msgs/LaserScan. Conserva metadatos angulares y valores no finitos: ausencia de retorno no significa distancia cero. Implementación.

Ping único hacia abajo

El adaptador Ping reduce un barrido GPU de 5×5 rayos al retorno válido más cercano y publica sensor_msgs/Range. Representa huella y validez del haz, sin calcular intensidad acústica, formas de onda ni multitrayecto.

Parámetro Generador
Rayos y ángulos 5×5, cada eje ±0,00872665 rad (±0,5°). Sensores de demos dedicadas pueden usar otro abanico.
Mínimo / máximo / resolución 0,1 / 30 / 0,01 m; máximo editable 1–100 m.
Frecuencia y pose Inicialmente 5 Hz, montaje inferior guardado en la receta.
field_of_view publicado Cono que engloba el haz cuadrado, calculado a partir de sus semiángulos. El retorno puede proceder de cualquier rayo.

Una entrada demasiado próxima produce −∞; sin retorno, +∞; desconocida, NaN si no hay impacto válido. Se conserva la marca de adquisición. Ping y DVL son alternativas inferiores en el generador. Una distancia sobre la huella no determina un punto único del fondo.

Corredera Doppler (DVL)

DopplerVelocityLog busca objetivos del fondo en conos renderizados. Proyecta la velocidad cinemática relativa sensor-objetivo sobre los haces, añade ruido y resuelve la velocidad por mínimos cuadrados mediante SVD. No sintetiza la portadora acústica ni estima su espectro Doppler.

Parámetro <gz:dvl> Perfil utilizado
type, arrangement phased_array; cuatro haces a 45°, 135°, −45°, −135°, inclinación 30°, apertura 2°.
tracking/bottom_mode/when best, seguimiento del fondo. El seguimiento de masas de agua existe en Gazebo, pero no está activado en este perfil.
tracking/bottom_mode/noise/stddev Desviación típica gaussiana por haz: 0,002 m/s. La covarianza resuelta depende de la geometría.
minimum_range, maximum_range, resolution 0,1 / 20 / 0,01 m; máximo editable 1–100 m.
update_rate, reference_frame Inicialmente 1 Hz; pose de referencia 0 0 0 0 0 0. Rotación y brazo de palanca forman parte de la calibración.

El adaptador exige al menos tres haces con seguimiento, covarianza válida, marco esperado y marcas crecientes. Emite geometry_msgs/Vector3Stamped y estado JSON en std_msgs/String. Perder el seguimiento no produce velocidad cero. El estado incluye distancias al fondo por haz: son mínimos dentro del cono, no necesariamente del rayo central. Sin varianza de distancia, la incertidumbre es desconocida. Implementación.

Sonar de imagen multihaz

El proveedor POSIM transforma geometría de rayos en retrodispersión acústica, respuestas de frecuencia corregidas por haz e intensidad por celda de distancia. Vista previa del sonar físico explica las rutas Rust/WGPU, CUDA y CPU y la diferencia entre medida acústica y nube geométrica.

Grupo Configuración
Haces horizontales 256 entre −π/3 y +π/3 rad, 120°.
Rayos verticales 256 entre −π/18 y +π/18 rad, 20°.
sonarFreq, maxDistance, rayos 700 kHz; procesamiento hasta 15 m; rayos 0,2–15 m.
update_rate, raySkips 2 Hz inicialmente, factor de salto 1.
soundSpeed, bandwidth, sourceLevel, sensorGain Parámetros del SDF del proveedor para propagación, procesamiento y escala visual. No todos son controles del generador; guárdalos junto a los datos.

La comparación exploratoria usa otro abanico inclinado, indicado junto a las figuras. El generador publica datos brutos marine_acoustic_msgs/ProjectedSonarImage. El abanico coloreado es su visualización. El proveedor debe superar las comprobaciones de compatibilidad del equipo.

IMU: aceleración y velocidad angular

ImuSensor recibe cinemática, resta la gravedad expresada en el marco del sensor para obtener fuerza específica y aplica ruido por eje. La orientación procede del estado del simulador respecto a la referencia configurada; no es la estimación de actitud de un equipo de a bordo.

Parámetro Selección
update_rate WAM-V: 200 Hz; BlueROV2 integrado: 1000 Hz solicitados, limitados por los pasos físicos.
pose, orientation_reference_frame Definen ejes y referencia. BlueROV2 con control ROS directo usa rotación de montaje cero; el modelo ArduPilot conserva la propia de su interfaz. Usa marcos publicados y TF.
imu/linear_acceleration/{x,y,z}/noise mean/stddev en m/s²; bias_mean/bias_stddev para sesgo; dynamic_bias_stddev/dynamic_bias_correlation_time para su evolución. Las IMU base no configuran estos bloques.
imu/angular_velocity/{x,y,z}/noise Equivalentes del giróscopo en rad/s. El sesgo dinámico tiene correlación temporal cuando se activa.

Salida sensor_msgs/Imu. IMU bruta y actitud fusionada MAVROS son señales distintas. Al evaluar VIO o controladores, indica la ausencia de ruido y orientación derivada del estado real simulado. IMU y ruido gaussiano.

La interfaz JSON de ArduPilot interpola los estados físicos ya calculados para generar muestras intermedias de SITL. La Planificación de rutas y control describe las frecuencias de muestreo y el comportamiento al cambiar el paso temporal. La adquisición del IMU de ROS sigue limitada por los pasos físicos; las muestras interpoladas de SITL no añaden detalle físico nuevo.

Magnetómetro

MagnetometerSensor transforma el campo magnético del mundo al marco del sensor y añade el ruido configurado por eje. BlueROV2 incorpora uno a 20 Hz en el origen de base_link. Los mundos usan teslas y ENU: use_units_gauss=false, use_earth_frame_ned=false.

Parámetro Significado
magnetic_field del mundo Vector de campo; conserve la definición del mundo.
pose, update_rate Montaje y frecuencia solicitada.
magnetometer/{x,y,z}/noise Media/desviación gaussiana en teslas; el sensor añadido no configura ruido adicional.

Salida sensor_msgs/MagneticField. No modela interferencias de hierro duro/blando ni anomalías locales. La brújula ArduPilot de WAM-V usa el modelo SITL: un topic ROS no demuestra qué fusiona la FCU. Implementación.

Receptor GNSS

posim::Gnss transforma la posición mundial de la antena a coordenadas geográficas, añade ruido reproducible de posición/velocidad, retrasa la entrega y condiciona las soluciones a inmersión y obstrucciones. Publica NavSatFix/estado y, en navegación GNSS, GPS_INPUT MAVLink.

Parámetros Función
update_rate, latency, reacquire_seconds Frecuencia, demora e intervalo continuo fuera del agua, en tiempo simulado.
horizontal_stddev, vertical_stddev, velocity_stddev, seed Magnitudes gaussianas y reproducibilidad.
link_name, pose, water_level, wave_topic, dry_margin Brazo de palanca y prueba de inmersión con oleaje.
enabled, topic de obstrucción Selección del receptor y bloqueo impuesto.

GNSS y navegación es la referencia de valores, covarianzas, ENU/NED, datum vertical y EKF. El modelo no incluye geometría satelital ni multitrayecto.

Presión y profundidad

La profundidad del simulador y la estimada por ArduSub son distintas de SubseaPressureSensorPlugin. Este complemento independiente se usa en modelos POSIM como RexROV y Slocum; no es un sensor seleccionable en el generador WWW-POSIM.

Lee la profundidad del origen del modelo bajo el plano medio z=0, limita a cero sobre el agua y añade presión hidrostática lineal. Publica sensor_msgs/FluidPressure en Pa y, opcionalmente, profundidad inferida en geometry_msgs/PointStamped.

Parámetro Valor o función
namespace, topic Localización del modelo y salida; topic predeterminado sea_pressure.
standard_pressure, kPa_per_meter 101,325 kPa y 9,80638 kPa/m; convierte kPa internos a Pa.
estimate_depth_on, update_rate Conversión inversa activada inicialmente; frecuencia 0 sin límite adicional del complemento.
saturation Se lee con valor 3000, pero no se aplica a la medida; no impone un corte de alcance.

No añade ruido real de presión, aunque publica varianza equivalente a una desviación de 3 kPa. Esa varianza no prueba ruido muestreado. Usa el origen del modelo, no un puerto de presión calibrado, ni presión de la superficie ondulada. Implementación.

Componentes USBL de POSIM

UsblTransceiver y UsblTransponder intercambian posiciones y órdenes simuladas para producir localizaciones relativas. El transpondedor perturba sus coordenadas mundiales con ruido gaussiano. Es un componente de prueba basado en posiciones, sin receptor de diferencias de fase ni solución de propagación acústica. No es un sensor estándar del generador.

Grupo Función
namespace, nombres/ID, objetos asociados Dispositivos, modelos y rutas de mensajes.
enable_ping_scheduler, ping_frequency, interrogation_mode Interrogaciones programadas y dirección común/individual.
sound_speed Inicialmente 1540 m/s; las funciones de recepción pueden sustituirlo por una aproximación de profundidad/temperatura.
mu, sigma del transpondedor Ruido de posición, media 0 y desviación 1 m.

La espera de propagación usa una pausa de reloj real dentro de la función de recepción; no representa un instrumento de tiempo de vuelo preciso en tiempo simulado. Consulta transceptor y transpondedor.

Odometría, referencia y registro

OdometryPublisher expone pose y velocidad simuladas; el controlador del viaje automático también publica estado nativo medido. Son señales de referencia, no odometría de ruedas ni estimaciones fusionadas. Registra marcos padre/hijo, frecuencia y cambios de origen. Identifique por separado estimaciones de FCU o SLAM.

Conserva SDF final, manifiesto, extrínsecos TF, calibración, revisiones de aplicación/proveedor, paso temporal, semillas, marcas de adquisición, validez y observaciones brutas. Vídeos, capturas y mapas de color son complementarios.

Preparar un vehículo · Personalizar los sensores · Simulación, renderizado y sensores · Dinámica marina y renderizado

Buscar en la documentación