Engee documentation

Angle Estimator

Estimation of angles.

blockType: DOAEstimator

Path in the library:

/Phased Array Systems/Direction of Arrival/Angle Estimator

Description

Block Angle Estimator evaluates the direction to the target (or targets) in azimuth based on the received radar response.

The direction is estimated by calculating the spatial spectrum of incoming narrowband signals using the MUSIC algorithm. This algorithm implements scanning of a rectangular area using a narrow-band beamformer. The geometry of the receiving antenna array is a uniform linear antenna array (ULA).

Ports

Input

# Resp — the Doppler-processed response data cube
complex column vector P by 1 | complex matrix M by P | complex matrix M by N by P

Details

A Doppler-processed response data cube defined as a complex column vector P by 1, a complex matrix M by P, or a complex array M by N by P. M is the number of range samples, N is the number of sensor elements or rays, and P is the number of Doppler bins.

Data types

Float16| Float32 | Float64 | Int8 | Int16 | Int32 | Int64| UInt8 | UInt16 | UInt32 | UInt64 | Bool

Complex numbers support

Yes

# DetIdx — detection indexes
the real matrix Nd on Q

Details

Detection indexes specified as a real matrix Nd by Q. Q is the number of detections, Nd is the number of measurements in the response data cube, Resp. Each column DetIdx contains the detection indexes in the response data cube.

Example

[-0.3,-0.2,-0.1,0,0.1,0.2,0.3]

Data types

Float16| Float32 | Float64 | Int8 | Int16 | Int32 | Int64| UInt8 | UInt16 | UInt32 | UInt64 | Bool

Complex numbers support

No

# Clusters — cluster IDs
real positive vector-row 1 on Q

Details

Cluster identifiers specified as a real positive vector are strings 1 on Q, where Q is the number of detections specified in the input port DetIdx. Each Clusters element corresponds to a DetIdx element.

Data types

Float16| Float32 | Float64 | Int8 | Int16 | Int32 | Int64| UInt8 | UInt16 | UInt32 | UInt64 | Bool

Complex numbers support

No

Output

# Est — estimates of angular position (bearing)
real vector-column Num by 1

Details

Estimates of the angular position are a real column vector, the length of which is determined by the parameter Maximum number of estimates.

Data types

Float16| Float32 | Float64 | Int8 | Int16 | Int32 | Int64| UInt8 | UInt16 | UInt32 | UInt64 | Bool

Complex numbers support

No

Parameters

Main

# Propagation speed (m/s) — signal propagation speed, m/s
Real number

Details

The propagation velocity of the signal in the form of a real positive scalar.

Default value

3e8

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

# Operating frequency (Hz) — the carrier frequency of the signal, Hz
Real number

Details

The carrier frequency of the signal, specified as a real positive scalar.

Default value

7.7e10

Program usage name

OperatingFrequency

Tunable

No

Evaluatable

Yes

# Maximum number of estimates — maximum number of angular position estimates
Int64 integer

Details

The maximum number of angular position estimates for the report, set as a positive integer. If the number of requested ratings is greater than the number of items on the input port DetIdx, then the remainder is filled with `NaN'.

Default value

0

Program usage name

MaxNumberEstimates

Tunable

No

Evaluatable

Yes

Main

# Specify sensor array as — the method of setting the antenna array
Array (no subarrays)

Details

The method for setting the antenna array specified as `Array (no subarrays)'.

  • Array (no subarrays)— the block parameters are used to set the antenna array.

Values

Array (no subarrays)

Default value

Array (no subarrays)

Program usage name

SpecifySensorArray

Tunable

No

Evaluatable

No

Element

# Element type — types of antenna array elements
Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Details

The type of antenna array element.

Available values:

  • Isotropic Antenna

  • Cardioid Antenna

  • Cosine Antenna

  • Custom Antenna

  • Gaussian Antenna

  • Sinc Antenna

  • Omni Microphone

  • Custom Microphone

