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
SetValueUse 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.
AddItemUsed 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
RemoveItemUsed 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.

Examples

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

Examples

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

Examples

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

Examples

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

Examples

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

Return message

Group membership

This command belongs to the following group(s):

Radar

Version

10.1