maritime-schema is a DNV initiative that establishes open formats and interfaces for collision avoidance testing, enabling industry collaboration in the field of Autonomous and Remotely Operated Ships.
The goal is to enable industry partners to share maritime traffic situations, and solutions (collision avoidance maneuvers) to these situations.
Full documentation and interactive schema viewers are available at dnv-opensource.github.io/maritime-schema.
| Schema | Description | File |
|---|---|---|
| Traffic Situation | Stores the initial scenario with own ship waypoints and target ship paths. | schemas/traffic_situation.json |
| Situation Output | The solution produced by a collision avoidance system. | schemas/situation_output.json |
| Simulation Output | Ship motion simulation data stored as Apache Arrow tables. | See documentation |
| Marzip | A container file format that bundles multiple schema files together. | See documentation |
Example JSON files conforming to each schema are provided in the examples/ folder:
examples/traffic_situation.json— A sample traffic situation scenarioexamples/situation_output.json— A sample collision avoidance output
The documentation can be found at dnv-opensource.github.io/maritime-schema.
- ship-traffic-generator — Python library for generating traffic situations. Includes pydantic classes that were previously part of this repo (prior to v0.0.7).
This project is licensed under the MIT License.
Copyright (c) 2026 DNV