andresperezlopez/pysofaconventions

python SOFA implementation

pysofaconventions

Python implementation of the SOFA Specification www.sofaconventions.org

Adapted from API_Cpp, the C++ implementation by Thibaut Carpentier. Based on the fork by andresperezlopez which implements the AmbisonicsDRIR Convention v0.1.

installation

automatic installation

sudo pip install pysofaconventions

manual installation

Clone the sources from github:

git clone https://github.com/andresperezlopez/pysofaconventions.git

Then enter the source folder and install using pip to handle python dependencies:

cd pysofaconventions
sudo pip install -e .

dependencies

• netCDF4

examples

Check the /examples folder to see some reference implementations.

changelog

Version 0.1.5, 18/05/2019

• SourceUp.Units and SourceUp.Coordinates are not mandatory
• SingleRoomDRIR: ListenerView.Units and SourceView.Units are not mandatory

Version 0.1.4, 13/05/2019

• ListenerUp.Units and ListenerUp.Coordinates are not mandatory
• SimpleFreeFieldHRIR: mandatory R=2
• Updated to netCDF4-1.5.1.2
• Removed remote build version 3.4 (netcdf4 lib incompatibility)

pysofaconventions's Issues

Possible error in createTestFile.py

In the above mentioned file the variable SourcePositionVar is created by means of sourcePositionVar = rootgrp.createVariable('SourcePosition', 'f8', ('I','C'))
Shouldn't it be sourcePositionVar = rootgrp.createVariable('SourcePosition', 'f8', ('M','C'))? We expect a data that is number of measurements x dimensions (so for example for the MIT KEMAR database with 710 measurements and (azimuth,elevation,distance), we have 710 x 3)

SOFA file dimension

What is the meaning of the I and C dimensions?
They are used in this file https://github.com/andresperezlopez/pysofaconventions/blob/master/examples/createTestFile.py and also inside the different SOFA database I am testing, but I can not figure out their meaning.

Thank you for the help

Validity check failing

Using the latest version of your API from PyPI (I assume that is identical to the current version in the repo?). Loading supposedly valid SOFA files like MIT KEMAR (http://sofacoustics.org/data/database/mit/mit_kemar_normal_pinna.sofa) or THK KU100 (http://sofacoustics.org/data/database/thk/HRIR_L2702.sofa).

Checking the validity fails by SOFAWarning: Missing Variable Attribute: ListenerUp.Units and also some other attributes (havn't checked in detail which else yet).

The convention (https://www.sofaconventions.org/mediawiki/index.php/SimpleFreeFieldHRIR) says that these attributes are not mandatory, i.e. optional I suppose. I think we should modify the validity check accordingly?