Display antenna patterns in the 3D Graphics window
VO <ObjectPath> Volumes {VolumeOption} [<Parameter>]
The VO Volumes command enables you to control the 3D display of antenna patterns. The colors in the 3D display of antenna beams run the spectrum from red (highest gain) to violet (lowest gain).
The volume graphics are based on the respective antenna's design frequency for Antenna, Receiver, and Transmitter objects, and on the radar's frequency for Radar objects.
Note: This command is valid only for Antenna, Monostatic Radar, Complex, GPS, Laser or Multibeam Transmitter and Complex, Laser or Multibeam Receiver. But note, this command is not valid for a transmitter or receiver that is linked to an antenna object.
Valid values for {VolumeOption} are:
| {VolumeOption} | Description |
|---|---|
| On | Display the shape and gain levels of antenna beams in the 3D Graphics window. |
| Off | Turn off the display of antenna beams. |
| "Antenna Beam" | Set 3D display options for antenna beams. The <Parameter> are described in the next table. Only one <Parameter> can be included on each command line. |
Valid <Parameter> for the "Antenna Beam" {VolumeOption} are:
| <Parameter> | Description |
|---|---|
| WireFrame {On | Off} | Display the shape of the antenna beam in the 3D Graphics window, using wireframe graphics, with colors indicating the gain level. |
| GainScale <GainValue> | Increase or decrease the size of the displayed antenna beam relative to its gain. <GainValue> is a value between 0.001 and 1.0e7 m, entered in Connect distance units. |
| Pattern <NumberOfPhiPoints> <MinPhi> <MaxPhi> <NumberOfThetaPoints> <MinTheta> <MaxTheta> | Control the antenna pattern resolution
for contouring.
Valid values for Phi and Theta are -180.0 degrees to 180.0 degrees. Valid values for number of points are 2 to 1000. |
| GainOffset <OffsetValue> | Set the gain offset. <OffsetValue> is a value between -100.0 and 200.0 entered in Scenario Ratio units. |
| Frequency <FrequencyValue> |
Note: This parameter is deprecated. If included in the command, it will be ignored. See description above for information on frequency. Displays the frequency of a receiver, transmitter or radar (in Hertz) in the 3D Graphics window. <FrequencyValue> is a value between 1.0 and 100e9 Hertz. |
| AddColorLevel <GainValue> {Color} | Explicitly define the mapping of gain
values to colors for 3D antenna beams.
<GainValue> is unitless. For valid {Color} options see Common Options. |
| DeleteColorLevel {All | <GainValue>} | Delete mapping between a gain value and
a color.
Enter All to delete all custom color mappings and apply the default STK color mappings. Enter <GainValue>, which is unitless, to delete the color mappings for that gain value. |
To display contours for Transmitter1 in the 3D Graphics window:
VO */Missile/Missile1/Transmitter/Transmitter1 Volumes On
To display the shape of the antenna beam for Transmitter1 in the 3D Graphics window, using wireframe graphics:
VO */Missile/Missile1/Transmitter/Transmitter1 Volumes "Antenna Beam" WireFrame On
VO */Missile/Missile1/Transmitter/Transmitter1 Volumes "Antenna Beam" Pattern 40 0.0 180.0 20 0.0 50.0
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
11
STK Programming Interface 11.0.1