getElementSpacing

System object: phased.UCA
Package: phased

Spacing between array elements

Syntax

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


Description

dist = getElementSpacing(sArray) returns the arc length between adjacent elements of the phased.UCA System object™, sArray.

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

Input Arguments

sArray — Uniform circular array

phased.UCA System object

Uniform circular array, specified as a phased.UCA System object.

Example: phased.UCA()

disttype — Distance type

'arc' (default) | 'chord'

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

Example: 'chord'

Output Arguments

spacing — Spacing between elements

scalar

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. If disttype is specified as 'arc', the method returns

RΔφ.

If disttype is specified as 'chord', the method returns

2Rsin(Δφ/2).

The chord distance is always less than the arc distance.

Examples

Spacing Between UCA Elements

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

×

Open Example

A modified version of this example exists on your system. Do you want to open this version instead?

No, overwrite the modified version Yes