viewArray
Description
viewArray(
displays the geometry of the
array
)array
.
viewArray(
displays the geometry of the array, with additional options specified by one or more
array
,Name,Value
)Name,Value
pair arguments.
returns the
handle of the array elements in the figure window. All input arguments described for the
previous syntaxes also apply here.hndl
= viewArray(___)
Examples
Geometry of NR Rectangular Panel Array
Construct a 5G antenna array where the grid is 2-by-2 and each panel is 4-by-4 array. Each antenna element consists of two short-dipole antennas with different dipole axis directions. The antenna elements are spaced 1/2 wavelength apart and the panels are spaced 3 wavelengths apart. The array operates at 6 GHz.
c = physconst('LightSpeed'); fc = 6.0e9; lambda = c/fc; antenna1 = phased.ShortDipoleAntennaElement('AxisDirection','Z'); antenna2 = phased.ShortDipoleAntennaElement('AxisDirection','X'); array = phased.NRRectangularPanelArray('ElementSet', ... {antenna1, antenna2},'Size',[4, 4, 2, 2], ... 'Spacing',[0.5*lambda,0.5*lambda,3*lambda,3*lambda]); viewArray(array,'ShowNormals',true, ... 'ShowLocalCoordinates',true,'Orientation',[60;100;45], ... 'ShowAnnotation',true)
Input Arguments
array
— Phased array
System object™
Phased array, specified as a System object.
Name-Value Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: 'ShowNormals',true,'ShowIndex','All','ShowTaper',true
Parent
— Handle to axes
real-valued scalar
Handle to the axes along which the array geometry is displayed.
ShowNormals
— Option to show normal vectors
false
(default) | true
Option to show normal directions, specified as the comma-separated pair consisting
of 'ShowNormals'
and a Boolean value.
true
— show the normal directions of all elements in the arrayfalse
— plot the elements without showing normal directions
Example: false
Data Types: logical
ShowLocalCoordinates
— Show local coordinates
true
(default) | false
Logical flag specifying whether to show the local coordinate axes.
Data Types: logical
ShowAnnotation
— Show aperture size and element spacing annotations
true
(default) | false
Logical flag specifying whether to show the annotations in the UI panel of the figure. Annotation shows aperture size and element spacing based on array axis of array.
Data Types: logical
Orientation
— Orientation of the array
[0;0;0]
(default) | 3-by-1 column vector with real values
Orientation of the array, specified as a 3-by-1 column vector containing the rotation angles with respect to the x-, y-, and z-axes of the local coordinate system, respectively. The default value is [0;0;0].
Data Types: double
ShowTaper
— Option to show taper magnitude
false
(default) | true
Option to show taper magnitude, specified as the comma-separated pair consisting
of 'ShowTaper'
and a Boolean value.
true
— change the element color brightness in proportion to the element taper magnitudefalse
— plot all elements using the same color
Example: true
Data Types: logical
ShowIndex
— Element indices to show
'None'
(default) | vector of positive integers | 'All'
Element indices to show in the figure, specified as the comma-separated pair
consisting of 'ShowIndex'
and a vector of positive integers. Each
number in the vector must be an integer between 1 and the number of elements. To show
all of indices of the array, specify 'All'
. To suppress all
indices, specify 'None'
.
Example: [1,2,3]
Data Types: double
Title
— Plot title
'Array Geometry'
(default) | character vector
Plot title, specified as a character vector.
Example: 'My array plot'
Data Types: char
| string
Output Arguments
hndl
— Handle of array elements plot
scalar
Handle of array elements plot in the figure window, returned as a scalar.
Version History
Introduced in R2021a
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)