CAGA Output Schema#

Test Output Schema

Test Output Schema

Type: object

This is a JSON schema for result data originating from Collision and Grounding Avoidance systems

Creationtime

Type: stringFormat: date-time

Date and Time that this file was created, in ISO 8601 format YYYY-MM-DDThh:mm:ssZ. This should be the simulation end time.
Example:

"2024-04-04T13:41:01.725632"

Default: null

The traffic situation that was simulated (input file). This should remain unmofidied.

Type: object

Title

Type: string Default: null

The title of the traffic situation
Example:

"overtaking_18"

Description

Default: null

A description of the traffic situation

Type: string
Type: null

Example:

"Crossing situation with 3 target vessels in the Oslofjord"

Starttime

Default: null

Starting time of the situation in ISO 8601 format YYYY-MM-DDThh:mm:ssZ

Type: stringFormat: date-time
Type: null

Example:

"2024-04-04T13:41:01.704131"

Own Ship data

Type: object

Own Ship data
Example:

{
    "initial": {
        "cog": 284.2,
        "heading": 283.1,
        "navStatus": "Under way using engine",
        "position": {
            "latitude": 57.2343,
            "longitude": 10.3432
        },
        "sog": 12.3
    },
    "static": {
        "height": 15.0,
        "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "imo": 1000001,
        "length": 230.0,
        "mmsi": 123456789,
        "name": "RMS Titanic",
        "shipType": "Fishing",
        "speedMax": 20.0,
        "width": 30.0
    },
    "waypoints": [
        {
            "data": {
                "heading": {
                    "interpMethod": "linear",
                    "mAfterLegChange": 100.0,
                    "mBeforeLegChange": 100.0,
                    "value": 12.3
                },
                "sog": {
                    "interpMethod": "linear",
                    "mAfterLegChange": 100.0,
                    "mBeforeLegChange": 100.0,
                    "value": 12.3
                }
            },
            "position": {
                "latitude": 57.2343,
                "longitude": 10.3432
            },
            "turnRadius": 500.0
        }
    ]
}

Type: object Default: null

Static ship information which does not change during a scenario.
Example:

{
    "height": 15.0,
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "imo": 1000001,
    "length": 230.0,
    "mmsi": 123456789,
    "name": "RMS Titanic",
    "shipType": "Fishing",
    "speedMax": 20.0,
    "width": 30.0
}

Id

Type: stringFormat: uuid

Unique Identifier
Example:

"8cbccf5a-2415-4609-a886-be2e6ecb67c3"

Length

Type: number Default: null

Length of the ship in meters

Value must be strictly greater than 0.0


Example:

230.0

Width

Type: number Default: null

Width of the ship in meters

Value must be strictly greater than 0.0


Example:

30.0

Height

Default: null

Height of the ship in meters

Type: number

Value must be strictly greater than 0.0

Type: null

Example:

15.0

Speedmax

Default: null

Maximum speed of the ship in knots

Type: number

Value must be strictly greater than 0.0

Type: null

Example:

15.0

Mmsi

Default: null

Maritime Mobile Service Identity (MMSI)

Type: integer

Value must be greater or equal to 100000000 and lesser or equal to 999999999

Type: null

Example:

123456789

Imo

Default: null

IMO Number

Type: integer

Value must be greater or equal to 1000000 and lesser or equal to 9999999

Type: null

Example:

1234567

Name

Default: null

Ship name

Type: string
Type: null

Example:

"RMS Titanic"

Default: null

General ship type, based on AIS

Type: enum (of string)

Must be one of:

  • "Wing in ground"
  • "Fishing"
  • "Towing"
  • "Dredging or underwater ops"
  • "Diving ops"
  • "Military ops"
  • "Sailing"
  • "Pleasure Craft"
  • "High speed craft"
  • "Pilot Vessel"
  • "Search and Rescue vessel"
  • "Tug"
  • "Port Tender"
  • "Anti-pollution"
  • "Law Enforcement"
  • "Medical Transport"
  • "Noncombatant ship"
  • "Passenger"
  • "Cargo"
  • "Tanker"
  • "Other Type"
Type: null

Additional Properties of any type are allowed.

Type: object

Default: null

Type: object

Type: object Default: null

Initial longitude and latitude of the ship.
Example:

