Spatial

note

You can use up to 30,000 receivers within a single simulation. A spatial receiver with ambisonics order 32 will create $(32+1)^2$ or 1089 receivers within a simulation.

Treble samples spatial sound fields to spatial receiver in spherical harmonics domain.

The default order is 2nd order ambisonics and the orientation is towards positive $x$ axis $[1, 0, 0]$. The image below shows the default orientation in the cartesian coordinate system with a receiver located at $[0, 0, 0]$.

from treble_tsdk import treble

receiver_list = [
        treble.Receiver.make_spatial(
            position=treble.Point3d(x=1.5, y=4, z=1.5),
            label="Spatial_receiver",
            ambisonics_order=16
        )
    ]

The order can be changed through ambisonics_order, Treble supports ambisonics orders 1, 2, 4, 8, 16 and 32.

Format of data

The spatial receiver generates a spatial impulse response with $(n+1)^2$ channels per order $n$. The data is formatted in ACN channel order with SN3D normalization.