audiblelight.micarrays.FOAListener

class audiblelight.micarrays.FOAListener(name='foalistener', is_spherical=False, channel_layout_type='foa')

Bases: MicArray

First Order Ambisonics (FOA) microphone “capsule”

This implementation uses a single listener with 4 ambisonics channels (W, X, Y, Z) following the AmbiX convention. Unlike AmbeoVR which places 4 separate mono capsules, this represents a single point in space with 4-channel ambisonics encoding.

Parameters:

• name (str)

• is_spherical (bool)

• channel_layout_type (str)

__init__(name='foalistener', is_spherical=False, channel_layout_type='foa')

Parameters:

• name (str)

• is_spherical (bool)

• channel_layout_type (str)

Return type:

None

Methods

__init__([name, is_spherical, ...])
from_dict(input_dict)	Instantiate a MicArray from a dictionary.
set_absolute_coordinates(mic_center)	Calculates absolute position of all microphone capsules based on a provided center.
to_dict()	Returns metadata for this MicArray as a dictionary.

Attributes

capsule_names
channel_layout	Returns the ray-tracing engine ChannelLayout object for this MicArray
channel_layout_type
coordinates_absolute
coordinates_cartesian
coordinates_center
coordinates_polar
irs
is_spherical
n_capsules
n_listeners	Returns the number of listeners this MicArray should be associated with in the engine.
name

property capsule_names: list[str]

channel_layout_type: str = 'foa'

property coordinates_cartesian: ndarray

is_spherical: bool = False

name: str = 'foalistener'