phased.HeterogeneousURA.getElementPosition

Positions of array elements

collapse all in page

Syntax

POS = getElementPosition(array)
POS = getElementPosition(array,ELEIDX)

Description

POS = getElementPosition(array) returns the element positions of the HeterogeneousURA System object™, array. POS is a 3-by-N matrix where N is the number of elements in array. 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.

example

POS = getElementPosition(array,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

collapse all

Open Live Script

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

Input Arguments

collapse all

Element positions of the HeterogeneousURA System object, array.

Data Types: single | double
Complex Number Support: Yes

Element index vector.

Data Types: single | double

Version History

Introduced in R2013a