Document toolboxDocument toolbox

(8.D.2.1) TableLookup

Overview

Evenly spaced table lookup

Discussion

Multichannel input / multichannel output table lookup module. The table lookup is evenly spaced, using a variety of interpolation methods. The module performs lookup as Y=f(X) where X is the input to the module and Y is the output. The module contains a table of values which are assumed to be linearly spaced. The first value in the table corresponds to the function value at .minX. The last value in the table corresponds to the function value at .maxX. The field .interpolationType determines how the interpolation occurs.

.interpolationType = 0 - output the nearest value .interpolationType = 1 - linear interpolation between the two nearest values.

Input values outside of the range [minX maxX] are clipped.

Type Definition

typedef struct _ModuleTableLookup { ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure INT32 L; // Number of entries in the table. INT32 interpolationType; // Selects the type of interpolation: 0=nearest, 1=linear. FLOAT32 minX; // X value corresponding to the first table entry. FLOAT32 maxX; // X value corresponding to the last table entry. FLOAT32 divisor; // Precomputed constant = (L-1)/(maxX-minX) to eliminate division on the target. FLOAT32* table; // Table of evenly spaced values. } ModuleTableLookupClass;

Variables

Properties

Name

Type

Usage

isHidden

Default value

Range

Units

L

int

const

0

10

2:1:5000

 

interpolationType

int

parameter

0

1

0:1:1

 

minX

float

parameter

0

-1

-1000:1000

 

maxX

float

parameter

0

1

-1000:1000

 

divisor

float

state

0

0

Unrestricted

 

table

float*

parameter

0

[10 x 1]

Unrestricted

 

Pins

Input Pins

Name: in

Description: audio input

Data type: float

Channel range: Unrestricted

Block size range: Unrestricted

Sample rate range: Unrestricted

Complex support: Real

Output Pins

Name: out

Description: audio output

Data type: float

MATLAB Usage

File Name: table_lookup_module.m

M=table_lookup_module(NAME, L) Creates a table lookup module for use in the Audio Weaver environment. This module has 1 multichannel input and 1 multichannel output and performs evenly spaced table lookup using a variety of interpolation schemes. Arguments: NAME - name of the module. L - size of the table. The module performs lookup as Y=f(X) where X is the input to the module and Y is the output. The module contains a table of values which are assumed to be linearly spaced. The first value in the table corresponds to the function value at .minX. The last value in the table corresponds to the function value at .maxX. The field .interpolationType determines how the interpolation occurs. .interpolationType = 0, output the nearest value. .interpolationType = 1, linear interpolation between the two nearest values. Input values outside of the range [minX maxX] are clipped.

Â