STK ObjectsSend comments on this topic.
IAgAircraft Interface

Description

Interface for aircraft object.

Public Properties

Public Property ChainAnalysisOptionsGet the aircraft's chain analysis options.
Public Property ExportToolsReturns the IAgAcExportTools interface.
Public Property GetEOIRGet the EOIR properties of the aircraft.
Public Property GraphicsGet the aircraft's 2D Graphics properties.
Public Property LaserEnvironmentGets the laser environment.
Public Property LightingMaxStepCbShapeGets or sets the maximum step size to use when computing lighting when UseTerrainInLightingComputations is false. Uses Time Dimension.
Public Property LightingMaxStepTerrainGets or sets the maximum step size to use when computing lighting when UseTerrainInLightingComputations is true. Uses Time Dimension.
Public Property RadarCrossSectionReturns the radar cross sectoin.
Public Property RFEnvironmentGets the RF environment.
Public Property VOGet the aircraft's 3D Graphics properties.

Interfaces

CoClasses that Implement IAgAircraft

Example

Set an aircraft to use Great Arc propagator
[C#]
// Set ship route to great arc
aircraft.SetRouteType(AgEVePropagatorType.ePropagatorGreatArc);

// Retrieve propagator interface
IAgVePropagatorGreatArc propagator = aircraft.Route as IAgVePropagatorGreatArc;
Configure an aircraft route using the Great Arc propagator
[C#]
// Set ship route to great arc
aircraft.SetRouteType(AgEVePropagatorType.ePropagatorGreatArc);

// Retrieve propagator interface
IAgVePropagatorGreatArc propagator = aircraft.Route as IAgVePropagatorGreatArc;
propagator.ArcGranularity = 51.333;

// Set Ref type to WayPtAltRefTerrain and retreive IAgVeWayPtAltitudeRefTerrain interface
propagator.SetAltitudeRefType(AgEVeAltitudeRef.eWayPtAltRefTerrain);
IAgVeWayPtAltitudeRefTerrain altRef = propagator.AltitudeRef as IAgVeWayPtAltitudeRefTerrain;
altRef.Granularity = 51.33;
altRef.InterpMethod = AgEVeWayPtInterpMethod.eWayPtEllipsoidHeight;

propagator.Method = AgEVeWayPtCompMethod.eDetermineTimeAccFromVel;

// Add waypoints
IAgVeWaypointsElement point1 = propagator.Waypoints.Add();
point1.Latitude = 39.7674;
point1.Longitude = -79.7292;
point1.Altitude = 3.0;
point1.Speed = 0.0772;

IAgVeWaypointsElement point2 = propagator.Waypoints.Add();
point2.Latitude = 38.3721;
point2.Longitude = -120.1160;
point2.Altitude = 3.0;
point2.Speed = 0.0772;

// Propagate
propagator.Propagate();
Set an aircraft to use Great Arc propagator
[Visual Basic .NET]
' Set ship route to great arc
aircraft.SetRouteType(AgEVePropagatorType.ePropagatorGreatArc)

' Retrieve propagator interface
Dim propagator As IAgVePropagatorGreatArc = TryCast(aircraft.Route, IAgVePropagatorGreatArc)
Configure an aircraft route using the Great Arc propagator
[Visual Basic .NET]
' Set ship route to great arc
aircraft.SetRouteType(AgEVePropagatorType.ePropagatorGreatArc)

' Retrieve propagator interface
Dim propagator As IAgVePropagatorGreatArc = TryCast(aircraft.Route, IAgVePropagatorGreatArc)
propagator.ArcGranularity = 51.333

' Set Ref type to WayPtAltRefTerrain and retreive IAgVeWayPtAltitudeRefTerrain interface
propagator.SetAltitudeRefType(AgEVeAltitudeRef.eWayPtAltRefTerrain)
Dim altRef As IAgVeWayPtAltitudeRefTerrain = TryCast(propagator.AltitudeRef, IAgVeWayPtAltitudeRefTerrain)
altRef.Granularity = 51.33
altRef.InterpMethod = AgEVeWayPtInterpMethod.eWayPtEllipsoidHeight

propagator.Method = AgEVeWayPtCompMethod.eDetermineTimeAccFromVel

' Add waypoints
Dim point1 As IAgVeWaypointsElement = propagator.Waypoints.Add()
point1.Latitude = 39.7674
point1.Longitude = -79.7292
point1.Altitude = 3
point1.Speed = 0.0772

Dim point2 As IAgVeWaypointsElement = propagator.Waypoints.Add()
point2.Latitude = 38.3721
point2.Longitude = -120.116
point2.Altitude = 3
point2.Speed = 0.0772

' Propagate
propagator.Propagate()
Create a New Aircraft (on the current scenario central body)
[Python - STK API]
# IAgStkObjectRoot root: STK Object Model root
aircraft = root.CurrentScenario.Children.New(AgESTKObjectType.eAircraft, 'MyAircraft')
Set Great Arc Propagator and Add Individual Waypoints to Aircraft
[Python - STK API]
# IAgAircraft aircraft: Aircraft object
# Set route to great arc, method and altitude reference
aircraft.SetRouteType(AgEVePropagatorType.ePropagatorGreatArc)
route = aircraft.Route
route.Method = AgEVeWayPtCompMethod.eDetermineTimeAccFromVel
route.SetAltitudeRefType(AgEVeAltitudeRef.eWayPtAltRefMSL)
# Add first point
waypoint = route.Waypoints.Add()
waypoint.Latitude = 37.5378
waypoint.Longitude = 14.2207
waypoint.Altitude = 5  # km
waypoint.Speed = .1    # km/sec
# Add second point
waypoint2 = route.Waypoints.Add()
waypoint2.Latitude = 47.2602
waypoint2.Longitude = 30.5517
waypoint2.Altitude = 5  # km
waypoint2.Speed = .1    # km/sec
# Propagate the route
route.Propagate()
Add Array of Waypoints to Aircraft
[Python - STK API]
# IAgAircraft aircraft: Aircraft object
route = aircraft.Route
ptsArray = [[37.5378, 14.2207, 3.0480, 0.0772, 2], [47.2602, 30.5517, 3.0480, 0.0772, 2]]
route.SetPointsSmoothRateAndPropagate(ptsArray)
# Propagate the route
route.Propagate()
Set the Attitude of the Aircraft
[Python - STK API]
# IAgAircraft aircraft: Aircraft object
aircraft.Attitude.Basic.SetProfileType(AgEVeProfile.eCoordinatedTurn)
Create a New Aircraft (on the current scenario central body)
[MATLAB]
% IAgStkObjectRoot root: STK Object Model root
aircraft = root.CurrentScenario.Children.New('eAircraft', 'MyAircraft');
Set aircraft to use Realtime propagator
[MATLAB]
% IAgStkObjectRoot root: STK Object Model root
% IAgAircraft aircraft: Aircraft object
% Set route to Realtime
aircraft.SetRouteType('ePropagatorRealtime');
% Set up real time propagator settings
aircraft.Route.TimeStep = 1; % sec
aircraft.Route.TimeoutGap = 1; % sec
aircraft.Route.Duration.LookAhead = 1; % sec
aircraft.Route.LookAheadPropagator = 'eLookAheadHoldCBFPosition';
aircraft.Route.Propagate();
% Add a realtime waypoint
aircraft.Route.PointBuilder.LLA.AddPosition(root.CurrentTime, 40, -70, 1000);
Set Great Arc Propagator and Add Individual Waypoints to Aircraft
[MATLAB]
% IAgAircraft aircraft: Aircraft object
% Set route to great arc, method and altitude reference
aircraft.SetRouteType('ePropagatorGreatArc');
route = aircraft.Route;
route.Method = 'eDetermineTimeAccFromVel';
route.SetAltitudeRefType('eWayPtAltRefMSL');
% Add first point
waypoint = route.Waypoints.Add();
waypoint.Latitude = 37.5378;
waypoint.Longitude = 14.2207;
waypoint.Altitude = 5;  % km
waypoint.Speed = .1;    % km/sec
% Add second point
waypoint2 = route.Waypoints.Add();
waypoint2.Latitude = 47.2602;
waypoint2.Longitude = 30.5517;
waypoint2.Altitude = 5; % km
waypoint2.Speed = .1;    % km/sec
% Propagate the route
route.Propagate();
Add Array of Waypoints to Aircraft
[MATLAB]
% IAgAircraft aircraft: Aircraft object
route = aircraft.Route;
ptsArray = {37.5378, 14.2207, 3.0480, 0.0772, 2;
            47.2602, 30.5517, 3.0480, 0.0772, 2};
route.SetPointsSmoothRateAndPropagate(ptsArray);
% Propagate the route
route.Propagate();
Set the Attitude of the Aircraft
[MATLAB]
% IAgAircraft aircraft: Aircraft object
aircraft.Attitude.Basic.SetProfileType('eCoordinatedTurn');
Set the Propagator to GreatArc and set the start time
[MATLAB]
% IAgAircraft aircraft: Aircraft object
% Set the propagator to GreatArc
aircraft.SetRouteType('ePropagatorGreatArc');

% Set the start time to a new start time
aircraft.Route.EphemerisInterval.SetExplicitInterval('25 Dec 2019 00:00:00.00', '25 Dec 2019 00:00:00.00'); % stop time computed based on Propagate call
aircraft.Route.Propagate();
© 2025 Analytical Graphics, Inc. All Rights Reserved.