{
    "latitude": 57.2343,
    "longitude": 10.3432
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Sog

Type: number Default: null

Initial ship speed over ground in knots

Value must be greater or equal to 0.0


Example:

10.0

Cog

Type: number Default: null

Initial ship course over ground in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.0

Heading

Type: number Default: null

Initial ship heading in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.2

Default: null

AIS Navigational Status

Type: enum (of string)

Must be one of:

  • "Under way using engine"
  • "At anchor"
  • "Not under command"
  • "Restricted manoeuverability"
  • "Constrained by her draught"
  • "Moored"
  • "Aground"
  • "Engaged in fishing"
  • "Under way sailing"
  • "Reserved for future amendment of navigational status for HSC"
  • "Reserved for future amendment of navigational status for WIG"
  • "Reserved for future use 1"
  • "Reserved for future use 2"
  • "Reserved for future use 3"
  • "AIS SART is active"
  • "Not defined (default)"
Type: null
Type: null

Example:

{
    "cog": 284.2,
    "heading": 283.1,
    "navStatus": "Under way using engine",
    "position": {
        "latitude": 57.2343,
        "longitude": 10.3432
    },
    "sog": 12.3
}

Waypoints

Default: null

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. This allows varying parameters on a per-leg basis, such as speed and heading, or navigational status

Type: array
No Additional Items

Each item of this array must be:

Type: object

Type: object

A geographical coordinate
Example:

{
    "latitude": 51.2123,
    "longitude": 11.2313
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Turnradius

Default: null

Orthodrome turn radius as defined in RTZ format

Type: number
Type: null

Example:

200

Default: null

A Data object that includes speed, course, and heading data points

Type: object

Each additional property must conform to the following schema

Type: object

The 'data' field can include additional properties. All additional properties should be DataPoint objects.

Type: number

Type: number

Type: number

Type: string
Type: null
Type: null

Example:

{
    "data": {
        "heading": {
            "interpMethod": "linear",
            "mAfterLegChange": 100.0,
            "mBeforeLegChange": 100.0,
            "value": 12.3
        },
        "sog": {
            "interpMethod": "linear",
            "mAfterLegChange": 100.0,
            "mBeforeLegChange": 100.0,
            "value": 12.3
        }
    },
    "position": {
        "latitude": 57.2343,
        "longitude": 10.3432
    },
    "turnRadius": 500.0
}

Target Ship data

Type: array Default: null

Target Ship data

 No Additional Items

Each item of this array must be:

Type: object

Type: object Default: null

Static ship information which does not change during a scenario.
Example:

{
    "height": 15.0,
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "imo": 1000001,
    "length": 230.0,
    "mmsi": 123456789,
    "name": "RMS Titanic",
    "shipType": "Fishing",
    "speedMax": 20.0,
    "width": 30.0
}

Id

Type: stringFormat: uuid

Unique Identifier
Example:

"8cbccf5a-2415-4609-a886-be2e6ecb67c3"

Length

Type: number Default: null

Length of the ship in meters

Value must be strictly greater than 0.0


Example:

230.0

Width

Type: number Default: null

Width of the ship in meters

Value must be strictly greater than 0.0


Example:

30.0

Height

Default: null

Height of the ship in meters

Type: number

Value must be strictly greater than 0.0

Type: null

Example:

15.0

Speedmax

Default: null

Maximum speed of the ship in knots

Type: number

Value must be strictly greater than 0.0

Type: null

Example:

15.0

Mmsi

Default: null

Maritime Mobile Service Identity (MMSI)

Type: integer

Value must be greater or equal to 100000000 and lesser or equal to 999999999

Type: null

Example:

123456789

Imo

Default: null

IMO Number

Type: integer

Value must be greater or equal to 1000000 and lesser or equal to 9999999

Type: null

Example:

1234567

Name

Default: null

Ship name

Type: string
Type: null

Example:

"RMS Titanic"

Default: null

General ship type, based on AIS

Type: enum (of string)

Must be one of:

  • "Wing in ground"
  • "Fishing"
  • "Towing"
  • "Dredging or underwater ops"
  • "Diving ops"
  • "Military ops"
  • "Sailing"
  • "Pleasure Craft"
  • "High speed craft"
  • "Pilot Vessel"
  • "Search and Rescue vessel"
  • "Tug"
  • "Port Tender"
  • "Anti-pollution"
  • "Law Enforcement"
  • "Medical Transport"
  • "Noncombatant ship"
  • "Passenger"
  • "Cargo"
  • "Tanker"
  • "Other Type"
Type: null

Additional Properties of any type are allowed.

Type: object

Default: null

Type: object

Type: object Default: null

Initial longitude and latitude of the ship.
Example:

{
    "latitude": 57.2343,
    "longitude": 10.3432
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Sog

Type: number Default: null

Initial ship speed over ground in knots

Value must be greater or equal to 0.0


Example:

10.0

Cog

Type: number Default: null

Initial ship course over ground in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.0

Heading

Type: number Default: null

Initial ship heading in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.2

Default: null

AIS Navigational Status

Type: enum (of string)

Must be one of:

  • "Under way using engine"
  • "At anchor"
  • "Not under command"
  • "Restricted manoeuverability"
  • "Constrained by her draught"
  • "Moored"
  • "Aground"
  • "Engaged in fishing"
  • "Under way sailing"
  • "Reserved for future amendment of navigational status for HSC"
  • "Reserved for future amendment of navigational status for WIG"
  • "Reserved for future use 1"
  • "Reserved for future use 2"
  • "Reserved for future use 3"
  • "AIS SART is active"
  • "Not defined (default)"
Type: null
Type: null

Example:

{
    "cog": 284.2,
    "heading": 283.1,
    "navStatus": "Under way using engine",
    "position": {
        "latitude": 57.2343,
        "longitude": 10.3432
    },
    "sog": 12.3
}

Waypoints

Default: null

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. This allows varying parameters on a per-leg basis, such as speed and heading, or navigational status

Type: array
No Additional Items

Each item of this array must be:

Type: object

Type: object

A geographical coordinate
Example:

{
    "latitude": 51.2123,
    "longitude": 11.2313
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Turnradius

Default: null

Orthodrome turn radius as defined in RTZ format

Type: number
Type: null

Example:

200

Default: null

A Data object that includes speed, course, and heading data points

Type: object

Each additional property must conform to the following schema

Type: object

The 'data' field can include additional properties. All additional properties should be DataPoint objects.

Type: number

Type: number

Type: number

Type: string
Type: null
Type: null

Example:

{
    "data": {
        "heading": {
            "interpMethod": "linear",
            "mAfterLegChange": 100.0,
            "mBeforeLegChange": 100.0,
            "value": 12.3
        },
        "sog": {
            "interpMethod": "linear",
            "mAfterLegChange": 100.0,
            "mBeforeLegChange": 100.0,
            "value": 12.3
        }
    },
    "position": {
        "latitude": 57.2343,
        "longitude": 10.3432
    },
    "turnRadius": 500.0
}

Example:

[
    {
        "initial": {
            "cog": 284.2,
            "heading": 283.1,
            "navStatus": "Under way using engine",
            "position": {
                "latitude": 57.2343,
                "longitude": 10.3432
            },
            "sog": 12.3
        },
        "static": {
            "height": 15.0,
            "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
            "imo": 1000001,
            "length": 230.0,
            "mmsi": 123456789,
            "name": "RMS Titanic",
            "shipType": "Fishing",
            "speedMax": 20.0,
            "width": 30.0
        },
        "waypoints": [
            {
                "data": {
                    "heading": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    },
                    "sog": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    }
                },
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "turnRadius": 500.0
            }
        ]
    }
]

Default: null

environmental parameters

Type: object

Airtemperature

Type: number Default: null

The air temperature in degrees Celsius
Example:

20.0

Waterremperature

Type: number Default: null

The water temperature in degrees Celsius
Example:

15.0

Type: enum (of string) Default: null

The type of precipitation

Must be one of:

  • "None"
  • "Rain"
  • "Snow"
  • "Sleet"
  • "Hail"

Example:

"Rain"

Windspeed

Type: number Default: null

The wind speed in m/s
Example:

10.0

Winddirection

Type: number Default: null

The wind direction in degrees
Example:

180.0

Currentspeed

Type: number Default: null

The current speed in m/s
Example:

1.0

Currentdirection

Type: number Default: null

The current direction in degrees
Example:

90.0

Type: enum (of string) Default: null

The wave spectrum

Must be one of:

  • "JONSWAP"
  • "Pierson-Moskowitz"
  • "Bretschneider"

Example:

"JONSWAP"

Significantwaveheight

Type: number Default: null

The significant wave height in meters
Example:

3.0

Waveperiod

Type: number Default: null

The wave period in seconds
Example:

12.0

Wavedirection

Type: number Default: null

The wave direction in degrees
Example:

270.0

Visibility

Type: number Default: null

The visibility in nautical miles
Example:

5.0

Type: enum (of string) Default: null

The overall weather conditions

Must be one of:

  • "Clear"
  • "Cloudy"
  • "Foggy"
  • "Rainy"
  • "Snowy"

Example:

"Clear"
Type: null

Example:

{
    "airTemperature": 20.0,
    "conditions": "Clear",
    "currentDirection": 90.0,
    "currentSpeed": 1.0,
    "precipitation": "Rain",
    "significantWaveHeight": 3.0,
    "visibility": 5.0,
    "waterRemperature": 15.0,
    "waveDirection": 270.0,
    "wavePeriod": 12.0,
    "waveSpectrum": "JONSWAP",
    "windDirection": 180.0,
    "windSpeed": 10.0
}

Additional Properties of any type are allowed.

Type: object
Type: null

Default: null

Data generated by the system under test (auto-navigation / collision and grounding avoidance system) during the scenario.

Type: object

Type: object

System Configuration

The following properties are required:

  • name
  • vendor
  • version

Example:

{
    "name": "AutoNavigation-System 1",
    "vendor": "CompanyABC",
    "version": "1.2.3"
}

Type: number

Minimum distance in meters that the system will keep to other Vessels
Example:

100

Type: number

If the projected CPA is less than minimumDistanceToTargets, and TCPA falls below criticalTCPA, a new manoeuver should be calculated
Example:

1000

Type: number

Time given in seconds to the navigator / system, before the proposed manoeuver is no longer able to be excecuted
Example:

20

Type: number

Minimum safety depth
Example:

30

Type: number

If automatic maneuver acceptance is enabled, the new route will be activated after a specified number of seconds
Example:

20

Additional Properties of any type are allowed.

Type: object

Timeseriesdata

Type: array

Time series data from the system

 No Additional Items

Each item of this array must be:

Type: object

Time


Date and Time of the predicted value ISO 8601 format YYYY-MM-DDThh:mm:ssZ

Type: stringFormat: date-time
Type: integer

Example:

"2024-04-04T13:41:01.715921"

Targetships

Type: array

list of target ships detected by the CAGA system

 No Additional Items

Each item of this array must be:

Type: object

Id

Type: stringFormat: uuid

Unique Identifier
Example:

"bcd8b8af-b2b9-4adb-9b53-cfa3a6250d0f"

Type: object

A geographical coordinate
Example:

{
    "latitude": 51.2123,
    "longitude": 11.2313
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Sog

Type: number

Initial ship speed over ground in knots

Value must be greater or equal to 0.0


Example:

10.0

Cog

Type: number

Initial ship course over ground in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.0

Heading

Default: null

Initial ship heading in degrees

Type: number

Value must be greater or equal to 0.0 and lesser or equal to 360.0

Type: null

Example:

45.2

Type: enum (of string) Default: null

AIS Navigational Status

Must be one of:

  • "Under way using engine"
  • "At anchor"
  • "Not under command"
  • "Restricted manoeuverability"
  • "Constrained by her draught"
  • "Moored"
  • "Aground"
  • "Engaged in fishing"
  • "Under way sailing"
  • "Reserved for future amendment of navigational status for HSC"
  • "Reserved for future amendment of navigational status for WIG"
  • "Reserved for future use 1"
  • "Reserved for future use 2"
  • "Reserved for future use 3"
  • "AIS SART is active"
  • "Not defined (default)"

Default: null

COLREG encounter type

Type: enum (of string)

Must be one of:

  • "Overtaking stand-on"
  • "Overtaking give-way"
  • "Head-on"
  • "Crossing give-way"
  • "Crossing stand-on"
  • "No Risk"
Type: null

Example:

"Overtaking stand-on"

Colregrulesapplied

Type: array of integer Default: null

COLREG rules the system is applying to the vessel. Each item in the list must be of type int corresponding to the COLREG rule number

 No Additional Items

Each item of this array must be:

Type: integer

Example:

[
    16,
    17
]

Distancetotarget

Type: number Default: null

Calculated distance from the own ship to the target vessel
Example:

1900.2

Dcpa

Default: null

Calculated closest point of approach

Type: number
Type: null

Example:

100.3

Tcpa

Default: null

calculated time to closest point of approach in seconds

Type: number
Type: null

Example:

2131

Predictions

Default: null

List of predicted future values. This can be used to store data like a predicted path for each target vessel. The value field supports both numbers and objects

Type: object

Each additional property must conform to the following schema

Type: array
No Additional Items

Each item of this array must be:

Type: object

Time


Date and Time of the predicted value ISO 8601 format YYYY-MM-DDThh:mm:ssZ

Type: stringFormat: date-time
Type: integer

Example:

"2024-04-04T13:41:01.708931"

Value


Value of the prediction

Type: number
Type: object

Examples:

{
    "latitude": 57.2343,
    "longitude": 10.3432
}

100
Type: null

Example:

[
    {
        "time": "2024-04-04T13:41:01.710381",
        "value": {
            "latitude": 57.2343,
            "longitude": 10.3432
        }
    },
    {
        "time": "2024-04-04T13:41:01.710400",
        "value": {
            "latitude": 57.2343,
            "longitude": 10.3432
        }
    },
    {
        "time": "2024-04-04T13:41:01.710410",
        "value": {
            "latitude": 57.2343,
            "longitude": 10.3432
        }
    }
]

Additional Properties of any type are allowed.

Type: object

Example:

[
    {
        "cog": 181.0,
        "colregRulesApplied": [
            12
        ],
        "dcpa": 300.0,
        "distanceToTarget": 874.0,
        "encounterType": "Head-on",
        "heading": 182.0,
        "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "navStatus": "Under way using engine",
        "position": {
            "latitude": 57.2343,
            "longitude": 10.3432
        },
        "predictions": {
            "position": [
                {
                    "time": "2024-04-04T13:41:01.715978",
                    "value": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    }
                },
                {
                    "time": "2024-04-04T13:41:01.715991",
                    "value": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    }
                },
                {
                    "time": "2024-04-04T13:41:01.716001",
                    "value": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    }
                }
            ]
        },
        "sog": 10.2,
        "tcpa": 1200.0
    }
]

