Engee documentation

EngeePhased.OmnidirectionalMicrophoneElement

Isotropic microphone.

Library

EngeePhased

Description

System object EngeePhased.OmnidirectionalMicrophoneElement Simulates a microphone with an isotropic radiation pattern.

To create and use an isotropic microphone, follow these steps:

  1. Create an object EngeePhased.OmnidirectionalMicrophoneElement and set its properties.

  2. Call an 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.OmnidirectionalMicrophoneElement() — Creates an isotropic microphone with by default property values.

  • microphone = phased.OmnidirectionalMicrophoneElement(Name=Value) — creates an isotropic microphone with specified properties in the form of a pair Name=Value, where Name — the name of the property, and Value — appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their by default values.

Usage

  • RESP = microphone(FREQ,ANG) — returns the directional pattern of the microphone RESP at the operating frequencies FREQ in the directions ANG.

Arguments

Input arguments

FREQ — microphone operating frequencies

+ scalar | vector-string of length L

Details

The operating frequencies of the microphone, specified as a real positive scalar or a real vector, are strings of length containing positive numbers.

Units of measurement — Hz.

Типы данных

Float64

ANG — azimuth angle and angle of the radiation pattern

+ vector-string of length M | matrix 2 by M

Details

The directions of the radiation pattern, specified as a real vector-a string of length or a real matrix on .

If ANG is a matrix, then each column specifies a direction in the form [azimuth; elevation]. The azimuthal 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 specifies the azimuthal angle of the direction. In this case, the corresponding angle of the place is assumed to be equal .

The units of measurement are degrees.

For more information about the azimuth angle and the elevation angle, see Azimuthal angles and place angles.

Типы данных

Float64

Output arguments

RESP — Microphone directional pattern
the complex matrix M on L

Details

The directional pattern of the microphone, returned as a complex matrix on , where — the number of angles specified in ANG, — the number of frequencies specified in FREQ.

Properties

# FrequencyRange — operating frequency range

+ [0.0 1.0e20] (by default) | a non-negative real vector is a 1 by 2 row

Details

The operating frequency range of the microphone, specified as a non-negative real vector on in the format [LowerBound HigherBound]. The microphone does not have a radiation pattern outside the specified frequency range.

Units of measurement — Hz.

# BackBuffled — mute the echo of the element

+ false (by default) | true

Details

Mute the echo of an element, set as false or true.

Set this property to true so that on the reverse side of the microphone element, the radiation pattern is zero. That is, at all azimuthal angles exceeding ±90° from the wide side (azimuth angle and the angle of the place ), the radiation pattern is zero.

When the value of this property is false. the back side of the microphone has no reflection.

Methods

Common to all system objects

step!

Running the system object operation algorithm

release!

Permission to change the value of a system object property

reset!

Resetting the internal states of the system object