Description | Example | Return message | Group

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.
AddFrequencyBandMinFrequency <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 = 0
Use 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):

Facilities, Places & Targets

Scenarios

Vehicles

Version

10.1