 |
|
|
This MotoHawk™ block behaves similarly to the native Simulink Look-Up Table (1-D) block.
motohawk_table_1d
MotoHawk_lib/Lookup Tables
This block performs 1-D linear interpolation of input values using the Breakpoint and Table Data. End values of Table Data is used for input outside of the Breakpoint Data.
Name is the VarDec name used in the Instrumentation Tool. The output is normally assigned a Display variable with this name, the breakpoint table has the suffix 'IdxArr', the intermediate index has the suffix 'Idx', and the 1-D Calibration table has the suffix 'Tbl'.
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 the Instrumentation Tool. Note that the data type of the breakpoint data determines the input port data type.
Table Data contains a 1-D vector of values to be accessed. This data may be modified via the Instrumentation Tool. Note that the data type of the table data determines the output port data type.
Source Name is the VarDec name of the signal 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 input will have a Display variable with the suffix 'In'.
| Parameter Field | Values | Comments/Description |
|---|---|---|
| Name | Alpha-numeric text, single-quote enclosed | Name as displayed in the Instrumentation Tool, for block. No special characters, such as spaces, dashes, commas (underscore allowed). Unless an optional Output Name is specified, a Display variable with this name with be generated in the Instrumentation Tool. The tool will also create calibration tables based on this name. |
| Breakpoint Name (optional) | Alpha-numeric text, single-quote enclosed | Name of breakpoint data. No special characters, such as spaces, dashes, commas (underscore allowed). If left blank, the Breakpoint Data will show up in the Instrumentation Tool Calibration under the VarDec name with the suffix 'IdxArr' and its intermediate index with the suffix 'Idx'. If non-empty, the same suffix will be added to the Breakpoint Name. |
| Breakpoint Data | Numeric or array [] | Specify the 1-D vector of breakpoint values to be searched and modified via the Instrumentation Tool. Note that the data type of the breakpoint data determines the input port data type. |
| Table Data | Numeric or array [] | Specify the vector of output values. Table Data contains a 1-D vector of values to be accessed and modified via the Instrumentation Tool. In the tool, it will have the VarDec name with the suffix 'Tbl'. Note that the data type of the table data determines the output port data type. |
| 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 field. Be sure to select a data type if there is possible ambiguity. |
| Breakpoint Storage Class | ||
| Constant | Values do not change at runtime, except via calibration. | |
| Volatile | Values can change at runtime - will not be saved over powerup cycles. | |
| NonVolatile | Values can change at runtime - will be saved over powerup cycles. | |
| Fixed NonVolatile |
Values can change at runtime - will be saved over
powerup cycles. Fixed NonVolatile data allows for greater flexibility by permitting the addition of new data items whilst retaining existing data during an application upgrade. | |
| Specify Memory Region | Check box (enable) | Selects that the breakpoint data will be placed in region specified by Breakpoint Memory Region Name. This option is only available if the target and selected breakpoint storage class support memory regions. The default memory region is used when this option is not available or unchecked. |
| Breakpoint Memory Region Name | Alpha-numeric text, single-quote enclosed | Name of the Memory Region in which to place the data. This option is only available when Specify Memory Region is checked. |
| 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. | |
| Adaptive - Fixed NonVolatile |
Values can change at runtime (using Adapt Table block) - will be saved over
powerup cycles. Fixed NonVolatile data allows for greater flexibility by permitting the addition of new data items whilst retaining existing data during an application upgrade. | |
| Specify Memory Region | Check box (enable) | Selects that the data will be placed in region specified by Memory Region Name. This option is only available if the target and selected storage class support memory regions. The default memory region is used when this option is not available or unchecked. |
| Memory Region Name | Alpha-numeric text, single-quote enclosed | Name of the Memory Region in which to place the data. This option is only available when Specify Memory Region is checked. |
| Read Access Level | 0-8 | Sets security level 1 lowest, 8 highest, for user access to read value. A setting of zero indicates unsecured access is allowed. |
| Write Access Level | 0-8 | Sets security level 1 lowest,8 highest, for user access to write value. A setting of zero indicates unsecured access is allowed. |
| Use uploaded calibration values from the Instrumentation Tool | Checkbox enable | Enable/disable to use or ignore uploaded values from the Instrumentation Tool. |
| Help Text | Alpha-numeric text, single-quote enclosed | Enter text to describe block usage per needs. |
| Breakpoint Units | Alpha-numeric text, single-quote enclosed | Enter text to describe or label breakpoint units or data, for clarification in the Instrumentation Tool, 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 the Instrumentation Tool, as appropriate per application. |
| Minimum 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 Breakpoint Value | Numeric Value | Sets higher end of allowable range for value. This can be used to prevent a user from entering an out of bounds range when calibrating. |
| Minimum Table Value | Numeric Value |
Sets the lower end of the allowable range for the variable. The specified value is in engineering units
(see Engineering Values versus Native Values). Typically this value is used by instrumentation to prevent a user from entering an out of range value when modifying. |
| Maximum Table Value | Numeric Value |
Sets the higher end of the allowable range for the variable. The specified value is in engineering units
(see Engineering Values versus Native Values). Typically this value is used by instrumentation to prevent a user from entering an out of range value when modifying. |
| ------- Breakpoint ------- | ||
| Breakpoint Precision | Numeric value, single-quote enclosed | Set the precision of the variable as displayed in the Instrumentation Tool, by entering a value '1.x' where "x" is the number of decimal places requested. Default is two decimal places. |
| Breakpoint Gain* | Numeric Value | Multiplier component of the conversion equation that converts a native value into an engineering units value (see Engineering Values versus Native Values). |
| Breakpoint Offset* | Numeric Value | Offset component of the conversion equation that converts a native value into an engineering units value (see Engineering Values versus Native Values). |
| Breakpoint Exponent | Numeric Value | Exponent component of the conversion equation that converts a native value into an engineering units value (see Engineering Values versus Native Values). |
| ---------- Table ----------- | ||
| Table Precision | Numeric value, single-quote enclosed | Set the precision of the variable as displayed in the Instrumentation Tool, 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 component of the conversion equation that converts a native value into an engineering units value (see Engineering Values versus Native Values). |
| Table Offset | Numeric Value | Offset component of the conversion equation that converts a native value into an engineering units value (see Engineering Values versus Native Values). |
| Table Exponent | Numeric Value | Exponent component of the conversion equation that converts a native value into an engineering units value (see Engineering Values versus Native Values). |
| Show Explicit Links to Other Blocks | ||
| Input Name (optional) | Alpha-numeric text, single-quote enclosed | Name for the input of the table. If left blank, the VarDec (Name) with suffix 'In' will be generated for the Instrumentation Tool to 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. |
| Output Name (optional) | Alpha-numeric text, single-quote enclosed | Name for the output of the table. If left blank, the VarDec (Name) will be generated for the Instrumentation Tool to 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. |
| Instrumentation Group | Alpha-numeric text, single-quote enclosed | Defines the folder name and hierarchy to be used by a suitable instrumentation tool. Use "|" character between folder names to delineate subfolder structure. |
*NOTE: Engineering Value = ((Native Value * Gain)^Exponent) + Offset
See the Engineering Values versus Native Values help topic for further information.
| Copyright 2009-2019 Woodward Corporation. All Rights Reserved. | Visit Us: mcs.woodward.com |