Description | Example | Return Message | Group

VectorTool Angle

Define and modify Angle geometry components and templates.

Syntax

VectorTool <ScenarioPath> <ParentObject> {Action} {Angle | AngleTemplate} <AngleName> [{AngleType} <AngleTypeParams>]

Related Commands

Description

The VectorTool Angle command is used to add, modify and delete Angle geometry components and templates.

For a component object the <ParentObject> is a truncated object path or a Central Body path.

For a template the <ParentObject> is an STK class name, and the AngleTemplate keyword must be entered.

The following table provides a description of {Action} values and the applicable parameters:

{Action} Parameters Description
Create {AngleType} [<AngleTypeParams>] <AngleTypeParams> are optional, except where noted below. If no <AngleTypeParams> are specified, default values are used.
Modify {AngleType} <AngleTypeParams> The values <AngleName> {AngleType} must define an existing Angle component or template. The {AngleType} can not be modified. <AngleTypeParams> are required.
Delete N/A Delete the component or template identified by <AngleName>

The following table describes each Angle type and it's parameters.

{AngleType} <AngleTypeParams>
"Between Planes" "<PlaneA>" "<PlaneB>"

Note: The Between Planes Angle is not valid for Star objects.

"Between Vectors" "<FromVector>" "<ToVector>"
"Dihedral Angle" "<FromVector>" "<ToVector>" "<AboutVector>" [{-180-180 | 0-360} {Positive | Negative}]
"Rotation" "<FromAxes>" "<ToAxes>" {X | Y | Z}
"To Plane" "<Vector>" "<Plane>" [{Signed} [{Positive | Negative}]]

Valid values for {Signed} are On and Off.

Note: The To Planes Angle is not valid for Star objects.

For details on the format of a reference component (e.g. "<PlaneA>", "<VectorTo>", etc) see Component Specification.

When specifying a reference component or template in the Create or Modify commands the {ComponentType} is implied based on the {AngleType} being created or modified and the {ComponentType} need not be entered. In the first example below, "Facility/Facility3 North Vector" is entered as "Facility/Facility3 North", since the command is expecting a vector.

Example

To create a new angle with respect to Facility3's Moon and North vectors, named NewAngBet:

VectorTool * Satellite/Satellite1 Create Angle NewAngBet "Between Vectors" "Facility/Facility3 Moon" "Facility/Facility3 North"

To create, modify and then delete a dihedral angle:

VectorTool * Satellite/ScenTestSat Create Angle SatAngle3 "Dihedral Angle"

VectorTool * Satellite/ScenTestSat Modify Angle SatAngle3 "Dihedral Angle" "Satellite/ScenTestSat Sun" "Satellite/ScenTestSat Moon" "Satellite/ScenTestSat Position" 0-360 Negative

VectorTool * Satellite/ScenTestSat Delete Angle SatAngle3

To create, modify and then delete a rotation angle template:

VectorTool * Satellite Create AngleTemplate SatAngleT4 "Rotation"

VectorTool * Satellite Modify AngleTemplate SatAngleT4 "Rotation" "Satellite J2000" "CentralBody/Earth Fixed" Y

VectorTool * Satellite Delete AngleTemplate SatAngleT4

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Area Targets

Attitude

Comm

Facilities, Places & Targets

Line Targets

Radar

Scenarios

Sensors

Stars & Planets

Object Tools

Vehicles

VO

VO Objects

Version

10

STK Programming Interface 11.0.1