Home

Awesome

Ambisonic Toolkit Matrices

A set of (real) matrix files for use by matrix mixing encoders and decoders.

Features

The ATK's fixed matrices are designed to support a variety of useful encoding and decoding strategies. Encoding means, converting from some other signal format, e.g., monophonic or stereophonic, to Ambisonic B-format. Decoding means converting from Ambisonic B-format.

Encoders

Transformers

Decoders


Matrix formats

Each matrix is provided in several formats:

.yml

A YAML file containing the matrix along with verbose metadata. Refer to flu-dec.yml for an example.

.txt

A text file containing the matrix, with one row per line, and cell values separated by spaces. Refer to flu-dec.txt for an example.

.mosl.txt

A text file containing one cell value per line. The first two values gives the dimension of the matrix as number of rows and number of columns. Empty lines can be used for improved readability. Comment lines can be added, starting with # or ;. Inline comments are also supported. Refer to flu-dec.mosl.txt for an example.


Using Matrices with Reaper

The matrices are included as part of the ATK for Reaper install, and there is no need to download and install the matrices separately.

Using Matrices with SuperCollider

Install ATK for SuperCollider. Launch SuperCollider3, and run the following code:

ATK Matrix Installation
(
// Create ATK support directory
// Place unzipped matrices in the directory opened  

Atk.createUserSupportDir;
Atk.openUserSupportDir;
)

If ATK for SuperCollider has been correctly installed, the above code will open the ATK's user support directory. Place the downloaded matrices here.

If you use ATK for Reaper as well as ATK for SuperCollider on Mac OSX, the matrices are shared between the two programs, and they will reside in the same location. We do not expect this to cause any problems.


Feedback and Bug Reports

Known issues are logged at GitHub.

If you experience problems or have questions pertaining to the ATK Matrices, please create an issue in the ATK-Matrices issue tracker.

If you use the matrices for an artistic project, please let us know. We plan on adding a gallery of example artistic and creative projects that make use of the Ambisonic Toolkit.

If you wish to use the matrices as part of a technical or software project, we'd like to know about that too. We're planning to link to other projects making use of Ambisonic Toolkit assets.

List of Changes

Version 1.0.3

Version 1.0.2

Version 1.0.1

Version 1.0.0

Credits

The matrix files distributed with the Ambisonic Toolkit are licensed under a Creative Commons Attribution-Share Alike 3.0 Unported (CC BY-SA 3.0) License and are copyright the Ambisonic Toolkit Community and Joseph Anderson, 2017-22.

 

 

Third Party Notices

 

Irregular array decoding

Irregular array decoding coefficients (5.0) are kindly provided by Bruce Wiggins: http://www.brucewiggins.co.uk/

B. Wiggins, "An Investigation into the Real-time Manipulation and Control of Three-dimensional Sound Fields," PhD Thesis, University of Derby, Derby, 2004.