HARK version 1.1.0 Document : LoadSourceLocation

6.2.14 LoadSourceLocation

Outline of the node

This node reads the source localization results stored in the SaveSourceLocation node.

Necessary file

Files in the formats saved from SaveSourceLocation .

Usage

When to use

This node is used when wishing to reuse a source localization result or to evaluate different sound source separation methods based on the exact same source localization result.

Typical connection

Figure 6.29 shows a network that reads and displays saved localization results.

$\includegraphics{fig/modules/LoadSourceLocation-2}$ $\includegraphics{fig/modules/LoadSourceLocation}$

Figure 6.29: Connection example of LoadSourceLocation

Input-output and property of the node

Input

No inputs.

Output

SOURCES: Vector<ObjectRef> type. The read localization result is output in the format same as those for source localization nodes (e.g. LocalizeMUSIC or ConstantLocalization ). ObjectRef refers Source type data.
NOT_EOF: bool type. Since this outputs false when the file has been read till the end, this terminal can be used as a termination condition of an Iteration subnetwork.

Parameter

Table 6.27: Parameter list of LoadSourceLocation

Parameter name	Type	Default value	Unit	Description
FILENAME	`string`			File name of the file to be read

FILENAME: string type. The name of the file to be read.

Details of the node

The source localization result output by this node is a Vector of objects containing five variables as follows.

Power Fixed at 100.0
ID ID of a sound source saved in a file
$x$ coordinate of sound source position Cartesian coordinate corresponding to a sound source direction on a unit ball.
$y$ coordinate of sound source position Cartesian coordinate corresponding to a sound source direction on a unit ball.
$z$ coordinate of sound source position Cartesian coordinate corresponding to a sound source direction on a unit ball.