WWW-POSIM v0.6.16Simulator documentation
Documentation menu
WWW-POSIM / Simulator documentation

LIVE world voyage

LIVE is a shared simulation of two WAM-Vs travelling between ports.

Try it step by step

  1. Open LIVE world voyage and select LIVE.
  2. Choose Vehicle to follow a boat or World to see its surroundings.
  3. Open Sensors and choose the lead or follow vehicle and a camera.
  4. Use the map to see the route. Pause preview pauses your display while the voyage continues.

The map shows the active navigation waypoint only while fresh telemetry belongs to the current simulation world. Obsolete terrain is cleaned in the background, with one cleanup task at a time. The active and requested worlds remain protected during cleanup.

Advanced: details and reference

The vehicles and simulation engine

Both vehicles use POSIM's WAM-V twin-hull model with a canopy marked POSIM.

POSIM provides the simulation foundation. WWW-POSIM provides voyage management, lead/follow control, terrain generation and observation views. See How POSIM fits in.

Gazebo computes motion from thrust, mass, inertia and wave forces. Wave Sim computes waves and their interaction with the hull. Wake and splash are visual effects.

Spray continues during forward travel and grows with speed. Pitching into the water produces a larger burst. A soft shade follows the water beneath each hull. These RGB effects preserve vehicle dynamics and depth measurements.

How the lead vehicle navigates

The lead vehicle follows an ordered port itinerary. The planner checks terrain depth and hull clearance, and prepares new terrain and routes while the vehicle moves.

After Hong Kong, the itinerary visits Shenzhen's Prince Bay cruise homeport, also called Shekou Cruise Center, then Haikou's Xiuying port and Da Nang.

  1. Select the destination and next course waypoint.
  2. Find a navigable route around land and shallow water.
  3. Adjust thrust using measured speed and heading. Differential thrust turns the boat.
  4. Record the visit and photographs on arrival, then depart after the stopover.

Coastal sections favour routes near land when they advance toward the destination. The final stretch must head toward the port. A shorter checked water route takes priority over a long scenic detour. Land and shallow water can require turns around islands and headlands. Canals and final approaches use separate route sections.

Coastal lookahead includes a checked water route onward, around headlands and out of bays. Once it joins the coast, its coastal segments stay within 1.5 km of mapped land. Across gaps between disconnected shores, the vehicle follows a complete checked water connection. The coastal-following limit applies after joining the next shore. Offshore onward segments require a separate checked route. Ordinary offshore graph bends use the checked onward coastal direction; saved port and canal waypoints remain ordered. Nearby forward coast is approached before an ordinary offshore route is selected. Coastal renewal starts at the checked corridor endpoint and retains the remaining forward bends. The vehicle waits at that endpoint if the continuation is still being prepared.

Coastal routes follow actual land. Submerged banks constrain safe clearance. Coastal routes keep an exclusion buffer around land and shallow water. A vehicle already inside the buffer follows a hull-checked outward departure that increases clearance before coastal travel resumes. The resident terrain rechecks the actual pilot corridor before propulsion is approved.

Near shore, planning starts with fine terrain. Harbour-exit and approach progress follows the checked waypoint sequence, including bends that initially lead away from the next port. A stationary or circling vehicle still triggers recovery. A routing watchdog observes prolonged waits, including zero-speed holds during sailing. It preserves pending work within its preparation budget and retries expired or failed work with finer or wider terrain. The vehicle holds in checked water during a planning delay. Unsafe hull clearance or a stalled propulsion route can request a checked water retreat. Shallow-water braking prepares a new checked corridor before propulsion resumes. Scheduled port service keeps its normal duration.

If rounding an offshore bend leaves no checked onward corridor, recovery retries toward the original course waypoint. It keeps the waypoint order and checks the replacement against the same depth and land constraints. Leaving a trapped area completes the local escape; normal voyage progress requires measured gains toward the destination or along the checked course.

A geographic guard detects prolonged circling from measured positions. After 10 minutes within 300 m of its reference position, it selects a checked escape route ending at least 550 m from that reference. It keeps the escape destination through replans, slows for heading changes and confirms escape only after the vehicle travels at least 500 m from the reference. A temporary detour may lead away from the onward course. For the following 30 minutes, resident recovery endpoints stay outside the escaped area. Checked onward corridors may cross that area and continue beyond it; paths making less than 50 m of onward progress avoid it throughout. Resident recovery checks the full available detour before accepting a shorter straight segment. It can inspect routes within 4.5 km of the vehicle, up to 12 km long, and rechecks each section before sailing. Depth, shoreline and coastal-distance checks remain active. Port stops, photo stops and operator holds suspend the guard. Voyage records remain intact.

