POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Riferimento dei plugin

Telecamera subacquea

UnderwaterCamera usa la profondità per attenuare i colori RGB con la distanza. Regola attenuazione e sfondo in base all'acqua da rappresentare. Per gli effetti condivisi dall'intera scena, consulta il rendering subacqueo.

Eseguire l'esempio

Il mondo della telecamera attiva piccole onde ed effetti subacquei nativi. L'avvio del sensore imposta POSIM_UNDERWATER_PLUGIN per inoltrare i pixel RGB già elaborati all'uscita compatibile senza una seconda attenuazione. Per confrontare il filtro indipendente basato sulla profondità, usa un mondo senza il sistema di scena e lascia questa variabile non impostata.

Esegui l’esempio nel terminale A preparato.

ros2 launch posim_demos posim_sensor.launch.py \
  namespace:=underwater_camera world_name:=camera_tutorial \
  x:=10 z:=-93.5 pitch:=0.3 yaw:=3.14 \
  paused:=false gui:=true headless:=false

Nel terminale B preparato:

ros2 topic echo /underwater_camera/simulated_image \
  sensor_msgs/msg/Image --once --no-arr
ros2 topic hz /underwater_camera/simulated_image

Aggiungi una visualizzazione Image in RViz. Se il topic compare ma le immagini non arrivano più, verifica il trasporto delle immagini grandi.

Configurare il plugin

Inserisci questo sensore RGBD in un <link>. Il mondo deve caricare gz-sim-sensors-system con <render_engine>ogre2</render_engine>, come il mondo della camera. Il plugin legge colore/profondità da Gazebo e pubblica direttamente il topic ROS /underwater_camera/simulated_image.

<sensor name="underwater_camera" type="rgbd_camera">
  <update_rate>10</update_rate>
  <topic>underwater_camera</topic>
  <camera>
    <horizontal_fov>1.05</horizontal_fov>
    <image><width>320</width><height>240</height></image>
    <clip><near>0.1</near><far>10.0</far></clip>
  </camera>
  <plugin filename="UnderwaterCamera"
          name="posim_gz_sensor_plugins::UnderwaterCamera">
    <attenuationR>0.8</attenuationR>
    <attenuationG>0.5</attenuationG>
    <attenuationB>0.2</attenuationB>
    <backgroundR>85</backgroundR>
    <backgroundG>107</backgroundG>
    <backgroundB>47</backgroundB>
  </plugin>
</sensor>
Parametro SDF Significato Predefinito
attenuationR Attenuazione rossa per metro, finita e ≥ 0 1/30
attenuationG Attenuazione verde per metro, finita e ≥ 0 1/30
attenuationB Attenuazione blu per metro, finita e ≥ 0 1/30
backgroundR Sfondo rosso, intero da 0 a 255 0
backgroundG Sfondo verde, intero da 0 a 255 0
backgroundB Sfondo blu, intero da 0 a 255 0

Topic e geometria della camera

<topic> deve produrre un nome ROS valido. Se manca, viene usato il percorso Gazebo /world/<world>/model/<model>/link/<link>/sensor/<sensor>, con /simulated_image aggiunto per ROS. I modelli annidati includono i percorsi dei modelli superiori.

La conversione da profondità a distanza lungo il raggio usa prima la proiezione della lente specificata, poi i parametri intrinseci espliciti, infine dimensioni dell'immagine e campo visivo orizzontale. Le coordinate del punto principale possono essere zero. Le focali devono essere positive, i valori della lente finiti e i piani di clipping rispettare 0 < near < far, in metri. Impostazioni non valide generano un errore e disattivano l'uscita.

Sincronizzazione e valori di esempio

Colore e profondità vengono abbinati tramite il timestamp di acquisizione, indipendentemente dall'ordine di arrivo. ROS conserva timestamp e identificatore del sistema di riferimento dell'immagine a colori. Quando il buffer è pieno, i fotogrammi senza corrispondenza vengono scartati. Il reset del tempo simulato scarta i fotogrammi in attesa e permette ai timestamp di ripartire.

L'esempio richiede 320 × 240 a 10 Hz, attenuazione RGB 0.8/0.5/0.2 e sfondo 85/107/47. Il SDF sostituisce i valori predefiniti del codice.

Regolare e confrontare

Posiziona un oggetto riconoscibile a distanze note. Mantieni fissi posa, luce, materiali e camera mentre modifichi un canale. Verifica anche timestamp e frequenza ricevuta.

L'attenuazione è esponenziale per canale, con miscelazione dello sfondo. Per un confronto senza attenuazione, imposta a zero tutti e sei i parametri della tabella. Omettere i tag ripristina i valori predefiniti.

Il renderer di scena applica effetti comuni a superfici PBR e camere. Con il sistema nativo attivo, POSIM_UNDERWATER_PLUGIN lascia passare i pixel già colorati per evitare un secondo filtraggio. Il modello definisce collegamenti e topic.

Particelle in sospensione

Il renderer può mostrare particelle nelle immagini a colori RGB/RGBD. Sono inizialmente disattivate: attivale tramite il servizio per l'aspetto della scena.

Si tratta di effetti ottici procedurali. Per studiare la diffusione calibrata serve un modello ottico adatto. Nella navigazione visiva, considera le particelle osservazioni in movimento e mantieni le impostazioni costanti nei confronti.

Confrontare le immagini subacquee

Scena Gazebo con telecamera subacquea
Scena Gazebo con telecamera subacquea
Visualizzazione dell’immagine subacquea
Visualizzazione dell’immagine subacquea
Immagine senza attenuazione RGB e con sfondo nero
Immagine senza attenuazione RGB e con sfondo nero
Acqua costiera torbida: attenuazione RGB 0.8/0.5/0.2 e sfondo 85/107/47
Acqua costiera torbida: attenuazione RGB 0.8/0.5/0.2 e sfondo 85/107/47

Immagini: wiki Notion POSIM; attribuzione DAVE in Citazioni e licenze. Usa comandi e topic nei blocchi di questa pagina.