HARK version 1.1.0 Document : ConstantLocalization

6.2.11 ConstantLocalization

Outline of the node

A node that continuously outputs constant sound source localization results. There are two parameters used for this node, which are ANGLES and ELEVATIONS, and the user sets azimuths (ANGLES) and elevation angles (ELEVATIONS) that the sound source comes from. Since each of these parameters is Vector , multiple localization results can be output.

Necessary file

No files are required.

Usage

When to use

This node is used in the case that the user wishes to perform evaluations when a source localization result is already known. For example, when wishing to judge whether a problem is in the separation processing or are sound source localization errors, or wishing to evaluate the performance of sound separation under the same sound source localization condition, while evaluating the results of sound source separation.

Typical connection

Figure 6.20 shows a connection example. This network continuously displays constant localization results.

$\includegraphics[]{fig/modules/ConstantLocalization-2}$ $\includegraphics[]{fig/modules/ConstantLocalization}$

Figure 6.20: Connection example of ConstantLocalization

Input-output and property of the node

Input

No inputs.

Output

SOURCES: Vector< ObjectRef > type. Fixed sound source localization results are output. The data ObjectRef refers to Source type data.

Parameter

Table 6.24: Parameter list of ConstantLocalization

Parameter name	Type	Default value	Unit	Description
ANGLES	`Object`	`<Vector<float> >`	[deg]	Azimuth (right or left) of the sound source
ELEVATIONS	`Object`	`<Vector<float> >`	[deg]	Elevation angle (up or down) of the sound source

ANGLES: Vector< float > type. Azimuth (right or left) of the direction that the sound source comes in. The unit of angle is degree.
ELEVATIONS: Vector< float > type. Elevation angle (up or down) of the direction that the sound source comes from. The unit of angle is degree.

Details of the node

It is assumed that the number of sound sources is $N$ , the azimuth (ANGLE) of the $i$ th sound source is $a_ i$ and the elevation angle (ELEVATION) is $e_ i$ . Here, parameters are described as follows.

ANGLES: < Vector< float > $a_1$ $\dots$ $a_ N$ >
ELEVATIONS: < Vector< float > $e_1$ $\dots$ $e_ N$ >

In this way, inputs are performed based on a spherical coordinate system, though the data that ConstantLocalization actually outputs are values in the Cartesian coordinate system $(x_ i, y_ i, z_ i)$ , which correspond to points on the unit ball. Conversion from the spherical coordinate system to the Cartesian coordinate system is performed based on the following equations.

$\displaystyle x_ i$	$\displaystyle =$	$\displaystyle \cos ( a_ i \pi / 180 ) \cos ( e_ i \pi / 180 )$	(5)
$\displaystyle y_ i$	$\displaystyle =$	$\displaystyle \sin ( a_ i \pi / 180 ) \cos ( e_ i \pi / 180 )$	(6)
$\displaystyle z_ i$	$\displaystyle =$	$\displaystyle \sin ( e_ i \pi / 180 )$	(7)

Other than the coordinates of sound sources, ConstantLocalization also outputs the power (fixed at $1.0$ ) and ID (indicated as $i$ ) of the sound source.