A headland can require sustained travel away from the next port before the coast turns toward it. If local recovery cannot continue, a fixed mapped coastal connection provides the discovery direction across replans and restarts. Every propelled portion still needs numeric-depth and native corridor approval. Measured progress along the unchanged connection keeps recovery moving without crediting circles.

Temporary terrain-service errors retry while fresh telemetry confirms the current world is healthy. Cache cleanup retires obsolete terrain jobs before deleting their files. Recently selected jobs stay protected while the next scene starts.

If a stopped world cannot restart at its last position, recovery can use a nearby, previously measured safe position. It rechecks that position against current terrain and mapped land. Restoration credits zero sailed distance and retains visit history.

Each port has ordered arrival and departure waypoints. The arrival path joins the global course to a port diversion and its arrival area. The departure path leads from the port back to the onward global course. The vehicle follows each saved bend within 5 m. Short legs use one continuous port-to-port path.

Saved port connections favour open water outside their terminal areas. Narrow harbour and canal sections follow the checked water channel. Gazebo collision terrain checks each commanded segment before motion. The vehicle waits while the next safe section is prepared.

The vehicle slows before shallow water and tight turns to keep enough room to stop.

Port markers show the selected photo stop when available, or the catalog location. The lime circle shows the arrival area.

Each saved harbour connection ends at a screened water gate. Its centre can be offshore when represented harbour water lacks clearance. The vehicle continues from this gate to its nearshore photo stop.

Turns, arrival and recovery reduce speed. The display shows measured speed. Arrival and departure paths have a 4 m/s speed ceiling. The controller brakes before bends and checks depth and hull clearance against Gazebo collision terrain.

Ports can have a selected scenic coast and a screened approach to nearby safe water. The stop selector checks rendered land inside both scheduled World-camera views and keeps the chosen coast as their viewing target. Phuket uses a fixed station by the Ao Yon coast. Its harbour arrival and departure join the direct scenic connection west of the nearby island. The station coordinates stay fixed while resident terrain and both camera directions are checked again. Changing the station requires matching arrival and departure geometry; mismatched saved geometry stops loading. Photo approaches also follow ordered waypoints. When no approach is configured, the controller checks and saves a complete route to the selected stop. After braking or reconnecting, it rechecks and continues that same route. The world map includes the approach to the photo stop and the return connection to the harbour departure path.

The final harbour waypoint leads to a checked photo stop near rendered land. The visit and gallery capture begin after the vehicle reaches that stop. The arrival marker follows the selected stop. On departure, the vehicle follows a screened fixed exit when one is configured, or retraces its measured photo approach before joining the next departure route. If nearshore water cannot be verified, it waits for a checked route.

If the remaining distance along a photo route does not decrease for two minutes, the controller rechecks that section. A drifted vehicle uses a checked connection to its next waypoint. If it is already inside the 40 m clearance margin, a short escape is limited to 120 m and 0.8 m/s. This escape requires at least 2 m depth across a 12 m footprint, increasing separation from shallow water, and a clear 40 m footprint at its endpoint.

During the 30-minute port stay, the World camera looks toward nearby land from two angles around the measured vehicle position: at arrival and after 15 minutes of simulation time. Each angle stays fixed for 15 minutes. A land-facing World photo is saved from each angle. Arrival photographs also include World, Vehicle and forward-camera views. The follower provides the views when available so the lead vehicle appears in them. Returning to the starting port begins another world tour.

While sailing, the World camera updates its land-facing angle every 10 minutes of simulation time, around the measured vehicle position. It holds the angle between updates. When no mapped coast is nearby, it keeps its viewing direction. The north arrow above the World / Lead / Follow scene switch turns with the measured World camera direction and points to true north. A vector-drawn N stays upright below the rotating arrow, with a clear gap. The graphic has a transparent background. A dash appears while the camera measurement is unavailable. The maps, vessel statistics, north arrow and sensor values follow the selected scene’s video playback clock. Sensor camera video shares this clock. AIS panels show reports available at the displayed time, with the provider’s reporting cadence and age. Video starts with a short buffer and increases it after sustained stalls. Sampling intervals can leave small differences between frames and readings.

