6.2.2 CMSave

6.2.2.1 Module Overview

Saves the sound source correlation matrix to a file.

6.2.2.2 Requested Files

None.

6.2.2.3 Usage

In what case is the node used?

Use when saving the correlation matrix for a sound source, created from CMMakerFromFFT  or CMMakerFromFFTwithFlag , etc.

Typical Examples

Figure. 6.12 shows a usage example of CMSave  node.

INPUTCM input terminal is connected with a correlation matrix calculated from CMMakerFromFFT  or CMMakerFromFFTwithFlag , etc.

OPERATION_FLAG is int  type or bool  type input, specifying when the correlation matrix is read. (Figure. 6.12 shows the connection of an Equal node as an example. However, if the node can output int  type or bool  type, then it does not matter at all).

\includegraphics[width=0.7\linewidth ]{fig/modules/CMSave}
Figure 6.12: Network Example using CMSave 

6.2.2.4 I/O and property setting of the node

Table 6.15: Parameter list of CMSave

Parameter

Type

Default

Unit

Description

ENABLE_DEBUG

bool 

false

 

ON/OFF of debugging information output

Input

INPUTCM

: Matrix<complex<float> >  type. Correlation matrix of each frequency bin. $M$-th order complex square array with correlation matrix outputs $NFFT/2 + 1$ items. Matrix<complex<float> >  indicates the row of frequency ($NFFT/2 + 1$ rows), and column of complex correlation matrix ($M * M$ columns).

FILENAMER

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

FILENAMEI

: string  type. Name of 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, the correlation matrix is saved.

Output

OUTPUTCM

: Matrix<complex<float> >  type. Same as INPUTCM.

Parameter

ENABLE_DEBUG

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

6.2.2.5 Module Description

Saving is performed only when OPERATION_FLAG is 1 or true.