MotoHawk:Blocks:Table2D
From MotoHawk
Jump to navigationJump to searchLookup Table (2-D)
This MotoHawk™ block behaves similarly to the native Simulink Look-Up Table (2-D) block.
Block ID
motohawk_table_2d
Library
MotoHawk_lib/Lookup Tables
Description
Name is the VarDec name used in MotoTune. The output is normally assigned a Display variable with this name, the 1-D Calibration breakpoint tables have the suffixes 'RowIdxArr' and 'ColIdxArr', the intermediate Display variables for the indices have the suffixes 'RowIdx' and 'ColIdx', and the 1-D Calibration table has the suffix 'Map'.
Output Name is an optional name for the output of the table. If left blank, a VarDec will be generated called Name. If non-empty, a downstream Probe must be provided called Output Name, which allows customization of the output VarDec. An error will result if the VarDec does not exist.
Breakpoint Data contains the table of breakpoint values to be searched. This data may be modified via MotoTune. Note that the data type of the breakpoint data determines the input port data type.
Table Data contains a 2-D matrix of values to be accessed. This data may be modified via MotoTune. Note that the data type of the table data determines the output port data type.
Row and Column Source Name are the VarDec names of the signals driving the input. If a non-empty string is entered, the source VarDec must exist, either by connecting a Probe or a Table of the same name. If an empty string is entered, the corresponding input will have a Display variable with the suffix 'Row' or 'Col'.
Block Parameters
| Parameter Field | Values | Comments/Description |
|---|---|---|
| Name | Alpha-numeric text, single-quote enclosed | Name as displayed in MotoTune, for block. No special characters, such as spaces, dashes, commas (underscore allowed). |
| Row Breakpoint Name (optional) | Alpha-numeric text, single-quote enclosed | Name of breakpoint data row. No special characters, such as spaces, dashes, commas (underscore allowed). If left blank, a VarDec will be generated called Name. If non-empty, a downstream Probe must be provided called by this Breakpoint Name, which allows customization of the output VarDec. An error will result if the named VarDec does not exist. |
| Column Breakpoint Name (optional) | Alpha-numeric text, single-quote enclosed | Name of breakpoint data column . No special characters, such as spaces, dashes, commas (underscore allowed). If left blank, a VarDec will be generated called Name. If non-empty, a downstream Probe must be provided called by this Breakpoint Name, which allows customization of the output VarDec. An error will result if the named VarDec does not exist. |
| Row Breakpoint Data | Numeric or array [] | Specify the vector of output values. The table data must be the same size as the input values vector. This data may be modified via MotoTune. Note that the data type of the breakpoint data determines the input port data type. |
| Column Breakpoint Data | Numeric or array [] | Specify the vector of output values. The table data must be the same size as the input values vector. This data may be modified via MotoTune. Note that the data type of the breakpoint data determines the input port data type. |
| Table Data | Drop-down list | Select a data type from list, or select "Inherit from 'Table Data'" to set type as inferred from entry in Table Data field. Be sure to select a data type if there is possible ambiguity. |
| Row Breakpoint Data Type | Drop-down list | Select a data type from list, or select "Inherit from 'Breakpoint Data'" to set type as inferred from entry in Breakpoint Data row. Be sure to select a data type if there is possible ambiguity. |
| Column Breakpoint Data Type | Drop-down list | Select a data type from list, or select "Inherit from 'Breakpoint Data'" to set type as inferred from entry in Breakpoint Data column. Be sure to select a data type if there is possible ambiguity. |
| Table Data Type | Drop-down list | Select a data type from list, or select "Inherit from 'Table Data'" to set type as inferred from entry in Table Data field. Be sure to select a data type if there is possible ambiguity. |
| Storage and Accessibility | ||
| Nonadaptive | Values do not change at runtime, except via calibration. | |
| Adaptive - Volatile | Values can change at runtime (using Adapt Table block) - will not be saved over powerup cycles. | |
| Adaptive - NonVolatile | Values can change at runtime (using Adapt Table block) - will be saved over powerup cycles. | |
| Read Access Level | 1-4 | Sets security level 1 lowest, 4 highest, for user access to read value |
| Write Access Level | 1-4 | Sets security level 1 lowest, 4 highest, for user access to write value |
| Use uploaded calibration values from MotoTune | Checkbox (enable) | Enable/disable to use or ignore uploaded values from MotoTune. |
| Help Text | Alpha-numeric text, single-quote enclosed | Enter text to describe block usage per needs. |
| Row Breakpoint Units | Alpha-numeric text, single-quote enclosed | Enter text to describe or label units or data for row, for clarification in MotoTune, as appropriate per application. |
| Column Breakpoint Units | Alpha-numeric text, single-quote enclosed | Enter text to describe or label units or data for column, for clarification in MotoTune, as appropriate per application. |
| Table Units | Alpha-numeric text, single-quote enclosed | Enter text to describe or label units or data for table, for clarification in MotoTune, as appropriate per application. |
| Minimum Row Breakpoint Value | Numeric Value | Sets lower end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
| Maximum Row Breakpoint Value | Numeric Value | Sets upper end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
| Minimum Column Breakpoint Value | Numeric Value | Sets lower end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
| Maximum Column Breakpoint Value | Numeric Value | Sets upper end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
| Minimum Table Value | Numeric Value | Sets lower end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
| Maximum Table Value | Numeric Value | Sets upper end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
| --------- Row Breakpoint --------- | ||
| Row Breakpoint Precision | Numeric value, single-quote enclosed | Set the precision of the variable as displayed in MotoTune, by entering a value '1.x' where "x" is the number of decimal places requested. Default is two decimal places. |
| Row Breakpoint Gain* | Numeric Value | Multiplier applied (Default is 1) to the raw value used in calculation of the engineering value as observed in MotoTune |
| Row Breakpoint Offset* | Numeric Value | Constant added (Default is 0) to the raw value calculations to result in the engineering value as observed in MotoTune |
| Row Breakpoint Exponent* | Numeric Value | Exponent applied (Default is 1) to the (raw value*gain) product used in calculating the engineering value as observed in MotoTune |
| ----- Column Breakpoint ----- | ||
| Column Breakpoint Precision | Numeric value, single-quote enclosed | Set the precision of the variable as displayed in MotoTune, by entering a value '1.x' where "x" is the number of decimal places requested. Default is two decimal places. |
| Column Breakpoint Gain* | Numeric Value | Multiplier applied (Default is 1) to the raw value used in calculation of the engineering value as observed in MotoTune |
| Column Breakpoint Offset* | Numeric Value | Constant added (Default is 0) to the raw value calculations to result in the engineering value as observed in MotoTune |
| Column Breakpoint Exponent* | Numeric Value | Exponent applied (Default is 1) to the (raw value*gain) product used in calculating the engineering value as observed in MotoTune |
| -------------- Table --------------- | ||
| Table Precision | Numeric value, single-quote enclosed | Set the precision of the variable as displayed in MotoTune, by entering a value '1.x' where "x" is the number of decimal places requested. Default is two decimal places. |
| Table Gain | Numeric Value | Multiplier applied (Default is 1) to the raw value used in calculation of the engineering value as observed in MotoTune |
| Table Offset | Numeric Value | Constant added (Default is 0) to the raw value calculations to result in the engineering value as observed in MotoTune |
| Table Exponent | Numeric Value | Exponent applied (Default is 1) to the (raw value*gain) product used in calculating the engineering value as observed in MotoTune |
| Row Input Name (optional) | Alpha-numeric text, single-quote enclosed | Row Input Name and Column Input Name are optional names for the input of the table. If left blank, the VarDec (Name) with suffix 'Row' or/and 'Col' will be generated for MotoTron Display. If a non-empty string is entered, the source VarDec must exist, either by connecting a Probe or a Table of the same name |
| Column Input Name (optional) | Alpha-numeric text, single-quote enclosed | |
| Output Name (optional) | Alpha-numeric text, single-quote enclosed | Provide a name for the output of the table. If left blank, the VarDec (Name) will be generated for MotoTron Display. If non-empty, a downstream Probe must be provided called Output Name, which allows customization of the output VarDec. An error will result if the VarDec does not exist. |
| MotoTune Group String | Alpha-numeric text, single-quote enclosed | Determines Folder name and hierarchy as displayed in MotoTune. Use "|" character between folder names to delineate subfolder structure |
- NOTE: Engineering Value = (Raw Module Value*Gain)^Exp)+Offset.
