Adams Basic Package > Adams View > View Function Builder > Design-Time Functions > Functions: R - S > READ_T_O_SUBBLOCK_TABLE_COLUMN

READ_T_O_SUBBLOCK_TABLE_COLUMN

Searches a specified subblock block within selected block in the currently open TeimOrbit file for column of real numbers with the specified attribute label. Returns the one-dimensional array of real number values from the selected column, or 0.0 if the attribute is not found or other errors occur.

Format

READ_T_O_SUBBLOCK_TABLE_COLUMN (Block Name, SubBlock Name, Column)

Prerequisites

READ_T_O_OPEN_FILE (Filename)

Arguments

 
SubBlock Name
Name of subblock in which to search
Block Name
Name of block in which to search
Column
Column header within the specified subblock to retrieve the one-dimensional array of real number values.

Examples

[The following assumes this file has already been opened (“<acar_shared>/powertrains.tbl/V12_engine_map.pwr”)]
 
Function
READ_T_O_SUBBLOCK_TABLE_COLUMN (“ENGINE”, “XY_DATA”, “engine_speed”)
Result
[0.0,500.0,1000.0,…,7500.0]
 
Function
READ_T_O_SUBBLOCK_TABLE_COLUMN (“ENGINE”, “XY_DATA”, “throttle”)
Result
0.0
This call will fail because “throttle” is not within the “XY_DATA” subblock.
 
Important:  
Filenames are case sensitive and parameters are not case sensitive.