Processing math: 100%

6.2.1 CMLoad

6.2.1.1 Module Overview

Reads the sound source correlation matrix from a file.

6.2.1.2 Requested Files

A file to save in CMSave  format.

6.2.1.3 Usage

In what case is the node used?

Use when reading the correlation matrix of a sound source saved using CMSave .

Typical Examples

Figure 6.15 shows the usage example for the CMLoad node.

OPERATION_FLAG is int  type or bool  type of input, and specifies when reading the correlation matrix is read. In the usage example, for all inputs of FILENAMER, FILENAMEI, OPERATION_FLAG, Constant nodes are connected. Parameters during run-time are constant, but the output of the constant node is dynamic and hence it is possible to change the correlation matrix used.

\includegraphics[width=0.8\linewidth ]{fig/modules/CMLoad}
Figure 6.15: Network Example using CMLoad 

6.2.1.4 I/O and property setting of the node

Table 6.16: Parameter list of CMLoad 

Parameter name

Type

Default

Unit

Description

ENABLE_DEBUG

bool 

false

 

ON/OFF of debugging information output

Input

FILENAMER

: string  type. Name of the file containing the real part of the correlation matrix.

FILENAMEI

: string  type. Name of the file containing the imaginary part of the correlation matrix.

OPERATION_FLAG

: int  type or bool  type. Only when this input terminal is 1 or when true, and the filename changes, the correlation matrix is read.

Output

OUTPUTCM

: Matrix<complex<float> >  type. A correlation matrix for each frequency bin. A M-th order complex square array with correlation matrix outputs NFFT/2+1 items. Matrix<complex<float> >  contains rows corresponding to frequency (NFFT/2+1 rows), and columns containing the complex correlation matrix (MM columns across).

Parameter

ENABLE_DEBUG

: bool  type. Default value is false. When true, it is output to the standard output when reading the correlation matrix.

6.2.1.5 Module Description

M-th order complex square array for each frequency bin with the correlation matrix’s real and imaginary parts is read as a Matrix<float>  type from the respective files. If the number of frequency bins is k, and (k=NFFT/2+1), then each read file consists of k rows and M2 columns. Reading is performed only when OPERATION_FLAG is 1 or true, and immediately after network operation, or when the read filename is changed.