Description

Satellite properties.

Object Model

Public Methods

IsAttitudeTypeSupported	Get a value indicating whether the specified type can be used.
IsPropagatorTypeSupported	Gets a value indicating whether the specified type can be used.
SetAttitudeType	Sets the attitude type.
SetPropagatorType	Sets the propagator type.

Public Properties

AccessConstraints	Get the constraints imposed on the satellite.
Attitude	Get the Attitude properties of the satellite.
AttitudeSupportedTypes	Return an array of valid choices.
AttitudeType	The type of the satellite's attitude.
EclipseBodies	Get the customized list of Eclipse Bodies, which are central bodies used in lighting computations.
ExportTools	Returns the IAgSaExportTools interface.
Graphics	Get the 2D Graphics properties of the satellite.
GroundEllipses	Get the Ground Ellipses properties of the satellite.
MassProperties	Get the Mass properties of the satellite.
PassBreak	Get the Pass Break properties of the satellite.
Propagator	Get information for the propagator.
PropagatorSupportedTypes	Returns an array of valid choices.
PropagatorType	The type of propagator used to define the satellite's orbit.
RadarClutterMap	Returns the radar clutter map.
RadarCrossSection	Returns the radar cross sectoin.
ReferenceVehicle	Get the reference vehicle of the satellite.
SpaceEnvironment	Get the SpaceEnvironment properties of the satellite.
VO	Get the 3D Graphics properties of the satellite.

Example

Create a satellite (on current scenario central body)

