Steering Vector

The propagation velocity of a signal as a real positive scalar.

By default, the speed of light is used.

The unit of measurement is m/c.

Operating frequency source: Input Port or Property.

If the parameters is set to Input Port, the operating frequency is set via the Freq input port.

If the parameter is set to Property, the operating frequency is set via the Operating frequency (Hz) parameter.

The operating frequency of the system, given as a positive scalar.

The unit of measurement is Hz.

Select this check box to output the conjugate control vector. Otherwise, the control vector will not be conjugated.

The number of bits used to quantise the phase shift component of the weights of the beamforming vector or control vector. Specify the number of bits as a non-negative integer. A value equal to zero indicates that quantisation is not performed.

A method for specifying an antenna array.

Available values:

Type of antenna or acoustic element.

Available values:

The operating frequency range of the antenna or acoustic element as a string vector 1 at . Outside this frequency range, the element has no response.

The unit of frequency measurement is Hz.

Dependencies

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

Frequency response of the user antenna or user acoustic element for frequencies defined by the Operating frequency vector (Hz) parameters. The size of the Frequency responses (dB) vector must match the size 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.

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

Dependencies

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

The azimuth angles from which the antenna radiation pattern will be calculated as a vector-line 1 to P. P must be greater than 2. The azimuth angles must lie in the range from −180° up to and including 180° 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 elevation angles at which the radiation pattern should be calculated as vector 1 at . must be greater than 2. The units of angles are degrees. Elevation angles must lie in the range from −90° to 90° 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.

Angular coordinates Phi of the points at which the antenna radiation pattern is defined. Defined as a real vector-line 1 at . 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 defined. They are set as a real vector-string 1 at . 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 radiation pattern of the combined antenna, given as a matrix to or an 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.

Phase radiation pattern of a compound antenna, specified as a matrix to or an 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 antenna element pattern is rotated to align normal to the antenna array. If off, the element pattern 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 directional pattern so that the x-axis of the element coordinate system points along the normal to the antenna array. If no selection is made, the directional pattern of the element 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, checking this checkbox rotates the pattern so that the z-axis of the element coordinate system points along the normal to 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.

The response frequencies of a polar pattern acoustic element, specified as a real scalar or a real string vector 1 at . The response 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.

Set the polar response angles as vector 1 on . The angles are measured from the centre axis of the acoustic element and should range from −180° up to and including 180°.

Dependencies

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

Set the polar pattern value of the custom acoustic element as a real vector string 1 at , 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 elevation angle 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, it is possible to construct the directivity diagram of an acoustic element in three-dimensional space.

Dependencies

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

The operating frequency range of an antenna or acoustic element as a 1 by 2 string vector in the form [LowerBound,UpperBound]. Outside this frequency range, the element has no response.

The unit of frequency measurement is Hz.

Dependencies

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

Angles of the directional pattern solution in degrees.

Dependencies

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

The direction of the zero emission axis.

Dependencies

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

Indices of the cosine directional diagram as a non-negative scalar or a real 1 by 2 matrix of non-negative values.

If the Exponent of cosine pattern is a 1 by 2 vector, the first element is the index in the azimuth direction and the second element is the index in the elevation direction. When this parameters is scalar, the cosines in the azimuth and elevation directions are raised to the same degree.

Dependencies

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

Select this check box to mute the response of the element.

Silencing the response at all azimuth angles greater than ±90° from the broadside sets the responses to zero. The broadside is defined as an azimuth angle of 0° and an elevation angle of 0°.

Dependencies

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

The geometry of the antenna array, given as:

The number of antenna array elements for a ULA or UCA, specified as an integer greater than or equal to 2.

Dependencies

To use this parameter, set the Geometry parameters to ULA or UCA.

The radius of the UCA antenna array, a positive scalar.

Dependencies

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

The dimensions of the URA antenna array, given as a positive integer or a vector of positive integers 1 by 2.

For URA, the elements of the antenna array are indexed from top to bottom by the leftmost column and then proceed to the next columns from left to right. The figure shows an antenna array for which the Array size parameters is [3,2], that is, it has three rows and two columns.

Dependencies

To use this parameter, set the Geometry parameter to URA.

The distance between neighbouring elements of ULA or URA arrays as a positive scalar.

Dependencies

To use this parameter, set the Geometry parameters to ULA or URA.

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

Dependencies

To use this parameter, set the Geometry parameter to ULA.

Lattice of URA element positions defined as rectangular or triangular.

Dependencies

To use this parameter, set the Geometry parameter to URA.

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

The elements of plane gratings lie in a plane orthogonal to the selected direction of the antenna array normal. The directions of the angular coordinates of the elements are directed along the normal direction of the antenna array.

Dependencies

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

The positions of the conformal antenna array elements given as a matrix of real values 3 by , where is the number of elements in the conformal array. Each column of this matrix represents the position [x;y;z] of the antenna array element in the local coordinate system of the antenna array. The origin of the local coordinate system is (0,0,0).

The units of measurement are m.

Dependencies

To use this parameter, set the Geometry parameters to Conformal Array.

The direction of the normal vectors of the elements of a conformal antenna array, given as a 2 by 1 column vector or a 2 by matrix, where denotes the number of elements in the antenna array. For a matrix, each column specifies the normal direction of the corresponding element as [azimuth;elevation] with respect to the local coordinate system. In the local coordinate system, the positive axis coincides with the direction of the normal to the conformal antenna array. If the parameter value is a 2-by-1 column vector, the same pointing direction is used for all elements of the antenna array.

The parameters Element positions (m) and Element normals (deg) can be used to represent any arrangement in which pairs of elements differ from each other by certain transformations. These transformations may include translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to the direction of the normal.

Dependencies

To use this parameter, set the Geometry parameters to Conformal Array.

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.