While LIVE connects, the most recently captured still image appears behind a centred connecting message and animated bar. Voyage status, destination, real-time factor and speed remain visible above them. Video replaces the still when playback starts. The still loads directly from the simulation server. Preview requests stop while the scene or browser tab is hidden.

The scene fills the browser view with its top edge visible. When the frame is too tall for the available space, the lower part is cropped to preserve the land near the top.

The public voyage uses an automatic route and thrust controller. To run an ArduPilot mission, use Autopilot in a Workspace basics.

The itinerary passes through Suez and the Mediterranean, then around South America via Cape Horn. Colón is a stop on Panama's Caribbean coast. Suez uses an assumed 10 m depth. See Terrain generation algorithms.

Port itinerary

The map shows all 92 stops in sailing order. Port names identify the destination locality; the checked arrival area can be offshore. Athens uses Piraeus, Porto uses Leixões, Edinburgh uses Leith, and Caracas uses La Guaira.

Expand a port to see its arrival and departure waypoints. Each figure includes an SVG and waypoint-coordinate CSV download. Grey shows the global-course connection, coral shows the ordered harbour path, and lime shows the arrival region. See Terrain generation algorithms for the figure sources and the Suez depth assumption.

East and Southeast Asia: Busan → Shanghai → Taichung → Xiamen → Hong Kong → Shenzhen · Prince Bay → Haikou · Xiuying → Da Nang → Singapore → Port Klang → Phuket → Port Blair.

Busan · KRPUS
Busan: Arrival approach
Arrival approach · SVG · Waypoint CSV
Busan: Departure connection
Departure connection · SVG · Waypoint CSV
Shanghai · CNSHA
Shanghai: Arrival approach
Arrival approach · SVG · Waypoint CSV
Shanghai: Departure connection
Departure connection · SVG · Waypoint CSV
Taichung · TWTXG
Taichung: Arrival approach
Arrival approach · SVG · Waypoint CSV
Taichung: Departure connection
Departure connection · SVG · Waypoint CSV
Xiamen · CNXMN
Xiamen: Arrival approach
Arrival approach · SVG · Waypoint CSV
Xiamen: Departure connection
Departure connection · SVG · Waypoint CSV
Hong Kong · HKHKG
Hong Kong: Arrival approach
Arrival approach · SVG · Waypoint CSV
Hong Kong: Departure connection
Departure connection · SVG · Waypoint CSV
Shenzhen · Prince Bay · CNSZX-PRINCEBAY
Shenzhen · Prince Bay: Arrival approach
Arrival approach · SVG · Waypoint CSV
Shenzhen · Prince Bay: Departure connection
Departure connection · SVG · Waypoint CSV
Haikou · Xiuying · CNHIG-XIUYING
Haikou · Xiuying: Arrival approach
Arrival approach · SVG · Waypoint CSV
Haikou · Xiuying: Departure connection
Departure connection · SVG · Waypoint CSV
Da Nang · VNDAD
Da Nang: Arrival approach
Arrival approach · SVG · Waypoint CSV
Da Nang: Departure connection
Departure connection · SVG · Waypoint CSV
Singapore · SGSIN
Singapore: Arrival approach
Arrival approach · SVG · Waypoint CSV
Singapore: Departure connection
Departure connection · SVG · Waypoint CSV
Port Klang · MYPKG
Port Klang: Arrival approach
Arrival approach · SVG · Waypoint CSV
Port Klang: Departure connection
Departure connection · SVG · Waypoint CSV
Phuket · THHKT
Phuket: Arrival approach
Arrival approach · SVG · Waypoint CSV · Photo waypoints P0–P1
Phuket: Departure connection
Departure connection · SVG · Waypoint CSV · Photo waypoints P0–P1
Port Blair · INIXZ
Port Blair: Arrival approach
Arrival approach · SVG · Waypoint CSV
Port Blair: Departure connection
Departure connection · SVG · Waypoint CSV

Indian Ocean and Red Sea: Colombo → Kochi → Mumbai → Karachi → Palm Jumeirah → Dubai → Muscat → Salalah → Aden → Jeddah → Suez City → Port Said.

