Set leading and trailing graphics in a 3D window for all types of vehicles (Deprecated Command)
VO <ObjectPath> Pass {LeadTrailOption} <Parameters>
Note: This command was deprecated in STK 9, it should no longer be used. This command has been replaced by the VO Pass3D command and the VO OrbitSystem command.
The VO Pass command allows you to modify the display of vehicle tracks in a 3D window. Use the {LeadTrailOptions} to define the display of the leading and trailing portions of vehicle tracks. The leading portion of a vehicle's track begins at the vehicle's present position and moves forward half the span of the its ephemeris. The trailing portion of a track begins at the vehicle's present position and moves backward half the span of the vehicle's ephemeris.
Note: Only one option can be entered on a command line.
{LeadTrailOption} can be:
| {LeadTrailOption} | <Parameters> | Description |
|---|---|---|
| OrbitLead | {Type} | {Type} Options are outlined in the following Table. |
| OrbitTrail | ||
| TrajLead | ||
| TrajTrail | ||
| GrndLead | ||
| GrndTrail | ||
| Inherit | {On | Off} | If On, the leading and trailing options are inherited from the 2D graphics settings. See Graphics Pass2D command. |
| Frame | {ECI | ECF | Both | BBR | All} | Select the reference frame for the
display.
Select Both to display in ECI and ECF coordinate frames at the same time . BBR specifies that the vehicle displays in the body-body rotating frame (BBR). The BBR frame requires a primary and secondary central body. The primary body is specified as the central body (to which the vehicle belongs) and the second central body is vehicle specific. Select All to display the vehicle in all coordinate frames at the same time (ECI, ECF and BBR). |
Use OrbitLead and OrbitTrail to specify Orbit pass options for Satellites.
Use TrajLead and TrajTrail to specify Trajectory pass options for LaunchVehicles and Missiles.
Use GrndLead and GrndTrail to specify GroundTrack pass options for All vehicles.
Valid values for {Type} are:
| {Type} | Description |
|---|---|
| Time <Value> | Specify the amount of time that you want the vehicle's path to display in the 3D Graphics window. <Value> is entered in seconds and should be greater or equal to 0.0. |
| Percent <Value> | Indicate the percentage of the leading or trailing portion of a vehicle's path that will display in the 3D Graphics window. |
| Quarter | Display one quarter of the leading or trailing portion of a vehicle's path in the 3D Graphics window. |
| Half | Display one half of the leading or trailing portion of a vehicle's path in the 3D Graphics window. |
| Full | Display the entire leading or trailing portion of a vehicle path in the 3D Graphics window. |
| OnePass | Display one full pass of a satellite's orbit. This option is valid for Satellites only. |
| CurrentInterval | When the vehicle is using Access Intervals, Custom Intervals or Realtime Intervals, display the leading portion of the vehicle's track for the graphics interval that contains the current animation time. When using Basic graphics options the entire leading portion will be displayed. |
| All | Display the path spanning the entire vehicle ephemeris. |
| None | Display none of the leading or trailing portion of the vehicle's path. |
If you wish to set a Trail value to the same as a Lead value you must set it explicitly using a separate VO Pass command.
To set graphics for the ERS1 satellite so that the options aren't inherited from the 2D Graphics:
VO */Satellite/ERS1 Pass Inherit Off
To display the one full pass of the ERS1 satellite's orbit:
VO */Satellite/ERS1 Pass OrbitTrail OnePass
To set both lead time 3600.0 seconds, and then set the trail time to be the same:
VO */Satellite/Sat1 Pass OrbitLead Time 3600.0
VO */Satellite/Sat1 Pass OrbitTrail Time 3600.0
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
9.0
STK Programming Interface 11.0.1