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:
|
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). |
Clear | N/A | Use 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:
Annual
None
Total
Then set the access option aberration type attribute as follows:
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):
Version
11