6.2.1 CMLoad

Module Overview

Reads the sound source correlation matrix from a file.

Requested Files

A file to save in CMSave  format.

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.10 shows the usage example for the CMLoad node. FILENAMER and FILENAMEI are inouts with type string, indicating the files containing the real and imaginary parts respectively of the correlation matrix. 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.eps}
Figure 6.10: Network Example using CMLoad 

I/O and property setting of the node

Table 6.14: Parameter list of CMLoad 

Parameter name

Type

Default

Unit

Description

NB_CHANNELS

int 

8

 

Number of channels $M$ of the correlation matrix

LENGTH

int 

512

 

Frame length $NFFT$

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 ($M * M$ columns across).

Parameter

NB_CHANNELS

int  type. Number of channels for input signal. Equivalent to the order of the correlation matrix. Default value is 8. Must be matched with the order of the correlation matrix at the time of saving.

LENGTH

int  type. Default value is 512. FFT points at the time of Fourier transform. Must be matched with the FFT points at the time of saving.

ENABLE_DEBUG

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

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 $M^2$ columns. Reading is performed only when OPERATION_FLAG is 1 or true, and immediately after network operation, or when the read filename is changed.