Main Content

getElementPosition

System object: phased.HeterogeneousURA
Namespace: phased

Positions of array elements

Syntax

POS = getElementPosition(H)
POS = getElementPosition(H,ELEIDX)

Description

POS = getElementPosition(H) returns the element positions of the HeterogeneousURA System object™, H. POS is a 3-by-N matrix where N is the number of elements in H. Each column of POS defines the position of an element in the local coordinate system, in meters, using the form [x; y; z].

For details regarding the local coordinate system of the URA or heterogeneous URA, enter phased.URA.coordinateSystemInfo on the command line.

POS = getElementPosition(H,ELEIDX) returns the positions of the elements that are specified in the element index vector, ELEIDX. The element indices of a URA run down each column, then to the top of the next column to the right. For example, in a URA with 4 elements in each row and 3 elements in each column, the element in the third row and second column has an index value of 6. This syntax can use any of the input arguments in the previous syntax.

Examples

expand all

Construct a heterogeneous URA with a rectangular lattice, and obtain the element positions.

antenna1 = phased.ShortDipoleAntennaElement('FrequencyRange',[100e6 1e9], ...
    'AxisDirection','Z');
antenna2 = phased.ShortDipoleAntennaElement('FrequencyRange',[100e6 1e9], ...
    'AxisDirection','Y');
array = phased.HeterogeneousURA('ElementSet',{antenna1,antenna2}, ...
    'ElementIndices',[1 2; 2 1]);
pos = getElementPosition(array)
pos = 3×4

         0         0         0         0
   -0.2500   -0.2500    0.2500    0.2500
    0.2500   -0.2500    0.2500   -0.2500