Values

Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Default value

Isotropic Antenna

Program usage name

ElementType

Tunable

No

Evaluatable

No

# Operating frequency vector (Hz) — array of operating frequencies of the antenna array element
Vector / matrix of real numbers

Details

Array of operating frequencies of the antenna array element in the form of a vector string on increasing actual values. The element has no response beyond the frequency range specified by the minimum and maximum elements of this vector.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna or `Custom Microphone'. To set the responses at these frequencies, use the Frequency responses (dB) parameter.

Default value

[0, 1e20]

Program usage name

FrequencyVector

Tunable

No

Evaluatable

Yes

# Frequency responses (dB) — frequency responses of the antenna array element
Vector / matrix of real numbers

Details

The frequency response of the user elements of the antenna arrays is determined by the parameter Operating frequency vector (Hz). The dimensions of the Frequency responses (dB) vector must match the dimensions of the vector specified by the Operating frequency vector (Hz) parameter.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna or `Custom Microphone'.

Default value

[0, 0]

Program usage name

FrequencyResponse

Tunable

No

Evaluatable

Yes

# Input pattern coordinate system — selecting the coordinate system of the radiation pattern of the user antenna array
az-el | phi-theta

Details

The choice of the coordinate system of the radiation pattern of the user antenna array is indicated by az-el or phi-theta'. When selecting `az-el, the Azimuth angles (deg) and Elevations angles (deg) parameters are used to set the coordinates of the directional pattern points. When specifying the phi-theta parameter, the Phi angle (deg) and Theta angles (deg) parameters are used to set the coordinates of the part points.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna.

Values

az-el | phi-theta

Default value

az-el

Program usage name

CoordinateSystem

Tunable

No

Evaluatable

No

# Azimuth angles (deg) — azimuth angles of the radiation pattern of the antenna array
Vector / matrix of real numbers

Details

The values of the azimuth angles, which will be used to calculate the antenna array radiation pattern in the form of a vector string on . There should be more . The azimuth angles should be in the range of −180° up to 180° inclusive and arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to az-el.

Default value

-180:180

Program usage name

AzimuthAngle

Tunable

No

Evaluatable

Yes

# Elevation angles (deg) — the values of the angles of the location of the antenna array radiation pattern
Vector / matrix of real numbers

Details

The values of the angles of the location at which it is necessary to calculate the radiation pattern in the form of a vector on . There should be more . Elevation angles should be in the range of −90° to 90° inclusive and arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to az-el.

Default value

-90:90

Program usage name

ElevationAngle_R

Tunable

No

Evaluatable

Yes

# Phi angles (deg) — the values of the angles of the Phi radiation pattern of the antenna array
Vector / matrix of real numbers

Details

The angular coordinates of the Phi points where the radiation pattern of the antenna array is set. They are defined as a real vector string on . There should be more .

The values of the Phi angles should be in the range from 0° to 360° and arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to phi-theta.

Default value

0:360

Program usage name

PhiAngles

Tunable

No

Evaluatable

Yes

# Theta angles (deg) — the values of the angles of the Theta radiation pattern of the antenna array
Vector / matrix of real numbers

Details

The angular coordinates of the Theta points where the radiation pattern of the antenna array is set. They are defined as a real vector string on . There should be more .

The values of the Theta angles must range from 0° to 180° and be arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to phi-theta.

Default value

0:180

Program usage name

ThetaAngles

Tunable

No

Evaluatable

Yes

# Magnitude pattern (dB) — the magnitude of the antenna array pattern
String

Details

The value of the antenna array radiation pattern, set as a matrix on or an array on on .

  • If the Input Pattern Coordinate System parameter is set to `az-el', then is equal to the length of the vector defined by the Elevation angles (deg) parameter, in turn, — the length of the vector defined by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to `phi-theta', then is equal to the length of the vector defined by the parameter Theta Angles (deg), in turn, — the length of the vector defined by the Phi Angles (deg) parameter.

