A spatially-localised active-intensity (SLAI) based direction-of- arrival estimator (SLDoA) More...

#include "sldoa.h"
#include "sldoa_internal.h"

Functions
void	sldoa_setCodecStatus (void *const hSld, CODEC_STATUS newStatus)
	Sets codec status (see CODEC_STATUS enum)

void	sldoa_initAna (void *const hSld)
	Intialises the codec variables, based on current global/user parameters.

void	sldoa_initTFT (void *const hSld)
	Initialise the filterbank used by sldoa.

void	sldoa_estimateDoA (float_complex *SHframeTF, int anaOrder, float_complex secCoeffs, float doa[MAX_NUM_SECTORS][TIME_SLOTS][2], float energy[MAX_NUM_SECTORS][TIME_SLOTS])
	Estimates the DoA using the active intensity vectors derived from spatially localised sectors, as in [1,2].

Detailed Description

A spatially-localised active-intensity (SLAI) based direction-of- arrival estimator (SLDoA)

VBAP gain patterns are imposed on the spherical harmonic signals, such that the DoA can be estimated in a spatially-constrained region; thus mitigating the effect of interferes and reflections arriving from other directions. The DoA is estimated per sector for each frequency band.

The algorithms within sldoa were developed in collaboration with Symeon Delikaris-Manias and Angelo Farina, and are explained in more detail in [1,2]

See also: [1] McCormack, L., Delikaris-Manias, S., Politis, A., Pavlidi, D., Farina, A., Pinardi, D. and Pulkki, V., 2019. Applications of Spatially Localized Active-Intensity Vectors for Sound-Field Visualization. Journal of the Audio Engineering Society, 67(11), pp.840-854.; [2] McCormack, L., Delikaris-Manias, S., Farina, A., Pinardi, D., and Pulkki, V., "Real-time conversion of sensor array signals into spherical harmonic signals with applications to spatially localised sub-band sound-field analysis," in Audio Engineering Society Convention 144, Audio Engineering Society, 2018.

Author: Leo McCormack

Date: 18.10.2017

License: ISC

Definition in file sldoa_internal.c.

Function Documentation

◆ sldoa_estimateDoA()

void sldoa_estimateDoA	(	float_complex **	SHframeTF,
		int	anaOrder,
		float_complex *	secCoeffs,
		float	doa[MAX_NUM_SECTORS][TIME_SLOTS][2],
		float	energy[MAX_NUM_SECTORS][TIME_SLOTS] )

Estimates the DoA using the active intensity vectors derived from spatially localised sectors, as in [1,2].

Note: If anaOrder is 1, then the algorithm reverts to the standard active- intensity based DoA estimation.

Parameters

[in]	SHframeTF	Input SH frame; MAX_NUM_SH_SIGNALS x TIME_SLOTS
[in]	anaOrder	Analysis order (1:AI, 2+: SLAI)
[in]	secCoeffs	Sector coefficients for this order
[out]	doa	Resulting DoA estimates per timeslot and sector
[out]	energy	Resulting sector energies per time slot

See also: [1] McCormack, L., Delikaris-Manias, S., Farina, A., Pinardi, D., and Pulkki, V., “Real-time conversion of sensor array signals into spherical harmonic signals with applications to spatially localised sub-band sound-field analysis,” in Audio Engineering Society Convention 144, Audio Engineering Society, 2018.; [2] McCormack, L., Delikaris-Manias, S., Politis, A., Pavlidi, D., Farina, A., Pinardi, D. and Pulkki, V., 2019. Applications of Spatially Localized Active-Intensity Vectors for Sound-Field Visualization. Journal of the Audio Engineering Society, 67(11), pp.840-854.

Definition at line 145 of file sldoa_internal.c.

◆ sldoa_initAna()

void sldoa_initAna ( void *const hSld )

Intialises the codec variables, based on current global/user parameters.

The formulae for calculating the sector coefficients can be found in [1,2].

See also: [1] McCormack, L., Delikaris-Manias, S., Farina, A., Pinardi, D., and Pulkki, V., “Real-time conversion of sensor array signals into spherical harmonic signals with applications to spatially localised sub-band sound-field analysis,” in Audio Engineering Society Convention 144, Audio Engineering Society, 2018.; [2] McCormack, L., Delikaris-Manias, S., Politis, A., Pavlidi, D., Farina, A., Pinardi, D. and Pulkki, V., 2019. Applications of Spatially Localized Active-Intensity Vectors for Sound-Field Visualization. Journal of the Audio Engineering Society, 67(11), pp.840-854.

Definition at line 60 of file sldoa_internal.c.

◆ sldoa_initTFT()

void sldoa_initTFT ( void *const hSld )

Initialise the filterbank used by sldoa.

Note: Call this function before sldoa_initAna()

Input Arguments: hSld - sldoa handle

Definition at line 127 of file sldoa_internal.c.

◆ sldoa_setCodecStatus()

void sldoa_setCodecStatus	(	void *const	hSld,
		CODEC_STATUS	newStatus )

Sets codec status (see CODEC_STATUS enum)