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

READ_T_O_TABLE_COLUMN

Searches a specified block within 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_TABLE_COLUMN (Block Name, Column)

Prerequisites

READ_T_O_OPEN_FILE (Filename)

Arguments

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

Examples

[The following assumes this file has already been opened (“<acar_shared>/springs.tbl/mdi_0001.spr”)]
 
Function
READ_T_O_TABLE_COLUMN (“CURVE”, “force”)
Result
[-10750.0, -8000.0, …, 10750.0]
 
Function
READ_T_O_TABLE_COLUMN (“CURVE”, “velocity”)
Result
0.0
This call will fail because “velocity” is not a column within the “CURVE” block.
 
Important:  
Filenames are case sensitive and parameters are not case sensitive.