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.
Examples
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
Examples
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) 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 = 0Use the SetValue command to set the Filename attribute:
RCS */Satellite/Satellite1 SetValue Model.FrequencyBandList[0].ComputeTypeStategy.Filename "c:/Path/To/Aircraft_RCS.rcs"
Return message
Group membership
This command belongs to the following group(s):
Version
10.1