RCS
Set and modify RCS values for an object
Syntax
RCS <ObjectPath> {Options} <Parameters>
Related Commands
Description
Set and modify Radar Cross Section (RCS) values for an object.
Valid values for {Options} are SetValue, AddFrequencyBand, RemoveFrequencyBand.
The following table further describes each {Options}.
| {Options} | <Parameters> | Description |
|---|---|---|
| SetValue | <AttributePath> <Value> [<Unit>] | 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. |
| AddFrequencyBand | MinFrequency <MinFreq> MaxFrequency <MaxFreq> | Used to add an additional frequency band. Specify the minimum and maximum frequency of the new band.
The minimum value must be greater than 2.99792e6 Hz and less than the maximum value. The maximum value must be less than 3.0e11 Hz. |
| RemoveFrequencyBand | <MinFreq> | Used to remove a frequency band The <MinFreq> specifies the minimum frequency of the band to be removed. |
Use this command in conjunction with the RCS_RM command, which will return a list of attributes, or the properties and choices for a specific attribute.
Example
First use the RCS_RM GetValue command to get the attributes for the Satellite RCS:
RCS_RM */Satellite/Satellite1 GetValue
UserComment = STK Radar RCS Extension
Inherit = true
Use the RCS SetValue command to set the Inherit attribute to false, then use the RCS_RM GetValue command to see what we have:
RCS */Satellite/Satellite1 SetValue Inherit false
RCS_RM */Satellite/Satellite1 GetValue
UserComment = STK Radar RCS Extension
Inherit = false
Model = Radar_Cross_Section
Model.UserComment = Radar Cross Section
Model.FrequencyBandList[0].MinFrequency = 2997920.00000000 Hz (Read-only)
Model.FrequencyBandList[0].MaxFrequency = 300000000000.00000000 Hz (Read-only)
Model.FrequencyBandList[0].ComputeType = Constant Value (Read-only)
Model.FrequencyBandList[0].ComputeTypeStrategy = Constant Value
Model.FrequencyBandList[0].ComputeTypeStrategy.ConstantValue = 1.00000000 sqm
Model.FrequencyBandList[0].SwerlingCase = 0
Model.BandInsertParameters.MinFrequency = 2997920.00000000 Hz
Model.BandInsertParameters.MaxFrequency = 300000000000.00000000 Hz
First let's change the minimum frequency. We see from the above output that the default units are Hz, but we want to enter the value in MHz. So we include the unit abbreviation after the frequency value:
RCS */Satellite/Satellite1 SetValue Model.BandInsertParameters.MinFrequency 2.99998 MHz
If we entered the frequency value in the default units, then we wouldn't need to include the unit abbreviation:
RCS */Satellite/Satellite1 SetValue Model.BandInsertParameters.MinFrequency 2999980.00
Let's check the frequency value. Use the RCS_RM GetValue command with the attribute name; note that the frequency will be displayed in the default units no matter how we entered it:
RCS_RM */Satellite/Satellite1 GetValue Model.BandInsertParameters.MinFrequency
Model.BandInsertParameters.MinFrequency = 2999980.00000000 Hz
Let's add a frequency band using the RCS AddFrequencyBand command:
RCS */Satellite/Satellite1 AddFrequencyBand MinFrequency 4.0e6 MaxFrequency 5.0e6
Frequency bands are accessed via their index in the list, starting with 0. Let's look at our list:
RCS_RM */Satellite/Satellite1 GetValue Model.FrequencyBandList
Our new Frequency band (whose index is 1) split the initial band in half, so there are now 3 bands. Showing just the band frequencies from the RCS_RM GetValue command output we can see this.
Model.FrequencyBandList[0].MinFrequency = 2997920.00000000 Hz (Read-only)
Model.FrequencyBandList[0].MaxFrequency = 4000000.00000000 Hz (Read-only)
...
Model.FrequencyBandList[1].MinFrequency = 4000000.00000000 Hz
Model.FrequencyBandList[1].MaxFrequency = 5000000.00000000 Hz (Read-only)
...
Model.FrequencyBandList[2].MinFrequency = 5000000.00000000 Hz
Model.FrequencyBandList[2].MaxFrequency = 300000000000.00000000 Hz (Read-only)
...
We want to change the SwerlingCase for our new frequency band. First we'll use the RCS_RM GetValues command with the Choices property to see what our options are:
RCS_RM */Satellite/Satellite1 GetValue Model.FrequencyBandList[1].SwerlingCase:Choices
0
I
II
III
IV
Set the SwerlingCase attribute for the FrequencyBand we added:
RCS */Satellite/Satellite1 SetValue Model.FrequencyBandList[1].SwerlingCase III
To check the value we've set:
RCS_RM */Satellite/Satellite1 GetValue Model.FrequencyBandList[1].SwerlingCase
Model.FrequencyBandList[1].SwerlingCase = III
To remove the frequency band we added use the RCS RemoveFrequencyBand command and specify the minimum frequency:
RCS */Satellite/Satellite1 RemoveFrequencyBand 4.0e6
Example
Use the RCS command to set an external RCS file.
Use the RCS SetValue command to set the Inherit attribute to false, then use the RCS_RM GetValue command to see what we have:
RCS */Satellite/Satellite1 SetValue Inherit false
RCS_RM */Satellite/Satellite1 GetValue
UserComment = STK Radar RCS Extension
Inherit = false
Model = Radar_Cross_Section
Model.UserComment = Radar Cross Section
Model.FrequencyBandList[0].MinFrequency = 2997920.00000000 Hz (Read-only)
Model.FrequencyBandList[0].MaxFrequency = 300000000000.00000000 Hz (Read-only)
Model.FrequencyBandList[0].ComputeType = Constant Value (Read-only)
Model.FrequencyBandList[0].ComputeTypeStrategy = Constant Value
Model.FrequencyBandList[0].ComputeTypeStrategy.ConstantValue = 1.00000000 sqm
Model.FrequencyBandList[0].SwerlingCase = 0
Model.BandInsertParameters.MinFrequency = 2997920.00000000 Hz
Model.BandInsertParameters.MaxFrequency = 300000000000.00000000 Hz
Use the RCS_RM GetValue command with the Choices property to see what the options are for the ComputeTypeStategy attribute:
RCS_RM */Satellite/Satellite1 GetValue Model.FrequencyBandList[0].ComputeTypeStategy:Choices
Constant Value
External File
Script Plugin
Use the RCS SetValue command to set the ComputeTypeStategy attribute to External File:
RCS */Satellite/Satellite1 SetValue Model.FrequencyBandList[0].ComputeTypeStategy "External File"
Use the RCS_RM GetValue command to get the FrequencyBandList attributes:
RCS_RM */Satellite/Satellite1 GetValue Model.FrequencyBandList
Model.FrequencyBandList[0].MinFrequency = 2997920.00000000 Hz (Read-only)Use the SetValue command to set the Filename attribute:
Model.FrequencyBandList[0].MaxFrequency = 300000000000.00000000 Hz (Read-only)
Model.FrequencyBandList[0].ComputeType = External File (Read-only)
Model.FrequencyBandList[0].ComputeTypeStrategy = External File
Model.FrequencyBandList[0].ComputeTypeStrategy.Filename = <empty>
Model.FrequencyBandList[0].SwerlingCase = 0
RCS */Satellite/Satellite1 SetValue Model.FrequencyBandList[0].ComputeTypeStategy.Filename "c:/Path/To/Aircraft_RCS.rcs"
ReturnMessage
Group Membership
This command belongs to the following group(s):
Version
10.1
Visit AGI.com