Set, add and remove properties for a radar.
Radar <RdrObjectPath> {Options} <AttributePath> [<Value>] [<Unit>]
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:
|
| 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.
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
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
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
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
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
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1