6.2.15 LoadSourceLocation

6.2.15.1 Outline of the node

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

6.2.15.2 Necessary file

Files in the formats saved from SaveSourceLocation .

6.2.15.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.36 , 6.37 show a network that reads and displays saved localization results.

\includegraphics[width=.8\textwidth ]{fig/modules/LoadSourceLocation}
Figure 6.36: Connection example of LoadSourceLocation  1

\includegraphics[width=.4\textwidth ]{fig/modules/LoadSourceLocation-2}
Figure 6.37: Connection example of LoadSourceLocation  2

6.2.15.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.29: 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.15.5 Details of the node

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

  1. Power: Fixed at 100.0

  2. ID: ID of a sound source saved in a file

  3. $x$ coordinate of sound source position: Cartesian coordinate corresponding to a sound source direction on a unit ball.

  4. $y$ coordinate of sound source position: Cartesian coordinate corresponding to a sound source direction on a unit ball.

  5. $z$ coordinate of sound source position: Cartesian coordinate corresponding to a sound source direction on a unit ball.