Sensor_plot_antenna_plot¶
Navigation: sensor_plot > antenna_plot
- antenna_plot … end_antenna_plot¶
antenna_plot Stub Definition Commands pattern_name ... axes ... azimuth_range ... azimuth_step ... elevation_range ... elevation_step ... tilt_angle ... frequency ... polarization ... electronic_beam_steering ... electronic_beam_steering_loss_exponent ... azimuth_steering_angle ... elevation_steering_angle ... output_file ... gnuplot_file ... header_line_1 ... header_line_2 ... header_line_3 ... output_column_limit ... end_antenna_plot
Overview¶
The antenna_plot command is used to generate a file that contains the gain of an antenna_pattern sample at selected points within specified spherical limits. This plot produces two output formats. One, specified by the output_file command, generates a table that can be loaded and viewed with the CME tool, SigView (load “threat assessment” feature). The other file, specified with the gnuplot_file command, produces an output file suitable for use with gnuplot.
Commands¶
- pattern_name <pattern-name>¶
Specifies the name of the pattern to be processed. This must be the name of an antenna pattern defined with the antenna_pattern command.
Default none - this is a required value.
- axes [ vertical | horizontal | both ]¶
Specifies the type of data file to be produced:
vertical - A vertical sampling at 0 degrees azimuth.
horizontal - A horizontal sampling at 0 degrees elevation.
both - A horizontal and vertical sampling.
Default vertical
- azimuth_range <min-angle-value> <max-angle-value>¶
Specifies the azimuth limits for axes horizontal or axes both.
Default -180 degrees 180 degrees
- azimuth_step <step-angle-value>¶
Specifies the increment between azimuth samples for axes horizontal or axes both.
Default 1 degree
- elevation_range <min-angle-value> <max-angle-value>¶
Specifies the elevation limits for axes vertical or axes both.
Default -90 degrees 90 degrees
- elevation_step <step-angle-value>¶
Specifies the increment between elevation samples for axes vertical or axes both.
Default 1 degree
- tilt_angle <tilt-angle-value>¶
Specifies the elevation tilt angle between [-90 90] degrees of the antenna pattern with respect to the normal of the pattern.
Default 0 degrees
- frequency <frequency-value>¶
Specifies the frequency which the pattern is to be plotted for.
Default 0.0 Hz
- polarization [ horizontal | vertical | slant_45 | slant_135 | left_circular | right_circular | default ]¶
Specifies the polarization which the pattern is to be plotted for.
Default default
- electronic_beam_steering [ none | azimuth | elevation | both | azimuth_and_elevation ]¶
Specifies that the subsystem uses an electronically-steered antenna that is capable of being electronically steered in the specified directions. When specified, the antenna gain is a function of the cosine of the angle relative to the array center. When enabled, the command affects the returned beamwidths of azimuth_beamwidth and elevation_beamwidth.
none - The beam is not electronically steered.
azimuth - The beam is electronically steered in azimuth.
elevation - The beam is electronically steered in elevation.
both or azimuth_and_elevation - The beam is electronically steered in both azimuth and elevation.
Default none
- electronic_beam_steering_loss_exponent <value>¶
Specifies the exponent that will be used in the beam steering loss computation.
- azimuth_steering_angle <steer-angle-value>¶
Specifies the azimuth steering angle between [-180 180] degrees of a steered array antenna pattern with respect to the normal of the pattern.
Default 0 degrees
- elevation_steering_angle <steer-angle-value>¶
Specifies the elevation steering angle between [-90 90] degrees of a steered array antenna pattern with respect to the normal of the pattern.
Default 0 degrees
- output_file <file-name>¶
Specifies the name to which the output is to be written.
Default none - this is a required value.
- gnuplot_file <file-name>¶
Specifies the name to which the gnuplot output is to be written.
- header_line_1 <text>¶
- header_line_2 <text>¶
- header_line_3 <text>¶
Specifies the text to be contained in the first three lines of the output file when axes both is specified.
Default all header lines are blank.
- output_column_limit <integer>¶
Specifies the maximum number of columns per physical line in the output file when axes both is specified.
Default 100
Note
If the file is to be imported into a spreadsheet such as Microsoft Excel, this value should be set so that the rows do not have to be split into multiple physical lines.