Description | Example | Return Message | Group

Graphics Pass2D

Set leading and trailing graphics for all types of vehicles

Syntax

Graphics <ObjectPath> Pass2D ({LeadTrailOption} <Parameters>)...

Related Commands

Description

The Graphics Pass2D command allows you to set the graphic display of ground and orbit tracks in the 2D and 3D windows.

The following table describes valid values for {LeadTrailOption} and the <Parameters>:

{LeadTrailOption} <Parameters>
OrbitLead
  • Time <Time>
  • Percent <PercentValue>
  • OnePass
  • Quarter
  • Half
  • Full
  • All
  • None
  • SameAsLead
  • CurrentInterval

These parameters are further described in the table below.

OrbitLead and OrbitTrail are applicable for Satellites only.

TrajLead and TrajTrail are applicable for LaunchVehicles and Missiles only.

The OrbitLead, OrbitTrail, TrajLead and TrajTrail options are only applicable if the 2D Map Projection is set to Orthographic or Perspective.

OrbitTrail
GrndLead
GrndTrail
TrajLead
TrajTrail
VisibleSides
  • Ascending
  • Descending
  • Both
  • None
Show {All | From {First | <StartPass>} {Last | <EndPass>}}

If All is entered than all passes will be displayed. Enter From and a start pass number and end pass number to display a selected range of passes. First can be entered in place of <StartPass>, and Last can be entered in place of <EndPass>.

ShowPassLabels {On | Off}
ShowPathLabels {On | Off}
Resolution {MinGroundTrack | MaxGroundTrack | MinOrbit | MaxOrbit | MinTrajectory | MaxTrajectory} <TimeStep>

Enter the minimum or maximum time step value for the Ground Track, Orbit or Trajectory. <TimeStep> is entered in Connect time units and must be greater or equal to 0.0.

The options GroundTrack, Orbit and Trajectory are deprecated in STK9.1 and should no longer be used. However, if used these will set the maximum resolution values.

The {LeadTrailOption} <Parameters> are described in the following table:

<Parameters> Description
Time <Time> Specify the amount of time that you want the vehicle's path to display in the 2D Graphics window. <Time> 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 2D Graphics window.
Quarter Display one quarter of the leading or trailing portion of a vehicle's path in the 2D Graphics window.
Half Display one half of the leading or trailing portion of a vehicle's path in the 2D Graphics window.
Full Display the entire leading or trailing portion of a vehicle path in the 2D 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.
SameAsLead This parameter will set the trailing path display to be the same as leading path display.

Note: The SameAsLead parameter is applicable for OrbitTrail, GrndTrail and TrajTrail only.

Example

To set graphics for the ERS1 satellite so that only 75 percent of the orbit track, and only ascending sides, displays in the 2D Graphics window:

Graphics */Satellite/ERS1 Pass2D OrbitLead Percent 75 VisibleSides Ascending

To set graphics for the Air1 aircraft so that only one quarter of the leading ground track and one half of the trailing ground track displays in the 2D Graphics window:

Graphics */Aircraft/Air1 Pass2D GrndLead Quarter GrndTrail Half

To set graphics for Satellite1 so that only passes 1 through 4 are displayed, with no labels:

Graphics */Satellite/Satellite1 Pass2d Show From 1 4 ShowPassLabels Off ShowPathLabels Off

To set graphics for Satellite1 so that passes 5 through the last pass are displayed, with pass labels:

Graphics */Satellite/Satellite1 Pass2d Show From 5 Last ShowPassLabels On

To set graphics for Satellite1 so that 65% of the orbit displays before the satellite, and set the trailing display the same (65%):

Graphics */Satellite/Satellite1 Pass2D OrbitLead Percent 65 OrbitTrail SameAsLead

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

2D Object Graphics

Vehicles

Version

9.1

STK Programming Interface 11.0.1