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.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 I/O and property setting of the node

Table 6.16: Parameter list of CMLoad 

Parameter name









ON/OFF of debugging information output



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


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


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



: 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).



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