(8.D.2.6) WOLAAnalysisV2
Overview
Analysis filterbank of an oversampled filterbank with selectable prototype filter
Discussion
This module implements version 2 of the analysis portion of a weighted-overlap filterbank. The first parameter is the filter type, v1 is the same prototype filter from the original WOLA. An additional parameter - timeFlip, has been introduced and is only valid for V1. By default the filter will be minimum phase at anaylsis, and maximum phase for synthesis. It may be advantageous to switch this for AEC applications - i.e. use min/max for input and max/min for reference. Note that final signal through analysis / synthesis is always linear phase. For v2, the module argument for attenuation is replaced by filter order. As a module argument, you specify the FFT size K, and the prototype filter order. The module inherits the block size from the input wire. The oversampling factor of the module is defined as K / (input block size). For example, if the block size of the input pin is K/2 then the module has an oversampling factor of 2. For reasonable reconstruction accuracy you should keep the oversampling factor to be at least 2. The module decimates by the input block size and the output sample rate will be reduced accordingly. In general, the V2 version will be equivalent or overperform V1 for lower latencies when the oversampling factor is >= 2, and should be considered for lower latency applications.
The length of the prototype filter (L) affects the latency through an analysis filter by: L - blockSize. Higher L will have higher attenuation (or less aliasing distortion), but also more latency. The module displays the latency on the canvas allowing you to compensate for it in other parts of the signal flow. The latency shown is the latency through the combination of the analysis and synthesis banks.
This module is usually used in conjunction with the wola_synthesis_v2_subsystem.m. The synthesis filterbank converts back from the frequency domain to the time domain. The synthesis filterbank must have exactly the same settings for K, the filter order, and the output block size of the synthesis bank must match the input block size of the corresponding analysis bank. This is not checked for but you will get distorted sound if this is not true.
This module is equivalent to V1, except for the method of design of the prototype filters. The Audio Weaver Module Users Guide has extensive documentation for v1 of this module. Please refer to this other document for more general WOLA information.
Type Definition
-Not Shown-
Variables
Properties
Name | Type | Usage | isHidden | Default value | Range | Units |
latency | int | const | 0 | 352 | Unrestricted | samples |
Pins
Input Pins
Name: t
Description: Time domain signal
Data type: float
Channel range: Unrestricted
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Real
Output Pins
Name: f
Description: Frequency domain subbands
Data type: float
Scratch Pins
Channel count: 1
Block size: 128
Sample rate: 48000
Â
Channel count: 1
Block size: 65
Sample rate: 48000
Â
Channel count: 1
Block size: 129
Sample rate: 48000
MATLAB Usage
File Name: wola_analysis_v2_subsystem.m
SYS=wola_analysis_v2_subsystem((NAME, K, ATTEN)
Creates an Audio Weaver subsystem that implements the analysis bank of an
oversampled filterbank. The analysis bank splits a time domain input
signal into multiple decimated frequency subbands. This version returns
a floating-point implementation. The input block size is inherited and
should be >= (and close) to K/2.
Arguments:
NAME - name of the subsystem
FILTERTYPE - prototpe filter design type
PARAM1 - type 1/2: K - size of the FFT (must be a power of 2)
PARAM2 - type 1 - attenuation, type 2 filter order
PARAM3 - reserved, enter 0
TIMEFLIP - option to use normal (1): min phase in / max phase out, or
(2) time flipped: max phase in, min phase out. This option
is ignored for FILTERTYPE == 2
Internally, the stft_design_v2.m functions is used to
design the filterbank. Refer to this file for more details.
Â