This is a schema that stores result data produced when testing collision and grounding avoidance systems.
maritime-schema version number
"0.0.7"
Date and Time that this file was created, in ISO 8601 format YYYY-MM-DDThh:mm:ssZ. This should be the simulation end time.
"2025-01-01T00:00:00"
The traffic situation that was simulated (input file). This should remain unmodified.
maritime-schema version number
"0.0.7"
The title of the traffic situation
"overtaking_18"
A description of the traffic situation
"Crossing situation with 3 target vessels in the Oslo fjord"
Starting time of the situation in ISO 8601 format YYYY-MM-DDThh:mm:ssZ
"2025-01-01T00:00:00"
Own Ship (OS) data
{
"initial": {
"cog": 284.2,
"heading": 283.1,
"navStatus": "Under way using engine",
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"sog": 12.3
},
"waypoints": [
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
}
]
}
Initial pose of the ship. If waypoints are provided, then these should correspond to the pose of the ship at the starting waypoint
{
"cog": 284.2,
"heading": 283.1,
"navStatus": "Under way using engine",
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"sog": 12.3
}
longitude and latitude of the ship.
{
"lat": 10.3432,
"lon": 57.2343
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectship (SOG) ground in knots
Value must be greater or equal to 0.0
10.0
ship course over ground (COG) in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.0
ship heading in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.2
An array of Waypoint objects. Each waypoint object must have a position property. If no turn radius is provided, it will be assumed to be 0. Additional data can be added to each waypoint leg.
A geographical coordinate.
{
"lat": 51.2123,
"lon": 11.2313
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectOrthodrome turn radius in nautical miles as defined in RTZ.
200
Current Leg information.
Starboard XTD in NM as defined in RTZ.
Starboard XTD in NM as defined in RTZ.
Planned Speed over Ground in knots for this leg. If provided, leg.data.sog shall take priority over leg.sog.
The data field can be used to store data, which is numerical and continuous. One such example is the vessels speed over ground (SOG). Every data object, can have the 4 following attributes:
value: This is the value of the data over the current leg.
interpStart: This is the distance (in NM) before the leg change, where the value will start changing (via interpolation) to the new value in the next leg.
interpEnd: This is the distance (in NM) after the leg change, where the value will finish changing (via interpolation) to the new value in the next leg.
interpMethod: This sets the interpolation (linear, cosine, smoothstep, etc.) that will be used to perform the interpolation.
Each additional property must conform to the following schema
the value of the data at the current waypoint
12.3
distance before start of the next leg (NM), to start interpolating to the next leg's value
10
distance after the start of the next leg (NM), to finish interpolating to the next leg's value
10
Method used for interpolation
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
}
Static ship information which does not change during a scenario.
{
"dimensions": {
"a": 50.0,
"b": 50.0,
"c": 10.0,
"d": 10.0,
"draught": null,
"height": null,
"length": 100.0,
"width": 20.0
},
"id": 1,
"imo": 1000001,
"initDelay": null,
"mmsi": 123456789,
"name": "RMS Titanic",
"pathType": null,
"positionFixingDevice": null,
"shipType": "Fishing",
"sogMax": 20.0,
"sogMin": null,
"stationType": null
}
Ship Identifier
Value must be greater or equal to 0 and lesser or equal to 4294967296
1
Maritime Mobile Service Identity (MMSI)
Value must be greater or equal to 100000000 and lesser or equal to 999999999
123456789
IMO Number
Value must be greater or equal to 1000000 and lesser or equal to 9999999
1234567
Ship name
"RMS Titanic"
Key ship dimensions
Width of the ship in meters
Value must be strictly greater than 0.0
130.0
Width of the ship in meters
Value must be strictly greater than 0.0
30.0
Height of the ship in meters
Value must be strictly greater than 0.0
15.0
Draught of the ship in meters
Value must be strictly greater than 0.0
15.0
Distance in meters from CCRP to Bow
Value must be strictly greater than 0.0
80
Distance in meters from CCRP to Stern
Value must be strictly greater than 0.0
20
Distance in meters from CCRP to Port
Value must be strictly greater than 0.0
20
Distance in meters from CCRP to Starboard
Value must be strictly greater than 0.0
20
General ship type, based on AIS
AIS Ship Type (not including cargo type).
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=116.
Ship Type.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=116.
AIS Ship Type in Integer format.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=116.
AIS station type
AIS Station Type.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=138.
AIS Station Type in Integer form.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=138.
AIS position fixing device
AIS Position Fixing Device.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=115.
AIS Position fixing device in Integer form.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=113.
Specifies the control-point model (e.g., Bezier, RTZ) used to define the path for the ship to follow.
Delay in seconds, before the ship is initialized
Value must be greater or equal to 0.0
15.0
Minimum ship speed over ground in knots
Value must be greater or equal to 0.0
5.0
Maximum ship speed over ground in knots
Value must be greater or equal to 0.0
15.0
Additional Properties of any type are allowed.
Type: objectTarget Ship (TGT) data
No Additional ItemsInitial pose of the ship. If waypoints are provided, then these should correspond to the pose of the ship at the starting waypoint
{
"cog": 284.2,
"heading": 283.1,
"navStatus": "Under way using engine",
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"sog": 12.3
}
longitude and latitude of the ship.
{
"lat": 10.3432,
"lon": 57.2343
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectship (SOG) ground in knots
Value must be greater or equal to 0.0
10.0
ship course over ground (COG) in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.0
ship heading in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.2
An array of Waypoint objects. Each waypoint object must have a position property. If no turn radius is provided, it will be assumed to be 0. Additional data can be added to each waypoint leg.
A geographical coordinate.
{
"lat": 51.2123,
"lon": 11.2313
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectOrthodrome turn radius in nautical miles as defined in RTZ.
200
Current Leg information.
Starboard XTD in NM as defined in RTZ.
Starboard XTD in NM as defined in RTZ.
Planned Speed over Ground in knots for this leg. If provided, leg.data.sog shall take priority over leg.sog.
The data field can be used to store data, which is numerical and continuous. One such example is the vessels speed over ground (SOG). Every data object, can have the 4 following attributes:
value: This is the value of the data over the current leg.
interpStart: This is the distance (in NM) before the leg change, where the value will start changing (via interpolation) to the new value in the next leg.
interpEnd: This is the distance (in NM) after the leg change, where the value will finish changing (via interpolation) to the new value in the next leg.
interpMethod: This sets the interpolation (linear, cosine, smoothstep, etc.) that will be used to perform the interpolation.
Each additional property must conform to the following schema
the value of the data at the current waypoint
12.3
distance before start of the next leg (NM), to start interpolating to the next leg's value
10
distance after the start of the next leg (NM), to finish interpolating to the next leg's value
10
Method used for interpolation
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
}
Static ship information which does not change during a scenario.
{
"dimensions": {
"a": 50.0,
"b": 50.0,
"c": 10.0,
"d": 10.0,
"draught": null,
"height": null,
"length": 100.0,
"width": 20.0
},
"id": 1,
"imo": 1000001,
"initDelay": null,
"mmsi": 123456789,
"name": "RMS Titanic",
"pathType": null,
"positionFixingDevice": null,
"shipType": "Fishing",
"sogMax": 20.0,
"sogMin": null,
"stationType": null
}
Ship Identifier
Value must be greater or equal to 0 and lesser or equal to 4294967296
1
Maritime Mobile Service Identity (MMSI)
Value must be greater or equal to 100000000 and lesser or equal to 999999999
123456789
IMO Number
Value must be greater or equal to 1000000 and lesser or equal to 9999999
1234567
Ship name
"RMS Titanic"
Key ship dimensions
Width of the ship in meters
Value must be strictly greater than 0.0
130.0
Width of the ship in meters
Value must be strictly greater than 0.0
30.0
Height of the ship in meters
Value must be strictly greater than 0.0
15.0
Draught of the ship in meters
Value must be strictly greater than 0.0
15.0
Distance in meters from CCRP to Bow
Value must be strictly greater than 0.0
80
Distance in meters from CCRP to Stern
Value must be strictly greater than 0.0
20
Distance in meters from CCRP to Port
Value must be strictly greater than 0.0
20
Distance in meters from CCRP to Starboard
Value must be strictly greater than 0.0
20
General ship type, based on AIS
AIS Ship Type (not including cargo type).
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=116.
Ship Type.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=116.
AIS Ship Type in Integer format.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=116.
AIS station type
AIS Station Type.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=138.
AIS Station Type in Integer form.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=138.
AIS position fixing device
AIS Position Fixing Device.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=115.
AIS Position fixing device in Integer form.
Source: https://www.itu.int/dms_pubrec/itu-r/rec/m/R-REC-M.1371-5-201402-I!!PDF-E.pdf#page=113.
Specifies the control-point model (e.g., Bezier, RTZ) used to define the path for the ship to follow.
Delay in seconds, before the ship is initialized
Value must be greater or equal to 0.0
15.0
Minimum ship speed over ground in knots
Value must be greater or equal to 0.0
5.0
Maximum ship speed over ground in knots
Value must be greater or equal to 0.0
15.0
Additional Properties of any type are allowed.
Type: object[
{
"initial": {
"cog": 284.2,
"heading": 283.1,
"navStatus": "Under way using engine",
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"sog": 12.3
},
"waypoints": [
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
}
]
}
]
Environmental parameters
{
"airTemperature": 20.0,
"conditions": "Clear",
"currentDirection": 90.0,
"currentSpeed": 1.0,
"precipitation": "Rain",
"significantWaveHeight": 3.0,
"visibility": 5.0,
"waterTemperature": 15.0,
"waveDirection": 270.0,
"wavePeriod": 12.0,
"waveSpectrum": "JONSWAP",
"windDirection": 180.0,
"windSpeed": 10.0
}
The air temperature in degrees Celsius
20.0
The water temperature in degrees Celsius
15.0
The type of precipitation
"Rain"
The wind speed in m/s
10.0
The wind direction in degrees
180.0
The current speed in m/s
1.0
The current direction in degrees
90.0
The wave spectrum
"JONSWAP"
The significant wave height in meters
3.0
The wave period in seconds
12.0
The wave direction in degrees
270.0
The visibility in nautical miles
5.0
The overall weather conditions
"Clear"
Additional Properties of any type are allowed.
Type: objectData generated by the system under test (auto-navigation / collision and grounding avoidance system) during the scenario.
System Configuration
{
"name": "AutoNavigation-System 1",
"vendor": "CompanyABC",
"version": "1.2.3"
}
Minimum distance in meters that the system will keep to other Vessels
100
Time given in seconds to the navigator / system, before the proposed manoeuver is no longer able to be executed
20
Minimum safety depth
30
Additional Properties of any type are allowed.
Type: objectEvent data from the system
No Additional ItemsDate and Time of the event
"2025-01-01T00:00:00"
Planned Collision Avoidance Route
No Additional ItemsA geographical coordinate.
{
"lat": 51.2123,
"lon": 11.2313
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectOrthodrome turn radius in nautical miles as defined in RTZ.
200
Current Leg information.
Starboard XTD in NM as defined in RTZ.
Starboard XTD in NM as defined in RTZ.
Planned Speed over Ground in knots for this leg. If provided, leg.data.sog shall take priority over leg.sog.
The data field can be used to store data, which is numerical and continuous. One such example is the vessels speed over ground (SOG). Every data object, can have the 4 following attributes:
value: This is the value of the data over the current leg.
interpStart: This is the distance (in NM) before the leg change, where the value will start changing (via interpolation) to the new value in the next leg.
interpEnd: This is the distance (in NM) after the leg change, where the value will finish changing (via interpolation) to the new value in the next leg.
interpMethod: This sets the interpolation (linear, cosine, smoothstep, etc.) that will be used to perform the interpolation.
Each additional property must conform to the following schema
the value of the data at the current waypoint
12.3
distance before start of the next leg (NM), to start interpolating to the next leg's value
10
distance after the start of the next leg (NM), to finish interpolating to the next leg's value
10
Method used for interpolation
Target Ship (TGT) states at the time the maneuver was generated
No Additional Itemslongitude and latitude of the ship.
{
"lat": 10.3432,
"lon": 57.2343
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectship (SOG) ground in knots
Value must be greater or equal to 0.0
10.0
ship course over ground (COG) in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.0
ship heading in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.2
Target id
Target range in nautical miles, at the closest point of approach. Sometimes known as 'dcpa'.
Time to CPA in seconds.
Current distance to the target
COLREG Encounter Type
Own Ship state at the time the maneuver was generated
longitude and latitude of the ship.
{
"lat": 10.3432,
"lon": 57.2343
}
WGS-84 Longitude
Value must be greater or equal to -180.0 and lesser or equal to 180.0
51.2131
WGS-84 Latitude
Value must be greater or equal to -90.0 and lesser or equal to 90.0
51.2131
Additional Properties of any type are allowed.
Type: objectship (SOG) ground in knots
Value must be greater or equal to 0.0
10.0
ship course over ground (COG) in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.0
ship heading in degrees
Value must be greater or equal to 0.0 and lesser or equal to 360.0
45.2
Additional Properties of any type are allowed.
Type: object{
"ownShip": null,
"route": [
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
},
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
},
{
"leg": null,
"position": {
"lat": 10.3432,
"lon": 57.2343
},
"turnRadius": 1.0
}
],
"targetShips": null,
"time": "2025-01-01T00:00:00"
}
Data generated by the simulator during the scenario
System Configuration
{
"name": "AutoNavigation-System 1",
"vendor": "CompanyABC",
"version": "1.2.3"
}
Minimum distance in meters that the system will keep to other Vessels
100
Time given in seconds to the navigator / system, before the proposed manoeuver is no longer able to be executed
20
Minimum safety depth
30
Additional Properties of any type are allowed.
Type: objectEvent data from the simulator
No Additional ItemsDate and Time of the event
"2025-01-01T00:00:00"
Additional Properties of any type are allowed.
Type: object{
"time": "2025-01-01T00:00:00"
}
Additional Properties of any type are allowed.
Type: object