Description | Example | Return Message | Group

Visibility_RM

Compute visibility to an identified number of MTO tracks from an STK Object.

Syntax

Visibility_RM <MTOObjectPath> Object <ObjectPath> {VisOptions}

Description

Use the Visibility_RM command to compute visibility to an identified number of MTO tracks (or all of them), from an STK Object, considering line of sight and, optionally, terrain.

The <ObjectPath> specifies the object to which visibility is being computed. <ObjectPath> may be a Facility, Place, Target, Satellite, GroundVehicle, LaunchVehicle, Missile, Ship, Aircraft, MTO, Planet or Star.

The following table describes the {VisOptions}.

{VisOptions} Description
Time "{TimeValue}" Enter the time at which one is checking for visibility from the MTO. Default is the current Animation time.

For valid {TimeValue} values see Time Options.

Terrain {On | Off} Indicate whether to use terrain instead of line of sight. Default is Terrain Off.
Mode {Any | All | Each | EachVisible | EachNotVisible} Enter method for returning data. Default Mode is Any. See table below for description of modes and return values.

If an object is not available then the message "Object not available" will be returned.

ObjectInterval {Normal | Extended} Enter Extended to use the last point of the ephemeris span of the object for times past the last point. Default value is Normal.
Track <TrackId> Enter the id of a track from which visibility is being computed. The Track option can be specified multiple times to select a subset of the tracks. If no tracks are selected in this manner, all tracks are considered.
ObjectData <TrackId> If the Object to which visibility will be computed is an MTO, use this option to specify the track that will be used to compute that visibility. By default the MTO's ComputeTrack will be used.

The following table describes the values for Mode and the return values for each.

Mode Description
Any Returns 1 if any track has visibility to the Object else returns 0. This is the default Mode.
All Returns 0 unless every track has visibility in which case it returns 1.
Each Returns the Track_id and 1 or 0 for every track; where 1 indicates the track is visible and 0 indicates it is not.
EachVisible Returns the Track_id and 1 only for those tracks having visibility. If all objects are invisible then the message "No Visibility" is returned.
EachNotVisible Returns the Track_id and 0 for those tracks not having visibility. If all objects are visible then the message "Complete Visibility" is returned.

Example

Return which of the two MTO tracks does not have visibility to Satellite1 at the time indicated:

Visibility_RM */MTO/MTO1 Object Satellite/Satellite1 Time "1 Jul 2007 12:55:00.00" Mode EachNotVisible

ReturnMessage

1,0
2,0

Example

Return a 1 if either track 2 or track 3 has visibility to Satellite1 (this command uses the default Mode of Any):

Visibility_RM */MTO/MTO1 Object Satellite/Satellite1 Track 2 Track 3

Group Membership

This command belongs to the following group(s):

MTO

Version

10

STK Programming Interface 11.0.1