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.