Internalstatus

Type: object Default: null

Dictionary containing additional internal information about the system (health, status..)

Example:

[
    {
        "internalStatus": null,
        "targetShips": [
            {
                "cog": 181.0,
                "colregRulesApplied": [
                    12
                ],
                "dcpa": 300.0,
                "distanceToTarget": 874.0,
                "encounterType": "Head-on",
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Under way using engine",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "predictions": {
                    "position": [
                        {
                            "time": "2024-04-04T13:41:01.720545",
                            "value": {
                                "latitude": 57.2343,
                                "longitude": 10.3432
                            }
                        },
                        {
                            "time": "2024-04-04T13:41:01.720558",
                            "value": {
                                "latitude": 57.2343,
                                "longitude": 10.3432
                            }
                        },
                        {
                            "time": "2024-04-04T13:41:01.720567",
                            "value": {
                                "latitude": 57.2343,
                                "longitude": 10.3432
                            }
                        }
                    ]
                },
                "sog": 10.2,
                "tcpa": 1200.0
            }
        ],
        "time": "2024-04-04T13:41:01.720525"
    }
]

Eventdata

Type: array Default: null

Event data from the system

 No Additional Items

Each item of this array must be:

Type: object

Time


Date and Time of the event

Type: stringFormat: date-time
Type: integer

