Root MUSIC DOA

Input signal given as a complex matrix. The columns of the matrix correspond to the channels of the signal.

Data types: Float64.

Elevation angle specified as a scalar in the range from -90° to 90°.

The place angles for all signals must be the same, as required by the phase mode excitation algorithm.

The units of measurement are degrees.

Dependencies

To enable this port, set the Geometry parameters to UCA.

Data types: Float64.

Calculated angles of the wave front direction, returned as a vector of strings with real values.

The units of measurement are degrees.

Data types: Float64.

Signal propagation speed as a real positive scalar. By default, the value of the speed of light is used: 299792458 m/s.

The unit of measurement is m/s.

The operating frequency of the system specified as a positive scalar.

The unit of measurement is Hz.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Specify the expected number of signals to estimate the directions of arrival of incoming signals (DOA) as a positive integer scalar number.

Dependencies

To use this parameter, select the Enable DOA output checkbox.

Select this checkbox to use forward-backward averaging to estimate the covariance matrix for sensor antenna arrays with conjugate-symmetric antenna array manifold structure.

The number of averages used by spatial smoothing to estimate the covariance matrix is specified as a non-negative integer. Each increase in smoothing handles one additional coherent source, but reduces the effective number of elements by one. The maximum value of this parameters is , where is the number of sensors in the ULA.

The method of specifying the antenna array specified as Array (no subarrays).

Type of antenna array element.

Available values:

The operating frequency range of the antenna array element as a 1-by-2 string-vector in the form of [LowerBound,UpperBound]. The element has no response outside this frequency range. Frequency measurement units are Hz.

Dependencies

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

Set this flag to exclude radiation to the rear hemisphere. The response from the rear hemisphere at all azimuth angles outside the ±90° interval from the broadside are set to zero. The broadside direction is defined as an azimuth angle of 0° and a place angle of 0°.

Dependencies

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

Axis direction along the null radiation.

Dependencies

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

Specify the exponents of the cosine model as a non-negative scalar or a 1-by-2 real matrix of non-negative values.

If the Exponent of cosine pattern parameters is a 1 by 2 vector, the first element is the exponent in the azimuth direction and the second element is the exponent in the elevation direction.

If the Exponent of cosine pattern parameters is a scalar, the cosines in the azimuth direction and in the elevation direction are raised to the same degree.

Dependencies

To enable this parameter, set the Element type parameters to Cosine Antenna.

Antenna array element operating frequencies of the antenna array element as a string vector 1 on of increasing real values. The element has no response outside the frequency range given by the minimum and maximum elements of this vector.

The units of measurement are Hz.

Dependencies

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

The frequency response of custom antenna array elements is determined by the Operating frequency vector (Hz) parameters. The dimensions of the Frequency responses (dB) vector must match the dimensions of the vector defined by the Operating frequency vector (Hz) parameters.

Dependencies

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

Selects the user antenna pattern coordinate system, either az-el or phi-theta is specified. When az-el is selected, the Azimuth angles (deg) and Elevations angles (deg) parameters are used to specify the coordinates of the directional pattern points. When the `phi-theta parameter is specified, the Phi angle (deg) and Theta angles (deg) parameters are used to specify the coordinates of the pattern points.

Dependencies

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

The azimuth angle values for which the antenna radiation pattern will be calculated as vector-string 1 at . must be greater than 2. The values of the azimuth angles must lie in the range from −180° to 180° inclusive and be 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.

The values of the place angles at which you want to calculate the radiation pattern as vector 1 at . must be greater than 2. The units of measurement of the angles are degrees. The elevation angles must lie in the range from −90° up to and including 90° and be 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.

Angular coordinates Phi of the points at which the antenna radiation pattern is specified. Defined as a real vector-string 1 on . must be greater than 2. The units of measurement of the angles are degrees. The values of the angles Phi must lie in the range from 0° to 360° 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.

Theta angular coordinates of the points where the antenna radiation pattern is specified. Defined as a real vector-string 1 on . must be greater than 2. The units of measurement of the angles are degrees. Values of the angles Theta must lie in the 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.

The magnitude of the antenna pattern given as a matrix to or antenna array to to .

The value of is equal to the value of the Operating frequency vector (Hz) parameters.

Dependencies

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

The phase radiation pattern of the combined antenna, given as a matrix to or antenna array to to .

The value of is equal to the value of the Operating frequency vector (Hz) parameters.

Dependencies

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

If the parameters value is on, the pattern of the antenna element is rotated to align with the normal of the antenna array. If off, the pattern of the element is not rotated.

If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters are set to az-el, selecting this checkbox rotates the element pattern so that the x-axis of the element coordinate system points along the normal of the antenna array. If no selection is made, the element pattern without rotation is used.

If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters is set to phi-theta, selecting this check box rotates the pattern so that the z-axis of the element coordinate system points along the normal of the antenna array.

Use this parameter in conjunction with the Array Normal parameters of the URA and UCA antenna arrays.

Dependencies

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

Antenna pattern beamwidth in degrees.

Dependencies

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

The frequency values for the polar radiation pattern are given as a real scalar or real vector-string 1 on . The frequencies lie within the frequency range specified by the parameter Operating frequency vector (Hz).

Dependencies

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

The angle values for the microphone’s polar pattern are specified as a vector . The angles are measured from the centre axis of the microphone and should range from −180° to 180° inclusive.

Dependencies

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

Set the polar pattern magnitude of the user microphone element as a real vector-string 1 by , where is the number of frequencies specified in the Polar pattern frequencies (Hz) parameters. The string represents the polar pattern magnitude measured at the corresponding frequency specified in Polar pattern frequencies (Hz). The directional pattern is measured in the azimuth plane. In the azimuth plane, the angle of place is 0° and the centre axis is 0° in azimuth and 0° in elevation. The polar pattern is symmetrical around the centre axis. Based on the polar diagram, you can construct the microphone’s radiation pattern in three-dimensional space.

Dependencies

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

Specify the antenna array geometry as one of the following:

Number of antenna array elements for ULA arrays, specified as an integer greater than or equal to 2.

*Example: 11

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

The distance between neighbouring ULA elements, specified as a positive scalar.

The unit of measurement is m.

*Example: 1.5

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

Dependencies

The direction of the antenna array normal, specified as x, y or z.

The elements of planar antenna arrays lie in a plane orthogonal to the selected direction of the antenna array normal.

The side view directions of the elements are directed along the normal direction of the antenna array.

Dependencies

To enable this parameter, set the Geometry parameters to URA or UCA.

The radius of the UCA antenna array specified as a positive scalar.

Dependencies

To enable this parameter, set the Geometry parameter to UCA.

The change of the directivity diagram of the antenna array elements is specified as a complex scalar or complex vector 1 at , where is the number of antenna array elements.

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

If the value of the Taper parameters is a scalar, the same weight is applied to each element.

If Taper is a vector, then the weight from the vector is applied to the corresponding antenna array element. The number of weights must correspond to the number of antenna array elements.