VectorTool Axes
Define and modify Axes geometry components and templates.
Syntax
VectorTool <ScenarioPath> <ParentObject> {Action} {Axes | AxesTemplate} <AxesName> [{AxesType} <AxesTypeParams>]
Related commands
Description
The VectorTool Axes command is used to add, modify and delete Axes 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 AxesTemplate keyword must be entered.
The following table provides a description of {Action} values and the applicable parameters:
| {Action} | Parameters | Description |
|---|---|---|
| Create | {AxesType} [<AxesTypeParams>] | <AxesTypeParams> are optional, except where noted below. If no <AxesTypeParams> are specified, default values are used. |
| Modify | {AxesType} <AxesTypeParams> | The values <AxesName> {AxesType} must define an existing Axes component or template. The {AxesType} can not be modified. <AxesTypeParams> are required. |
| Delete | N/A | Delete the component or template identified by <AxesName> |
The following table describes each Axes type and it's parameters. Labels for the X, Y and Z axis can be optionally be entered for all Axes types.
| {AxesType} | <AxesParams> |
|---|---|
| "Aligned and Constrained" | {AlignVector_OrientMethod} <AlignVector_OrientParameters> "<AlignVector>" {ConstrainVector_OrientMethod} <ConstrainVector_OrientParameters> "<ConstrainVector>" ["<XLabel>" "<YLabel>" "<ZLabel>"]
Valid values for {OrientMethod} <OrientParameters> are described below this table. |
| "Angular Offset" | Any or all of the following keyword-value pairs can be specified:
Offset <Value> is entered in degrees and must be between -360.0 and 360.0 degrees. The default value is 0 degrees. |
| "B-Plane" | <CentralBodyName> "<TrajectoryPoint>" "<ReferenceVector>" {Incoming | Outgoing} ["<XLabel>" "<YLabel>" "<ZLabel>"]
The <ParentObject> for the "B-Plane" Axes must be a Satellite. |
| "Custom Inline Script" | Any or all of the following keyword-value pairs can be specified:
EulerAFunction, EulerBFunction, EulerCFunction and at least one Argument are required on the Create command. There must be at least as many arguments defined as are specified in the functions. For example if a function is defined as "x1+(t*x2)", there must be at least 2 arguments defined, x1 and x2. When using Inline Script components you may see error pop-ups from the scripts when there are errors in the functions that have been defined. Most of these errors will be caught when a Custom Inline Script component is created. Any errors must be fixed before using the component. The XDerivativeFunction, YDerivativeFunction, and ZDerivativeFunction must all be defined, or all must be undefined. These functions can be cleared by setting the value to an empty string, for example: XDerivativeFunction "" Enter "Arguments Add" to add the specified Scalar Calculations to the arguments list, and enter "Arguments Replace" to replace the Scalar Calculations in the argument list. <NumberOfScalars> indicates the number of Scalar Calculations entered. For the RemoveArgument option enter the index number of the component to be removed. The first component in the list has an index of 1. Use the VectorTool_R with the Details option to see the list of components. Valid values for Sequence <nnn> are 121, 123, 131, 132, 212, 213, 231, 232, 312, 313, 321, 323. |
| "Custom Script" | {Reload | "<ReferenceAxes>" "<FilePath>" [{InvalidOnExec}] ["<XLabel>" "<YLabel>" "<ZLabel>"]}
"<FilePath>" can be a .m, .pl, .vbs or .dll (PC only) file. The "<FilePath>" value should include a full path. Custom Script files must be located in a hierarchy of pre-determined directories. For more information see Plugin Script Reference "<ReferenceAxes>" "<FilePath>" parameters are required when Creating the "Custom Script" Axes Reload is valid for the Modify command only. The option {InvalidOnExec} is deprecated in STK 10, it should not be entered. |
| "File" | {Filename "<FilePath>" | Reload} [StartTime {TimeInstant}] [OverrideStartTime {Yes | No}] ["<XLabel>" "<YLabel>" "<ZLabel>"]
"<FilePath>" must specify an STK attitude file (*.a) Reload is valid for the Modify command only. Either Filename "<FilePath>" or Reload must be entered on each Axes "File" command. For valid {TimeInstant} values see Time Options. "<FilePath>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information. Sending StartTime {TimeInstant} will turn on the OverrideStartTime option. |
| "Fixed at Epoch" | "<EpochDate>" "<SourceAxes>" ["<ReferenceAxes>"] ["<XLabel>" "<YLabel>" "<ZLabel>"]
"<EpochDate>" is entered in Connect date units. |
| "Fixed at Time Instant" | Any or all of the following keyword-value pairs can be specified:
|
| "Fixed in Axes" | {OrientMethod} <OrientParameters> "<ReferenceAxes>" ["<XLabel>" "<YLabel>" "<ZLabel>"]
Valid values for {OrientMethod} <OrientParameters> are described below this table. |
| "Libration" | <CentralBodyName> {L1 | L2 | L3 | L4 | L5} <SecondaryBody> [<SecondaryBody>...] ["<XLabel>" "<YLabel>" "<ZLabel>"]
As many <SecondaryBody> as needed can be entered on the command line. The <ParentObject> for the "Libration" Axes must be a CentralBody |
| "Model Attachment" | "<MdlAttachPoint>"
A valid <MdlAttachPoint> is determined by the attach points specified in the parent object's model file. "<MdlAttachPoint>" is a required parameter for Create and Modify. The <ParentObject> for the "Model Attachment" Axes must be an object for which a model is valid, Satellite, Facility, etc. The "Model Attachment" Axes type is not valid for Templates. |
| "Plugin" |
The Reset parameter is valid for a Modify command only. The "<ProgID>" value is the ProgID that was used to register the plugin. The PluginName "<ProgID>" parameter is required when Creating the "Plugin" Axes. The "Plugin" Axes type is not valid for Templates. |
| "Scheduled" | Any or all of the following keyword-value pairs can be specified:
The ReferenceIntervals "<Interval or List>" and Schedule "<Interval or List>" can be an Interval component or Interval List component and should include the time component type, e.g. "Satellite/Sat1 EphemerisInterval Interval List" Slew Options:
SlewWindowDuration <value> and SlewMinOffSchedule <value> are entered in Connect time units. The SlewMaxRateX, SlewMaxRateY, SlewMaxRateZ <value> is entered in degree/Connect time. Entering <value> turns on the constraint. SlewMaxRateMag <value> is entered in degree/Connect time. This constraint is on by default, and can't be turned off. The SlewMaxRateX, SlewMaxRateY, SlewMaxRateZ <value> is entered in degree/Connect time. Entering <value> turns on the constraint. The SlewMaxAccelerationX, SlewMaxAccelerationY, SlewMaxAccelerationZ, SlewMaxAccelerationMag <value> is entered in degree/Connect time^2. Entering <value> turns on the constraint Advanced options:
Parameters for SamplingType FixedStep:
Parameters for SamplingType RelativeTolerance:
Parameters for SamplingType CurvatureTolerance: <TimeStep>, <StepBound>, <MinStep> and <MaxStep> are entered in Connect time units and must be between 1e-13 and 99999999999.0. <RelTol>, and <CurveTol> must be between 1e-13 and 1.0 <AbsTol> must be greater or equal to 1e-13 Parameters for Convergence:
<TimeTol> is entered in Connect time units, and must be between 1e-13 and 99999999999.0. <ConvergeAbsTol> must be greater or equal to 1e-13 <ConvergeRelTol> must be between 1e-13 and 1.0 |
| "Spinning" | Any or all of the following keyword-value pairs can be specified:
"<Epoch>" is entered in Connect Date units. The default value is the object's start time. Offset <Value> is entered in degrees and must be between -360.0 and 360.0 degrees. The default value is 0 degrees. RotationRate <Value> is entered in Degrees/ConnectTimeUnit. The default value is 1.0 degree/second. |
| "Surface" | <CentralBodyName> "<Point>" [{UseMSLOn | UseMSLOff}] ["<XLabel>" "<YLabel>" "<ZLabel>"] |
| "Trajectory" | "<TrajectoryPoint>" "<ReferenceSystem>" {ICR | VNC | RIC | LVLH | VVLH | BBR} ["<XLabel>" "<YLabel>" "<ZLabel>"] |
Description of {OrientMethod} <OrientParams>
| {AxesType} | {OrientMethod} | <OrientParams> |
|---|---|---|
| "Fixed in Axes" | Quat | <Q1> <Q2> <Q3> <Q4> |
| Euler | <EulerA> <EulerB> <EulerC> <Sequence>
<EulerA>, <EulerB> and <EulerC> are entered in Degrees. Valid values for <Sequence> are 121, 123, 131, 132, 212, 213, 231, 232, 312, 313, 321, 323 | |
| YPR | <Yaw> <Pitch> <Roll> <Sequence>
<Yaw>, <Pitch> and <Roll> are entered in Degrees. Valid values for <Sequence> are RPY, RYP, PYR, PRY, YRP, YPR | |
| "Aligned and Constrained" | Spherical | <RightAsc> <Declin>
<RightAsc> and <Declin> are entered in Degrees. |
| Cartesian | <X> <Y> <Z> | |
| Euler | <EulerB> <EulerC> {12 | 31 | 21 | 32}
<EulerB> and <EulerC> are entered in Degrees. | |
| PR | <Pitch> <Roll>
<Pitch> and <Roll> are entered in Degrees. |
For details on the format of a reference component (e.g. "<Point>", "<SourceAxes>", "<Vector>", etc) see Component Specification.
When specifying a reference component or template in the Create or Modify commands the {ComponentType} is implied based on the {AxesType} being created or modified and the {ComponentType} need not be entered. In the first example below, "Satellite/ScenTestSat J2000 Axes" is entered as "Satellite/ScenTestSat J2000", since the command is expecting an axes.
Examples
To create and modify a Fixed in Axes axes:
To create and modify a Libration axes:
To create an Angular Offset axes:
To create, modify and then delete a Spinning axes template:
Examples
To create and modify a Custom Inline Script axes:
Return message
Group membership
This command belongs to the following group(s):
Version
11.5