Main Content

getElementSpacing

System object:phased.UCA
Package:phased

Spacing between array elements

expand all in page

Syntax

dist = getElementSpacing(sArray)
dist = getElementSpacing(sArray,disttype)

Description

dist= getElementSpacing(sArray)returns the arc length between adjacent elements of thephased.UCASystem object™,sArray.

dist= getElementSpacing(sArray,disttype)returns either the arc length or chord length between adjacent elements depending on the specification ofdisttype.

Input Arguments

expand all

Uniform circular array, specified as aphased.UCASystem object.

Example:phased.UCA()

Distance type to define path between adjacent array elements, specified as a either'arc'or'chord'. Ifdisttypeis specified as'arc', the returned distance is the arc length between adjacent elements. Ifdisttypeis specified as'chord', the returned distance is the chord length between adjacent elements.

Example:'chord'

Output Arguments

expand all

Spacing between elements, returned as a scalar. A uniform circular array has a unique distance between all pairs of adjacent elements. The distance depends only upon the radius of the array,R, and the angle between two adjacent elements,Δφ. The angle between two adjacent elements is computed from the number of elements,Δφ = 2π/N. Ifdisttypeis specified as'arc', the method returns

RΔφ.

Ifdisttypeis specified as'chord', the method returns

2Rsin(Δφ/2).

The chord distance is always less than the arc distance.

Examples

expand all

Open Live Script

Construct a 10-element UCA with a radius of 1.5 meters, and obtain the arc distance between any two adjacent elements. Then, obtain the chord distance.

sArray = phased.UCA('NumElements',10,'Radius',1.5); dist = getElementSpacing(sArray,'arc')
dist = 0.9425
dist = getElementSpacing(sArray,'chord')
dist = 0.9271

版本历史

Introduced in R2015a