HoaRadius
Extension
ExtensionDescription
Higher Order Ambisonic (HOA) radial utilities. Useful for finding ambisonic decoder effective radius, effective order and effective frequency.
Class Methods
.new
Create a new instance, in terms of distance.
Arguments:
| radius |
Radius, in meters. Def. |
.newFreq
Create a new instance, in terms of frequency by the relationship:
(order * speedOfSound) / (2 * pi * freq).
Arguments:
| freq |
Frequency, in Hz. |
| order |
Ambisonic order. Def. |
| speedOfSound |
Speed of sound, in meters per second. Def. |
.newWn
Create a new instance, in terms of normalized frequency wn by the relationship:
(order * speedOfSound) / (pi * wn * sampleRate).
Arguments:
| wn |
Normalized frequency. DC = 0.0, Nyquist = 1.0; |
| sampleRate |
Sample rate, in Hz. |
| order |
Ambisonic order. Def. |
| speedOfSound |
Speed of sound, in meters per second. Def. |
.newWaveNumber
Create a new instance, in terms of a spatial frequency defined by the angular wavenumber, by the relationship:
order / waveNumber.
Arguments:
| waveNumber |
Angular wavenumber, in radians per meter. |
| order |
Ambisonic order. Def. |
.newDelay
Create a new instance, in terms of time by the relationship:
delay * speedOfSound.
Arguments:
| delay |
Radial delay, in seconds. |
| speedOfSound |
Speed of sound, in meters per second. Def. |
Instance Methods
Radius & delay
.radius
Return radius, in meters.
.delay
Return reference delay, in seconds.
Arguments:
| speedOfSound |
Speed of sound, in meters per second. Def. |
Effective order
.orderAtFreq
Return effective ambisonic order, given frequency.
Arguments:
| freq |
Frequency, in Hz. |
| speedOfSound |
Speed of sound, in meters per second. Def. |
.orderAtWn
Return effective ambisonic order, given normalized frequency.
Arguments:
| wn |
Normalized frequency. DC = 0.0, Nyquist = 1.0. |
| sampleRate |
Sample rate, in Hz. |
| speedOfSound |
Speed of sound, in meters per second. Def. |
.orderAtWaveNumber
Return effective ambisonic order, given spatial frequency defined by the angular wavenumber.
Arguments:
| waveNumber |
Angular wavenumber, in radians per meter. |
Effective frequency
.freq
Return effective frequency.
Arguments:
| order |
Ambisonic order. Def. |
| speedOfSound |
Speed of sound, in meters per second. Def. |
.wn
Return effective normalized frequency where DC = 0.0, Nyquist = 1.0.
Arguments:
| sampleRate |
Sample rate, in Hz. |
| order |
Ambisonic order. Def. |
| speedOfSound |
Speed of sound, in meters per second. Def. |