6.2.13 DisplayLocalization

6.2.13.1 Outline of the node

This node displays sound source localization results using GTK.

6.2.13.2 Necessary file

No files are required.

6.2.13.3 Usage

When to use

This node is used when wishing to visually confirm the sound source location results.

Typical connection

This node is connected after localization nodes such as ConstantLocalization  or LocalizeMUSIC . The example in Figure 6.28 continuously displays fixed localization results from ConstantLocalization .

\includegraphics[width=.8\textwidth ]{fig/modules/DisplayLocalization}
Figure 6.28: Connection example of DisplayLocalization 

6.2.13.4 Input-output and property of the node

Input

SOURCES

: Vector< ObjectRef >  type. Users enter the data (Source  type) that indicate source positions.

Output

OUTPUT

: Vector< ObjectRef >  type. Input values (Source  type) are output.

Parameter

Table 6.27: Parameter list of DisplayLocalization 

Parameter name

Type

Default value

Unit

Description

WINDOW_NAME

string 

Source Location

 

Name of the GUI window that displays

WINDOW_LENGTH

int 

1000

Frame

Length of the GUI window that displays

       

sound source localization results

VERTICAL_RANGE

Vector< int > 

See below

 

Plot range for the vertical axis

PLOT_TYPE

string 

AZIMUTH

 

Type of data for plotting

WINDOW_NAME

]: string  type. Name of the GUI window.

WINDOW_LENGTH

]: int  type. The default value is 1000. This parameter can be adjusted according to the length of the sound source localization results that the user wishes to see.

VERTICAL_RANGE

: Vector< int >  type. The plot range for the vertical axis. This is the vector of 2 elements. The first and second elements denote the minimum and maximum values of the data, respectively. In the default setting, namely <Vector<int> -180 180>, this module plots the azimuth data from -180[deg] to 180[deg].

PLOT_TYPE

: string type. The type of data for plotting. If AZIMUTH, this module plots the result of azimuth estimation. If ELEVATION, this module plots the result of elevation estimation.

6.2.13.5 Details of the node

Colors are different for each ID though the colors themselves do not have any particular meaning.