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 .

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

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.