irdl.get_fabian

irdl.get_fabian(kind: str = 'measured', hato: int = 0, path: str = PosixPath('/home/runner/.cache/irdl'), output_format: str = 'pyfar')

Download and extract the FABIAN HRTF Database v4 from DepositOnce.

DOI: 10.14279/depositonce-5718.5

Parameters:

kindstr

Type of HRTF to download. Either 'measured' or 'modeled'.

hatoint

Head-above-torso-rotation of HRTFs in degrees. Either 0, 10, 20, 30, 40, 50, 310, 320, 330, 340 or 350.

pathstr or pathlib.Path

Path to the directory where the data should be stored. Will be overwritten, if the environment variable IRDL_DATA_DIR is set. Default is the user cache directory.

output_formatstr

Output format of the returned data. Either 'pyfar' (default), 'hdf5', or 'numpy'.

Returns:

datadict or pathlib.Path

Returned data depends on output_format:

• 'pyfar' : dict with keys 'impulse_response' (pyfar.Signal), 'source_coordinates' (pyfar.Coordinates), and 'receiver_coordinates' (pyfar.Coordinates).

• 'hdf5' : pathlib.Path to the HDF5 file containing the data.

• 'numpy' : dict with keys 'impulse_response' (numpy.ndarray), 'source_coordinates' (numpy.ndarray), 'receiver_coordinates' (numpy.ndarray), and 'sampling_rate' (float).