Mapping File for User-Defined Interpolation Routine

The ASCET interpolation routines search, interpol and getAt must be mapped to function names in the generated code. For this purpose, a mapping file (*.ini) must be created.

The mapping file is similar to the services.ini file used for arithmetic services. It has sections named like a target (e.g., [<target name>]), like a target group, i.e. [Experiment] for experimental targets (RP targets, PC target, Prototyping target) and [Production] for microcontroller targets, or [Interpolation].

To select an interpolation routine, a section named like the current target is searched first. If the interpolation routine cannot be found in such a section, the section [Experiment] or [Production] is searched, depending on whether you are using an experimental target or a microcontroller target. If the interpolation routine still cannot be found, it is searched in section [Interpolation]. With that, you can use one mapping file for all targets, and reuse identical definitions for multiple targets.

Routines for non-adaptive characteristic lines/maps are mapped Closed as follows.

Routines for adaptive characteristic lines/maps are mapped Closed as follows.

Mapping: adaptive characteristic lines

ASCET Routine	Meaning
interpol1\|tx\|tv	Interpolation routine for characteristic line
interpol2\|tx\|ty\|tv	Interpolation routine for characteristic map
getAt1\|tx\|tv	Access to characteristic line
getAt2\|tx\|ty\|tv	Access to characteristic map
getAtFixed1\|tx\|tv	Access to fixed characteristic curve
getAtFixed2\|tx\|ty\|tv	Access to fixed characteristic map
searchDistrib\|tx	Search for sample points in distribution
interpolGroup1\|tx\|tv	Interpolation routine for group characteristic line
interpolGroup2\|tx\|ty\|tv	Interpolation routine for group characteristic map
getX1\|tx	Gets X axis point of characteristic line
getX2\|tx	Gets X axis point of characteristic map
getY2\|ty	Gets Y axis point of characteristic map
setX1\|tx	Sets X axis point of characteristic line
setX2\|tx	Sets X axis point of characteristic map
setY2\|ty	Sets Y axis point of characteristic map
getValue1\|tv	Gets value of characteristic line
getValue2\|tv	Gets value of characteristic map
setValue1\|tv	Sets value of characteristic line
setValue2\|tv	Sets value of characteristic map
getCurrentSize1	Gets current size of characteristic line
getCurrentSizeX2	Gets current X size of characteristic map
getCurrentSizeY2	Gets current Y size of characteristic map
setCurrentSize1	Sets current size of characteristic line
setCurrentSizeX2	Sets current X size of characteristic map
setCurrentSizeY2	Sets current Y size of characteristic map
getValueFixed1\|tv	Gets value of fixed characteristic line
getValueFixed2\|tv	Gets value of fixed characteristic map
setValueFixed1\|tv	Sets value of fixed characteristic line
setValueFixed2\|tv	Sets value of fixed characteristic map
getCurrentSizeFixed1	Gets current size of fixed characteristic line
getCurrentSizeFixedX2	Gets current X size of fixed characteristic map
getCurrentSizeFixedY2	Gets current Y size of fixed characteristic map
setCurrentSizeFixed1	Sets current size of fixed characteristic line
setCurrentSizeFixedX2	Sets current X size of fixed characteristic map
setCurrentSizeFixedY2	Sets current Y size of fixed characteristic map
searchDistrib\|t1	Search for sample points in distribution
getXDistrib\|tx	Gets X axis point of distribution
setXDistrib\|tx	Sets X axis point of distribution
getCurrentSizeDistrib	Gets current size of distribution
setCurrentSizeDistrib	Sets current size of distribution
interpolGroup1\|tx\|tv	Interpolation routine for group characteristic line
interpolGroup2\|tx\|ty\|tv	Interpolation routine for group characteristic map
getValueGroup1\|tv	Gets value of group characteristic line
getValueGroup2\|tv	Gets value of group characteristic map
setValueGroup1\|tv	Sets value of group characteristic line
setValueGroup2\|tv	Sets value of group characteristic map
getCurrentSizeGroup1	Gets current size of group characteristic line
getCurrentSizeXGroup2	Gets current X size of group characteristic map
getCurrentSizeYGroup2	Gets current Y size of group characteristic map
setCurrentSizeGroup1	Sets current size of group characteristic line
setCurrentSizeXGroup2	Sets current X size of group characteristic map
setCurrentSizeYGroup2	Sets current Y size of group characteristic map

The following abbreviations are used:

ct	characteristic line/map
tv / tx / ty	short name of value type / X axis type / Y axis type (s8, u8, s16, u16, s32, u32, r32, r64)
ftv / ftx / fty	full name of value type / X axis type / Y axis type (sint8, uint8, sint16, uint16, sint32, uint32, real32, real64)
td / ftd	short/full name of the "double precision" type of a high-resolution interpolation routine
x	X axis point
y	Y axis point
v	value
d	distribution
t1 / ft1	short/full name of axis type in distribution
i1	axis point in distribution

Examples for mapping files – IntpolLinear.ini and IntpolRounded.ini – can be found in the ..\target\common\interpolation directory.

ASCET Routine	Meaning
search1\|tx	Search for sample points in characteristic line or distribution
search2\|tx\|ty	Search for sample points in characteristic map
interpol1\|tv	Interpolation routine for characteristic line
interpol2\|tv	Interpolation routine for characteristic map
getAt1\|tx\|tv	Access to characteristic line
getAt2\|tx\|ty\|tv	Access to characteristic map
getAtFixed1\|tx\|tv	Access to fixed characteristic curve
getAtFixed2\|tx\|ty\|tv	Access to fixed characteristic map
searchDistrib\|t1	Search for sample points in distribution
interpolGroup1\|tx\|tv	Interpolation routine for group characteristic line
interpolGroup2\|tx\|ty\|tv	Interpolation routine for group characteristic map