Colombo · LKCMB
Colombo: Arrival approach
Arrival approach · SVG · Waypoint CSV
Colombo: Departure connection
Departure connection · SVG · Waypoint CSV
Kochi · INCOK
Kochi: Arrival approach
Arrival approach · SVG · Waypoint CSV
Kochi: Departure connection
Departure connection · SVG · Waypoint CSV
Mumbai · INBOM
Mumbai: Arrival approach
Arrival approach · SVG · Waypoint CSV
Mumbai: Departure connection
Departure connection · SVG · Waypoint CSV
Karachi · PKKHI
Karachi: Arrival approach
Arrival approach · SVG · Waypoint CSV
Karachi: Departure connection
Departure connection · SVG · Waypoint CSV
Palm Jumeirah · AEDXB-PALM
Palm Jumeirah: Arrival approach
Arrival approach · SVG · Waypoint CSV
Palm Jumeirah: Departure connection
Departure connection · SVG · Waypoint CSV
Dubai · AEDXB
Dubai: Arrival approach
Arrival approach · SVG · Waypoint CSV
Dubai: Departure connection
Departure connection · SVG · Waypoint CSV
Muscat · OMMCT
Muscat: Arrival approach
Arrival approach · SVG · Waypoint CSV
Muscat: Departure connection
Departure connection · SVG · Waypoint CSV
Salalah · OMSLL
Salalah: Arrival approach
Arrival approach · SVG · Waypoint CSV
Salalah: Departure connection
Departure connection · SVG · Waypoint CSV
Aden · YEADE
Aden: Arrival approach
Arrival approach · SVG · Waypoint CSV
Aden: Departure connection
Departure connection · SVG · Waypoint CSV
Jeddah · SAJED
Jeddah: Arrival approach
Arrival approach · SVG · Waypoint CSV
Jeddah: Departure connection
Departure connection · SVG · Waypoint CSV
Suez City · EGSUZ
Suez City: Arrival approach
Arrival approach · SVG · Waypoint CSV
Suez City: Departure connection
Departure connection · SVG · Waypoint CSV
Port Said · Suez Canal · EGPSD
Port Said · Suez Canal: Arrival approach
Arrival approach · SVG · Waypoint CSV
Port Said · Suez Canal: Departure connection
Departure connection · SVG · Waypoint CSV

Eastern Mediterranean: Alexandria → Tel Aviv → Beirut → Antalya → Izmir → Istanbul → Thessaloniki → Piraeus · Athens → Corfu → Gallipoli (Italy) → Crotone.

Alexandria · EGALY
Alexandria: Arrival approach
Arrival approach · SVG · Waypoint CSV
Alexandria: Departure connection
Departure connection · SVG · Waypoint CSV
Tel Aviv · ILTLV-PORT
Tel Aviv: Arrival approach
Arrival approach · SVG · Waypoint CSV
Tel Aviv: Departure connection
Departure connection · SVG · Waypoint CSV
Beirut · LBBEY
Beirut: Arrival approach
Arrival approach · SVG · Waypoint CSV
Beirut: Departure connection
Departure connection · SVG · Waypoint CSV
Antalya · TRAYT
Antalya: Arrival approach
Arrival approach · SVG · Waypoint CSV
Antalya: Departure connection
Departure connection · SVG · Waypoint CSV
Izmir · TRIZM
Izmir: Arrival approach
Arrival approach · SVG · Waypoint CSV
Izmir: Departure connection
Departure connection · SVG · Waypoint CSV
Istanbul · TRIST
Istanbul: Arrival approach
Arrival approach · SVG · Waypoint CSV
Istanbul: Departure connection
Departure connection · SVG · Waypoint CSV
Thessaloniki · GRSKG
Thessaloniki: Arrival approach
Arrival approach · SVG · Waypoint CSV
Thessaloniki: Departure connection
Departure connection · SVG · Waypoint CSV
Piraeus · Athens · GRPIR
Piraeus · Athens: Arrival approach
Arrival approach · SVG · Waypoint CSV
Piraeus · Athens: Departure connection
Departure connection · SVG · Waypoint CSV
Corfu · GRCFU
Corfu: Arrival approach
Arrival approach · SVG · Waypoint CSV
Corfu: Departure connection
Departure connection · SVG · Waypoint CSV
Gallipoli · ITGAL
Gallipoli: Arrival approach
Arrival approach · SVG · Waypoint CSV
Gallipoli: Departure connection
Departure connection · SVG · Waypoint CSV
Crotone · ITCRV
Crotone: Arrival approach
Arrival approach · SVG · Waypoint CSV
Crotone: Departure connection
Departure connection · SVG · Waypoint CSV

