Description | Example | Return Message | Group

Radar Antenna

Set the antenna properties of a radar (Deprecated Command)

Syntax

Radar <RdrObjectPath> Antenna {AntennaType} <Parameters>

ATTENTION: THIS COMMAND IS DEPRECATED and has been replaced by:

Radar

Description

Note: This command was deprecated in STK 10.1, it should no longer be used. This command has been replaced by the Radar command.

The Radar Connect commands were enhanced in STK 10.1 to make use of attributes and to simplify the format required to use these commands. For more information on using the new format see Transitioning to the New Radar Format.

The Radar module features several analytical antenna models for your use. The Radar Antenna command allows you to set the model and associated parameters needed to use any of these models.

Available options for {AntennaType} and associated <Parameters> are:

{AntennaType} <Parameters> Description
Gaussian <Efficiency> <Value1> [{ComputeOption}]

<Efficiency> is between 0.001 and 1.0

{ComputeOption} can be Size, BeamWidth or MaxGain

If {ComputeOption} is Size, then <Value1> is the dimension entered in small distance units, between 0.001 and 1000 meters

If {ComputeOption} is BeamWidth, then <Value1> is the beamwidth entered in degrees, between 0.001 and 90 deg

If {ComputeOption} is MaxGain, then <Value1> is the gain entered in dB, between 0.0 and 1000

Parabolic
SquareHorn
RectangularPattern <SideLobeGain> <Value1> <Value2> {ComputeOption}

<SideLobeGain> is entered in dB, between -500.0 and -3.0

{ComputeOption} can be MainLobeGain, Azimuth or Elevation

If {ComputeOption} is MainLobeGain,then <Value1> and <Value2> are azimuth and elevation
If {ComputeOption} is Azimuth, then <Value1> and <Value2> are elevation and main lobe gain
If {ComputeOption} is Elevation, then <Value1> and <Value2> are azimuth and main lobe gain

Azimuth and Elevation values are entered in degrees, between 0.001 and 90.0.

Main lobe gain value is entered in dB, between -500.0 and 1000.0.

PencilBeam <MainLobeGain> <SideLobeGain> [<MaxAngle> {GainEffects}]

<MainLobeGain> is entered in dB greater than 0.0

<SideLobeGain> is entered in dB less than 0.0

<MaxAngle> is entered in degrees between 0.0 and 180.0

{GainEffects} can be On or Off

Warning: <MaxAngle> and {GainEffects} should only be specified if you're running STK Radar version 1.0. These parameters should not be used for later versions of Radar.

External "<FilePath>" "<FilePath>", is the full path and file name for the antenna pattern file.
Dipole <Efficiency> <Length>

<Efficiency> is between 0.0 and 1.0

<Length> is entered in Connect distance units, between 0.001 and 1000000.0 meters.

CosecantSquared <Alpha1> <Alpha2> {<AzimuthBeamwidth> <AlphaMAngle> | <AzimuthStart> <AzimuthStop> <Elevation>} <MainLobeGain> <SideLobeGain> <Efficiency>

<Alpha1> is entered in degrees, between 0.0 and 90.0

<Alpha2> is entered in degrees, between 0.0 and 90.0

<AzimuthBeamwidth> is entered in degrees, between 0.0 and 60.0

<AlphaMAngle> is entered in degrees, between 0.0 and 90.0

<AzimuthStart> is entered in degrees, between 0.0 and 360.0

<AzimuthStop> is entered in degrees, between 0.0 and 360.0

<Elevation> is entered in degrees, between 0.0 and 90.0

<MainLobeGain> is entered in dB, between -500.0 and 1000.0

<SideLobeGain> is entered in dB, between -500.0 and 0.0

<Efficiency> is between 0.0 and 1.0

Aperture {ApertureType} <ApertureParameters> See table below for Aperture description

If {AntennaType} is Aperture, {ApertureType} and associated <ApertureParameters> can be:

{ApertureType} <ApertureParameters>
Cosine {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <Efficiency> [<BackLobeGain>]
CosSquare {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <Efficiency> [<BackLobeGain>]
CosPedestal {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <EdgePedestal> <Efficiency> [<BackLobeGain>]
CosSqrPedestal {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <EdgePedestal> <Efficiency> [<BackLobeGain>]
SincPowerN {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <Power> <Efficiency> [<BackLobeGain>]
SincPowerX {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <Power> <Efficiency> [<BackLobeGain>]
UniformRectangular {Dimension | BeamWidth} <XValue> <YValue> <MainLobeGain> <Efficiency> [<BackLobeGain>]
UniformCircular {Dimension | BeamWidth} <XValue> <MainLobeGain> <EdgePedestal> <Power> <Efficiency> [<BackLobeGain>]
CircularBesselEnvelope {Dimension | BeamWidth} <XValue> <MainLobeGain> <EdgePedestal> <Power> <Efficiency> [<BackLobeGain>]

If Dimension is entered then <XValue> and <YValue> are entered in Connect distance units, and should be between 0.01 and 1000.0 meters.

If BeamWidth is entered then <XValue> and <YValue> are entered in degrees. <XValue> should be between 0.001 and 90.0. <YValue> should be between 0.0 and 90.0.

Note: To define a Circular Aperture set <YValue> to 0.0

<MainLobeGain> is entered in dB, between 0.0 and 1000.0

<EdgePedestal> is entered in dB, between -300.0 and 0.0

<Efficiency> should be between 0.0 and 1.0

<Power> for SincPowerN and SincPowerX should be between 1.0 and 10.0

<Power> for UniformCircular and CircularBesselEnvelope should be between 0.0 and 3.0.

For SincPowerN, UniformCircular and CircularBesselEnvelope apertures the <Power> value entered will be rounded down to the nearest integer.

The user can optionally enter a <BackLobeGain> value. This value is entered in dB and should be between -1000.0 and 1000.0. If not entered then the default -30 dB is used.

Example

To set a square horn antenna type for the TestRadar with an efficiency of 0.4 and a dimension of 1.3 m:

Radar */Facility/Customer/Radar/TestRadar Antenna SquareHorn 0.4 1.3

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Radar

Deprecated Commands

Version

10.1

STK Programming Interface 11.0.1