Value is equal to the value of the Operating frequency vector (Hz) parameter.

  • If the value of this parameter is a matrix on , then the same scheme is used for all frequencies specified in the parameter Operating frequency vector (Hz).

  • If the value is an array on on , each element on The array defines a template for the corresponding frequency specified in the parameter Operating frequency vector (Hz).

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna.

Default value

zeros(181,361)

Program usage name

MagnitudePattern

Tunable

No

Evaluatable

Yes

# Phase pattern (deg) — the phase of the radiation pattern of the user antenna array
String

Details

The phase radiation pattern of the combined antenna array, defined as a matrix on or an array on on .

  • If the Input Pattern Coordinate System parameter is set to `az-el', then is equal to the length of the vector defined by the Elevation angles (deg) parameter, in turn, — the length of the vector defined by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to `phi-theta', then is equal to the length of the vector defined by the parameter Theta Angles (deg), in turn, — the length of the vector defined by the Phi Angles (deg) parameter.

Value is equal to the value of the Operating frequency vector (Hz) parameter.

  • If the value of this parameter is a matrix on , then the same scheme is applied for all frequencies specified in the parameter Operating frequency vector (Hz).

  • If the value is an array on on , each element on The array defines a template for the corresponding frequency specified in the parameter Operating frequency vector (Hz).

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna.

Default value

zeros(181,361)

Program usage name

PhasePattern

Tunable

No

Evaluatable

Yes

# Align element normal with array normal — align the normal of the antenna array element with respect to the grid normal
Logical

Details

Select this option so that the radiation pattern of the antenna array element rotates to align with the normal of the antenna array.

  • If the antenna array element is used in the antenna array and the parameter Input Pattern Coordinate System has the value az-el, selecting this flag rotates the radiation pattern so that the axis x of the coordinate system of the antenna array element points along the normal of the antenna array. If there is no selection, the element template is used without rotation.

  • If an element of the antenna array is used in the antenna array and the parameter Input Pattern Coordinate System has the value phi-theta, checking this box rotates the radiation pattern so that the axis z of the coordinate system of the element of the antenna array points along the normal of the antenna array.

Use this parameter together with the Array Normal parameter of the URA and UCA arrays.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna.

Default value

true (switched on)

Program usage name

AlignElementNormal

Tunable

No

Evaluatable

No

# Polar pattern frequencies (Hz) — frequency values for the polar radiation pattern of an acoustic element
Real number

Details

The frequency values for the polar radiation pattern are set as a real scalar or a real vector string. on . The frequencies are in the frequency range specified by the parameter Operating frequency vector (Hz).

Dependencies

To use this parameter, set the Element type parameter to Custom Microphone.

Default value

1e3

Program usage name

FrequencyPattern

Tunable

No

Evaluatable

Yes

# Polar pattern angles (deg) — angle values for the polar radiation pattern of an acoustic element
Vector / matrix of real numbers

Details

The angle values for the polar radiation pattern of an acoustic element are set as a vector . The angles are measured from the central axis of the acoustic element and should be in the range of −180° to 180° inclusive.

Dependencies

To use this parameter, set the Element type parameter to Custom Microphone.

Default value

-180:180

Program usage name

AnglePattern

Tunable

No

Evaluatable

Yes

# Polar pattern (dB) — polar radiation pattern of an acoustic element
Vector / matrix of real numbers

Details

Set the value of the polar radiation pattern of the user acoustic element in the form of a real vector string on , where — the number of frequencies specified in the parameter Polar pattern frequencies (Hz). The string represents the value of the polar radiation pattern measured at the corresponding frequency specified in the Polar pattern frequencies (Hz). The radiation pattern is measured in the azimuthal plane. In the azimuthal plane, the elevation angle is 0°, and the central axis is 0° in azimuth and 0° in elevation. The polar radiation pattern is symmetrical around the central axis. Based on the polar diagram, it is possible to construct a directional diagram of an acoustic element in three-dimensional space.