Example:

"2024-04-04T13:41:01.718307"

Route

Type: array Default: null

Planned CAGA Route

 No Additional Items

Each item of this array must be:

Type: object

Type: object

A geographical coordinate
Example:

{
    "latitude": 51.2123,
    "longitude": 11.2313
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Turnradius

Default: null

Orthodrome turn radius as defined in RTZ format

Type: number
Type: null

Example:

200

Default: null

A Data object that includes speed, course, and heading data points

Type: object

Each additional property must conform to the following schema

Type: object

The 'data' field can include additional properties. All additional properties should be DataPoint objects.

Type: number

Type: number

Type: number

Type: string
Type: null

Example:

[
    {
        "data": {
            "heading": {
                "interpMethod": "linear",
                "mAfterLegChange": 100.0,
                "mBeforeLegChange": 100.0,
                "value": 12.3
            },
            "sog": {
                "interpMethod": "linear",
                "mAfterLegChange": 100.0,
                "mBeforeLegChange": 100.0,
                "value": 12.3
            }
        },
        "position": {
            "latitude": 57.2343,
            "longitude": 10.3432
        },
        "turnRadius": 500.0
    },
    {
        "data": {
            "heading": {
                "interpMethod": "linear",
                "mAfterLegChange": 100.0,
                "mBeforeLegChange": 100.0,
                "value": 12.3
            },
            "sog": {
                "interpMethod": "linear",
                "mAfterLegChange": 100.0,
                "mBeforeLegChange": 100.0,
                "value": 12.3
            }
        },
        "position": {
            "latitude": 57.2343,
            "longitude": 10.3432
        },
        "turnRadius": 500.0
    },
    {
        "data": {
            "heading": {
                "interpMethod": "linear",
                "mAfterLegChange": 100.0,
                "mBeforeLegChange": 100.0,
                "value": 12.3
            },
            "sog": {
                "interpMethod": "linear",
                "mAfterLegChange": 100.0,
                "mBeforeLegChange": 100.0,
                "value": 12.3
            }
        },
        "position": {
            "latitude": 57.2343,
            "longitude": 10.3432
        },
        "turnRadius": 500.0
    }
]

Calculationtime

Default: null

Time to calculate new route

Type: number
Type: null

Additional Properties of any type are allowed.

Type: object

Example:

[
    {
        "calculationTime": 1.242,
        "route": [
            {
                "data": {
                    "heading": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    },
                    "sog": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    }
                },
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "turnRadius": 500.0
            },
            {
                "data": {
                    "heading": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    },
                    "sog": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    }
                },
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "turnRadius": 500.0
            },
            {
                "data": {
                    "heading": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    },
                    "sog": {
                        "interpMethod": "linear",
                        "mAfterLegChange": 100.0,
                        "mBeforeLegChange": 100.0,
                        "value": 12.3
                    }
                },
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "turnRadius": 500.0
            }
        ],
        "time": "2024-04-04T13:41:01.720636"
    }
]
Type: null

