Description | Example | Return Message | Group

AddWaypoint

Add waypoints to a great arc vehicle

Syntax

AddWaypoint <VehObjectPath> {AddMethod} <Parameters> [<TurnRadius>]

Related Commands

Description

The AddWaypoint Connect command allows you to add a new waypoint to the route of a great arc vehicle using a specified {AddMethod}.

The AddWaypoint command will only propagate from the last point to the newly added point. To repropagate the entire route use the Propagate command.

The following table describes the <Parameters> which are based on the {AddMethod}:

{AddMethod} <Parameters>
DetTimeFromVelAcc [{MapGridSpec}] {PointDef} <Velocity> <Acceleration>
DetTimeAccFromVel [{MapGridSpec}] {PointDef} <Velocity>
DetVelFromTime [{MapGridSpec}] {PointDef} {DateTime}

<TurnRadius> is an optional parameter for any {AddMethod}. It is entered in Connect distances units. If no value is entered, <TurnRadius> is 0.0 meters.

{MapGridSpec} indicates the method for specifying points. It can be LatLon or UTM. This is an optional parameter and if not specified then LatLon is assumed. The following table describes the values for {PointDef} based on the {MapGridSpec}.

{MapGridSpec} {PointDef}
LatLon <Latitude> <Longitude> <Altitude>
UTM <ZoneStr> <Easting> <Northing> <Altitude>

Note: If {MapGridSpec} is not entered then {PointDef} is <Latitude> <Longitude> <Altitude>

The parameters described in the preceding two tables are entered using the following units and values:

<Parameter> Unit
Latitude and Longitude Connect Latitude and Longitude units (default is degrees).
Altitude <Altitude> is entered in Connect distance units, or can be the keyword Terrain, to calculate the altitude using loaded Terrain data.
ZoneStr Valid values for <ZoneStr> are A, B, Y, Z or ddc, where 00>dd>61 and c is C-X.
Easting Northing <Easting> and <Northing> are entered in Connect distance units.
Acceleration Connect distance units per sec^2
Velocity Connect distance units per sec
{DateTime} For valid {DateTime} values see Time Options.
TurnRadius <TurnRadius> is an optional parameter entered in Connect distances units. If no value is entered, <TurnRadius> is 0.0.

Waypoints added using the DetVelFromTime {AddMethod} must be added in increasing time order or a NACK will occur.

Note: Specifying the {AddMethod} sets that Method for all waypoints, which may alter Time, Velocity or Acceleration for any previously defined waypoints. When adding a series of points, all should use the same method.

Example

To add a series of waypoints to Ship1 using the DetTimeAccFromVel method and LatLon point definition:

New / */Ship Ship1
AddWaypoint */Ship/Ship1 DetTimeAccFromVel 42.5 15 0.0 1.0

AddWaypoint */Ship/Ship1 DetTimeAccFromVel 44.5 15.7 Terrain 5.0

AddWaypoint */Ship/Ship1 DetTimeAccFromVel 44 18 Terrain 10.0

AddWaypoint */Ship/Ship1 DetTimeAccFromVel 43.2 18.9 0.0 9.0

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

Version

10

STK Programming Interface 11.0.1