Create initial message schemas

Closes #7 (closed)

examples/ecosub_c2/platform_status-from_usbl_example.json

+{
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "hermes",
+    "destination": "autonomy_engine",
+    "delivery_type": "publish",
+    "encoded": false,
+    "message_type": "platform_status",
+    "platform_ID": 1,

examples/ecosub_c2/observation.json

+{
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "ecosub_c2",
+    "destination": "autonomy_engine",
+    "delivery_type": "publish",
+    "encoded": false,
+    "message_type": "observation",
+    "platform_ID": 3,

examples/gui/planning_configuration.json

+              "safe_command": "go_home",
+              "target_depth": 10.0
+            },
+            "max_velocity": 0.9,
+            "min_altitude": 15.2,
+            "min_velocity": 0.1,
+            "additional_data": {
+                "scan_type": "DVL",
+                "swath_width": 10
+            }
+          },
+          {
+            "platform_ID": 10,
+            "serial": "ecosub-5",
+            "model": "ecosub",
+            "emergency": {

formats/mission_plan.py

+            "example": 15.0,
+        },
+        "activate_payload": {
+            "type": "boolean",
+            "description": "To activate/deactivate sensor for Autosub "
+            + "Hover-1 --> `MBES` sensor and for EcoSUB --> `Sidescan`",
+            "example": True,
+        },
+        "send_environmental_data": {
+            "type": "boolean",
+            "description": "To trigger the platform to send list of"
+            + "  observations if any found",
+            "example": False,
+        },
+    },
+    "required": [

formats/mission_plan.py

+action_schema = {
+    "type": "object",
+    "properties": {
+        "action": {
+            "type": "string",
+            "description": "Autonomy Engine's action from `move`, `payload`,"
+            + " `dive`, `send_hits`, `scanline`, `scanpoint`.",
+            "example": "move",
+        },
+        "flight_style": {
+            "type": "string",
+            "description": "Platform-specific modes/flight styles to perform"
+            + " next action",
+            "example": "orbit",
+        },
+        "latitude_waypoint": {

formats/platform_status.py

+            "example": {"payload": [1.2, 434]},
+        },
+    },
+    "required": [],
+}
+
+platform_status_message_schema = {
+    "allOf": [{"$ref": "#/components/schemas/Message"}],
+    "type": "object",
+    "properties": {
+        "platform_ID": {
+            "type": "integer",
+            "description": "Identifier for platform",
+            "example": 1,
+        },
+        "status_source": {

formats/planning_configuration.py

+            "description": "Minimum altitude set for squad.",
+            "example": 15.2,
+        },
+        "min_velocity": {
+            "type": "number",
+            "format": "float",
+            "description": "Minimum velocity set for squad.",
+            "example": 0.1,
+        },
+        "max_velocity": {
+            "type": "number",
+            "format": "float",
+            "description": "Maximum altitude set for squad.",
+            "example": 0.9,
+        },
+        "additional_data": {

requirements.txt

+Flask
+flask-restx
+flasgger
+flask-marshmallow

tests/test.py

+"""
+schema, spec_url = read_from_filename("fixtures/swagger.json")
+errors_iterator = openapi_v3_spec_validator.iter_errors(schema)
+print(errors_iterator)
+print(openapi_v30_spec_validator.validate(schema))
+
+"""
+Test schema - Hydrosurv Messages
+"""
+message_types = ["acknowledgement", "mission_plan", "platform_status"]
+for item in message_types:
+    f = open("mock_data/hydrosurv_adapter/%s.json" % item)
+    mock_data = json.load(f)
+    header_data = mock_data["header"]
+    payload_data = mock_data["payload"]
+    print(validate(header_data, message_header, format_checker=FormatChecker()))

examples/autonomy_engine_adapter/mission_plan_AH1.json

+{
+  "header": {  
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "autonomy_engine",
+    "destination": "noc_c2",
+    "delivery_type": "publish",
+    "encoded": false
+  },
+  "payload":{
+    "message_type": "mission_plan",
+    "platform_ID": "5-ah1",
+    "autonomy_engine_mission_plan_ID": 1,
+    "plan": [
+      {
+        "action": "move",
+        "flight_style": "go to waypoint",
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": null,
+        "depth": 0.0,
+        "activate_payload": false,
+        "send_environmental_data": false
+      },
+      {
+        "action": "dive",
+        "flight_style": "dive to depth",
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": 10,
+        "depth": null,
+        "activate_payload": false,
+        "send_environmental_data": false
+      },
+      {
+        "action": "scanline",
+        "flight_style": "go to waypoint",
+        "latitude_waypoint": -0.237143188645706,
+        "longitude_waypoint": 60.00000000000000,
+        "altitude": 10,
+        "depth": null,
+        "activate_payload": true,
+        "send_environmental_data": false
+      },
+      {
+        "action": "climb",
+        "flight_style": "go to surface",
+        "latitude_waypoint": -0.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": null,
+        "depth": 0,
+        "activate_payload": false,
+        "send_environmental_data": true
+      }
+    ]
+  }
+}
\ No newline at end of file

examples/autonomy_engine_adapter/mission_plan_ECOSUB.json

+{
+  "header": {  
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "autonomy_engine",
+    "destination": "ecosub_c2",
+    "delivery_type": "publish",
+    "encoded": false
+  },
+  "payload":{
+    "message_type": "mission_plan",
+    "platform_ID": "ecosub-5",
+    "autonomy_engine_mission_plan_ID": 1,
+    "plan": [
+      {
+        "action": "move",
+        "flight_style": "go to waypoint",
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": null,
+        "depth": 0.0,
+        "activate_payload": false,
+        "send_environmental_data": false
+      },
+      {
+        "action": "dive",
+        "flight_style": "dive to depth",
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": 10,
+        "depth": null,
+        "activate_payload": false,
+        "send_environmental_data": false
+      },
+      {
+        "action": "scanline",
+        "flight_style": "go to waypoint",
+        "latitude_waypoint": -0.237143188645706,
+        "longitude_waypoint": 60.00000000000000,
+        "altitude": 10,
+        "depth": null,
+        "activate_payload": true,
+        "send_environmental_data": false
+      },
+      {
+        "action": "climb",
+        "flight_style": "go to surface",
+        "latitude_waypoint": -0.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": null,
+        "depth": 0,
+        "activate_payload": false,
+        "send_environmental_data": true
+      }
+    ]
+  }
+}
\ No newline at end of file

examples/autonomy_engine_adapter/mission_plan_HYDROSURV.json

+{
+  "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+  "timestamp": "2022-11-16T00:00:00Z",
+  "version": 2,
+  "source": "autonomy_engine",
+  "destination": "hydrosurv_adapter",
+  "delivery_type": "publish",
+  "encoded": false,
+  "message_type": "mission_plan",
+  "platform_ID": "reav-60-1",
+  "autonomy_engine_plan_ID": 1,
+  "plan": [
+      {
+        "latitude_waypoint": -4.187143188645706,
+        "longitude_waypoint": 50.37072283932642
+      },
+      {
+        "latitude_waypoint": -3.187143188645706,
+        "longitude_waypoint": 51.37072283932642
+      },
+      {
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642
+      }
+    ]
+}
\ No newline at end of file

examples/autonomy_engine_adapter/planning_configuration.json

+{
+  "header":{
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "ecosub_c2",
+    "destination": "autonomy_engine",
+    "delivery_type": "publish",
+    "encoded": false
+  },
+  "payload":{
+    "message_type": "platform_status",
+    "planning_config_ID": 3,
+    "exclusion_zones": [
+      {
+        "geometry_coordinates": [
+          [
+            [
+              -4.187143188645706,
+              50.37072283932642
+            ],
+            [
+              -4.202697005964865,
+              50.368816892405874
+            ],
+            [
+              -4.203156724702808,
+              50.365640144076906
+            ],
+            [
+              -4.19449868846155,
+              50.362267670845654
+            ]
+          ]
+        ]
+      }
+    ],
+    "squads": [
+      {
+        "squad_ID": 1,
+        "no_of_platforms": 1,
+        "squad_mission_type": "tracking",
+        "squad_state": false,
+        "platforms": [
+          {
+            "model": "reav",
+            "platform_ID": "reav-60-1",
+            "serial": "reav-60",
+            "emergency": {
+              "additional_data": {},
+              "latitude_waypoint": -7.432,
+              "longitude_waypoint": 50.365,
+              "safe_command": "go_home",
+              "target_depth": 10
+            },
+            "max_velocity": 0.9,
+            "min_altitude": 15.2,
+            "min_velocity": 0.1,
+            "additional_data": {}
+          }
+        ],
+        "region_of_interest": {
+          "geometry_coordinates": [
+            [
+              [
+                -4.187143188645706,
+                50.37072283932642
+              ],
+              [
+                -4.202697005964865,
+                50.368816892405874
+              ],
+              [
+                -4.203156724702808,
+                50.365640144076906
+              ],
+              [
+                -4.19449868846155,
+                50.362267670845654
+              ]
+            ]
+          ]
+        }
+      },
+      {
+        "squad_ID": 2,
+        "no_of_platforms": 3,
+        "squad_mission_type": "survey",
+        "squad_state": true,
+        "platforms": [
+          {
+            "platform_ID": "ecosub-1",
+            "serial": "ecosub-2",
+            "model": "ecosub",
+            "emergency": {
+              "additional_data": {},
+              "latitude_waypoint": -7.432,
+              "longitude_waypoint": 50.365,
+              "safe_command": "go_home",
+              "target_depth": 10.0
+            },
+            "max_velocity": 0.9,
+            "min_altitude": 15.2,
+            "min_velocity": 0.1,
+            "additional_data": {
+                "scan_type": "DVL",
+                "swath_width": 10
+            }
+          },
+          {
+            "platform_ID": "ecosub-2",
+            "serial": "ecosubxyz-5",
+            "model": "ecosub",
+            "emergency": {
+              "additional_data": {},
+              "latitude_waypoint": -0.432,
+              "longitude_waypoint": 20.365,
+              "safe_command": "go_home",
+              "target_depth": 0.0
+            },
+            "max_velocity": 0.9,
+            "min_altitude": 15.2,
+            "min_velocity": 0.1,
+            "additional_data": {
+                "scan_type": "DVL",
+                "swath_width": 10
+            }
+          }
+        ],
+        "region_of_interest": {}
+      },
+      {
+        "squad_ID": 3,
+        "no_of_platforms": 1,
+        "squad_mission_type": "inspection",
+        "squad_state": false,
+        "platforms": [
+          {
+            "platform_ID": "ah-1",
+            "serial": "autosubhover-1",
+            "model": "autosub",
+            "emergency": {
+              "additional_data": {},
+              "latitude_waypoint": 20.432,
+              "longitude_waypoint": 50.365,
+              "safe_command": "safety_abort",
+              "target_depth": 0.0
+            },
+            "max_velocity": 0.9,
+            "min_altitude": 15.2,
+            "min_velocity": 0.1,
+            "additional_data": {
+                "scan_type": "MBES"
+            }
+          }
+        ],
+        "region_of_interest": {}
+      }
+    ]
+  }
+}
\ No newline at end of file

examples/ecosub_adapter/mission_plan.json

+{
+  "header": {  
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "autonomy_engine",
+    "destination": "ecosub_c2",
+    "delivery_type": "publish",
+    "encoded": false
+  },
+  "payload":{
+    "message_type": "mission_plan",
+    "platform_ID": "ecosub-2",
+    "autonomy_engine_mission_plan_ID": 1,
+    "plan": [
+      {
+        "action": "move",
+        "flight_style": "go to waypoint",
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": null,
+        "depth": 0.0,
+        "activate_payload": false,
+        "send_environmental_data": false
+      },
+      {
+        "action": "dive",
+        "flight_style": "dive to depth",
+        "latitude_waypoint": -3.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": 10,
+        "depth": null,
+        "activate_payload": false,
+        "send_environmental_data": false
+      },
+      {
+        "action": "scanline",
+        "flight_style": "go to waypoint",
+        "latitude_waypoint": -0.237143188645706,
+        "longitude_waypoint": 60.00000000000000,
+        "altitude": 10,
+        "depth": null,
+        "activate_payload": true,
+        "send_environmental_data": false
+      },
+      {
+        "action": "climb",
+        "flight_style": "go to surface",
+        "latitude_waypoint": -0.237143188645706,
+        "longitude_waypoint": 52.37072283932642,
+        "altitude": null,
+        "depth": 0,
+        "activate_payload": false,
+        "send_environmental_data": true
+      }
+    ]
+  }
+}
\ No newline at end of file

examples/ecosub_adapter/observation.json

+{
+    "header":{
+        "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+        "timestamp": "2022-11-16T00:00:00Z",
+        "version": 2,
+        "source": "ecosub_c2",
+        "destination": "autonomy_engine",
+        "delivery_type": "publish",
+        "encoded": false
+    },
+    "payload":{
+        "message_type": "observation",
+        "platform_ID": "ecosub-2",
+        "points_of_interest": [
+            {
+                "latitude": 178.2,
+                "longitude": -10.122,
+                "quality_of_point": 0.98
+            },
+            {
+                "latitude": 50.1382,
+                "longitude": -11.122,
+                "quality_of_point": 0.50
+            }
+        ],
+        "region_surveyed": ""
+    }
+}
\ No newline at end of file

examples/ecosub_adapter/platform_status-from_usbl_example.json

+{
+    "header":{
+        "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+        "timestamp": "2022-11-16T00:00:00Z",
+        "version": 2,
+        "source": "hermes",
+        "destination": "autonomy_engine",
+        "delivery_type": "publish",
+        "encoded": false
+    },
+    "payload":{
+        "message_type": "platform_status",
+        "platform_ID": "ecosub-5",
+        "platform_timestamp": "2022-12-21T00:00:00Z",
+        "status_source": "usbl",
+        "latitude": 178.2,
+        "longitude": -10.122,
+        "depth": 50,
+        "altitude": 20
+    }
+}

examples/ecosub_adapter/platform_status.json

+{
+    "header":{
+        "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+        "timestamp": "2022-11-16T00:00:00Z",
+        "version": 2,
+        "source": "ecosub_c2",
+        "destination": "autonomy_engine",
+        "delivery_type": "publish",
+        "encoded": false
+    },
+    "payload":{
+        "message_type": "platform_status",
+        "platform_ID": "ecosub-2",
+        "platform_timestamp": "2022-12-21T00:00:00Z",
+        "status_source": "onboard_platform",
+        "autonomy_engine_plan_ID": 1,
+        "battery_remaining_capacity": 80.2,
+        "active": true,
+        "platform_state": "ABORT",
+        "mission_action_ID": 1,
+        "mission_track_ID": 4,
+        "latitude": 178.2,
+        "longitude": -10.122,
+        "depth": 50,
+        "altitude": 20,
+        "heading": 90.0,
+        "health_status": "Warning",
+        "localisation_error": null,
+        "usbl_fix_seconds_ago": null,
+        "range_to_go": 124.3,
+        "sensor_config": {
+            "sensor_ID": 22,
+            "serial": "sidescan-2x",    
+            "sensor_on": true,
+            "additional_data": {
+                "whiskers_on": true
+            }      
+        },
+        "current_pitch": -4,
+        "speed_over_ground": 4.3,
+        "thrust_applied": 124.3,
+        "water_current_velocity": 124.3
+    }
+}

examples/ecosub_c2/mission_plan.json

-{
-  "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-  "timestamp": "2022-11-16T00:00:00Z",
-  "version": 2,
-  "source": "autonomy_engine",
-  "destination": "ecosub_c2",
-  "delivery_type": "publish",
-  "encoded": false,
-  "message_type": "mission_plan",
-  "platform_serial": "reav-60",
-  "autonomy_engine_mission_plan_ID": 1,
-  "plan": [
-    {
-      "action": "move",
-      "flight_style": "go to waypoint",
-      "latitude_waypoint": -3.237143188645706,
-      "longitude_waypoint": 52.37072283932642,
-      "altitude": null,
-      "depth": 0.0,
-      "activate_payload": false,
-      "send_environmental_data": false
-    },
-    {
-      "action": "dive",
-      "flight_style": "dive to depth",
-      "latitude_waypoint": -3.237143188645706,
-      "longitude_waypoint": 52.37072283932642,
-      "altitude": 10,
-      "depth": null,
-      "activate_payload": false,
-      "send_environmental_data": false
-    },
-    {
-      "action": "scanline",
-      "flight_style": "go to waypoint",
-      "latitude_waypoint": -0.237143188645706,
-      "longitude_waypoint": 60.00000000000000,
-      "altitude": 10,
-      "depth": null,
-      "activate_payload": true,
-      "send_environmental_data": false
-    },
-    {
-      "action": "climb",
-      "flight_style": "go to surface",
-      "latitude_waypoint": -0.237143188645706,
-      "longitude_waypoint": 52.37072283932642,
-      "altitude": null,
-      "depth": 0,
-      "activate_payload": false,
-      "send_environmental_data": true
-    }
-  ]
-}
\ No newline at end of file

examples/ecosub_c2/observation.json

-{
-    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-    "timestamp": "2022-11-16T00:00:00Z",
-    "version": 2,
-    "source": "ecosub_c2",
-    "destination": "autonomy_engine",
-    "delivery_type": "publish",
-    "encoded": false,
-    "message_type": "observation",
-    "platform_ID": 3,
-    "points_of_interest": [
-        {
-            "latitude": 178.2,
-            "longitude": -10.122,
-            "quality_of_point": 0.98
-        },
-        {
-            "latitude": 50.1382,
-            "longitude": -11.122,
-            "quality_of_point": 0.50
-        }
-    ],
-    "region_surveyed": ""
-}
\ No newline at end of file

examples/ecosub_c2/platform_status-from_usbl_example.json

-{
-    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-    "timestamp": "2022-11-16T00:00:00Z",
-    "version": 2,
-    "source": "hermes",
-    "destination": "autonomy_engine",
-    "delivery_type": "publish",
-    "encoded": false,
-    "message_type": "platform_status",
-    "platform_ID": 1,
-    "platform_timestamp": "2022-12-21T00:00:00Z",
-    "status_source": "usbl",
-    "latitude": 178.2,
-    "longitude": -10.122,
-    "depth": 50,
-    "altitude": 20
-}

examples/ecosub_c2/platform_status.json

-{
-    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-    "timestamp": "2022-11-16T00:00:00Z",
-    "version": 2,
-    "source": "ecosub_c2",
-    "destination": "autonomy_engine",
-    "delivery_type": "publish",
-    "encoded": false,
-    "message_type": "platform_status",
-    "platform_ID": 1,
-    "platform_timestamp": "2022-12-21T00:00:00Z",
-    "status_source": "onboard_platform",
-    "autonomy_engine_plan_ID": 1,
-    "battery_remaining_capacity": 80.2,
-    "active": true,
-    "platform_state": "ABORT",
-    "mission_action_ID": 1,
-    "mission_track_ID": 4,
-    "latitude": 178.2,
-    "longitude": -10.122,
-    "depth": 50,
-    "altitude": 20,
-    "heading": 90.0,
-    "health_status": "Warning",
-    "localisation_error": null,
-    "usbl_fix_seconds_ago": null,
-    "range_to_go": 124.3,
-    "sensor_config": {
-        "sensor_ID": 22,
-        "serial": "sidescan-2x",    
-        "sensor_on": true,
-        "additional_data": {
-            "whiskers_on": true
-        }      
-    },
-    "current_pitch": -4,
-    "speed_over_ground": 4.3,
-    "thrust_applied": 124.3,
-    "water_current_velocity": 124.3
-}

examples/gui_adapter/planning_configuration.json

 {
+  "header":{
     "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
     "timestamp": "2022-11-16T00:00:00Z",
     "version": 2,
     "source": "ecosub_c2",
     "destination": "autonomy_engine",
     "delivery_type": "publish",
-    "encoded": false,
+    "encoded": false
+  },
+  "payload":{
     "message_type": "platform_status",
     "planning_config_ID": 3,
     "exclusion_zones": [
         "platforms": [
           {
             "model": "reav",
-            "platform_ID": 23,
+            "platform_ID": "reav-60-1",
             "serial": "reav-60",
             "emergency": {
               "additional_data": {},
         "squad_state": true,
         "platforms": [
           {
-            "platform_ID": 23,
+            "platform_ID": "ecosub-2",
             "serial": "ecosub-2",
             "model": "ecosub",
             "emergency": {
             }
           },
           {
-            "platform_ID": 10,
+            "platform_ID": "ecosub-5",
             "serial": "ecosub-5",
             "model": "ecosub",
             "emergency": {
         "squad_state": false,
         "platforms": [
           {
-            "platform_ID": 23,
+            "platform_ID": "139-ah-1",
             "serial": "ah-1",
             "model": "autosub",
             "emergency": {
         "region_of_interest": {}
       }
     ]
-  }
\ No newline at end of file
+  }
+}
\ No newline at end of file

examples/hydrosurv_adapter/acknowledgement.json

 {
-    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-    "timestamp": "2022-11-16T00:00:00Z",
-    "version": 1,
-    "source": "hydrosurv_adapter",
-    "destination": "autonomy_engine",
-    "delivery_type": "publish",
-    "encoded": false,
-    "message_type": "acknowledgement",
-    "acknowledged_message_ID": "11111111-7bc8-11ed-a1eb-0242ac999999",
-    "status": "Approved and sent to platform"
+    "header":{
+        "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+        "timestamp": "2022-11-16T00:00:00Z",
+        "version": 1,
+        "source": "hydrosurv_adapter",
+        "destination": "autonomy_engine",
+        "delivery_type": "publish",
+        "encoded": false
+    },
+    "payload":{
+        "message_type": "acknowledgement",
+        "acknowledged_message_ID": "11111111-7bc8-11ed-a1eb-0242ac999999",
+        "status": "c2_received"
+    }
 }
\ No newline at end of file

examples/hydrosurv_adapter/mission_plan.json

 {
-  "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-  "timestamp": "2022-11-16T00:00:00Z",
-  "version": 2,
-  "source": "autonomy_engine",
-  "destination": "hydrosurv_adapter",
-  "delivery_type": "publish",
-  "encoded": false,
-  "message_type": "mission_plan",
-  "platform_serial": "reav-60",
-  "autonomy_engine_plan_ID": 1,
-  "plan": [
+  "header":{
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "autonomy_engine",
+    "destination": "hydrosurv_adapter",
+    "delivery_type": "publish",
+    "encoded": false
+  },
+  "payload":{
+    "message_type": "mission_plan",
+    "platform_ID": "reav-60-1",
+    "autonomy_engine_plan_ID": 1,
+    "plan": [
       {
         "latitude_waypoint": -4.187143188645706,
         "longitude_waypoint": 50.37072283932642
         "longitude_waypoint": 52.37072283932642
       }
     ]
+  }
 }
\ No newline at end of file

examples/hydrosurv_adapter/platform_status.json

 {
-  "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-  "timestamp": "2022-11-16T00:00:00Z",
-  "version": 2,
-  "source": "hydrosurv_adapter",
-  "destination": "autonomy_engine",
-  "delivery_type": "publish",
-  "encoded": false,
-  "message_type": "platform_status",
-  "autonomy_engine_plan_ID": 1,
-  "active": true,
-  "status_source": "onboard_platform",
-  "battery_remaining_capacity": 80.2,
-  "heading": 310.0,
-  "health_status": "Lost Connection",
-  "latitude": 178.2,
-  "longitude": -10.122,
-  "mission_action_ID": 1,
-  "mission_track_ID": 4,
-  "platform_ID": 1,
-  "platform_state": "ABORT",
-  "platform_timestamp": "2022-12-21T00:00:00Z",
-  "speed_over_ground": 4.5,
-  "range_to_go": null,
-  "thrust_applied": null
+  "header":{
+    "message_ID": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+    "timestamp": "2022-11-16T00:00:00Z",
+    "version": 2,
+    "source": "hydrosurv_adapter",
+    "destination": "autonomy_engine",
+    "delivery_type": "publish",
+    "encoded": false
+  },
+  "payload":{
+    "message_type": "platform_status",
+    "autonomy_engine_plan_ID": 1,
+    "active": true,
+    "status_source": "onboard_platform",
+    "battery_remaining_capacity": 80.2,
+    "heading": 310.0,
+    "health_status": "Lost Connection",
+    "latitude": 178.2,
+    "longitude": -10.122,
+    "mission_action_ID": 1,
+    "mission_track_ID": 4,
+    "platform_ID": "reav-60-1",
+    "platform_state": "ABORT",
+    "platform_timestamp": "2022-12-21T00:00:00Z",
+    "speed_over_ground": 4.5,
+    "range_to_go": null,
+    "thrust_applied": null
+  }
 }
\ No newline at end of file

formats/__init__.py

-# from flask_restx import fields
-# from . import api
 import os
 
 
     if x.endswith(".py") and x != "__init__.py"
 ]
 
-# TODO: Define units for all schemas
-
-# message_types = [
-#     "platform_status",
-#     "mission_plan_ecosub",
-#     "mission_plan_reav",
-#     "mission_plan_autosub",
-# ]  # TODO: Add full range of message types once scoped out
-
-# full_message_schema = api.model(
-#     "FullMessageSchema",
-#     {
-#         "message_ID": fields.String(
-#             required=True,
-#             description="UUID assigned to this message",
-#             example="b427003c-7bc8-11ed-a1eb-0242ac120002",
-#         ),
-#         "timestamp": fields.DateTime(
-#             required=True,
-#             description="Timestamp of message",
-#             example="2022-11-16T00:00:00Z",
-#         ),
-#         "version": fields.Float(
-#             required=True,
-#             description="Version of comms bacbone messaging format protocol",
-#             example=2.0,
-#         ),
-#         "source": fields.String(
-#             required=True,
-#             description="Where is this message from",
-#             example="autonomy_engine",
-#         ),
-#         "destination": fields.String(
-#             required=True,
-#             description="What is the destination of this message",
-#             example="ah-1",
-#         ),
-#         "encoded": fields.Boolean(
-#             required=True,
-#             description="Indicate that message raw (encoded) or decoded. "
-#             + "Options: encoded=True, decoded=False",
-#             example=False,
-#         ),
-#         "type": fields.String(
-#             required=True,
-#             description="Type of message",
-#             example="platform_status",
-#         ),
-#         "payload": fields.Raw(
-#             required=True,
-#             description="Content of Message",
-#             # example="{}",
-#         ),
-#     },
-# )
-
-# constraints_schema = api.model(
-#     "ConstraintsSchema",
-#     {
-#         "min_altitude": fields.Float(
-#             required=True,
-#             description="Minimum altitude set for squad.",
-#             example=15.2,
-#         ),
-#         "min_velocity": fields.Float(
-#             required=True,
-#             description="Minimum velocity set for squad.",
-#             example=0.1,
-#         ),
-#         "max_velocity": fields.Float(
-#             required=True,
-#             description="Maximum altitude set for squad.",
-#             example=0.9,
-#         ),
-#     },
-# )
-
-# platform_schema = api.model(
-#     "PlatformSchema",
-#     {
-#         "platform_ID": fields.Integer(
-#             required=True,
-#             description="unique identifier for platform",
-#             example=1,
-#         ),
-#         "serial": fields.String(
-#             required=True,
-#             description="platform serial number",
-#             example="reav-60",
-#         ),
-#         "model": fields.String(
-#             required=True,
-#             description="platform serial number",
-#             example="reav",
-#         ),
-#         "constraints": fields.Nested(constraints_schema),
-#     },
-# )
+message_header = {
+    "type": "object",
+    "discriminator": {
+        "propertyName": "message_type",
+    },
+    "properties": {
+        "message_ID": {
+            "type": "string",
+            "description": "An identifier for the type of message received.",
+            "example": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
+        },
+        "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Timestamp of message",
+            "example": "2022-11-16T00:00:00Z",
+        },
+        "version": {
+            "type": "number",
+            "format": "float",
+            "description": "Version of comms backbone message format protocol",
+            "example": 2.0,
+        },
+        "source": {
+            "type": "string",
+            "description": "The sender; Where is this message from",
+            "example": "autonomy_engine",
+        },
+        "destination": {
+            "type": "string",
+            "description": "Publisher topic; What is the destination"
+            + " of this message",
+            "example": "ah1",
+        },
+        "encoded": {
+            "type": "boolean",
+            "description": "Indicate that message raw (encoded) or decoded. "
+            + "Options: encoded=True, decoded=False",
+            "example": False,
+        },
+        "delivery_type": {
+            "type": "string",
+            "description": "To publish or broadcast this message.",
+            "enum": ["broadcast", "publish"],
+            "example": "publish",
+            "default": "publish",
+        },
+    },
+}
\ No newline at end of file

formats/acknowledgement.py

     receipt of message.
 """
 acknowledgement_schema = {
-    "allOf": [{"$ref": "#/components/schemas/Message"}],
     "type": "object",
     "properties": {
+        "message_type": {
+            "type": "string",
+            "description": "Type of message",
+            "example": "acknowledgement",
+        },
         "acknowledged_message_ID": {
             "type": "string",
             "description": "Identifier of message received and executed with "
         },
         "status": {
             "type": "string",
+            "enum": ["c2_received", "operator_approved_and_sent", "executed"],
             "description": "Highest level of acknowledgement. I.e."
-            + " `c2_received`: Received by C2, `c2_sent`: Sent from"
-            + "  C2->Platform, `executed`: Executed by platform",
+            + " `c2_received`: Received by C2, `operator_approved_and_sent`"
+            + " : Approved by operator and sent from C2->Platform,"
+            + " `executed`: Executed by platform",
             "example": "executed by platform",
         },
     },
-    "required": ["acknowledged_message_ID", "status"],
+    "required": ["message_type", "acknowledged_message_ID", "status"],
 }
-
-# acknowledgement_schema = api.model(
-#     "Acknowledgement",
-#     {
-#         "message": fields.Nested(
-#             full_message_schema,
-#             required=True,
-#             description="Message header",
-#         ),
-#         "message_ID": fields.Integer(
-#             required=True,
-#             description="Identifier of message received and executed with "
-#             + "success for mission plans sent by the Autonomy Engine.",
-#             example=202,
-#         ),
-#         "status": fields.String(
-#             required=True,
-#             description="Highest level of acknowledgement. "
-#             + " I.e. `c2_received`: Received by C2, `c2_sent`:"
-#             + "  Sent from C2->Platform, `executed`: Executed by platform",
-#         ),
-#     },
-# )

formats/message_wrapper.py

-"""
-    schemas: Message Wrapper is used to wrap all message types that contain
-    details of where the message is coming from, which end client is its
-    destination and the type of message.
-"""
-
-message_wrapper_schema = {
-    "type": "object",
-    "discriminator": {
-        "propertyName": "message_type",
-    },
-    "properties": {
-        "message_ID": {
-            "type": "string",
-            "description": "An identifier for the type of message received.",
-            "example": "b427003c-0000-11aa-a1eb-bvcdfghjgfdd",
-        },
-        "timestamp": {
-            "type": "date-time",
-            "description": "Timestamp of message",
-            "example": "2022-11-16T00:00:00Z",
-        },
-        "message_type": {
-            "type": "Type of message",
-            "description": "Type of message",
-            "example": "platform_status",
-        },
-        "version": {
-            "type": "string",
-            "description": "Version of comms bacbone message format protocol",
-            "example": 2.0,
-        },
-        "source": {
-            "type": "string",
-            "description": "The sender; Where is this message from",
-            "example": "autonomy_engine",
-        },
-        "destination": {
-            "type": "string",
-            "description": "Publisher topic; What is the destination"
-            + " of this message",
-            "example": "ah1",
-        },
-        "encoded": {
-            "type": "boolean",
-            "description": "Indicate that message raw (encoded) or decoded. "
-            + "Options: encoded=True, decoded=False",
-            "example": False,
-        },
-        "delivery_type": {
-            "type": "string",
-            "description": "To publish or broadcast this message.",
-            "enum": ["broadcast", "publish"],
-            "example": "publish",
-            "default": "publish",
-        },
-    },
-    "required": ["message_type"],
-}

formats/mission_plan.py

 """
-    schemas: Mission plan (un-compiled) geenrated by the  Autonomy Engine
+    schemas: Mission plan (un-compiled) generated by the Autonomy Engine
     sent to the respective platform's C2 to compile into a platform-specific
     mission plan.
 """
-# from . import api, full_message_schema
-# from flask_restx import fields
 
 action_schema = {
     "type": "object",
         },
         "latitude_waypoint": {
             "type": "number",
+            "format": "float",
             "description": "Next waypoint, x-coordinate",
             "example": -4.187143188645706,
         },
         "longitude_waypoint": {
             "type": "number",
+            "format": "float",
             "description": "Next waypoint, y-coordinate",
             "example": 50.37072283932642,
         },
         "altitude": {
             "type": "number",
+            "format": "float",
             "description": "Altitude of next action",
             "example": 15.0,
         },
         "depth": {
             "type": "number",
+            "format": "float",
             "description": "Depth of next action",
             "example": 15.0,
         },
 }
 
 mission_plan_schema = {
-    "allOf": [{"$ref": "#/components/schemas/Message"}],
     "type": "object",
     "properties": {
-        "autonomy_engine_plan_ID": {"type": "integer"},
-        "platform_serial": {"type": "string"},
+        "message_type": {
+            "type": "string",
+            "description": "Type of message",
+            "example": "mission_plan",
+        },
+        "autonomy_engine_plan_ID": {
+            "type": "integer",
+            "description": "Unique identifier for this plan"
+            + "generated by the Autonomy Engine",
+            "example": 3,
+        },
+        "platform_ID": {
+            "type": "string",
+            "description": "Unique identifier for this platform",
+            "example": "reav-x-1",
+        },
         "plan": {
             "type": "array",
             "items": action_schema,
         },
     },
-    "required": ["plan_ID", "platform_serial", "plan"],
+    "required": ["message_type", "autonomy_engine_plan_ID", "platform_ID", "plan"],
 }
-
-# action_schema = api.model(
-#     "AutonomyEngineAction",
-#     {
-#         "action": fields.String(
-#             required=True,
-#             description="Autonomy Engine's action from `move`, `payload`,"
-#             + " `dive`, `send_hits`, `scanline`, `scanpoint`.",
-#             example="move",
-#         ),
-#         "flight_style": fields.String(
-#             required=False,
-#             description="Platform-specific modes/flight styles to perform"
-#             + " next action",
-#             example="orbit",
-#         ),
-#         "latitude_waypoint": fields.Float(
-#             required=True,
-#             description="Next waypoint, x-coordinate",
-#             example=-4.187143188645706,
-#         ),
-#         "longitude_waypoint": fields.Float(
-#             required=True,
-#             description="Next waypoint, y-coordinate",
-#             example=50.37072283932642,
-#         ),
-#         "altitude": fields.Float(
-#             required=False,
-#             description="Altitude of next action",
-#             example=15.0,
-#         ),
-#         "depth": fields.Float(
-#             required=False,
-#             description="Depth of next action",
-#             example=15.0,
-#         ),
-#         "activate_payload": fields.Boolean(
-#             required=False,
-#             description="To activate/deactivate sensor for Autosub "
-#             + "Hover-1 --> `MBES` sensor and for EcoSUB --> `Sidescan`",
-#             example=True,
-#         ),
-#         "send_environmental_data": fields.Boolean(
-#             required=False,
-#             description="To trigger the platform to send list of"
-#             + " observations if any found",
-#             example=False,
-#         ),
-#     },
-# )
-
-# mission_plan_schema = api.model(
-#     "MissionPlan",
-#     {
-#         "message": fields.Nested(
-#             full_message_schema,
-#             required=True,
-#             description="Message header",
-#         ),
-#         "plan_ID": fields.Integer(
-#             required=True,
-#             description="Identifier of given mission sequence planned",
-#             example=1,
-#         ),
-#         "platform_serial": fields.String(
-#             required=True,
-#             description="Serial of target platform to send mission to",
-#             example="reav-60",
-#         ),
-#         "plan": fields.List(
-#             fields.Nested(action_schema),
-#             required=True,
-#             description="Sequence of actions/instructions generated by the"
-#             + " Autonomy Engine that should be compiled by the",
-#             + " respective C2.",
-#         ),
-#     },
-# )

formats/observation.py

     schema: Observation Message sent by platforms when points of
     interest are found.
 """
-# from . import full_message_schema, api
-# from flask_restx import fields
 
 hits_schema = {
     "type": "object",
     "properties": {
         "latitude": {
             "type": "number",
+            "format": "float",
             "description": "Identified x-coordinate of point of interest",
             "example": 178.2,
         },
         "longitude": {
             "type": "number",
+            "format": "float",
             "description": "Identified y-coordinate of point of interest",
             "example": -10.122,
         },
         "quality_of_point": {
             "type": "number",
+            "format": "float",
             "description": "Quality/strength of points from features of"
-            + " interest identified by platform. TODO: DEFINE FORMAT.",
+            + " interest identified by platform.",  # TODO: DEFINE FORMAT.
             "example": 0.98,
         },
     },
-    "required": [],
+    "required": ["latitude", "longitude"],
 }
 
 observation_schema = {
-    "allOf": [{"$ref": "#/components/schemas/Message"}],
     "type": "object",
     "properties": {
+        "message_type": {
+            "type": "string",
+            "description": "Type of message",
+            "example": "observation",
+        },
         "platform_ID": {
-            "type": "integer",
-            "description": "ID of platform to sending observations",
-            "example": "ecosub-3",
+            "type": "string",
+            "description": "Unique identifier for this platform",
+            "example": "reav-x-1",
         },
-        # "observation_type" ==> payloads tied to different types maybe?
-        # properties of each observation?
         "points_of_interest": {
             "type": "array",
             "items": hits_schema,
             "description": "Points from features of interest identified by"
-            + " platform if any found. DEFINE FORMAT.",
+            + " platform if any found.",  # TODO: DEFINE FORMAT.
         },
         "region_surveyed": {
-            "description": "Region surveyed by given platform. DEFINE FORMAT."
-            + " GEOJSON",
+            # "type": "null",
+            "nullable": True,
+            "description": "Region surveyed by given platform."
+            + " GEOJSON",  # TODO: DEFINE FORMAT.
             "example": "",
         },
         "additional_data": {
             "example": {"sensor_payload": False},
         },
     },
-    "required": ["platform_serial"],
+    "required": ["message_type", "platform_ID"],
 }
-
-# observation_schema = api.model(
-#     "Observation",
-#     {
-#         "message": fields.Nested(
-#             full_message_schema,
-#             required=True,
-#             description="Message header",
-#         ),
-#         "platform_serial": fields.String(
-#             required=True,
-#             description="Serial of platform to sendign observations",
-#             example="ecosub-3",
-#         ),
-#         # "observation_type" ==> payloads tied to different types maybe?
-#         # properties of each observation?
-#         "points_of_interest": fields.Float(
-#             required=False,
-#             description="Points from features of interest identified by"
-#             + " platform if any found. DEFINE FORMAT.",
-#             example="",
-#         ),
-#         "region_surveyed": fields.Float(
-#             required=False,
-#             description="Region surveyed by given platform. DEFINE FORMAT."
-#             + " GEOJSON?",
-#             example="",
-#         ),
-#         "quality_of_points": fields.Float(
-#             required=False,
-#             description="Quality/strength of points from features of"
-#             + " interest identified by platform. DEFINE FORMAT.",
-#             example=0.98,
-#         ),
-#         "additional_data": fields.Raw(
-#             required=False,
-#             description="Placeholder field for any additional data",
-#             example={"sensor_payload": False},
-#         ),
-#     },
-# )

formats/planning_configuration.py

     schemas: configuration sent to Autonomy Engine (i.e. during an emergency,
     if a platform needs to be removed from the mission planning)
 """
-# from . import api, full_message_schema, platform_schema
-# from flask_restx import fields
 
 emergency_schema = {
     "type": "object",
         },
         "latitude_waypoint": {
             "type": "number",
+            "format": "float",
             "description": "X-coordinate safe place for respective platform",
             "example": -7.432,
         },
         "longitude_waypoint": {
             "type": "number",
+            "format": "float",
             "description": "Y-coordinate safe place for respective platform",
             "example": 50.365,
         },
         "target_depth": {
             "type": "number",
+            "format": "float",
             "description": "Z-coordinate safe place for respective platform"
             + " . If platform to NOT stay at depth, key in `0.0`",
             "example": 10,
         },
         "additional_data": {
-            "type": "null",
             "description": "Any addition fields/data to be added here",
             "example": {},
         },
     "type": "object",
     "properties": {
         "platform_ID": {
-            "type": "integer",
-            "description": "Identifier for platform",
-            "example": 23,
+            "type": "string",
+            "description": "Unique identifier for this platform",
+            "example": "reav-x-1",
         },
         "serial": {
             "type": "string",
         "emergency": emergency_schema,
         "min_altitude": {
             "type": "number",
+            "format": "float",
             "description": "Minimum altitude set for squad.",
             "example": 15.2,
         },
         "min_velocity": {
             "type": "number",
+            "format": "float",
             "description": "Minimum velocity set for squad.",
             "example": 0.1,
         },
         "max_velocity": {
             "type": "number",
+            "format": "float",
             "description": "Maximum altitude set for squad.",
             "example": 0.9,
         },
-        "additional_data": {
-            "type": "null",
+        "additional_specs": {
             "description": "Any addition fields/data to be added here",
             "example": {"swath_width": 10.0, "scan_type": "DVL"},
         },
         "platforms",
         "squad_mission_type",
         "squad_state",
-        "exclusion_zones",
     ],
 }
 
 planning_configuration_schema = {
-    "allOf": [{"$ref": "#/components/schemas/Message"}],
     "type": "object",
     "properties": {
+        "message_type": {
+            "type": "string",
+            "description": "Type of message",
+            "example": "planning_configuration",
+        },
         "planning_config_ID": {
             "type": "integer",
             "description": "Unique identifier tagged to version of this"
         },
     },
     "required": [
-        "config_ID",
+        "message_type",
+        "planning_config_ID",
         "squads",
         "exclusion_zones",
     ],
 }
-
-# region_schema = api.model(
-#     "RegionSchema",
-#     {
-#         "region": fields.Raw(
-#             required=True,
-#             description="Using GEOJSON, exact region of "
-#             + "interest in rectangle format polygon",
-#             example={
-#                 "type": "FeatureCollection",
-#                 "features": [
-#                     {
-#                         "type": "Feature",
-#                         "properties": {},
-#                         "geometry": {
-#                             "coordinates": [
-#                                 [
-#                                     [-4.187143188645706, 50.37072283932642],
-#                                     [-4.202697005964865, 50.368816892405874],
-#                                     [-4.203156724702808, 50.365640144076906],
-#                                     [-4.19449868846155, 50.362267670845654],
-#                                 ]
-#                             ],
-#                             "type": "Polygon",
-#                         },
-#                     }
-#                 ],
-#             },
-#         ),
-#     },
-# )
-
-# squad_metadata_schema = api.model(
-#     "SquadMetadataSchema",
-#     {
-#         "squad_ID": fields.Integer(
-#             required=True,
-#             description="Identifier of given squad",
-#             example=23,
-#         ),
-#         "no_of_platforms": fields.Integer(
-#             required=True,
-#             description="Number of platforms",
-#             example=3,
-#         ),
-#         "platforms": fields.List(
-#             fields.Nested(platform_schema),
-#             required=True,
-#             description="Squad consists of these platforms",
-#         ),
-#         "squad_mission_type": fields.String(
-#             required=True,
-#             description="Mission of given squad: `tracking`, `survey`"
-#             + ", `inspection`",
-#             example="survey",
-#         ),
-#         "squad_state": fields.Boolean(
-#             required=True,
-#             description="In execution, Waiting.. <define further>",
-#             example=False,
-#         ),
-#         "region_of_interest": fields.List(
-#             fields.Nested(region_schema),
-#             required=False,
-#             description="Region of interest and exclusion zones per squad.",
-#         ),
-#         "exclusion_zones": fields.List(
-#             fields.Nested(region_schema),
-#             required=True,
-#             description="Exclusion zones exclusion zones per squad.",
-#         ),
-#     },
-# )
-
-
-# planning_configuration_schema = api.model(
-#     "PlanningConfigurationSchema",
-#     {
-#         "message": fields.Nested(
-#             full_message_schema,
-#             required=True,
-#             description="Message header",
-#         ),
-#         "ID": fields.Integer(
-#             required=True,
-#             description="Unique identifier tagged to version of this"
-#             + " configuration plan",
-#             example=3,
-#         ),
-#         "squads": fields.Nested(
-#             squad_metadata_schema,
-#             required=False,
-#             description="Details of each squad",
-#         ),
-#     },
-# )

[Trishna Saeharaseelan]

Note: Ignore all the files under examples/*. Main files are:

• README.md
• init.py
• autonomy_configuration.py
• platform_status.py

[izzat]

Another thing to consider is the sensor data for perception or scientific observation, and whether it should go under platform status or a separate status message/topic for on-board sensor payload. Another thing we discussed previously is if this could be made generic or if we should allow customised data/messages for some platforms.

For SoAR, this would be for the pings/targets/feature-of-interests detected by the AUVs.

[Trishna Saeharaseelan]

[Alvaro] Add message format version

[Trishna Saeharaseelan]

To add separate message schema for usbl_position_updates

latitude: <>
longitude: <>
depth: <>
timestamp: <>
comms_quality: <>
ref_platform_ID: <>

[Trishna Saeharaseelan]

@geosal to have a look for USBL positions update example.

[Trishna Saeharaseelan]

@geosal to have a look at observations example. Is anything missing?

[Trishna Saeharaseelan]

@geosal @danjon to check out initial sample based on our idea for emergency behaviour in the planning config

[Trishna Saeharaseelan]

Remove safe_command

[Trishna Saeharaseelan]

[DAN] Useful to add a heading value in the vehicle status updates

[James Kirk]

Should action also be required? I guess the sub can declare its position without that, but I'd think that might be an action in and of itself? declare_pos action or something?

[Trishna Saeharaseelan]

[TO DISCUSS] action is basically from the Autonomy engine's side (i.e. what is the "action" in autonomy engine lingo). Let's discuss?

[Trishna Saeharaseelan]

To be platform-agnostic; remove flightstyle field + make action mandatory

declare_pos > not needed

[James Kirk]

Few comments of little bits I think have been from copy + pasting Only other thing is there's a lot of TODOs, commented out stuff, and just things to come back to later. Are the comments needed in there? And are there issues or notes somewhere of what work is left to do amongst all the TODOs and that?

[Dan Jones]

Can we have a chat about the structure of the messages maybe after stand-up tomorrow? This (I think) is the opposite way round from the schema I've based the prototype on. In the prototype schema every message is an instance of Message and the anyOf defines which payload schema it contains. The idea is that the backbone only deals in messages and passes the message on to the protocol handler which cares about what a message contains.

The model here is there are a bunch of different top-level schemas which each contain the content of the "Message" schema. It may well be fine or even preferable but it doesn't match the thing I've currently got working so it's probably worth a conversation.

[Trishna Saeharaseelan]

[TO DISCUSS] Interesting. Let's discuss this (need to clarify). If we need to change it from this end instead of the core, we should make the changes sooner since the partners will be working with this schemas as a start

[Trishna Saeharaseelan]

• Trishna to follow the structure the adapter is using to read schemas
• Validate all examples

[Dan Jones]

Have you tried validating the examples against this schema? I had a go with npm swagger-model-validator which I've used for the javascript adapter in the prototype. So far I've only tried the ecosub platform status message but it's not successfully validating.

[Trishna Saeharaseelan]

So with openapi-spec-validator it was validated successfully. Let's chat. That being said, I will add a task to build some tests

[Dan Jones]

That's interesting. I'll see if there's a javascript equivalent and have a go at validating it with that.

[Dan Jones]

Oh wait a minute. openapi-spec-validator is validating that the swagger.json conforms to the open api standard. It's not parsing a messaging and validating that the message conforms to the schema definition. What I'm talking about is validating that the example platform_status.json messages validate against the PlatformStatus definition defined in the schema.

[Dan Jones]

I think the python version of what I'm talking about is here: https://github.com/p1c2u/openapi-schema-validator

[Dan Jones]

The swagger.json is also curiously different in structure to all out existing APIs. Normally the models are under definitions but here they're under components/schemas and definitions is there but empty.

[Dan Jones]

The other thing Ashley suggested was that rather than define our own schema for anything geographic we just point to the existing GeoJson feature schema: https://geojson.org/schema/Feature.json

We could explicitly require a Point or a BoundingBox or whatever or just point to the parent feature definition.

Point is not very specific - it just has a min of 2 coordinates so we could supply 3=z or even 4=depth+altitude if it were necessary.

[Dan Jones]

The advantage of using Feature would be that the operating area and exclusion zones could be a BoundingBox or they could be a Polygon or even a MultiPolygon. We might not want to allow that complexity for the MVP but it would be good to have it in future - especially given the ultimate goal of the funders.

[Trishna Saeharaseelan]

Actually geojson is being in the planning_configuration message for exclusion_zones and the optional region_of_interest. Would we want to generate a 4-point polygon for each point then?

[Dan Jones]

What I mean by using geojson is adding a ref to the published geojson schema.

"coordinates": {
  "$ref": "https://geojson.org/schema/Point.json"
},

What the planning configuration message is doing is creating a data structure that matches GeoJSON.

To do that we'd need a validator that supported resolving remote refs which it seems like the one I'm currently using doesn't.

[Dan Jones]

Would we want to generate a 4-point polygon for each point then

No - We use the GeoJSON feature that represents what we want to draw. So Point for a status update/area of interest, Polygon for an operating area / exclusion zone.

[Dan Jones]

This one does it: https://www.npmjs.com/package/json-schema-remote

[Trishna Saeharaseelan]

@allore what's the best terminology to distinguish between the type of status message (i.e. from USBL or from the platform itself) vs. source/rx mode of the message (i.e. from acoustics, iridium, or wifi)?

[Alvaro Lorenzo]

Tricky. Maybe we want a field called something like platform_source: {USBL, Slocum, Ecosub, ALR ...} and other called transmission_mean : {Wifi, acoustics, iridium, starlink ... }

[Trishna Saeharaseelan]

To add warm-up time field in the planning config (e.g. for ecosub warm-up of sidescan payload)

[Dan Jones]

Needs the validator packages adding in here or in a requirements-dev.txt

[Trishna Saeharaseelan]

DONE

[Dan Jones]

Why aren't you validating the whole mock_data as a whole against the MESSAGE schema?

Should the tests be pytest/unittest or something so we can tell if they pass/fail in the CI later?

[Trishna Saeharaseelan]

1. Didn't just validate the FULL mock messages against message_schema because it kept passing even when it should have errors. Decided to break it down in the meantime to ensure it gets validated & does prompt errors (as it should). Added TODO in epic issue card to clean this up for better validation

2. DONE