blockTableFunction
Extends from Interfaces.PartialConverters.SISO_Conversion (Partial SISO converter class with input and output conversions for lookup functions), Icons.InterpolationTable (Icon for table functions).
Information
This information is part of the Business Simulation Library (BSL). Please support this work and ► donate.
This converter uses the Modelica CombiTable format to read in a 1-D table function from file. For more explanation regarding the 1-D Modelica CombiTable interpolation see Modelica.Blocks.Tables.CombiTable1Ds.
For more convenience, the input u to and the ouput from the lookup table can be converted into different units. This typically applies to rates and times which in non-technical modeling will typically not be referenced in SI-units (e.g., s).
Notes
The Modelica CombiTable format can be generated by Wolfram Mathematica using Export[]:
Export[ filename, { {"TableName1", table1}, {"TableName2", table2}, ... }, "MCTT" ]
where table1, table2, ... are 2-dimensional arrays. By default all lookup data are assumed to be included in a single file whose name is given by the global parameter lookupDataFileURI.
See also
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Time Conversion | |||
| Boolean | convertInput (from SISO_Conversion) | false | = true, if the input value is a rate or time variable that needs to be converted |
| Boolean | inputIsRate (from SISO_Conversion) | false | = true, if the input is given in units of time, otherwise it is assumed to be a rate |
| Boolean | convertOutput (from SISO_Conversion) | false | = true, if the output value is a rate or time variable that needs to be converted |
| Boolean | outputIsRate (from SISO_Conversion) | false | = true, if the output is given in units of time, otherwise it is assumed to be a rate |
| TimeBases | timeBaseInput (from SISO_Conversion) | TimeBases.seconds | TimeBase to convert from (default = seconds) |
| TimeBases | timeBaseTableIn (from SISO_Conversion) | modelSettings.modelDisplayTimeBase | TimeBase used for the lookup function input (default = modelDisplayTimeBase) |
| TimeBases | timeBaseTableOut (from SISO_Conversion) | modelSettings.modelDisplayTimeBase | TimeBase assumed for the lookup function output (default = modelSettings.modelDisplayTimeBase) |
| TimeBases | timeBaseOutput (from SISO_Conversion) | TimeBases.seconds | TimeBase used for the output (default = seconds) |
| TableDataDefinition | |||
| Boolean | tableOnFile | false | = true, if table is defined on file or in function usertab (combiTable1D.tableOnFile) |
| Real[:,:] | table | fill(0.0, 2, 2) | Table matrix (combiTable1D.table) |
| String | tableName | "NoName" | Name of the table in the file containing the data |
| String | fileNameURI | modelSettings.lookupDataFileURI | URI of the file to read the data from (default = modelSettings.lookupDataFileURI) |
| Boolean | verboseRead | true | = true, if info message that file is loading is to be printed (combiTable1D.verboseRead) |
| TableDataInterpretation | |||
| Smoothness | smoothness | Smoothness.LinearSegments | Smoothness of table interpolation |
| Integer | column | 2 | Column of table to be interpolated |
| Extrapolation | extrapolation | Modelica.Blocks.Types.Extrapolation.HoldLastPoint | Extrapolation of data outside the definition range (combiTable.extrapolation) |
| Boolean | verboseExtrapolation | false | = true, if warning messages are to be printed if table input is outside the definition range (combiTable.verboseExtrapolation) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Connectors.RealInput | u (from SISO) | Input |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| RealOutput | y (from SO) | ||
| ModelSettings | modelSettings (from SISO_Conversion) |
Revisions
- Updated in v2.0.0.