POSIM v1.0.1Platform for Ocean Simulation · Documentation
Documentation menu
POSIM / Introducing POSIM

Features & examples

Use this catalogue to find each public simulation capability, its implementation and its usage guide. POSIM provides Gazebo systems, robot models and ROS interfaces. World SDF and launch configuration select the systems used by a simulation.

Environment and rendering

Capability Public implementation Usage
Underwater haze, RGB absorption and sunlight fading gazebo/posim_gz_rendering Scene effects, defaults and live controls
Seabed caustics, suspended specks / marine snow gazebo/posim_gz_rendering Enable and inspect underwater effects
Seabed texture, measurement grid and depth contours gazebo/posim_gz_rendering; maps supplied by the terrain Spacing and material configuration
Spectral waves and WAM-V wave-aware hydrodynamics External Wave Sim; extras/surface integration Surface robots and waves
Uniform, depth-dependent and tidal currents posim_gz_world_plugins, posim_gz_model_plugins, posim_ros_gz_plugins Current inputs and ROS services
Geographic origin and coordinate conversion posim_ros_gz_plugins Spherical-coordinate services
Seabed, objects and task worlds models/posim_worlds, posim_object_models Worlds, objects, heightmaps

Underwater optics shade PBR surfaces and preserve numeric depth. The ocean's custom surface material has its own rendering. Marine snow is a procedural visual approximation and is disabled by default. See the underwater guide for the sea-level assumption and camera behavior.

Sensors, robots and control

Capability Public implementation Usage
Marine GNSS, immersion loss, reacquisition and latency gazebo/posim_gz_gnss Receiver setup and measurement schema
RGBD-based underwater image attenuation posim_gz_sensor_plugins/UnderwaterCamera Camera example and parameters
DVL measurements and ROS conversion Gazebo DVL and posim_ros_gz_plugins Beam settings and output
Hydrostatic pressure and derived depth posim_gz_sensor_plugins Pressure configuration and units
USBL acoustic interrogation and positioning posim_gz_sensor_plugins Transceiver/transponder example
Multibeam sonar gazebo/posim_gz_multibeam_sonar Sonar model, build and tuning
REXROV, BlueROV2 variants and Slocum glider models/posim_robot_models ROVs, glider, custom robots
ArduRover WAM-V integration and ROS control extras/surface, model launch configurations, posim_interfaces Surface vehicle, ROS 2

Sensor availability depends on installed plugins and model configuration. GNSS profiles describe mounts; attach the link and receiver when integrating one. Sonar can use CPU, WGPU or CUDA; choose the backend for your environment. Use each sensor reference's quickstart to confirm live measurements.

Source directories

The paths below are relative to the POSIM source repository.

Location What it supplies
models/posim_worlds World files and their environment resources
models/posim_robot_models Robot mechanics, sensors and per-robot ROS configuration
models/posim_sensor_models Standalone sensor descriptions and examples
gazebo/ Marine environment and sensor plugins
posim_interfaces POSIM message and service definitions
examples/posim_demos Launch files that connect worlds, models and ROS

Use First simulation to run these components together. Use Add a robot and Create a world when you want to change the model or environment.

macOS Ogre lifetime overlay

The Ogre overlay helper builds an isolated Ogre core for the documented macOS arm64 / Ogre-Next 2.3.3 configuration. Follow its supported SDK profile and loaded-library checks when using that configuration.

Third-party license terms remain with their components.