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

VectorTool

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