VO SetVectorGeometry
Define the display of geometric components in the 3D Graphics window
Syntax
VO <ObjectPath> SetVectorGeometry {Option} <Parameters> [WindowID <WinNumber>]
Description
The VO SetVectorGeometry command enables you to display various geometric components (vectors, axes, angles, planes, points) relative to a vehicle (any type), facility, place, target, area target, or central body in a 3D Graphics window.
If <ObjectPath> is the scenario path, then the geometric components on the central body in a 3D Graphics window are affected. Use the WindowID <WinNumber> option to indicate to which 3D Graphics window the {DisplayOptions} should be applied. If you do not include WindowID <WinNumber>, then the first 3D Graphics window will be used.
If <ObjectPath> is the scenario path and there are no 3D Graphics windows in the scenario, then the VO SetVectorGeometry command will Nack.
If <ObjectPath> is not scenario, then the geometric components on the object specified by <ObjectPath> are affected, and the WindowID <WinNumber> option is ignored.
| {Option} | <Parameters> |
|---|---|
| Data | {DataOption} <DataValue> [{DataOption2} <DataValue2>...] |
| Add | "<ReferenceCrdn>" [{DisplayOption} <DisplayValue>...] |
| Modify | |
| Delete | "<ReferenceCrdn>" |
ReferenceCrdn
For the specification of "<ReferenceCrdn>", used with the Add, Modify, or Delete {Option}, see Component Specification.
Data Options
You can specify {DataOptions} in any order. You must use at least one {DataOptions} in a single command.
If {Option} is <Data>, {DataOptions} can be:
| {DataOption} | <DataValues> | Description |
|---|---|---|
| FractionalScale | <ScaleValue> | Enter a number from 0.0 to 5.0 indicating the scale factor that modifies the distance from the center of the object at which the arc will be drawn. |
| SupportingDihedralArcLineWidth | <LineWidth> | Enter a number from 1.0 to 10.0 indicating the line width of the supporting lines of a dihedral angle. |
| ArcLineWidth | <LineWidth> | Enter a number from 1.0 to 10.0 indicating the line width of the arc that represents the angle. |
| PixelThreshold | <Value> | Enter a value greater than or equal to 0.1 that determines how smooth the arc of an angle will appear, where a lower value gives a smoother arc. |
| FixVectorAxesScaleToModel | {On | Off} | This is only available for geometric components relating to objects. If you enter On, geometric components relating to objects will scale with the object's model. |
| FixVectorAxesScaleToAttSphere | {On | Off} | This is only available for Vehicles, Facilities, Targets, and Sensors that have the Attitude Sphere turned on. |
| Scale | <ScaleValue> | If {FixVectorAxesScaleToModel} is Off, you can set the size of the geometric components drawn by specifying a value between 1 and 10. If {FixVectorAxesScaleToModel} is On, the <ScaleValue> is used to set the ratio for scaling the geometric components. For instance, if this scale factor is set to 2 and you change the model scale from 3 to 4 (model scale is set using the VO ScaleLog or VO ScaleModel command), the geometric components are sized two times larger than they would be if the model scale were set to 3. |
| PersistentLineWidth | <Value> | Specify the width of the trace line that is drawn when vector persistence is turned on with a <ConnectType> of <Trace> (see {DisplayOptions} below), using a value between 1 and 10. |
| PointSize | <Value> | When displaying a Point component, use this value to specify the point size in pixels. Valid value is between 0 and 10. |
| VectorAxesAngleSwapDist | {<Value> | All | ModelLabel | MarkerLabel | Marker | Point} | Sets the distance at which Vectors, Axes, and Angles are visible. <Value> must be greater than or equal to 0.0, or enter the component whose swap distance will be used. |
| PlaneSwapDist | {<Value> | All | ModelLabel | MarkerLabel | Marker | Point} | Sets the distance at which the Planes are visible. <Value> must be greater than or equal to 0.0, or enter the component whose swap distance will be used. |
The ArrowPointSize Data option is obsolete in STK 11.4, it should no longer be used.
Add and Modify Options
You can specify {DisplayOptions} in any order and use any number of {DisplayOptions} in a single command.
If {Option} is Add or Modify, the following {DisplayOptions} are valid for ALL components:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| Show | {On | Off} | If you enter On, the geometric component appears in the 3D Graphics window. |
| ShowLabel | {On | Off} | If you enter On, the name appears with the selected geometric component. |
| IntervalType | AlwaysOn | This directs STK to always display geometric components. |
| DuringAccess | STK will only display geometric components only during periods of access. This option is only valid for "To" vectors and certain displacement vectors. | |
| UseIntervals | STK will display geometric components at the user-defined times specified using the AddInterval option. | |
| UseTimeComponent | STK will display geometric components at the times from an interval or interval list time component specified using the TimeComponent option. | |
| AddInterval | "<StartTime>" "<StopTime>" | Specifies the "<StartTime>" and "<StopTime>" of an interval to add. The "<StartTime>" and "<StopTime>" must be within the object's time period. |
| DeleteInterval | {"<StartTime>" "<StopTime>" | All} | Specify All to delete all display time intervals. To remove a selected interval, specify the "<StartTime>" "<StopTime>" of the interval. |
| LoadIntervals | "<IntervalFile>" | Loads intervals from an interval file. The intervals from the file are added to the existing interval list. |
| ImportIntervals | "<TimeComponent>" | Imports the specified Interval or Interval List time component. The intervals are added to the existing interval list.
For information about "<TimeComponent>", see Component Specification. |
| TimeComponent | "<TimeComponent>" | Specifies an interval or interval list time component. Only the times from the component will be used. Any changes to the specified time component will be observed in the display times of the geometry component.
For information about "<TimeComponent>", see Component Specification. |
| Color | {Color} | Sets the color of the geometric component. For valid {Color} options, see Common Options. |
If {Option} is Add or Modify, the following {DisplayOptions} are valid for VECTORS and AXES only:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| Persistent | {On | Off} | If you enter On, STK displays geometric components successively over the specified duration. |
| Duration | <DurationValue> | Sets the length of time during which the geometric component is visible when Persistent is turned on. |
| Fade | {On | Off} | If you set this to On and Persistent is On, earlier occurrences of a geometric component display fade over time so that it is drawn as completely filled at the most recent animation time and fades as the animation moves forward. |
| ConnectType | Trace | Has STK use a single-line arc to represent the path of the component when connecting vectors and axes, during Persisence. |
| Sweep | Tells STK to use a continuous band of color to represent the path of the component when connecting vectors and axes, during Persistence. | |
| Line | Draws a line representing the position of the component at every time step, during Persistence. | |
| RefCrdn | "<ReferenceCrdn>" | RefCrdn is the reference frame in which persistence is drawn. {ComponentType} must be Axes. For details, see the Table above describing "<ReferenceCrdn>". |
| DrawFirstArrowOnly | {On | Off} | If you set this to On and Persistent is On, the arrow representing the specified component will display only at the current time. If you set it to Off, the arrow representing the specified component will appear at all time steps that cover the <DurationValue> value specified. |
| DrawAtCB | {On | Off} | This is only available for vectors and axes relating to objects. If you set it to On, the geometric component is drawn at the central body. |
| OriginPointDef | "{ReferenceCrdn}" | Specifies the point to be used as the Origin Point for the vector or axes. |
| Thickness | <Value> | Sets the thickness of a Vector or Axes, in pixels. <Value> is a real number greater than or equal to 1. |
| ArrowType | {2D | 3D} | Select the arrow type used to represent the vector or axis in the 3D Graphics window. Selecting 2D will create an arrow with a thickness of 1 pixel. Selecting 3D will create an arrow with a thickness of 5 pixels.
This option is deprecated as of STK 11.4. Use the Thickness option instead. The PointOnly, Point, and None values are obsolete as of STK 11.4. |
| AddColorInterval | "<StartTime>" "<StopTime>" {Color} | Specify the "<StartTime>" and "<StopTime>" of an interval to add. The "<StartTime>" and "<StopTime>" must be within the object's time period.
For valid {Color} options, see Common Options. |
| DeleteColorInterval | {"<StartTime>" "<StopTime>" | All} | Specify All to delete all color intervals. To remove a selected color interval, specify the "<StartTime>" "<StopTime>" of the interval. |
| LoadColorIntervals | "<ColorIntervalFile>" | Loads color intervals from an interval file. The intervals from the file are added to the existing interval list. A color interval file is similar to a standard interval file, but with the addition of a color value at the end of the interval line.
For valid color values, see Common Options. |
If {Option} is Add or Modify, the following {DisplayOptions} are valid for VECTORS or POINTS only:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| ShowRaDec | {On | Off} | If you set this to On, right-ascension and declination values appear with the selected geometric component. |
| RaDecUnits | <UnitAbbrev> | Enter the abbreviation of the right-ascension and declination units that will be displayed. <UnitAbbrev> is case-sensitive. Valid values are: deg, rad, arcSec, arcMin, secArc, mrad, urad, revs, semiC, and mdeg. |
| ShowMagnitude | {On | Off} | If you set this to On, the magnitude value displays on the selected geometric component. |
If {Option} is Add or Modify, the following {DisplayOptions} are valid for VECTORS only:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| UseTrueScale | {On | Off} | Specify whether to show vectors at their true length. This option will only affect displacement vectors (represented in distance). |
| MagnitudeUnits | <UnitAbbrev> | Enter the abbreviation of the magnitude unit that will be displayed. Valid values for the abbreviation depend on the type of vector. The magnitude for most Vectors will be distance or velocity units, which are <DistanceUnit>/<TimeUnit>. <UnitAbbrev> is case-sensitive. Valid values for <DistanceUnit> are ft, mi, nm, m, km, Au, Re, kft, sqrtm, fur, fm, and leag. Valid values for <TimeUnit> are sec, min, hr, day, cd, EarthTU, SunTU, fn, and yr. For other valid unit abbreviations, see the Set Scenario Properties - Units page of the STK Help. |
If {Option} is Add or Modify, the following {DisplayOptions} are valid for PLANES only:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| ShowAxisLabel | {On | Off} | If you set this to On, STK will display the X and Y axis labels. |
| PlaneSize | <ScaleValue> | Scale planes using the <ScaleValue> set here relative to the <ScaleValue> {DataOption} set for global scaling. |
| Translucent | {On | Off} | If you set this to On, STK will display planes using the translucency value specified. |
| Translucency | <TranslucencyValue> | The <TranslucencyValue> specified must be between 0.0 and 1.0, with 0.0 being opaque and 1.0 being totally transparent. |
| DrawAtObject | {On | Off} | This is only available for geometric components relating to objects. If you set this to On, STK will draw the geometric component at the object. |
| ShowRectGrid | {On | Off} | Displays a rectangular grid within the plane. |
| ShowCircGrid | {On | Off} | Displays a circular grid within the plane. |
| GridSpacing | <SpacingValue> | Specify the grid spacing value in meters. |
If {Option} is Add or Modify, the following {DisplayOptions} are valid for ANGLES only:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| ShowAngle | {On | Off} | Displays the angle in the 3D Graphics window specified. |
| ShowDihedralAngleSupportingArcs | {On | Off} | Displays the support arcs for a dihedral angl, in the 3D Graphics window specified. |
| AngleUnits | <UnitAbbrev> | Enter the abbreviation of the angle unit that STK will display. <UnitAbbrev> is case-sensitive. Valid values are: deg, rad, arcSec, arcMin, secArc, mrad, urad, revs, semiC, and mdeg. |
If {Option} is Add or Modify, the following {DisplayOptions} are valid for POINTS only:
| {DisplayOption} | <DisplayValue> | Description |
|---|---|---|
| ShowCartesian | {On | Off} | If you set this to On, cartesian values appear with the selected point. |
| CartesianUnits | <UnitAbbrev> | Enter the abbreviation of the cartesian unit to be displayed. <UnitAbbrev> is case-sensitive. Valid values are ft, mi, nm, m, km, Au, Re, kft, sqrtm, fur, fm, and leag. |
| TrajectoryType | {Point | Trace | Line} | Set the trajectory type for the point. |
| MagnitudeUnits | <UnitAbbrev> | Enter the abbreviation of the magnitude unit to be displayed. <UnitAbbrev> is case-sensitive. Valid values are ft, mi, nm, m, km, Au, Re, kft, sqrtm, fur, fm, and leag. |
Examples
To set the relative scale of geometric components being drawn to 3, and the line width of angle arcs to 2:
VO */Satellite/Satellite1 SetVectorGeometry Data Scale 3 ArcLineWidth 2.0
To add the Facility1's body XY plane to Satellite1, as almost completely transparent, display its axis label and scale the plane relative to the global scaling set:
VO */Satellite/Satellite1 SetVectorGeometry Add "Facility/Facility1 BodyXY Plane" Translucent On Translucency 0.9 PlaneSize 4.0 ShowAxisLabel On
To show the Facility1's body XY plane that was added in the previous command:
VO */Satellite/Satellite1 SetVectorGeometry Modify "Facility/Facility1 BodyXY Plane" Show On
To display a "to vector" from Satellite1 to Facility1:
VO */Satellite/Satellite1 SetVectorGeometry Add "Satellite/Satellite1 Facility/Facility1 Vector" Show On
To display the "to vector" from Satellite1 to Facility1 (added in the previous command) only during access:
VO */Satellite/Satellite1 SetVectorGeometry Modify "Satellite/Satellite1 Facility/Facility1 Vector" IntervalType DuringAccess
To modify the "to vector" from Satellite1 to Facility1 (previously added) to originate from the Satellite's SunGlint point:
VO */Satellite/Satellite1 SetVectorGeometry Modify "Satellite/Satellite1 Facility/Facility1 Vector" OriginPointDef "Satellite/Satellite1 SunGlint"
To display the Earth inertial axes on the central body:
VO * SetVectorGeometry Modify "CentralBody/Earth Inertial Axes" Show On
To display Satellite1's Center Point, with all possible display values on, but only during the specified interval:
VO */Satellite/Satellite1 SetVectorGeometry Modify "Satellite/Satellite1 Center Point" TrajectoryType Line ShowCartesian On ShowMagnitude On ShowRaDec On IntervalType UseIntervals AddInterval "1 Jun 2004 14:00:00.00" "1 Jun 2004 22:00:00.00"
To display the Satellite Velocity vector with nautical mile/hour units:
VO */Satellite/Satellite1 SetVectorGeometry Modify "Satellite/Satellite1 Velocity Vector" Show On ShowMagnitude On Color yellow MagnitudeUnits nm/hr
To display the Sun Moon vector on the Central Body in the 2nd 3D Graphics window:
VO * SetVectorGeometry Add "CentralBody/Sun Moon Vector" Show On Color white WindowID 2
To add intervals from a time component to the display of Satellite1's Center Point:
VO */Satellite/Satellite1 SetVectorGeometry Modify "Satellite/Satellite1 Center Point" ImportIntervals "Satellite/Satellite1 FixedInt17 Interval"
To specify a time component for display of a satellite's VelocityAzimuth Angle:
VO */Satellite/ScenTestSat SetVectorGeometry Modify "Satellite/ScenTestSat VelocityAzimuth Angle" IntervalType UseTimeComponent TimeComponent "Satellite/ScenTestSat2 LightingIntervals.Sunlight Interval List"
Return message
Group membership
This command belongs to the following group(s):
Version
12.10