Engee documentation

Interpolation Using Prelookup

Using pre-calculated values of indices and fractions to speed up the approximation - dimensional function.

blockType: Interpolation_n-D

Path in the library:

/Basic/Lookup Tables/Interpolation Using Prelookup

Description

Block Interpolation Using Prelookup most effective when using a block Prelookup. Block Prelookup calculates the index and fraction of the interval, which determine how its input value is refers to a data set of reference points. The obtained index and fraction values are fed into the block Interpolation Using Prelookup for interpolation - dimensional table. Both blocks have integrated algorithms.

The block icon will change depending on the set parameters.

Supported block operations

To use the block Interpolation Using Prelookup You must specify a set of table data values directly in the dialog box. As a rule, these tabular values correspond to data sets of reference points specified in blocks Prelookup. Block Interpolation Using Prelookup generates output data by searching or evaluating tabular values based on index values and interval fractions obtained from the block Prelookup. The ports for the index and the interval fraction are displayed as k and f on the block icon Interpolation Using Prelookup.

When entering the values of the index and the fraction of the interval…​ Block Interpolation Using Prelookup…​

Mapping to values in datasets with reference points

Displays the table value at the intersection of rows, columns, and reference points of higher dimension

Are not matched with the values in the data sets of the reference points, but are within the range

Interpolates the corresponding table values using the selected interpolation method

Are not matched with the values in the data sets of the reference points and are out of range

Extrapolates the output value using the selected extrapolation method

Ports

Output

# OUT_1 — approximation of N-dimensional function
scalar | vector | matrix

Details

An approximation of an N-dimensional function calculated by interpolating (or extrapolating) tabular data from the values of the input index, k, and the fraction, f.

Data types

Float64.

Complex numbers support

No

Input

# k1 — index k for the first dimension of the table
scalar | vector | matrix

Details

Index with the first value specifying the interval containing the input value , for the first dimension of the table.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Complex numbers support

No

# f1 — fraction f for the first dimension of the table
scalar | vector | matrix

Details

Fraction , representing the normalised position of the input in the interval for the first dimension of the table.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Complex numbers support

No

# kn — index k for the nth dimension of the table
scalar | vector | matrix

Details

Index with the first value , specifying the interval containing the input value for the nth dimension of the table.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Complex numbers support

No

# fn — fraction f for the nth dimension of the table
scalar | vector | matrix

Details

Fraction , representing the normalised position of the input in the interval for the nth dimension of the table.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Complex numbers support

No

Parameters

Table data

# Number of dimensions — table data dimensionality
Real number

Details

Specify the dimensionality that the table data should have. The number of dimensions determines the number of independent variables for the table.

The maximum table dimensionality supported by this block is 30.

Default value

2

Program usage name

NumberOfTableDimensions

Tunable

No

Evaluatable

Yes

# Value — tabular data values
Array of real numbers

Details

Setting the tabular data as an N-dimensional array, where is the value of the parameters. Number of dimensions.

Default value

sqrt.(collect(1:11) * collect(1:11)')

Program usage name

Table

Tunable

Yes

Evaluatable

Yes

Algorithm

# Interpolation method — interpolation method
Flat | Nearest | Linear point-slope | Linear Lagrange

Details

The method by which the block interpolates the table data.

Read more about interpolation methods here: Methods for approximating function values

Values

Flat | Nearest | Linear point-slope | Linear Lagrange

Default value

Linear point-slope

Program usage name

InterpMethod

Tunable

No

Evaluatable

No

# Extrapolation method — a method of processing input values that are outside the range of the dataset of reference points
Clip | Linear

Details

The method that the block uses to extrapolate values for all inputs that fall outside the range of the reference point dataset.

Read more about extrapolation methods here: Methods for approximating function values

To make the blocks Prelookup and Interpolation Using Prelookup repeat the behaviour of block n-D Lookup Table, the extrapolation method for both blocks Prelookup and must be the same as when using only block . Interpolation Using Prelookup should be the same as for usage of only block n-D Lookup Table.

For example, to get the same behaviour for the n-D Lookup Table block with the Linear extrapolation method, set the extrapolation method to Linear for both the Prelookup block and the Interpolation Using Prelookup block.

The block Interpolation Using Prelookup block does not support linear extrapolation if the input or output signals are of fixed point data type.

Values

Clip | Linear

Default value

Linear

Program usage name

ExtrapMethod

Tunable

No

Evaluatable

No