Central and Western Mediterranean: Valletta → Messina → Naples → Olbia → Ajaccio → Marseille → Barcelona → Valencia → Málaga → Gibraltar.

Valletta · MTVAL
Valletta: Arrival approach
Arrival approach · SVG · Waypoint CSV
Valletta: Departure connection
Departure connection · SVG · Waypoint CSV
Messina · ITMSN
Messina: Arrival approach
Arrival approach · SVG · Waypoint CSV
Messina: Departure connection
Departure connection · SVG · Waypoint CSV
Naples · ITNAP
Naples: Arrival approach
Arrival approach · SVG · Waypoint CSV
Naples: Departure connection
Departure connection · SVG · Waypoint CSV
Olbia · ITOLB
Olbia: Arrival approach
Arrival approach · SVG · Waypoint CSV
Olbia: Departure connection
Departure connection · SVG · Waypoint CSV
Ajaccio · FRAJA
Ajaccio: Arrival approach
Arrival approach · SVG · Waypoint CSV
Ajaccio: Departure connection
Departure connection · SVG · Waypoint CSV
Marseille · FRMRS
Marseille: Arrival approach
Arrival approach · SVG · Waypoint CSV
Marseille: Departure connection
Departure connection · SVG · Waypoint CSV
Barcelona · ESBCN
Barcelona: Arrival approach
Arrival approach · SVG · Waypoint CSV
Barcelona: Departure connection
Departure connection · SVG · Waypoint CSV
Valencia · ESVLC
Valencia: Arrival approach
Arrival approach · SVG · Waypoint CSV
Valencia: Departure connection
Departure connection · SVG · Waypoint CSV
Málaga · ESAGP
Málaga: Arrival approach
Arrival approach · SVG · Waypoint CSV
Málaga: Departure connection
Departure connection · SVG · Waypoint CSV
Gibraltar · GIGIB
Gibraltar: Arrival approach
Arrival approach · SVG · Waypoint CSV
Gibraltar: Departure connection
Departure connection · SVG · Waypoint CSV

Atlantic Europe: Lisbon → Porto · Leixões → A Coruña → Bilbao → Le Havre → Rotterdam → Hamburg → Esbjerg → Oslo → Edinburgh · Leith → Sunderland → Dover → Southampton.

Lisbon · PTLIS
Lisbon: Arrival approach
Arrival approach · SVG · Waypoint CSV
Lisbon: Departure connection
Departure connection · SVG · Waypoint CSV
Porto · Leixões · PTLEI
Porto · Leixões: Arrival approach
Arrival approach · SVG · Waypoint CSV
Porto · Leixões: Departure connection
Departure connection · SVG · Waypoint CSV
A Coruña · ESLCG
A Coruña: Arrival approach
Arrival approach · SVG · Waypoint CSV
A Coruña: Departure connection
Departure connection · SVG · Waypoint CSV
Bilbao · ESBIO
Bilbao: Arrival approach
Arrival approach · SVG · Waypoint CSV
Bilbao: Departure connection
Departure connection · SVG · Waypoint CSV
Le Havre · FRLEH
Le Havre: Arrival approach
Arrival approach · SVG · Waypoint CSV
Le Havre: Departure connection
Departure connection · SVG · Waypoint CSV
Rotterdam · NLRTM
Rotterdam: Arrival approach
Arrival approach · SVG · Waypoint CSV
Rotterdam: Departure connection
Departure connection · SVG · Waypoint CSV
Hamburg · DEHAM
Hamburg: Arrival approach
Arrival approach · SVG · Waypoint CSV
Hamburg: Departure connection
Departure connection · SVG · Waypoint CSV
Esbjerg · DKEBJ
Esbjerg: Arrival approach
Arrival approach · SVG · Waypoint CSV
Esbjerg: Departure connection
Departure connection · SVG · Waypoint CSV
Oslo · NOOSL
Oslo: Arrival approach
Arrival approach · SVG · Waypoint CSV
Oslo: Departure connection
Departure connection · SVG · Waypoint CSV
Edinburgh · Leith · GBLEI
Edinburgh · Leith: Arrival approach
Arrival approach · SVG · Waypoint CSV
Edinburgh · Leith: Departure connection
Departure connection · SVG · Waypoint CSV
Sunderland · GBSUN
Sunderland: Arrival approach
Arrival approach · SVG · Waypoint CSV
Sunderland: Departure connection
Departure connection · SVG · Waypoint CSV
Dover · GBDVR
Dover: Arrival approach
Arrival approach · SVG · Waypoint CSV
Dover: Departure connection
Departure connection · SVG · Waypoint CSV
Southampton · GBSOU
Southampton: Arrival approach
Arrival approach · SVG · Waypoint CSV
Southampton: Departure connection
Departure connection · SVG · Waypoint CSV

