6.2.15 SaveSourceLocation

Outline of the node

This nodes saves source localization results.

Necessary file

No files are required

Usage

When to use

This node is used when a localization result is saved in a file for analysis of the localization result later. To read the saved file, the LoadSourceLocation  node is used.

Typical connection

Figure 6.30 shows a typical connection example. The network shown in the example saves fixed localization results in files. For the save format, see . Moreover, this node can be connected to nodes that output localization results (e.g. LocalizeMUSIC , ConstantLocalization  or LoadSourceLocation ).

\includegraphics[width=100mm]{fig/modules/SaveSourceLocation}
Figure 6.30: Connection example of SaveSourceLocation 

Input-output and property of the node

Input

SOURCES

Vector<ObjectRef>  type. Source localization results are input. ObjectRef  type refers to Source  type data.

Output

OUTPUT

Vector<ObjectRef>  type. Inputs (Source type) are output without modification.

Parameter

FILENAME

string  type. No default values.

Table 6.28: Parameter list of SaveSourceLocation 

Parameter name

Type

Default value

Unit

Description

FILENAME

string 

   

Name of the file that the user wishes to save

Details of the nodes

Typical error messages and their reasons

FILENAME is empty
Node parameter FILENAME is not assigned.

Can't open file name
File open for write failed because, for example, the file is not writable.