EngeePhased.CustomMicrophoneElement
|
Page in progress. |
A custom microphone.
| Library |
|
Description
System object EngeePhased.CustomMicrophoneElement simulates a microphone with a custom spatial directional pattern.
To create and use a custom microphone, follow these steps:
-
Create an object EngeePhased.CustomMicrophoneElement and set its properties.
-
Call the object with arguments as if it were a function.
To learn more about how to work with system objects, see Engee System Objects.
Syntax
Creation
-
microphone = phased.CustomMicrophoneElement()— creates a custom microphone with default property values. -
microphone = phased.CustomMicrophoneElement(Name=Value)— creates a custom microphone with the specified properties as a pairName=Value, whereName— the name of the property, andValue— the appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their default values.
Arguments
Input arguments
FREQ — microphone operating frequencies
+
scalar | vector is a string of length L
Details
Microphone operating frequencies, specified as a real positive scalar or a real vector string of length containing positive numbers.
Typical values are in the range FrequencyVector.
Otherwise, the element does not have a directional pattern and returns it as −Inf.
The units of measurement are Hz.
| Типы данных |
|
ANG — azimuth angle and angle of the radiation pattern
+
vector is a string of length M | the 2 by M matrix
Details
The directions of the radiation pattern, specified as a real vector, are a string of length or a real matrix on .
If ANG is a matrix, then each column defines a direction in the form [azimuth; elevation]. The azimuth angle should be in the range of −180° before 180° inclusive. The angle of the seat should be in the range of −180° before 180° inclusive.
If ANG is a string vector, each element sets the azimuth angle of the direction. In this case, the corresponding seat angle is assumed to be 0°.
The units of measurement are degrees.
For more information about the azimuth angle and the location angle, see Azimuthal angles and location angles.
| Типы данных |
|
Features
# FrequencyVector is a vector of the operating frequency range
+
[0 1e20] (by default) | a non-negative real vector is row 1 on L
Details
The frequencies at which the frequency characteristics and antenna patterns are to be obtained, specified as a non-negative real vector string on . The elements of the vector must be arranged in ascending order. The microphone does not have a radiation pattern outside the frequency range specified by the minimum and maximum elements of the frequency vector.
The units of measurement are Hz.
# FrequencyResponse — frequency characteristics of the microphone
+
[0 0] (by default) | real vector 1 on L
Details
Frequency characteristics at frequencies defined by the property FrequencyVector, set as a string vector on , where — length of the FrequencyVector vector.
The units of measurement are dB.
# PolarPatternFrequencies — measurement frequencies of the polar radiation pattern
+
1e3 (by default) | a real vector of positive values of 1 by M
Details
The frequency of measurement of the polar radiation pattern, defined as a real vector of positive values with the size on .
The measurement frequencies must be in the frequency range specified in the FrequencyVector.
The units of measurement are Hz.
# PolarPatternAngles — measurement angles of the polar radiation pattern
+
[-180:180] (by default) | the real vector is 1 by N
Details
Measurement angles of polar radiation patterns, given as a real vector on . The angles are measured from the central axis of the microphone and should be in the range of −180° before 180° inclusive.
The units of measurement are degrees.
# PolarPattern — directional pattern
+
isotropic radiation pattern with a normalized signal level of 0 dB (by default) | the matrix of real values M by N
Details
Microphone radiation pattern, defined as a real matrix on , where is the number of frequencies specified in the property PolarPatternFrequencies, and — the number of angles specified in the property PolarPatternAngles.
Each row of the matrix represents a radiation pattern of the microphone measured at the corresponding frequency specified in the property PolarPatternFrequencies, and the corresponding angles specified in the property PolarPatternAngles.
It is assumed that the radiation pattern is measured in the azimuthal plane, where the elevation angle is 0° and where the central axis of the receiver is assumed to be equal to 0° by azimuth angle and 0° by the corner of the place.
It is assumed that the polar radiation pattern is symmetrical with respect to the central axis, therefore, based on the polar radiation pattern, it is possible to construct a microphone radiation pattern in three-dimensional space.
The units of measurement are dB.
Algorithms
Details
The directional pattern of a user microphone is a combination of its frequency response and spatial response. This system object calculates both characteristics by interpolating the nearest neighbors, and then multiplies them to obtain a common diagram.
If the value of the PolarPatternFrequencies property is not a scalar, the object defines several directional patterns. In this case, the radiation pattern that is measured closest to the specified frequency is used for interpolation.