Map Using Prelookup

Use previously calculated index and fraction values to accelerate approximation of two-dimensional function

• 

Libraries:
AUTOSAR Blockset / Classic Platform / Library Routines / Interpolation

Description

The Map Using Prelookup block is intended for use with a Prelookup block. This block enables a prelookup result to drive multiple interpolation results. The Prelookup block calculates the index and interval fraction that specify how its input value u relates to the breakpoint data set and feeds the resulting index and fraction values into a Map Using Prelookup block to interpolate a two-dimensional table. The Prelookup and Map Using Prelookup blocks have distributed algorithms that when used together perform the same algorithm operation as the Map block but offer greater flexibility and more efficient simulation and code generation.

If you select the AUTOSAR 4.0 code replacement library (CRL) for your AUTOSAR model, code generated from this block is replaced with the AUTOSAR library routine that you configure in the block parameters dialog box.

Ports

Input

kf1 — Input containing index k and fraction f

bus object

Inputs to the kf1 port contain index k and fraction f specified as a bus object.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | fixed point | bus

T — Table data

scalar | vector | matrix | 2-d array

Table data values provided as input to port T. These table values correspond to the breakpoint data sets specified in Prelookup blocks. The Interpolation Using Prelookup block generates output by looking up or estimating table values based on index (k) and interval fraction (f) values fed from a Prelookup block.

Dependencies

To enable this port, set Source to Input port.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | fixed point

Output

Port 1 — Approximation of two-dimensional function

scalar | vector | matrix

Approximation of the two-dimensional function computed by interpolating table data that uses values from the input index, k, and the fraction, f.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | fixed point

Parameters

Targeted Routine Library — Indicates the AUTOSAR routine library used for block code replacement

IFX(fixed-point) (default) | IFL(floating-point)

If you select the AUTOSAR 4.0 code replacement library (CRL) for your model, code generated from this block is replaced from the selected AUTOSAR routine library. This parameter enables you to choose either fixed-point (IFX) or floating-point (IFL) code replacement and validation checks.

Targeted Routine — AUTOSAR library routine used for code replacement

Ifx_IpoMap (default)

This parameter reflects the name of the AUTOSAR code replacement library (CRL) routine used to replace the code generated by this block. The naming convention includes the targeted routine library, interpolation method, and block type. This parameter is reference-only and must not be edited.

Table Specification

Data Specification — Choose how to enter table data

Explicit values (default) | Lookup table object

Specify whether to enter table data directly or use a lookup table object. If you set this parameter to:

• Explicit values, the Table Data parameter is visible in the dialog box.

• Lookup table object, the Name parameter is visible in the dialog box.

Programmatic Use

Block Parameter: TableSpecification

Type: character vector

Values: 'Explicit values' | 'Lookup table object'

Default: 'Explicit values'

Name — Name of a Simulink.LookupTable object

Simulink.LookupTable object

Specify the name of a Simulink.LookupTable object. A lookup table object references Simulink^® breakpoint objects. If a Simulink.LookupTable object does not exist, click the action button and select Create. The corresponding parameters of the new lookup table object are populated with the block information.

Dependencies

To enable this parameter, set Data Specification to Lookup table object.

Programmatic Use

Block Parameter: LookupTableObject

Type: character vector

Value: Simulink.LookupTable object

Default: ''

Table data — Define the table of output values

[4 5 6;16 19 20;10 18 23] (default) | character vector

Enter the table of output values.

During simulation, the matrix size must be two-dimensional. However, during block diagram editing, you can enter an empty matrix (specified as []) or an undefined workspace variable. This technique lets you postpone specifying a correctly dimensioned matrix for the table data and continue editing the block diagram.

Dependencies

To enable this parameter, set Data specification to Table and breakpoints.

Programmatic Use

Block Parameter: Table

Type: character vector

Values: matrix of table values

Default: [4 5 6;16 19 20;10 18 23]'

Edit table and breakpoints — Launch Lookup Table Editor dialog box

button

Click this button to open the Lookup Table Editor. For more information, see Edit Lookup Tables in the Simulink documentation.

Clicking this button for a lookup table object lets you edit the object and save the new values for the object.

Algorithm

Interpolation method — Select Linear point-slope or Flat interpolation methods

Linear point-slope (default) | Flat

Specify the method that the block uses to interpolate table data. You can select Linear point-slope or Flat. For more information, see Interpolation Methods.

Programmatic Use

Block Parameter: InterpMethod

Type: character vector

Values: 'Flat' | 'Linear point-slope'

Default: 'Linear point-slope'

Integer rounding mode — Rounding mode for fixed-point operations

Round (default) | Zero

Specify the rounding mode for fixed-point or floating-point lookup table calculations that occur during simulation or execution of code generated from the model.

This option does not affect rounding of values of block parameters. Simulink rounds such values to the nearest representable integer value. To control the rounding of a block parameter, enter an expression using a MATLAB™ rounding function into the edit field on the block dialog box.

Programmatic Use

Block Parameter: RndMeth

Type: character vector

Values: 'Round' | 'Zero'

Default: 'Round'

Data Types

Table data — Data type of table data

Inherit: Same as output (default) | double | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | fixdt(1,16) | fixdt(1,16,0) | fixdt(1,16,2^0,0) | <data type expression>

Specify the table data type. The block will validate that the selected types are compatible with the specification of the targeted routine. You can set it to:

• A rule that inherits a data type, for example, Inherit: Same as output

• The name of a built-in data type, for example, single

• The name of a data type object, for example, a Simulink.NumericType object

• An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Tip

Specify a table data type different from the output data type for these cases:

• Lower memory requirement for storing table data that uses a smaller type than the output signal

• Sharing of prescaled table data between two Curve blocks with different output data types

• Sharing of custom storage table data in the generated code for blocks with different output data types

Programmatic Use

Block Parameter: TableDataTypeStr

Type: character vector

Values: 'Inherit: Inherit from 'Table data'' | 'Inherit: Same as output' | 'double' | 'single' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'fixdt(1,16)' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)'|'<data type expression>'

Default: 'Inherit: Same as output'

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2019a