Route Planning

Table of Contents

• Route Storage
• Route Editor
• Route Passage Parameters
• Route Monitoring

With the Route Planning Library you can create and manage the base/storage of routes, edit routes, calculate passage parameters and solve route monitoring tasks such as calculating direction and time between route waypoints.

Route Storage

Route storage is a folder where all routes are stored, each route in its file. Format of route files is Navtor Route Format (json).

A route consists of waypoints and event marks. Parameters of the leg between two waypoints are stored in the end waypoint. So, each waypoint stores the following parameters: waypoint coordinates, name, turning radius, parameters of the incoming leg (speed, deviation corridor width, and leg geometry type: rhumb line or great circle). Event marks are defined by coordinates and a parameter specifying the moment when to notify the user that they have reached the event mark. It can be distance from the own vessel to the event mark or time before the own vessel reaches the event mark (to be more precise, it’s closest position to the event mark).

Below is a sample of a route:

  {
   "format_name": "Navtor Route Format",
   "format_version": 1.0,
   "routes": [{
      "route_name": "tds",
      "waypoints": [ {
         "latitude": -32.465123601946324,
         "longitude": 61.06366673305522,
         "name": "wp1_name",
         "planned_speed": 15.0,
         "port_deviation": 0.1,
         "rhumbline": true,
         "starboard_deviation": 0.1
      }, {
         "latitude": -32.4596782515538,
         "longitude": 61.04308941149176,
         "name": "wp2_name",
         "planned_speed": 15.0,
         "port_deviation": 0.1,
         "radius_of_turn": 0.01,
         "rhumbline": true,
         "starboard_deviation": 0.1
      }],
      "event marks": [{
         "distance": 0.0,
         "latitude": -32.45957980145266,
         "longitude": 61.053378437126774,
         "time": 0.0
      }],   
  }]
}

You can also export and import routes with the following formats from and to the route storage: Navtor, NMEA RTE/WPL, Maris RTU and TXT, Jeppesen, CIRM.

Route Editor

The following route editing options are available:

• Adding/deleting a waypoint
• Specifying waypoint parameters
• Specifying incoming leg parameters
• Adding/deleting an event mark
• Specifying event mark parameters
• Controlling the selector used to mark the active position on the route
• Reverting a route

When editing a route, you should create a separate workspace and put a copy of the route there. All editing operations should be made on the copy of the route. Modifications are accepted after they have been committed to the route storage.

Route Passage Parameters

You can calculate route passage parameters. For each waypoint, you can calculate the following parameters:

• Time from the current own vessel position to the waypoint (TTG)
• Time left to arrival to the end waypoint (TTA)
• Time of arrival to the end waypoint (ETA)
• Distance from the current own vessel position to the waypoint (DTG)
• Distance left to the end waypoint (DTA)
• Bearing from the previous waypoint (BWW)

Route Monitoring

You can start monitoring mode for any route. You should constantly send the current position of the own vessel, its current speed and course to the route monitoring component.

The following sailing parameters to the nearest waypoint will be calculated:

• Course to steer to the waypoint (CTS)
• Distance to the waypoint (XTD)
• Distance to the position where to start turning to the next waypoint (DWOL)
• Time of arrival to the waypoint (TTG)
• Time left to the end waypoint (TTA)
• Time of arrival to the end waypoint (ETA)
• Indication of turn start
• Indication of the route end
• Indication of deviation from the route