WaveNumber:

Filter:
Classes (extension)
| Libraries > Ambisonic Toolkit > Coefficients & Theory

Extension

Higher Order Ambisonic (HOA) radial utilities

Source: WaveNumber.sc

Higher Order Ambisonic (HOA) radial utilities. Useful for finding ambisonic decoder *effective radius*, *effective order* and *effective frequency*.

Create a new instance, in terms of spatial frequency.

waveNumber |
Angular wavenumber, in radians per meter. |

Create a new instance, in terms of frequency by the relationship:

`2pi * freq / speedOfSound`

.

freq |
Frequency, in Hz. |

speedOfSound |
Speed of sound, in meters per second. Def: |

Create a new instance, in terms of normalized frequency `wn`

by the relationship:

`pi * wn * sampleRate / speedOfSound`

.

wn |
Normalized frequency. DC = 0.0, Nyquist = 1.0; |

sampleRate |
Sample rate, in Hz. |

speedOfSound |
Speed of sound, in meters per second. Def: |

Create a new instance, in terms of distance and effective order by the relationship:

`order / radius`

.

radius |
Radius, in meters. Def: |

order |
Ambisonic order. Def: |

Create a new instance, in terms of time and effective order by the relationship:

`order / (delay * speedOfSound)`

.

delay |
Radial delay, in seconds. |

order |
Ambisonic order. Def: |

speedOfSound |
Speed of sound, in meters per second. Def: |

Return effective radius, in meters.

order |
Ambisonic order. Def: |

Return effective delay, in seconds.

order |
Ambisonic order. Def: |

speedOfSound |
Speed of sound, in meters per second. Def: |

Return effective ambisonic order, given radius.

radius |
Radius, in meters. Def: |

Return effective ambisonic order, given delay.

delay |
Delay, in seconds. |

speedOfSound |
Speed of sound, in meters per second. Def: |

Return frequency, in Hz.

speedOfSound |
Speed of sound, in meters per second. Def: |

Return normalized frequency. DC = 0.0, Nyquist = 1.0.

sampleRate |
Sample rate, in Hz. |

speedOfSound |
Speed of sound, in meters per second. Def: |

Angular wavenumber, in radians per meter.

Return complex near-field effect proximity radial filtering coefficients, collected by Associated Legendre degree (ℓ).

radius |
Radius, in meters. Def: |

order |
Ambisonic order. Def: |

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).

Return complex near-field effect distance radial filtering coefficients, collected by Associated Legendre degree (ℓ).

radius |
Radius, in meters. Def: |

order |
Ambisonic order. Def: |

These complex weights are the reciprocal of -proxWeights.

See further discussion on The Near-Field Effect (NFE).

Return complex near-field effect control radial filtering coefficients, collected by Associated Legendre degree (ℓ).

encRadius |
Encoding radius, in meters. Def: |

decRadius |
Decoding radius, in meters. Def: |

order |
Ambisonic order. Def: |

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).

helpfile source: /Library/Application Support/SuperCollider/downloaded-quarks/atk-sc3/HelpSource/Classes/WaveNumber.schelp

link::Classes/WaveNumber::

link::Classes/WaveNumber::