HARK version 1.1.0 Document : CMLoad

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.