Example:

{
    "configuration": {
        "name": "AutoNavigation-System 1",
        "vendor": "CompanyABC",
        "version": "1.2.3"
    },
    "eventData": [
        {
            "calculationTime": 1.242,
            "route": [
                {
                    "data": {
                        "heading": {
                            "interpMethod": "linear",
                            "mAfterLegChange": 100.0,
                            "mBeforeLegChange": 100.0,
                            "value": 12.3
                        },
                        "sog": {
                            "interpMethod": "linear",
                            "mAfterLegChange": 100.0,
                            "mBeforeLegChange": 100.0,
                            "value": 12.3
                        }
                    },
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "turnRadius": 500.0
                },
                {
                    "data": {
                        "heading": {
                            "interpMethod": "linear",
                            "mAfterLegChange": 100.0,
                            "mBeforeLegChange": 100.0,
                            "value": 12.3
                        },
                        "sog": {
                            "interpMethod": "linear",
                            "mAfterLegChange": 100.0,
                            "mBeforeLegChange": 100.0,
                            "value": 12.3
                        }
                    },
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "turnRadius": 500.0
                },
                {
                    "data": {
                        "heading": {
                            "interpMethod": "linear",
                            "mAfterLegChange": 100.0,
                            "mBeforeLegChange": 100.0,
                            "value": 12.3
                        },
                        "sog": {
                            "interpMethod": "linear",
                            "mAfterLegChange": 100.0,
                            "mBeforeLegChange": 100.0,
                            "value": 12.3
                        }
                    },
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "turnRadius": 500.0
                }
            ],
            "time": "2024-04-04T13:41:01.725796"
        }
    ],
    "timeSeriesData": [
        {
            "internalStatus": null,
            "targetShips": [
                {
                    "cog": 181.0,
                    "colregRulesApplied": [
                        12
                    ],
                    "dcpa": 300.0,
                    "distanceToTarget": 874.0,
                    "encounterType": "Head-on",
                    "heading": 182.0,
                    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                    "navStatus": "Under way using engine",
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "predictions": {
                        "position": [
                            {
                                "time": "2024-04-04T13:41:01.725746",
                                "value": {
                                    "latitude": 57.2343,
                                    "longitude": 10.3432
                                }
                            },
                            {
                                "time": "2024-04-04T13:41:01.725757",
                                "value": {
                                    "latitude": 57.2343,
                                    "longitude": 10.3432
                                }
                            },
                            {
                                "time": "2024-04-04T13:41:01.725766",
                                "value": {
                                    "latitude": 57.2343,
                                    "longitude": 10.3432
                                }
                            }
                        ]
                    },
                    "sog": 10.2,
                    "tcpa": 1200.0
                }
            ],
            "time": "2024-04-04T13:41:01.725728"
        }
    ]
}