North America and Caribbean: Boston → Newport, RI → New York → Norfolk → Charleston → Miami → Kingston → Colón → Cartagena → Caracas · La Guaira.

Boston · USBOS
Boston: Arrival approach
Arrival approach · SVG · Waypoint CSV
Boston: Departure connection
Departure connection · SVG · Waypoint CSV
Newport, RI · USEFK
Newport, RI: Arrival approach
Arrival approach · SVG · Waypoint CSV
Newport, RI: Departure connection
Departure connection · SVG · Waypoint CSV
New York · USNYC
New York: Arrival approach
Arrival approach · SVG · Waypoint CSV
New York: Departure connection
Departure connection · SVG · Waypoint CSV
Norfolk · USORF
Norfolk: Arrival approach
Arrival approach · SVG · Waypoint CSV
Norfolk: Departure connection
Departure connection · SVG · Waypoint CSV
Charleston · USCHS
Charleston: Arrival approach
Arrival approach · SVG · Waypoint CSV
Charleston: Departure connection
Departure connection · SVG · Waypoint CSV
Miami · USMIA
Miami: Arrival approach
Arrival approach · SVG · Waypoint CSV
Miami: Departure connection
Departure connection · SVG · Waypoint CSV
Kingston · JMKIN
Kingston: Arrival approach
Arrival approach · SVG · Waypoint CSV
Kingston: Departure connection
Departure connection · SVG · Waypoint CSV
Colón · PAONX
Colón: Arrival approach
Arrival approach · SVG · Waypoint CSV
Colón: Departure connection
Departure connection · SVG · Waypoint CSV
Cartagena · COCTG
Cartagena: Arrival approach
Arrival approach · SVG · Waypoint CSV
Cartagena: Departure connection
Departure connection · SVG · Waypoint CSV
Caracas · La Guaira · VELAG
Caracas · La Guaira: Arrival approach
Arrival approach · SVG · Waypoint CSV
Caracas · La Guaira: Departure connection
Departure connection · SVG · Waypoint CSV

South America: Recife → Rio de Janeiro → Santos → Buenos Aires → Montevideo → Puerto Madryn → Cape Horn passage → Valparaíso → Callao.

Recife · BRREC
Recife: Arrival approach
Arrival approach · SVG · Waypoint CSV
Recife: Departure connection
Departure connection · SVG · Waypoint CSV
Rio de Janeiro · BRRIO
Rio de Janeiro: Arrival approach
Arrival approach · SVG · Waypoint CSV
Rio de Janeiro: Departure connection
Departure connection · SVG · Waypoint CSV
Santos · BRSSZ
Santos: Arrival approach
Arrival approach · SVG · Waypoint CSV
Santos: Departure connection
Departure connection · SVG · Waypoint CSV
Buenos Aires · ARBUE
Buenos Aires: Arrival approach
Arrival approach · SVG · Waypoint CSV
Buenos Aires: Departure connection
Departure connection · SVG · Waypoint CSV
Montevideo · UYMVD
Montevideo: Arrival approach
Arrival approach · SVG · Waypoint CSV
Montevideo: Departure connection
Departure connection · SVG · Waypoint CSV
Puerto Madryn · ARPMY
Puerto Madryn: Arrival approach
Arrival approach · SVG · Waypoint CSV
Puerto Madryn: Departure connection
Departure connection · SVG · Waypoint CSV
Valparaíso · CLVAP
Valparaíso: Arrival approach
Arrival approach · SVG · Waypoint CSV
Valparaíso: Departure connection
Departure connection · SVG · Waypoint CSV
Callao · PECLL
Callao: Arrival approach
Arrival approach · SVG · Waypoint CSV
Callao: Departure connection
Departure connection · SVG · Waypoint CSV

