Description

The Vessel is a Vehicle that represents a maritime object on the Earth’s surface. It can be used to simulate ships or connect to maritime data streams to represent real vessel positions. The vessel is constrained to the surface of a WGS-84 (World Geodetic System) globe, which models the true non-spherical shape of the Earth. The vessel outputs standard AIS (Automatic Identification System) position reports for integration with maritime systems.


Example Use Cases

  • Ship Tracking: Represent vessel positions from AIS maritime data streams.
  • Ground Station Visibility: Simulate ship-based tracking stations for spacecraft communication analysis.
  • Maritime Operations: Model surface vessels for multi-domain simulation scenarios.
  • AIS Integration: Generate position reports compatible with maritime communication standards.

Module Implementation

The vessel extends the base Vehicle with maritime-specific properties and surface-constrained motion.

Heading and Velocity

The vessel orientation is defined by a heading angle measured clockwise from true north, in . The bow is the body’s forward axis and points along . When the vessel speed is non-zero, the velocity in the vehicle origin frame is computed from the heading and the vehicle’s Origin North :

where the components are origin east, origin north, and up. With these are true east and true north.

Course Over Ground

The course over ground (COG) represents the actual direction of travel based on the vessel’s surface velocity. It is calculated from the origin-frame velocity components and returned as a true-north bearing:

where is the origin-east velocity component and is the origin-north velocity component. When the vessel is stationary, the COG defaults to the current heading.

AIS Position Report

The vessel generates an AIS position report when it is created and on every update. The true heading is also refreshed whenever Heading is set, so it is correct before the simulation runs. The report contains:

  • True Heading: The bow angle in degrees, clockwise from true north
  • Course Over Ground: Direction of surface velocity in degrees, clockwise from true north
  • Speed Over Ground: Vessel speed converted to knots ()
  • Position: Latitude and longitude in WGS-84 coordinates

Maritime Identification

The vessel supports identification via Maritime Mobile Service Identity (MMSI), the standard unique nine-digit identifier used in maritime communications.

Surface Constraint

The vessel is always positioned on the Earth’s surface using the WGS-84 ellipsoid model. Location changes are restricted to Earth regardless of any planet parameter specified.


Assumptions/Limitations

  • The vessel is constrained to the Earth’s surface; it cannot represent objects on other celestial bodies.
  • The model does not simulate hydrodynamic effects, wave motion, or ocean currents.
  • Altitude is measured relative to the WGS-84 reference ellipsoid, not mean sea level.
  • Course over ground assumes flat-Earth geometry for velocity decomposition over short distances.
  • The AIS position report does not include all fields defined in the full AIS standard.