Description

Provides access to the properties and methods used in defining a facility object.

Public Methods

GetAzElMask	Get the az-el mask. A member of the AgEAzElMaskType enumeration.
GetAzElMaskData	Get az-el mask data.
ResetAzElMask	Reset the az-el mask.
SetAzElMask	Set an az-el mask. A member of the AgEAzElMaskType enumeration.

Public Properties

AccessConstraints	Get the constraints imposed on the facility.
AltRef	Gets or sets the altitude reference of the object.
Atmosphere	This property is deprecated. The new RFEnvironment property can be used to configure atmospheric models.
Graphics	Get the 2D Graphics properties of the facility.
HeightAboveGround	Height of facility above its model of the ground. Height is measured along the normal to surface defined by reference ellipsoid of the central body. Facility models the ground as an ellipsoid passing through the ground position. Uses Distance Dimension.
LaserEnvironment	Gets the laser environment.
LightingMaxStep	Gets or sets the maximum step size to use when computing lighting. Only applies (and only can be set) when LightingObstructionModel is eLightingObstructionAzElMask or eLightingObstructionTerrain. Uses Time Dimension.
LightingObstructionModel	Gets or sets the obstruction model used in lighting computations.
LocalTimeOffset	The amount of the time offset from GMT, if this option is used. Uses Time Dimension.
MaxRangeWhenComputingAzElMask	Gets or sets the maximum range to use when computing the az el mask using terrain data. Zero indicates to use algorithm default. Only applies when GetAzElMask returns eTerrainData (cannot be set if eMaskFile). Uses Distance Dimension.
Position	Get the position of the facility.
RadarClutterMap	Returns the radar clutter map.
RadarCrossSection	Returns the radar cross sectoin.
RFEnvironment	Gets the RF environment.
SaveTerrainMaskDataInBinary	Save terrain az-el mask data in binary.
TerrainNorm	Get the normal to the local terrain.
TerrainNormData	Data used in specifying terrain slope.
UseLocalTimeOffset	Opt whether to use a local time offset from GMT.
UseTerrain	Opt whether to set altitude automatically by using terrain data.
VO	Get the 3D Graphics properties of the facility.

Interfaces

Implemented Interface
IAgStkObject
IAgLifetimeInformation
IAgDisplayTm

CoClasses that Implement IAgFacility

Name
AgFacility

Example

Create a facility (on current scenario central body)

[C#]

// Create a facility on current scenario central body
IAgFacility facility = root.CurrentScenario.Children.New(AgESTKObjectType.eFacility, "MyFacility") as IAgFacility;

Create a facility on Earth at lat/lon/alt

[C#]

IAgFacility facility = root.CurrentScenario.Children.NewOnCentralBody(AgESTKObjectType.eFacility, "MyFacility", "Earth") as IAgFacility;

// Assuming unit preferences are set to radians for latitude and longitude and km for distance
facility.Position.AssignPlanetodetic(0.4506, -1.4011, 4);

Create a facility on specified central body at lat/lon/alt

[C#]

IAgFacility facObject = root.CurrentScenario.Children.NewOnCentralBody(AgESTKObjectType.eFacility, "Facility1", "Mars") as IAgFacility;

// Assuming unit preferences are set to radians for latitude and longitude and km for distance
facObject.Position.AssignPlanetodetic(-5.4245, 0.1902, 0);

Create a facility from facility database

[C#]

// Get STK database location using Connect
IAgExecCmdResult result = root.ExecuteCommand("GetDirectory / Database Facility");
string facDataDir = result[0];
string filelocation = Path.Combine(facDataDir, @"stkFacility.fd");

// Import object from database using Connect
string command = "ImportFromDB * Facility \"" + filelocation + "\" Class Facility SiteName Weilheim";
root.ExecuteCommand(command);

IAgFacility facility = root.GetObjectFromPath("Facility/Weilheim") as IAgFacility;

Create a facility (on current scenario central body)

[Visual Basic .NET]

' Create a facility on current scenario central body
Dim facility As IAgFacility = TryCast(root.CurrentScenario.Children.[New](AgESTKObjectType.eFacility, "MyFacility"), IAgFacility)

Create a facility on Earth at lat/lon/alt

[Visual Basic .NET]

Dim facility As IAgFacility = TryCast(root.CurrentScenario.Children.NewOnCentralBody(AgESTKObjectType.eFacility, "MyFacility", "Earth"), IAgFacility)

' Assuming unit preferences are set to radians for latitude and longitude and km for distance
facility.Position.AssignPlanetodetic(0.4506, -1.4011, 4)

Create a facility on specified central body at lat/lon/alt

[Visual Basic .NET]

Dim facObject As IAgFacility = TryCast(root.CurrentScenario.Children.NewOnCentralBody(AgESTKObjectType.eFacility, "Facility1", "Mars"), IAgFacility)

' Assuming unit preferences are set to radians for latitude and longitude and km for distance
facObject.Position.AssignPlanetodetic(-5.4245, 0.1902, 0)

Create a facility from facility database

[Visual Basic .NET]

' Get STK database location using Connect
Dim result As IAgExecCmdResult = root.ExecuteCommand("GetDirectory / Database Facility")
Dim facDataDir As String = result(0)
Dim filelocation As String = Path.Combine(facDataDir, "stkFacility.fd")

' Import object from database using Connect
Dim command As String = "ImportFromDB * Facility """ + filelocation + """ Class Facility SiteName Weilheim"
root.ExecuteCommand(command)

Dim facility As IAgFacility = TryCast(root.GetObjectFromPath("Facility/Weilheim"), IAgFacility)

Create a facility (on the current scenario central body)

[Python - STK API]

# IAgStkObjectRoot root: STK Object Model Root
facility = root.CurrentScenario.Children.New(AgESTKObjectType.eFacility, 'MyFacility')

Set the geodetic position of the facility

[Python - STK API]

# IAgFacility facility: Facility Object
facility.Position.AssignGeodetic(41.9849, 21.4039, 0)  # Latitude, Longitude, Altitude

# Set altitude to height of terrain
facility.UseTerrain = True

# Set altitude to a distance above the ground
facility.HeightAboveGround = .05   # km

Add an AzEl Mask to a Facility

[Python - STK API]

# IAgFacility facility: Facility Object
facility.SetAzElMask(AgEAzElMaskType.eTerrainData, 0)

Create a facility (on the current scenario central body)

[MATLAB]

% IAgStkObjectRoot root: STK Object Model Root
facility = root.CurrentScenario.Children.New('eFacility', 'MyFacility');

Set the geodetic position of the facility

[MATLAB]

% IAgFacility facility: Facility Object
facility.Position.AssignGeodetic(41.9849, 21.4039, 0) % Latitude, Longitude, Altitude

% Set altitude to height of terrain
facility.UseTerrain = true;

% Set altitude to a distance above the ground
facility.HeightAboveGround = .05;   % km

Add an AzEl Mask to a Facility

[MATLAB]

% IAgFacility facility: Facility Object
facility.SetAzElMask('eTerrainData', 0);

STK Objects	Send comments on this topic.
IAgFacility Interface