Description | Example | Return message | Group

LaserCAT

Set LaserCAT properties

Syntax

LaserCAT <ObjectPath> {AvoidanceOptions} <Parameters>

Description

Use the LaserCAT command to perform a laser clearinghouse analysis. {AvoidanceOptions} and <Parameters> can be:

{AvoidanceOption} <Parameters>Description
TargetObject <TruncObjectPath> Specify the Target Object. The TargetObject must be a Satellite or Missile.
MaxLaserRange <RangeValue>Enter the range value in Connect distance units; it must be greater then or equal to 0.0.
ExclusionHalfAngle <Value>Enter the Exclusion Half Angle in degrees; it must be between 0.0 and 90.0.
MinElevAngle <Value>The Minimum Topocentric Elevation Angle is entered in degrees, and is between -90.0 and 90.0.
Duration <DurationValue>Enter the duration value in Connect time units; it must be between 0.0 and 5000.0 seconds.
StartStop {TimeInterval}Enter times that are within the target object's time period.

For valid {TimeInterval} values, see Time Options.

Database "<FilePath>"Specify the Satellite Database.

"<FilePath>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information. Any file containing GP element data may be used, including TLE files and files containing CCSDS OMM content in XML, KVN, (using file extension .omm), and CSV formats.

AddVictims {On | Off} [<NumberToShow>]Specify whether to add potential victims to the Scenario, and optionally, how many to add.
AtRiskFile {On | Off} ["<FilePath>"]Specify a file containing a list of satellites, by SSC number, at risk for close approach.

"<FilePath>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information.

GeometricFilters {On | Off}Specify the use of geometry-based filters to reduce the number of objects that need to be considered.
OutOfDate {On | Off} [<NearEarthValue> <DeepSpaceValue>]Specify whether potential victims are to be removed from the LaserCAT analysis if the epoch of an element set is too far outside the analysis interval. <NearEarthValue> and <DeepSpaceValue> are specified in days. Valid values are between 0 and 1.e10 days.
ComputeTriggers the laser clearinghouse analysis. Use the Report and Graph commands to view results.
Routine {SGP4 | Default | <Name>}Specify the implementation of the SGP4 propagator to be used, where SGP4 is the internal SGP4 routine implemented by STK, Default is the propagator selected in the Edit Preferences panel, and <Name> is an installed SGP4 plugin routine, e.g. ASTROSTDS_SGP4_V9.

Astro Standards routines may be available as an option if you have properly configured STK to support it. It is only available if you have obtained the official SGP4 DLL (and related files) from USSF (US Space Force) and performed a minor install procedure. STK provides an interface to the USSF SGP4 routines; contact customer support for more information.

Examples

To set the ERS1 satellite as the target object for the Santiago facility and then show up to 25 victims in the 2D Graphics window:

LaserCAT */Facility/Santiago TargetObject Satellite/ERS1 AddVictims On 25

To set values for and compute the laser clearinghouse analysis for the Santiago facility:

LaserCAT */Facility/Santiago StartStop "1 Jun 2004 14:30:00.00" "1 Jun 2004 16:30:00.00" GeometricFilters Off Compute

To set the routine to SGP4 for the facility:

LaserCAT */Facility/Facility1 Routine SGP4

Return message

Group membership

This command belongs to the following group(s):

CAT

Version

11.6