Dependencies

To use this parameter, set the Element type parameter to Custom Microphone.

Default value

zeros(1, 361)

Program usage name

PolarPattern

Tunable

No

Evaluatable

Yes

# Operating frequency range (Hz) — the range of operating frequencies of the antenna array element
Array of real numbers

Details

The range of operating frequencies of the antenna array element in the form of a vector string on in the form of [LowerBound, UpperBound]. The element has no response outside this frequency range.

Dependencies

To use this parameter, set the Element type parameter to Isotropic Antenna, Cosine Antenna or 'Omni Microphone'.

Default value

[0 1e20]

Program usage name

OperatingFrequencyRange

Tunable

No

Evaluatable

Yes

# Radiation pattern beamwidth (deg) — beam width of the antenna array pattern
Scalar / array of real numbers

Details

The beam width of the antenna array pattern.

Dependencies

To use this parameter, set the Element type parameter to Gaussian Antenna.

Default value

[10, 10]

Program usage name

RadiationPatternBeamwidth

Tunable

No

Evaluatable

Yes

# Null axis direction — the direction of the axis along the zero radiation
String

Details

The direction of the axis is along the zero radiation.

Dependencies

To use this parameter, set the Element type parameter to Cardioid Antenna.

Default value

-x

Program usage name

NullAxisDirection

Tunable

No

Evaluatable

Yes

# Exponent of cosine pattern — exponent exponent when defining the shape of a cosine radiation pattern
Scalar / array of real numbers

Details

Exponent of the exponent of the cosine model in the form of a non-negative scalar or a real matrix on from non-negative values. If Exponent of cosine pattern is a vector on , then the first element is the exponent in the direction of the azimuth, and the second is in the direction of the angle of the place. With a scalar value of this parameter, the cosines in the azimuthal and elevation directions are raised to one power.

Dependencies

To use this parameter, set the Element type parameter to `Cosine Antenna'.

Default value

[1.5 1.5]

Program usage name

ExponentCosinePattern

Tunable

No

Evaluatable

Yes

# Baffle the back of the element — accounting for radiation through the rear beam of the radiation pattern into the rear hemisphere of the antenna array element
Logical

Details

Select this option to exclude radiation into the rear hemisphere. The response from the rear hemisphere at all azimuth angles outside the ±90° range from the wide side is set to zero. The wide-angle direction is defined as the azimuth angle of 0° and the elevation angle of 0°.

Dependencies

To use this parameter, set the Element type parameter to Isotropic Antenna or `Omni Microphone'.

Default value

false (switched off)

Program usage name

BaffleBackElement

Tunable

No

Evaluatable

No

ULA

# Number of elements — number of antenna array elements
Real number

Details

The number of elements of the ULA antenna array, set as an integer greater than or equal to .

Default value

4

Program usage name

NumberElements

Tunable

No

Evaluatable

Yes

# Array axis — direction of the ULA linear axis
x | y | z

Details

The direction of the ULA linear axis, set as y, x or z. All elements of the ULA array are evenly distributed along this axis in the local coordinate system of the array.

Values

x | y | z

Default value

y

Program usage name

ArrayAxis

Tunable

No

Evaluatable

No

# Taper — changing the radiation pattern of antenna array elements
Scalar / array of real and/or complex numbers

Details

Changing the radiation pattern of the antenna array elements. It is defined as a complex scalar or a complex vector. on , where — the number of antenna array elements.

The coefficients that change the radiation pattern, also called element weights, multiply the responses of the antenna array elements. The coefficients change both the amplitude and the phase of the response to reduce the side lobes or the direction of the main axis of the response.

If the value of the Taper parameter is a scalar, then the same weight is applied to each element. If Taper is a vector, then a weight from the vector is applied to the corresponding element of the antenna array. The number of scales must correspond to the number of antenna array elements.

Default value

1

Program usage name

Taper

Tunable

No

Evaluatable

Yes