Description | Example | Return message | Group

CommSystem

Set or modify options for a CommSystem.

Syntax

CommSystem <CommSystemPath> {Options} [<Parameters>]

Related commands

Description

The CommSystem command allows you to specify the values of a specific CommSystem as pointed to by a specific attribute.

Valid values for {Options} are SetValue, AddItem, RemoveItem, Compute, and Clear.

The <AttributePath> specifies the attribute to be set, added to, or removed from. Use the CommSystem_RM GetValue command to return either a list of attributes or the properties and choices for a specific attribute.

When entering a numeric value, include the <Unit> to specify the abbreviation of the unit that the numeric value is being entered in. If not included, then the <Value> is assumed to be in the internal units.

The following table further describes the {Options}.

{Options}<Parameters>Description
SetValue<AttributePath> <Value> [<Unit>]Use this 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<AttributePath> <Value> [<Unit>]This is used to add an 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 a list of STK Objects, <Value> is TruncPath <TruncObjPath> following the <AttributePath>. STK Object list attribute paths include:

  • Transmitters
  • Receivers
  • InterferenceSources
RemoveItem<AttributePath> <Value>Use this 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 a list of STK Objects, the <Value> is TruncPath <TruncObjPath> to indicate which list item to remove.

Compute[NOW]Use this to calculate link and interference data for a Comm System.

The Compute command may take some time to complete calculations, depending on the number of objects in the Comm System and the time interval selected.

You can force a compute by specifying the optional NOW parameter. Otherwise, this command will set the compute flag and the actual compute will be carried out later (e.g., before report generation).

ClearN/AUse this to clear the compute cache and thus clear the graphics when the graphics are refreshed. The next time a CommSystem report is requested, the CommSystem will recompute.

Use the CommSystem command in conjunction with the CommSystem_RM GetValue command, which will return either a list of attributes or the properties and choices for a specific attribute.

Examples

To set the CommSystem Role to Transmit, add transmitters, and set the step size to half a minute, use the following commands:

CommSystem */CommSystem/CommSystem1 SetValue ConstrainingRole Transmit

CommSystem */CommSystem/CommSystem1 AddItem Transmitters TruncPath Constellation/Constellation3

CommSystem */CommSystem/CommSystem1 SetValue StepSize 0.5 min

Examples

To set the access option aberration type attribute, first use the CommSystem_RM GetValue command with the Choices option on the "AccessOptions.AberrationType" attribute to get the names of valid aberration types:

CommSystem_RM */CommSystem/CommSystem1 GetValue AccessOptions.AberrationType:Choices

Annual

None

Total

Then set the access option aberration type attribute as follows:

CommSystem */CommSystem/CommSystem1 SetValue AccessOptions.AberrationType "Total"

Examples

To clear and then force CommSystem1 to compute:

CommSystem */CommSystem/CommSystem1 Clear

CommSystem */CommSystem/CommSystem1 Compute NOW

Examples

To set the CommSystem's LinkCriteria to a specific criterion:

CommSystem */CommSystem/CommSystem1 SetValue LinkCriteria "Maximum C/N"

Examples

To see all the available choices for the LinkCriteria attribute, issue the following query command:

CommSystem_RM */CommSystem/CommSystem1 GetValue LinkCriteria:choices

Return message

Group membership

This command belongs to the following group(s):

Comm

Version

11