Default: null

Data generated by the simulator duirng the scenario

Type: object

Type: object

Simulator software configuration
Example:

{
    "name": "AutoNavigation-System 1",
    "vendor": "CompanyABC",
    "version": "1.2.3"
}

Name

Type: string

The name of the system
Example:

"AutoNavigation-System 1"

Vendor

Type: string

The name of the system vendor
Example:

"CompanyABC"

Version

Type: string

The software version
Example:

"1.2.3"

Additional Properties of any type are allowed.

Type: object

Timeseriesdata

Type: array

TimeSeries data originating from the Simulator

 No Additional Items

Each item of this array must be:

Type: object

Time


Date and Time of the predicted value ISO 8601 format YYYY-MM-DDThh:mm:ssZ

Type: stringFormat: date-time
Type: integer

Example:

"2024-04-04T13:41:01.722626"

Type: object

Id

Type: stringFormat: uuid

Unique Identifier
Example:

"f5efb5dd-da1b-4731-93d8-e8636efb7eb1"

Type: object

A geographical coordinate
Example:

{
    "latitude": 51.2123,
    "longitude": 11.2313
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Sog

Type: number

Initial ship speed over ground in knots

Value must be greater or equal to 0.0


Example:

10.0

Cog

Type: number

Initial ship course over ground in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.0

ship heading

Default: null

Initial ship heading in degrees

Type: number

Value must be greater or equal to 0.0 and lesser or equal to 360.0

Type: null

Example:

45.2

Type: enum (of string)

AIS Navigational Status

Must be one of:

  • "Under way using engine"
  • "At anchor"
  • "Not under command"
  • "Restricted manoeuverability"
  • "Constrained by her draught"
  • "Moored"
  • "Aground"
  • "Engaged in fishing"
  • "Under way sailing"
  • "Reserved for future amendment of navigational status for HSC"
  • "Reserved for future amendment of navigational status for WIG"
  • "Reserved for future use 1"
  • "Reserved for future use 2"
  • "Reserved for future use 3"
  • "AIS SART is active"
  • "Not defined (default)"

Acceleration

Type: number Default: null

Ship acceleration in ms^-2
Example:

0.01

Rateofturn

Type: number Default: null

Ship rate of turn in deg/s
Example:

1.8

Additional Properties of any type are allowed.

Type: object

Targetships

Type: array
No Additional Items

Each item of this array must be:

Type: object

Id

Type: stringFormat: uuid

Unique Identifier
Example:

"f5efb5dd-da1b-4731-93d8-e8636efb7eb1"

Type: object

A geographical coordinate
Example:

{
    "latitude": 51.2123,
    "longitude": 11.2313
}

Latitude

Type: number Default: null

WGS-84 latitude

Value must be greater or equal to -90.0 and lesser or equal to 90.0


Example:

51.2131

Longitude

Type: number Default: null

WGS-84 longitude

Value must be greater or equal to -180.0 and lesser or equal to 180.0


Example:

11.2131

Additional Properties of any type are allowed.

Type: object

Sog

Type: number

Initial ship speed over ground in knots

Value must be greater or equal to 0.0


Example:

10.0

Cog

Type: number

Initial ship course over ground in degrees

Value must be greater or equal to 0.0 and lesser or equal to 360.0


Example:

45.0

ship heading

Default: null

Initial ship heading in degrees

Type: number

Value must be greater or equal to 0.0 and lesser or equal to 360.0

Type: null

Example:

45.2

Type: enum (of string)

AIS Navigational Status

Must be one of:

  • "Under way using engine"
  • "At anchor"
  • "Not under command"
  • "Restricted manoeuverability"
  • "Constrained by her draught"
  • "Moored"
  • "Aground"
  • "Engaged in fishing"
  • "Under way sailing"
  • "Reserved for future amendment of navigational status for HSC"
  • "Reserved for future amendment of navigational status for WIG"
  • "Reserved for future use 1"
  • "Reserved for future use 2"
  • "Reserved for future use 3"
  • "AIS SART is active"
  • "Not defined (default)"

Acceleration

Type: number Default: null

Ship acceleration in ms^-2
Example:

0.01

Rateofturn

Type: number Default: null

Ship rate of turn in deg/s
Example:

1.8

Additional Properties of any type are allowed.

Type: object

Example:

[
    {
        "ownShip": {
            "acceleration": 0.01,
            "cog": 181.0,
            "heading": 182.0,
            "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
            "navStatus": "Engaged in fishing",
            "position": {
                "latitude": 57.2343,
                "longitude": 10.3432
            },
            "rateOfTurn": 1.0,
            "sog": 10.0
        },
        "targetShips": [
            {
                "acceleration": 0.01,
                "cog": 181.0,
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Engaged in fishing",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "rateOfTurn": 1.0,
                "sog": 10.0
            },
            {
                "acceleration": 0.01,
                "cog": 181.0,
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Engaged in fishing",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "rateOfTurn": 1.0,
                "sog": 10.0
            }
        ],
        "time": "2024-04-04T13:41:01.724054"
    },
    {
        "ownShip": {
            "acceleration": 0.01,
            "cog": 181.0,
            "heading": 182.0,
            "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
            "navStatus": "Engaged in fishing",
            "position": {
                "latitude": 57.2343,
                "longitude": 10.3432
            },
            "rateOfTurn": 1.0,
            "sog": 10.0
        },
        "targetShips": [
            {
                "acceleration": 0.01,
                "cog": 181.0,
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Engaged in fishing",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "rateOfTurn": 1.0,
                "sog": 10.0
            },
            {
                "acceleration": 0.01,
                "cog": 181.0,
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Engaged in fishing",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "rateOfTurn": 1.0,
                "sog": 10.0
            }
        ],
        "time": "2024-04-04T13:41:01.724121"
    }
]

Eventdata

Type: array Default: null

Event data from the simulator

 No Additional Items

Each item of this array must be:

Type: object

Time


Date and Time of the event

Type: stringFormat: date-time
Type: integer

Example:

"2024-04-04T13:41:01.719748"

Additional Properties of any type are allowed.

Type: object
Type: null

Example:

{
    "configuration": {
        "name": "AutoNavigation-System 1",
        "vendor": "CompanyABC",
        "version": "1.2.3"
    },
    "eventData": [],
    "timeSeriesData": [
        {
            "ownShip": {
                "acceleration": 0.01,
                "cog": 181.0,
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Engaged in fishing",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "rateOfTurn": 1.0,
                "sog": 10.0
            },
            "targetShips": [
                {
                    "acceleration": 0.01,
                    "cog": 181.0,
                    "heading": 182.0,
                    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                    "navStatus": "Engaged in fishing",
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "rateOfTurn": 1.0,
                    "sog": 10.0
                },
                {
                    "acceleration": 0.01,
                    "cog": 181.0,
                    "heading": 182.0,
                    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                    "navStatus": "Engaged in fishing",
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "rateOfTurn": 1.0,
                    "sog": 10.0
                }
            ],
            "time": "2024-04-04T13:41:01.725928"
        },
        {
            "ownShip": {
                "acceleration": 0.01,
                "cog": 181.0,
                "heading": 182.0,
                "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                "navStatus": "Engaged in fishing",
                "position": {
                    "latitude": 57.2343,
                    "longitude": 10.3432
                },
                "rateOfTurn": 1.0,
                "sog": 10.0
            },
            "targetShips": [
                {
                    "acceleration": 0.01,
                    "cog": 181.0,
                    "heading": 182.0,
                    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                    "navStatus": "Engaged in fishing",
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "rateOfTurn": 1.0,
                    "sog": 10.0
                },
                {
                    "acceleration": 0.01,
                    "cog": 181.0,
                    "heading": 182.0,
                    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
                    "navStatus": "Engaged in fishing",
                    "position": {
                        "latitude": 57.2343,
                        "longitude": 10.3432
                    },
                    "rateOfTurn": 1.0,
                    "sog": 10.0
                }
            ],
            "time": "2024-04-04T13:41:01.725981"
        }
    ]
}

Additional Properties of any type are allowed.

Type: object