Pacific and return to Busan: Acapulco → Manzanillo → San Diego → Los Angeles → San Francisco → Honolulu → Yokohama → Nagoya → Osaka → Kobe → Hiroshima → Hakata → Nagasaki → Jeju → Yeosu → Geoje → Busan.

Acapulco · MXACA
Acapulco: Arrival approach
Arrival approach · SVG · Waypoint CSV
Acapulco: Departure connection
Departure connection · SVG · Waypoint CSV
Manzanillo · MXZLO
Manzanillo: Arrival approach
Arrival approach · SVG · Waypoint CSV
Manzanillo: Departure connection
Departure connection · SVG · Waypoint CSV
San Diego · USSAN
San Diego: Arrival approach
Arrival approach · SVG · Waypoint CSV
San Diego: Departure connection
Departure connection · SVG · Waypoint CSV
Los Angeles · USLAX
Los Angeles: Arrival approach
Arrival approach · SVG · Waypoint CSV
Los Angeles: Departure connection
Departure connection · SVG · Waypoint CSV
San Francisco · USSFO
San Francisco: Arrival approach
Arrival approach · SVG · Waypoint CSV
San Francisco: Departure connection
Departure connection · SVG · Waypoint CSV
Honolulu · USHNL
Honolulu: Arrival approach
Arrival approach · SVG · Waypoint CSV
Honolulu: Departure connection
Departure connection · SVG · Waypoint CSV
Yokohama · JPYOK
Yokohama: Arrival approach
Arrival approach · SVG · Waypoint CSV
Yokohama: Departure connection
Departure connection · SVG · Waypoint CSV
Nagoya · JPNGO
Nagoya: Arrival approach
Arrival approach · SVG · Waypoint CSV
Nagoya: Departure connection
Departure connection · SVG · Waypoint CSV
Osaka · JPOSA
Osaka: Arrival approach
Arrival approach · SVG · Waypoint CSV
Osaka: Departure connection
Departure connection · SVG · Waypoint CSV
Kobe · JPUKB
Kobe: Arrival approach
Arrival approach · SVG · Waypoint CSV
Kobe: Departure connection
Departure connection · SVG · Waypoint CSV
Hiroshima · JPHIJ
Hiroshima: Arrival approach
Arrival approach · SVG · Waypoint CSV
Hiroshima: Departure connection
Departure connection · SVG · Waypoint CSV
Hakata · JPHKT
Hakata: Arrival approach
Arrival approach · SVG · Waypoint CSV
Hakata: Departure connection
Departure connection · SVG · Waypoint CSV
Nagasaki · JPNGS
Nagasaki: Arrival approach
Arrival approach · SVG · Waypoint CSV
Nagasaki: Departure connection
Departure connection · SVG · Waypoint CSV
Jeju · KRCHA
Jeju: Arrival approach
Arrival approach · SVG · Waypoint CSV
Jeju: Departure connection
Departure connection · SVG · Waypoint CSV
Yeosu · KRYOS
Yeosu: Arrival approach
Arrival approach · SVG · Waypoint CSV
Yeosu: Departure connection
Departure connection · SVG · Waypoint CSV
Geoje · KRKJE
Geoje: Arrival approach
Arrival approach · SVG · Waypoint CSV
Geoje: Departure connection
Departure connection · SVG · Waypoint CSV

How the follow vehicle stays behind

The follower steers along the lead vehicle's sailed trail. It looks ahead to begin turns early and sets requested speed from measured lead speed and spacing error.

The follower brakes as it closes the gap and stops requesting forward speed at very short range. Waves, turns and attitude affect actual separation. When the lead vehicle nearly stops, the follower faces it for the forward-camera view.

If the vehicles remain within 8 m for 60 seconds of simulation time, the controller stops the leader and relocates the follower. It selects a recorded track point 60–120 m away, requiring at least 3 m depth across a 12 m footprint and no mapped land. It recreates only the follower, then confirms a measured gap of at least 20 m. The leader, world and voyage history remain intact; the recovery log records the relocation. Failed attempts are at least five simulation minutes apart.

Each vehicle has propellers, a camera, LiDAR, IMU, thrust telemetry, wake and splash. Lead/follow control uses simulator position and velocity. Test a sensor-based controller with Control an installed workspace.

