viewArray

System object: phased.ConformalArray
Package: phased

View array geometry

Syntax

viewArray(H)
viewArray(H,Name,Value)
hPlot = viewArray(___)


Description

viewArray(H) plots the geometry of the array specified in H.

viewArray(H,Name,Value) plots the geometry of the array, with additional options specified by one or more Name,Value pair arguments.

hPlot = viewArray(___) returns the handle of the array elements in the figure window. All input arguments described for the previous syntaxes also apply here.

Input Arguments

H	Array 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.

Parent	Handle to the axes along which the array geometry is displayed.
ShowNormals	Set this value to true to show the normal directions of all elements of the array. Set this value to false to plot the elements without showing normal directions. Default: false
ShowLocalCoordinates	Logical flag specifying whether to show the local coordinate axes. Default: true
ShowAnnotation	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. Default: true
Orientation	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]. Default: [0;0;0]
ShowTaper	Set this value to true to specify whether to change the element color brightness in proportion to the element taper magnitude. When this value is set to false, all elements are drawn with the same color. Default: false
ShowIndex	Vector specifying the element indices to show in the figure. Each number in the vector must be an integer between 1 and the number of elements. You can also specify the value 'All' to show the indices of all elements of the array or 'None' to suppress indices. Default: 'None'
Title	Character vector specifying the title of the plot. Default: 'Array Geometry'

Output Arguments

hPlot

Handle of array elements in figure window.

Examples

View Uniform Circular Array

Display the element positions and normal directions of all elements of an 8-element uniform circular array.

Create the uniform circular array

N = 8;
azang = (0:N-1)*360/N - 180;
ha = phased.ConformalArray(...
    'ElementPosition',[cosd(azang);sind(azang);zeros(1,N)],...
    'ElementNormal',[azang;zeros(1,N)]);

Display the positions and normal directions of the elements

viewArray(ha,'ShowNormals',true);