Description | Example | Return Message | Group

Radar

Set, add and remove properties for a radar.

Syntax

Radar <RdrObjectPath> {Options} <AttributePath> [<Value>] [<Unit>]

Related Commands

Description

The Radar command allows you to define the basic properties of the specified radar. This command replaces the Radar Define command, which has been deprecated.

Valid values for {Options} are SetValue, AddItem, and RemoveItem.

The <AttributePath> specifies the attribute to be set, added to or removed from. Use the Radar_RM GetValue command to return a list of attributes, or the properties and choices for a specific attribute.

The <Value> parameter is entered if {Options} is SetValue or RemoveItem.

The following table further describes the {Options}.

{Options} Description
SetValue Use to set the <AttributePath> to the <Value>. Include the <Unit> if specifying a numeric value in a unit other than the internal unit for the attribute.
AddItem Used to add an additional item to a list that is pointed to by <AttributePath>. If the <AttributePath> does not point to a list, this command returns NACK.

When adding to an ObjectList you must also include: TruncPath <TruncObjPath> following the <AttributePath>. Object list attribute paths include:

  • Model.Jamming.Jammers.ObjectList
  • Model.BistaticTransmitterSelectionStrategy.BistaticTransmitters.ObjectList
  • Model.BistaticReceiverSelectionStrategy.BistaticReceivers.ObjectList
RemoveItem Used to remove an item from the list pointed to by <AttributePath> and the given index specified in <Value>. The index values begin at 0.

Alternatively, when removing an item from an ObjectList the <Value> can be: TruncPath <TruncObjPath> to indicate which list item to be removed.

Use this command in conjunction with the Radar_RM command, which will return a list of attributes, or the properties and choices for a specific attribute.

Example

Use the Radar_RM GetValue command, specifying the Model attribute with the Choices option to get the names of available Radar models:

Radar_RM */Facility/Facility1/Radar/Radar1 GetValue Model:Choices

Bistatic_Receiver
Bistatic_Transmitter
Monostatic

Example

Use the Radar command with the SetValue option to set the Radar model to Monostatic; then set the value of the Power and Frequency attributes. For numeric values include the abbreviation of the unit that the value is being entered in, if it is different from the internal unit:

Radar */Facility/Facility1/Radar/Radar1 SetValue Model Monostatic

Radar */Facility/Facility1/Radar/Radar1 SetValue Model.Transmitter.Power 45.0

Radar */Facility/Facility1/Radar/Radar1 SetValue Model.Transmitter.Frequency 2.8 GHz

Example

To change the orientation attributes of the Radar Antenna:

Radar */Satellite/Satellite1/Radar/Rdr_S1 SetValue Model.AntennaControl.Orientation.AzimuthAngle 23.4 deg

Radar */Satellite/Satellite1/Radar/Rdr_S1 SetValue Model.AntennaControl.Orientation.ElevationAngle 51 deg

Radar */Satellite/Satellite1/Radar/Rdr_S1 SetValue Model.AntennaControl.Orientation.AboutBoresight Rotate

To check the orientation values you've set:

Radar_RM */Satellite/Satellite1/Radar/Rdr_S1 GetValue Model.AntennaControl.Orientation

Model.AntennaControl.Orientation = Azimuth Elevation
Model.AntennaControl.Orientation.AzimuthAngle = 0.40840704 rad
Model.AntennaControl.Orientation.ElevationAngle = 0.89011792 rad
Model.AntennaControl.Orientation.AboutBoresight = Rotate
Model.AntennaControl.Orientation.XPositionOffset = 0 m
Model.AntennaControl.Orientation.YPositionOffset = 0 m
Model.AntennaControl.Orientation.ZPositionOffset = 0 m

Example

Enable jamming, and add a jamming object to a radar:

Radar */Facility/Facility1/Radar/Radar1 SetValue Model.Jamming.Enabled true

Radar */Facility/Facility1/Radar/Radar1 AddItem Model.Jamming.Jammers.ObjectList TruncPath Satellite/Satellite1/Radar/Rdr_S1

To check the jamming values you've set:

Radar_RM */Facility/Facility1/Radar/Radar1 GetValue Model.Jamming

Model.Jamming.Enabled = true
Model.Jamming.Jammers.ObjectList[0] = Satellite/Satellite1/Radar/Rdr_S1

Remove the jamming object from the radar.

Radar */Facility/Facility1/Radar/Radar1 RemoveItem Model.Jamming.Jammers.ObjectList TruncPath Satellite/Satellite1/Radar/Rdr_S1

Example

Add an item to the GainLoss list:

Radar */Satellite/Satellite1/Radar/Radar1 AddItem Model.Receiver.AdditionalGainsLosses.GainLossList

To see the gain/loss parameters:

Radar_RM */Satellite/Satellite1/Radar/Radar1 GetValue Model.Receiver.AdditionalGainsLosses

Model.Receiver.AdditionalGainsLosses.GainLossList[0].Identifier = Misc.
Model.Receiver.AdditionalGainsLosses.GainLossList[0].Gain = 1.00000000 units
Model.Receiver.AdditionalGainsLosses.TotalGain = 1.00000000 units (Read-only)

To set the gain/loss parameters:

Radar */Satellite/Satellite1/Radar/Radar1 SetValue Model.Receiver.AdditionalGainsLosses.GainLossList[0].Identifier Abc

Radar */Satellite/Satellite1/Radar/Radar1 SetValue Model.Receiver.AdditionalGainsLosses.GainLossList[0].Gain 10.05

To remove item 0 from the gain/loss list:

Radar */Satellite/Satellite1/Radar/Radar1 RemoveItem Model.Receiver.AdditionalGainsLosses.GainLossList 0

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Radar

Version

10.1

STK Programming Interface 11.0.1