HARK version 1.2.0 Document : LoadSourceLocation

6.2.14 LoadSourceLocation

6.2.14.1 Outline of the node

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

6.2.14.2 Necessary file

Files in the formats saved from SaveSourceLocation .

6.2.14.3 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.30 shows a network that reads and displays saved localization results.

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

Figure 6.30: Connection example of LoadSourceLocation

6.2.14.4 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.

6.2.14.5 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.