Terrain, water and nearby traffic

Terrain uses real seabed and land elevation with coastline refinement and satellite imagery. Nearby tiles load in the background; recent tiles support turning back. The vehicle waits when safe terrain coverage is insufficient. The public voyage prepares a complete tile square around the vessel and downloads the next outer row before crossing a cell boundary. Only tiles verified in Gazebo count as safe coverage.

Generated tile files are checked for cleanup every minute. The disk cache targets 128 tiles per terrain origin; loaded, pending and required tiles stay protected, and retired files have a 10-minute grace period. Protected or recent files can temporarily exceed the target. Numeric seam samples remain available for consistent terrain regeneration.

Sea level is local z = 0. Waves can cover low coastal surfaces. The World camera shows loaded terrain, and route checks use depth and collision geometry.

Open AIS feed to see reported ships sorted by distance. AIS vessels are visual models of received reports. Moving-vessel collision avoidance is unsupported.

AIS reception and vessel models

Automatic Identification System (AIS) reports from AISStream and Open Waters are matched by MMSI, each vessel's maritime radio identifier. Each vessel uses its latest position and known dimensions. The feed shows the provider and time since the latest report. Course over ground supplies direction when true heading is unavailable.

Click a minimap marker to see the vessel name. Nearby ships also appear in the Gazebo 3D scene.

Coverage and report intervals vary by region. An empty list means no reports meet the display conditions.

Valid AIS dimensions set length to A + B and beam to C + D. Missing dimensions use the representative sizes below. Models depict vessel categories.

AIS category Model example Representative length Features
Cargo Cargo AIS model 120 m Containers, aft superstructure
Tanker Tanker AIS model 150 m Red hull, deck tanks
Passenger Passenger AIS model 80 m Windows, multiple decks, funnels
Fishing Fishing AIS model 18 m Blue hull, wheelhouse, masts
Tug / towing Tug AIS model 25 m Red hull, wheelhouse
Sailing Sailing AIS model 10 m Sail, mast, cabin
Pleasure craft Pleasure-craft AIS model 12 m Yellow hull, small cabin
Unknown Unknown AIS model 25 m Workboat shape

Images show models rendered with representative dimensions, each at its own scale. Meshes use the CC0 Kenney Watercraft Kit 2.1. The tanker uses a cargo deck with tanks.

Sensors and measured signals

Choose Lead / Follow in the sensor panel independently of the main scene. The follower is selected by default.

The forward camera renders loaded terrain within its field of view.

LiDAR lead / follow annotations show Gazebo positions transformed into the sensor frame. Coral points show measured LiDAR returns. Annotations disappear when the other vehicle is out of range or its position is stale.

Signal Meaning
Forward camera Gazebo sensor image attached to the hull; follows roll, pitch and heave.
LiDAR Measured ray ranges. Several vertical layers help the follower scan the lead hull. Returns depend on range, field of view and geometry.
IMU Sensor-frame orientation, angular velocity and linear acceleration; affected by waves.
Position and attitude Latitude/longitude, heading, roll and pitch. Fullscreen local position uses NED.
Thruster input Left/right propeller force commands in newtons.
Speed Measured vehicle speed. Maps show kn; sensor panels show m/s and kn.

Sensors use the selected scene’s playback clock. Expand the panel to compare values and sample age.

Read the live panels

Control or panel What it shows
World / Vehicle Gazebo coastal overview or a lead/follow vehicle view
Lead / Follow in Sensors Selected vehicle's camera, LiDAR and measurements
Sensor panel Position, speed, IMU and thrust; more values in fullscreen
Minimap OpenFreeMap local map, both vehicles, upcoming waypoints and track
World map Equal Earth overview of the lead vehicle and itinerary
Voyage statistics Distance, time, port visits, world tours, destination and arrival estimate
Port photos Highlighted photo icon and text below Port visits; World, Vehicle and forward-camera photographs by visit

Waypoint labels follow the map's zoom level. Zoom in to see nearby segment ends.

Map zoom changes the map content while the viewer interface keeps its scale. On desktop, the viewer fills the window; action and sensor panels scroll independently.

The world map uses Natural Earth 1:50M coastlines. Port labels depend on zoom and available space.

The voyage continues while viewing is paused. Buffered video can lag behind telemetry. For hands-on testing, open a Workspace basics or install the Installation.

Search documentation