For antenna, microphone, and array System objects, the pattern
method
replaces the plotResponse
method. In addition,
two new simplified methods exist just to draw 2-D azimuth and elevation
pattern plots. These methods are azimuthPattern
and elevationPattern
.
The following table is a guide for converting your code from
using plotResponse
to pattern
.
Notice that some of the inputs have changed from input arguments to Name-Value pairs
and conversely. The general pattern
method syntax
is
pattern(H,FREQ,AZ,EL,'Name1','Value1',...,'NameN','ValueN')
plotResponse Inputs | plotResponse Description | pattern
Inputs |
---|
H argument | Antenna, microphone, or array System object. | H argument (no change) |
FREQ argument | Operating frequency. | FREQ argument (no change) |
V argument | Propagation speed. This argument is used only for arrays. | 'PropagationSpeed' name-value pair. This
parameter is only used for arrays. |
'Format' and 'RespCut' name-value
pairs | These options work together to let you create a plot
in angle space (line or polar style) or UV space.
They also determine whether the plot is 2-D or 3-D. This table shows
you how to create different types of plots using plotResponse .
Display space | |
---|
Angle space (2D) | Set 'RespCut' to 'Az' or 'El' . Set 'Format' to
'line' or
'polar' . Set the
display axis using either the
'AzimuthAngles' or
'ElevationAngles' name-value
pairs.
| Angle space (3D) | Set 'RespCut' to '3D' . Set
'Format' to
'line' or
'polar' .
Set the display axis using both the
'AzimuthAngles'
and'ElevationAngles' name-value
pairs. | UV space (2D) | Set 'RespCut' to'U' .
Set 'Format' to 'UV' . Set the
display range using the 'UGrid' name-value pair. | UV space (3D) | Set 'RespCut' to'3D' .
Set 'Format' to 'UV' . Set the
display range using both the 'UGrid' and 'VGrid' name-value
pairs. |
| 'CoordinateSystem' name-value pair
used together with the AZ and EL input
arguments.
'CoordinateSystem' has the
same options as the plotResponse method 'Format' name-value
pair, except that 'line' is now named 'rectangular' .
The table shows how to create different types of plots using pattern .
Display space | |
---|
Angle space (2D) | Set 'Coordinate System' to 'rectangular' or 'polar' .
Specify either AZ or EL as a
scalar. | Angle space (3D) | Set 'Coordinate System' to 'rectangular' or 'polar' .
Specify both AZ and EL as vectors. | UV space (2D) | Set 'Coordinate System' to 'uv' .
Use AZ to specify a U-space
vector. Use EL to specify a V-space
scalar. | UV space (3D) | Set 'Coordinate System' to 'uv' .
Use AZ to specify a U-space
vector. Use EL to specify a V-space
vector. |
If you set CoordinateSystem to 'uv' ,
enter the UV grid values using AZ and EL . |
'CutAngle' name-value pair | Constant angle at to take an azimuth or elevation cut. When
producing a 2-D plot and when 'RespCut' is set
to 'Az' or 'El' , use 'CutAngle' to
set the slice across which to view the plot. | No equivalent name-value pair. To create a cut, specify either AZ or EL as
a scalar, not a vector. |
'NormalizeResponse' name-value pair | Normalizes the plot. When 'Unit' is set
to 'dbi' , you cannot specify 'NormalizeResponse' . | Use the 'Normalize' name-value pair. When 'Type'
is set to 'directivity' you cannot specify
'Normalize' . |
'OverlayFreq' name-value pair | Plot multiple frequencies on the same 2-D plot. Available only
when 'Format' is set to 'line' or 'uv' and 'RespCut' is
not set to '3D' . The value true produces
an overlay plot and the value false produces a
waterfall plot. | 'PlotStyle' name-value pair plots
multiple frequencies on the same 2-D plot.
The values 'overlay' and 'waterfall' correspond
to 'OverlayFreq' values of true and false .
The option 'waterfall' is allowed only when 'CoordinateSystem' is
set to 'rectangular' or 'uv' . |
'Polarization' name-value pair | Determines how to plot polarized fields. Options are 'None' , 'Combined' , 'H' ,
or 'V' . | 'Polarization' name-value pair determines
how to plot polarized fields. The 'None' option
is removed. The options 'Combined' , 'H' ,
or 'V' are unchanged. |
'Unit' name-value pair | Determines the plot units. Choose 'db' , 'mag' , 'pow' ,
or 'dbi' , where the default is 'db' . | 'Type' name-value pair, uses equivalent options with different
names
plotResponse | pattern |
---|
'db' | 'powerdb' | 'mag' | 'efield' | 'pow' | 'power' | 'dbi' | 'directivity' |
|
'Weights' name-value pair | Array element tapers (or weights). | 'Weights' name-value pair (no change). |
'AzimuthAngles' name-value pair | Azimuth angles used to display the antenna or array response. | AZ argument
|
'ElevationAngles' name-value pair | Elevation angles used to display the antenna or array response. | EL argument
|
'UGrid' name-value pair | Contains U coordinates in UV-space. | AZ argument when 'CoordinateSystem' name-value
pair is set to 'uv'
|
'VGrid' name-value pair | Contains V-coordinates in UV-space. | EL argument when 'CoordinateSystem' name-value
pair is set to 'uv'
|