Description | Example | Return Message | Group

SetPosition (Facility, Place, Target & Area Target)

Set the position of a facility, place, target or area target

Syntax

SetPosition <ObjectPath> [{Type}] {CoordType} <Parameters>

Related Commands

Description

Use the SetPosition command to set the position of a facility, place or target, or to set the centroid position of an area target.

The {Type} option can be Ground or Actual. If not specified, or Ground is specified, then this will set the position of the ground. If Actual is specified, then the actual position of the object is set with the given position description. When setting an Actual position, if the height above ground is non-zero, then the position will be altered so that the specified altitude equals the altitude on the ground plus height above ground.

Note: For AreaTarget {Type} is invalid and MUST NOT be entered. Ground will be used.

Specify the coordinate type to be used, then the parameters. {CoordType} and <Parameters> can be:

{CoordType} <Parameters>
Cartesian <X> <Y> <Z>
Geodetic <Lat> <Lon> {<Altitude> | Terrain} [MSL]
Geocentric <Lat> <Lon> {<Altitude> | Terrain} [MSL]
Cylindrical <R> <Lon> <Z>
Spherical <Lat> <Lon> {<Radius> | Terrain}
UTM <ZoneStr> <Easting> <Northing> {<Altitude> | Terrain} [MSL]

<Lat> and <Lon> are entered in Connect Latitude and Longitude units (default is degrees).

Valid values for <ZoneStr> are A, B, Y, Z or ddc, where 00>dd>61 and c is C-X. <Easting> and <Northing> are entered in Connect distance units.

If you specify Terrain, STK will use the altitude or radius from the terrain data being used in the scenario. If no terrain data is available at the specified latitude and longitude, STK will set the <Altitude> to 0.0.

Note: You can only use Terrain to specify the Ground position (not Actual).

If you specify MSL, the altitude will be set with respect to mean sea level.

Note: For AreaTarget MSL is invalid and MUST NOT be entered.

Example

To set the position of the Wallops facility in the current scenario:

SetPosition */Facility/Wallops Geodetic 37.9 -75.5 0.0

To set the position of the FacTest1 facility, setting the altitude at mean sea level:

SetPosition */Facility/FacTest1 Geodetic 37.9 -75.5 0.0 MSL

To set the centroid position of the AreaTarget using UTM coordinates:

SetPosition */AreaTarget/AreaTarget1 UTM 18S 523222 3706636 0.0

To set the centroid position of the AreaTarget using Spherical coordinates:

SetPosition */AreaTarget/AreaTarget1 Spherical 37.878 -77.31 6370049

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Area Targets

Facilities, Places & Targets

Version

10

STK Programming Interface 11.0.1