Support for recorded source/mic directivities from DIRPAT database (#259)

[fakufaku]

This PR is to integrate the work done by @prerak23 into the master branch:

Generalize for other SOFA files

The goal is to generalize what has been done for DIRPAT by @prerak23 to all SOFA files.
The target syntax is as follows.

# the file reader object reads the file and optionally performs interpolation
# if the file contains multiple directivities, they are all read
hrtf = MeasuredDirectivityFile(
    path="hrtf_file.sofa",
    fs=fs,
    interp_order=12,
    interp_n_points=1000,
)

# orientations can be provided as rotation matrices
orientation = Rotation3D([colatitude_deg, azimuth_deg], "yz", degrees=True)

# we can then choose which directivities we want from the file
dir_left = hrtf.get_mic_directivity("left", orientation=orientation)
dir_right = hrtf.get_mic_directivity("right", orientation=orientation)

TODO

• documentation
• changelog
• Read multiple objects from a single file to be able to simulate mic arrays more smoothly, e.g. eigenmike. This could be implemented by detecting the multiple channels after the call to get_response that would return a (n_image_sources, n_channels, n_taps) array.
• Implement 3D rotations with Euler angles

Co-authored-by: prerak23 [email protected]

Thanks for sending a pull request (PR), we really appreciate that! Before hitting the submit button, we'd be really glad if you could make sure all the following points have been cleared.

Please also refer to the doc on contributing for more details. Even if you can't check all the boxes below, do not hesitate to go ahead with the PR and ask for help there.

• Are there docstrings ? Do they follow the numpydoc style ?
• Have you run the tests by doing nosetests or py.test at the root of the repo ?
• Have you checked that the doc builds properly and that any new file has been added to the repo ? How to do that is covered in the documentation.
• Is there a unit test for the proposed code modification ? If the PR addresses an issue, the test should make sure the issue is fixed.
• Last but not least, did you document the proposed change in the CHANGELOG file ? It should go under "Unreleased".

Happy PR 😃

[fakufaku]

@prerak23
How are you doing?
I have made good progress, and I am feeling good about releasing things soon.
Would you mind taking a look at the current code?
I have also created some documentation here
(I don't have your new email address, so please send me an email)