Description | Example | Return Message | Group

Graphics Projection

Set various options that affect projection of sensor field of view

Syntax

Graphics <SensorObjectPath> Projection {Option}

Description

The Graphics Projection command is used to specify the display of sensor projection graphics in the 2D Graphics window.

Sensors attached to facilities, places and targets differ in their display behavior from those attached to vehicles. The intersections of vehicle-based sensors with the Earth display during animation. Nontargeted sensors attached to facilities, places and targets only display if the <StepCount> is greater than 0. The <StepCount> works in conjunction with <MinAlt> <MaxAlt> to determine the number and altitude of projections to be displayed.

The following options are valid only for ground-based sensors.

Ground-based Sensor {Option} Description
Altitudes <MinAlt> <MaxAlt> <StepCount> Specify the minimum and maximum altitude above the facility, place or target to which the sensor projects. The <StepCount> determines the number and altitude of projections to be displayed. For more information, refer to the STK Help topic on Sensor Projection. <MinAlt> and <MaxAlt> are entered in Connect distance units.
Ranges <MinRange> <MaxRange> <StepCount> Specify the minimum and maximum range from the facility, place or target to which the sensor projects. The <StepCount> determines the number of projections to display and the range value for each projection. For more information, refer to the STK Help topic on Sensor Projection. <MinRange> and <MaxRange> are entered in Connect distance units.
Object {On | Off} [<TruncObjectPath>] If On, projections display at the altitude of the vehicle specified using the <TruncObjectPath>. If Off, projections display at a constant altitude. If On, you must enter the <TruncObjectPath>.
RangeConstraint Minimum and maximum projection range is determined by the range constraint (range constraints are explained in the documentation for SetConstraint (Vehicles)) set for the sensor.

Note: Both Min and Max values for the Sensor's Range constraints must be turned on, or this command will NACK.

The following options are valid for all sensors.

Sensor {Option} Description
Intersections {None | CentralBody | Terrain} Select one of the following:
  • None. Forces the sensor to its defined shape, regardless of affects that would otherwise occur due to Earth intersections. It can be used, for example, if you want to use the sensor to help detect obscuration by the spacecraft body and want to avoid the removal of parts of the outer sensor cone that would ordinarily result from Earth intersections.
  • CentralBody. Modifies field of view of the sensor to account for its intersections
  • Terrain. Modifies the field of view of the sensor to account for its intersections with the central body and terrain. The actual extent of the terrain intersection region depends on the availability of terrain and the type of the terrain source. This option is only applicable for sensors located on vehicles.
FOVwithConstraints {On | Off} [<ConstraintNames>] If on, defines which constraints can be used to modify field of view of the sensor. The constraints must also be turned on in order for this to occur. If off, removes specified constraints from consideration for field of view modification. If off and no constraint names are specified, disables field of view modification from constraints.
ShowOn2dMap {On | Off} If on, the sensor projection is shown on the 2d map If off, the projection is not shown. The default is On.
Distance {On | Off} Indicates whether the sensor field of view crossings at specified distances are computed and displayed in the 2D Graphics window.
Through {Yes | No} Indicates whether the sensor field of view will extend beyond specified crossings.
Sides {Both| One} Indicates the crossings that are computed and displayed in the 2D Graphics window:
  • Both Sides. If the Direction option for altitude crossing permits two possible crossings, front and back, then both are computed and displayed in the 2D Graphics window.
  • One Side. Indicates that only one crossing, the first that satisfies the Direction option for altitude crossing, is computed and displayed in the 2D Graphics window.
Direction {Either | InsideOut | OutsideIn} Indicates the direction in which the sensor field of view crosses the specified altitude:
  • Inside Out. Crossing occurs from lower altitudes to higher altitudes.
  • Outside In. Crossing occurs from higher altitudes to lower altitudes.
  • Either. Crossing can occur in either direction.
ExcludeHorizonArcs {Yes | No} Specifies whether to exclude the lines that indicate the intersection of the sensor with the horizon.

Example

To set the graphics of the Uplink sensor attached to the Perth facility so that the sensor projection display at an altitude of 500000 m, 750000 m and 1000000 m:

Graphics */Facility/Perth/Sensor/Uplink Projection Altitudes 500000 1000000 3

To turn off the display of Sensor2's projection:

Graphics */Facility/Facility2/Sensor/Sensor2 Projection Object Off

To display Sen2 ignoring any intersections:

Graphics */Satellite/Sat1/Sensor/Sn2 Projection Intersections None

To define the minimum and maximum limits of Sensor1's projection using values set for Sensor1's Range Constraint:

Graphics */Facility/Facility1/Sensor/Sensor1 Projection RangeConstraint

To modify Sensor1's field of view to account for ground elevation constraints:

Graphics */Satellite/Satellite1/Sensor/Sensor1 Projection FOVwithConstraints On GroundElevAngle

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

2D Object Graphics

Sensors

Version

10

STK Programming Interface 11.0.1