[C#] Copy Code

// Create the Satellite 


IAgSatellite satellite = root.CurrentScenario.Children.New(AgESTKObjectType.eSatellite, "MySatellite") as IAgSatellite;

Create a satellite from the satellite database

[C#] Copy Code

// Get STK database location using Connect 


<a href="STKUtil.chm::/STKUtil~AgExecCmdResult.html">AgExecCmdResult</a> result = root.ExecuteCommand("GetDirectory / Database Satellite"); 


string satDataDir = result[0]; 


string filelocation = "\"" + Path.Combine(satDataDir, @"stkAllTLE.sd") + "\""; 


string commonname = "\"hst\""; 


 

// Import object from database using Connect 


string command = String.Format("ImportFromDB * Satellite {0} Constellation ImportedFromSatDB Propagate On CommonName {1}", filelocation, commonname); 


root.ExecuteCommand(command);

Set the satellite to use the J2 propagator

[C#] Copy Code

// Set propagator to J2 Perturbation 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorJ2Perturbation); 


 

// Get the J2 Perturbation propagator 


IAgVePropagatorJ2Perturbation propagator = satellite.Propagator as IAgVePropagatorJ2Perturbation;

Set the satellite to use the GPS propagator

[C#] Copy Code

// Set propagator to GPS 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorGPS); 


 

// Get the GPS propagator 


IAgVePropagatorGPS propagator = satellite.Propagator as IAgVePropagatorGPS;

Set the satellite to use the STK External propagator

[C#] Copy Code

// Set propagator to STK External 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorStkExternal); 


 

// Get the STK External propagator 


IAgVePropagatorStkExternal propagator = satellite.Propagator as IAgVePropagatorStkExternal;

Set the satellite to use the SGP4 propagator

[C#] Copy Code

// Set propagator to SGP4 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorSGP4); 


 

// Get the SGP4 propagator 


IAgVePropagatorSGP4 propagator = satellite.Propagator as IAgVePropagatorSGP4;

Set the satellite to use the SPICE propagator

[C#] Copy Code

// Set propagator to SPICE 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorSPICE); 


 

// Get the SPICE propagator 


IAgVePropagatorSPICE propagator = satellite.Propagator as IAgVePropagatorSPICE;

Set the satellite to use the LOP propagator

[C#] Copy Code

// Set satellite propagator to LOP 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorLOP); 


 

// Get the LOP propagator 


IAgVePropagatorLOP propagator = satellite.Propagator as IAgVePropagatorLOP;

Set the satellite to use the HPOP propagator

[C#] Copy Code

// Set satellite propagator to HPOP 


satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorHPOP); 


 

// Get the HPOP propagator 


IAgVePropagatorHPOP propagator = satellite.Propagator as IAgVePropagatorHPOP;

Create a satellite (on current scenario central body)

[Visual Basic .NET] Copy Code

' Create
the Satellite

Dim satellite As IAgSatellite =
TryCast(root.CurrentScenario.Children.[New](AgESTKObjectType.eSatellite,
"MySatellite"), IAgSatellite)

Create a satellite from the satellite database

[Visual Basic .NET] Copy Code

' Get
STK database location using Connect

Dim result As AgExecCmdResult =
root.ExecuteCommand("GetDirectory / Database
Satellite")

Dim satDataDir As String =
result(0)

Dim filelocation As String =
"""" +
Path.Combine(satDataDir, "stkAllTLE.sd") + """"

Dim commonname As String =
"""hst"""



' Import object from database using
Connect

Dim command As String =
[String].Format("ImportFromDB * Satellite {0}
Constellation ImportedFromSatDB Propagate On CommonName
{1}", filelocation, commonname)

root.ExecuteCommand(command)

Set the satellite to use the J2 propagator

[Visual Basic .NET] Copy Code

' Set
propagator to J2 Perturbation

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorJ2Perturbation)




' Get the J2 Perturbation
propagator

Dim propagator As IAgVePropagatorJ2Perturbation =
TryCast(satellite.Propagator, IAgVePropagatorJ2Perturbation)

Set the satellite to use the GPS propagator

[Visual Basic .NET] Copy Code

' Set
propagator to GPS

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorGPS)



' Get the GPS propagator

Dim propagator As IAgVePropagatorGPS =
TryCast(satellite.Propagator, IAgVePropagatorGPS)

Set the satellite to use the STK External propagator

[Visual Basic .NET] Copy Code

' Set
propagator to STK External

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorStkExternal)




' Get the STK External propagator

Dim propagator As IAgVePropagatorStkExternal =
TryCast(satellite.Propagator, IAgVePropagatorStkExternal)

Set the satellite to use the SGP4 propagator

[Visual Basic .NET] Copy Code

' Set
propagator to SGP4

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorSGP4)




' Get the SGP4 propagator

Dim propagator As IAgVePropagatorSGP4 =
TryCast(satellite.Propagator, IAgVePropagatorSGP4)

Set the satellite to use the SPICE propagator

[Visual Basic .NET] Copy Code

' Set
propagator to SPICE

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorSPICE)




' Get the SPICE propagator

Dim propagator As IAgVePropagatorSPICE =
TryCast(satellite.Propagator, IAgVePropagatorSPICE)

Set the satellite to use the LOP propagator

[Visual Basic .NET] Copy Code

' Set
satellite propagator to LOP

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorLOP)



' Get the LOP propagator

Dim propagator As IAgVePropagatorLOP =
TryCast(satellite.Propagator, IAgVePropagatorLOP)

Set the satellite to use the HPOP propagator

[Visual Basic .NET] Copy Code

' Set
satellite propagator to HPOP

satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorHPOP)




' Get the HPOP propagator

Dim propagator As IAgVePropagatorHPOP =
TryCast(satellite.Propagator, IAgVePropagatorHPOP)

Create a satellite (on the current scenario central body)

[MATLAB] Copy Code

% IAgStkObjectRoot root: STK Object Model Root 


satellite = root.CurrentScenario.Children.New('eSatellite', 'MySatellite');

Set satellite attitude basic spinning

[MATLAB] Copy Code

% IAgSatellite satellite: Satellite object 


basic = satellite.Attitude.Basic; 

basic.SetProfileType('eProfileSpinning') 

basic.Profile.Body.AssignXYZ(0,0,1) 

basic.Profile.Inertial.AssignXYZ(0,1,0); 

basic.Profile.Rate = 6;  % rev/sec

Set satellite attitude targeting

[MATLAB] Copy Code

% IAgSatellite satellite: Satellite object 


attitudePointing = satellite.Attitude.Pointing; 

attitudePointing.UseTargetPointing = 1; 

attitudePointing.Targets.RemoveAll; 

attitudePointing.Targets.Add('AreaTarget/MyAreaTarget'); 

attitudePointing.TargetTimes.UseAccessTimes;

Set satellite attitude external

[MATLAB] Copy Code

% IAgSatellite satellite: Satellite object 


satellite.Attitude.External.Load('C:\Program Files\AGI\STK 11\Help\stktraining\text\AttitudeTimeEulerAngles_Example.a');

CoClasses that Implement IAgSatellite

Name
AgSatellite

AGI STK Objects 11	Send comments on this topic.
IAgSatellite Interface