WaveNumber
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 spatial frequency.
Arguments:
| waveNumber |
Angular wavenumber, in radians per meter. |
.newFreq
Create a new instance, in terms of frequency by the relationship:
2pi * freq / speedOfSound.
Arguments:
| freq |
Frequency, in Hz. |
| speedOfSound |
Speed of sound, in meters per second. Def: |
.newWn
Create a new instance, in terms of normalized frequency wn by the relationship:
pi * wn * sampleRate / speedOfSound.
Arguments:
| wn |
Normalized frequency. DC = 0.0, Nyquist = 1.0; |
| sampleRate |
Sample rate, in Hz. |
| speedOfSound |
Speed of sound, in meters per second. Def: |
.newRadius
Create a new instance, in terms of distance and effective order by the relationship:
order / radius.
Arguments:
| radius |
Radius, in meters. Def: |
| order |
Ambisonic order. Def: |
.newDelay
Create a new instance, in terms of time and effective order by the relationship:
order / (delay * speedOfSound).
Arguments:
| delay |
Radial delay, in seconds. |
| order |
Ambisonic order. Def: |
| speedOfSound |
Speed of sound, in meters per second. Def: |
Instance Methods
Radius & delay
.radius
Return effective radius, in meters.
Arguments:
| order |
Ambisonic order. Def: |
.delay
Return effective delay, in seconds.
Arguments:
| order |
Ambisonic order. Def: |
| speedOfSound |
Speed of sound, in meters per second. Def: |
Effective order
.orderAtRadius
Return effective ambisonic order, given radius.
Arguments:
| radius |
Radius, in meters. Def: |
.orderAtDelay
Return effective ambisonic order, given delay.
Arguments:
| delay |
Delay, in seconds. |
| speedOfSound |
Speed of sound, in meters per second. Def: |
Frequency
.freq
Return frequency, in Hz.
Arguments:
| speedOfSound |
Speed of sound, in meters per second. Def: |
.wn
Return normalized frequency. DC = 0.0, Nyquist = 1.0.
Arguments:
| sampleRate |
Sample rate, in Hz. |
| speedOfSound |
Speed of sound, in meters per second. Def: |
.waveNumber
Angular wavenumber, in radians per meter.
NFE
.proxWeights
Return complex near-field effect proximity radial filtering coefficients, collected by Associated Legendre degree (ℓ).
Arguments:
| radius |
Radius, in meters. Def: |
| order |
Ambisonic order. Def: |
Discussion:
These complex weights represent the magnitude and phase change of each degree when encoding an otherwise far-field source at a distance of radius.
See further discussion on The Near-Field Effect (NFE).
.distWeights
Return complex near-field effect distance radial filtering coefficients, collected by Associated Legendre degree (ℓ).
Arguments:
| radius |
Radius, in meters. Def: |
| order |
Ambisonic order. Def: |
Discussion:
These complex weights are the reciprocal of -proxWeights.
See further discussion on The Near-Field Effect (NFE).
.ctrlWeights
Return complex near-field effect control radial filtering coefficients, collected by Associated Legendre degree (ℓ).
Arguments:
| encRadius |
Encoding radius, in meters. Def: |
| decRadius |
Decoding radius, in meters. Def: |
| order |
Ambisonic order. Def: |
Discussion:
These complex weights represent a ratio of the -proxWeights of the encoding radius to the decoding radius, i.e. proxWeights(encRadius) / proxWeights(decRadius).
See further discussion on The Near-Field Effect (NFE).