Sofaconventions - User contributions [en]

Software and APIs

2017-02-10T07:57:28Z

Christian Hoene: /* libmysofa */

== API for Matlab/Octave ==

An application-programming interface (API) for Matlab and Octave.

The releases are provided at [https://sourceforge.net/projects/sofacoustics/ Sourceforge].

The sources are stored at [https://github.com/sofacoustics/sofa github]

'''Note:'''
* The last stable version 0.4.3 does not fully support the recently published standard AES69-2015.
* The full support of AES69-2015 is provided with the version 1.0, which is now in the stage of being a release candidate 2 (1.0RC2).

If you have questions about this API, please send an email to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the list moderator.

== API for C++ ==

An API for C++ is available online. The version 1.0 is in accordance with the AES69-2015 standard.

The sources are stored at [https://github.com/sofacoustics/API_Cpp github]

If you have questions about this API, please send an email to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the list moderator.

== SOFAlizer: Demo of a SOFA-based audio engine in C++ ==

SOFAlizer is a simple demo of an audio engine as a plugin for the [http://www.videolan.org/vlc/ VLC-Player].

Currently, Windows binaries of the VLC-Player 2.1 compiled with the SOFAlizer plugin are available. In order to use SOFAlizer:
* Download the official VLC 2.1 from [https://www.videolan.org/vlc/releases/2.1.0.html#download here] and install on your machine
* Download the SOFAlizer from [https://github.com/sofacoustics/SOFAlizer/releases/tag/0.1.0 here], unzip, and copy over your VLC installation
* Start VLC
* Goto Tools, Preferences, check "Show settings: All"
* In the left panel, for Audio/Filters, check "SOFAlizer"
* In the left panel, for Audio/Filters/SOFAlizer, select at SOFA file 1,2,3 up to three SOFA files
* Click on Save
* Goto Tools/Effects and Filters, in that panel, select "SOFAlizer"
* Enable SOFAlizer
* Load a audio/video file, enjoy

The source code is available [https://github.com/sofacoustics/SOFAlizer here]. The file [https://github.com/sofacoustics/SOFAlizer/blob/master/modules/audio_filter/sofalizer/sofalizer.c sofalizer.c] can serve as an example of how to load SOFA files in C++.

== WaveCloud-M ==

[http://www.ee.bgu.ac.il/~sheaffer/wavecloud.html WaveCloud-M] is Matlab-oriented room simulator. Beginning with version 1.0, WaveCloud-M can use HRTFs saved in SOFA to render binaural signals.

== Spat ==
[http://forumnet.ircam.fr/product/spat-en/ Spat] is a software suite for spatialization of sound signals in real-time intended for musical creation, postproduction, and live performances made by IRCAM. It supports SOFA for binaural rendering.

== HDF5View ==

SOFA files are based on [http://en.wikipedia.org/wiki/NetCDF netCDF-4]. NetCDF is based on [http://en.wikipedia.org/wiki/Hdf5 HDF5]. [http://www.hdfgroup.org/hdf-java-html/hdfview/ HDFView] is a generic viewer for [http://en.wikipedia.org/wiki/Hdf5 HDF5] files running in Java.

Thus, SOFA files can be loaded and edited in the HDFView.

== libmysofa ==

[https://github.com/hoene/libmysofa Libmysofa] is a light weight C-library to read SOFA files.

It hardly has any library dependencies and is suitable for embedded devices.

In addition, it normalizes the input data and provides a function to look up and to interpolate the FIR filters for a given orientation.

Software and APIs

2017-02-04T17:20:16Z

Christian Hoene:

== API for Matlab/Octave ==

An application-programming interface (API) for Matlab and Octave.

The releases are provided at [https://sourceforge.net/projects/sofacoustics/ Sourceforge].

The sources are stored at [https://github.com/sofacoustics/sofa github]

'''Note:'''
* The last stable version 0.4.3 does not fully support the recently published standard AES69-2015.
* The full support of AES69-2015 is provided with the version 1.0, which is now in the stage of being a release candidate 2 (1.0RC2).

If you have questions about this API, please send an email to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the list moderator.

== API for C++ ==

An API for C++ is available online. The version 1.0 is in accordance with the AES69-2015 standard.

The sources are stored at [https://github.com/sofacoustics/API_Cpp github]

If you have questions about this API, please send an email to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the list moderator.

== SOFAlizer: Demo of a SOFA-based audio engine in C++ ==

SOFAlizer is a simple demo of an audio engine as a plugin for the [http://www.videolan.org/vlc/ VLC-Player].

Currently, Windows binaries of the VLC-Player 2.1 compiled with the SOFAlizer plugin are available. In order to use SOFAlizer:
* Download the official VLC 2.1 from [https://www.videolan.org/vlc/releases/2.1.0.html#download here] and install on your machine
* Download the SOFAlizer from [https://github.com/sofacoustics/SOFAlizer/releases/tag/0.1.0 here], unzip, and copy over your VLC installation
* Start VLC
* Goto Tools, Preferences, check "Show settings: All"
* In the left panel, for Audio/Filters, check "SOFAlizer"
* In the left panel, for Audio/Filters/SOFAlizer, select at SOFA file 1,2,3 up to three SOFA files
* Click on Save
* Goto Tools/Effects and Filters, in that panel, select "SOFAlizer"
* Enable SOFAlizer
* Load a audio/video file, enjoy

The source code is available [https://github.com/sofacoustics/SOFAlizer here]. The file [https://github.com/sofacoustics/SOFAlizer/blob/master/modules/audio_filter/sofalizer/sofalizer.c sofalizer.c] can serve as an example of how to load SOFA files in C++.

== WaveCloud-M ==

[http://www.ee.bgu.ac.il/~sheaffer/wavecloud.html WaveCloud-M] is Matlab-oriented room simulator. Beginning with version 1.0, WaveCloud-M can use HRTFs saved in SOFA to render binaural signals.

== Spat ==
[http://forumnet.ircam.fr/product/spat-en/ Spat] is a software suite for spatialization of sound signals in real-time intended for musical creation, postproduction, and live performances made by IRCAM. It supports SOFA for binaural rendering.

== HDF5View ==

SOFA files are based on [http://en.wikipedia.org/wiki/NetCDF netCDF-4]. NetCDF is based on [http://en.wikipedia.org/wiki/Hdf5 HDF5]. [http://www.hdfgroup.org/hdf-java-html/hdfview/ HDFView] is a generic viewer for [http://en.wikipedia.org/wiki/Hdf5 HDF5] files running in Java.

Thus, SOFA files can be loaded and edited in the HDFView.

== libmysofa ==

[https://github.com/choene/libmysofa Libmysofa] is a light weight C-library to read SOFA files.

It hardly has any library dependencies and is suitable for embedded devices.

In addition, it normalizes the input data and provides a function to look up and to interpolate the FIR filters for a given orientation.

Software and APIs

2017-02-04T17:19:29Z

Christian Hoene:

== API for Matlab/Octave ==

An application-programming interface (API) for Matlab and Octave.

The releases are provided at [https://sourceforge.net/projects/sofacoustics/ Sourceforge].

The sources are stored at [https://github.com/sofacoustics/sofa github]

'''Note:'''
* The last stable version 0.4.3 does not fully support the recently published standard AES69-2015.
* The full support of AES69-2015 is provided with the version 1.0, which is now in the stage of being a release candidate 2 (1.0RC2).

If you have questions about this API, please send an email to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the list moderator.

== API for C++ ==

An API for C++ is available online. The version 1.0 is in accordance with the AES69-2015 standard.

The sources are stored at [https://github.com/sofacoustics/API_Cpp github]

If you have questions about this API, please send an email to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the list moderator.

== SOFAlizer: Demo of a SOFA-based audio engine in C++ ==

SOFAlizer is a simple demo of an audio engine as a plugin for the [http://www.videolan.org/vlc/ VLC-Player].

Currently, Windows binaries of the VLC-Player 2.1 compiled with the SOFAlizer plugin are available. In order to use SOFAlizer:
* Download the official VLC 2.1 from [https://www.videolan.org/vlc/releases/2.1.0.html#download here] and install on your machine
* Download the SOFAlizer from [https://github.com/sofacoustics/SOFAlizer/releases/tag/0.1.0 here], unzip, and copy over your VLC installation
* Start VLC
* Goto Tools, Preferences, check "Show settings: All"
* In the left panel, for Audio/Filters, check "SOFAlizer"
* In the left panel, for Audio/Filters/SOFAlizer, select at SOFA file 1,2,3 up to three SOFA files
* Click on Save
* Goto Tools/Effects and Filters, in that panel, select "SOFAlizer"
* Enable SOFAlizer
* Load a audio/video file, enjoy

The source code is available [https://github.com/sofacoustics/SOFAlizer here]. The file [https://github.com/sofacoustics/SOFAlizer/blob/master/modules/audio_filter/sofalizer/sofalizer.c sofalizer.c] can serve as an example of how to load SOFA files in C++.

== WaveCloud-M ==

[http://www.ee.bgu.ac.il/~sheaffer/wavecloud.html WaveCloud-M] is Matlab-oriented room simulator. Beginning with version 1.0, WaveCloud-M can use HRTFs saved in SOFA to render binaural signals.

== Spat ==
[http://forumnet.ircam.fr/product/spat-en/ Spat] is a software suite for spatialization of sound signals in real-time intended for musical creation, postproduction, and live performances made by IRCAM. It supports SOFA for binaural rendering.

== HDF5View ==

SOFA files are based on [http://en.wikipedia.org/wiki/NetCDF netCDF-4]. NetCDF is based on [http://en.wikipedia.org/wiki/Hdf5 HDF5]. [http://www.hdfgroup.org/hdf-java-html/hdfview/ HDFView] is a generic viewer for [http://en.wikipedia.org/wiki/Hdf5 HDF5] files running in Java.

Thus, SOFA files can be loaded and edited in the HDFView.

== libmysofa ==

[https://github.com/choene/libmysofa Libmysofa] is a light weight C-library to read SOFA files. It hardly has any library dependencies and is suitable for embedded devices. In addition, it normalizes the input data and provides a function to look up and to interpolate the FIR filters for a given orientation.