TABLE2OUT

TABLE2OUT - data transfer: table -> spu

Reads data from a table.

Usage:

TABLE2OUT TABLE MODE C NC R NR

Inputs:

TABLE

The name of an extended shell-table.

MODE

The conversion mode.

number|0 - convert to numbers (fire each). The outputs of the atom are single numbers. With each evaluation step one row of the table is copied to the outputs. This copy mode can be used to convert an array to a stream of numbers. Xi(t) := TABLE[C+i,R+t] with: output index i = 0..NC-1; evaluation counter t=0..NR-1

vector|1 - convert to vectors (fire once). The outputs of the atom are vectors of length NR. With each evaluation step all selected rows of a column are copied to the corresponding output. Xi[0..NR-1](t) := TABLE[C+i,R..R+NR-1](t), with: output index i=0..NC-1; evaluation counter t=0,1,...

array|2 - convert to array (fire once)

tarray|3 - convert to array (fire once) transposed

rows|4 - convert to vector of one row per evaluation step

columns|5 - convert to vector of one column per evaluation step

C

The starting column. If not specified, the first column is used (i.e. default=0).

NC

The number of columns. The number of table-fields is used if NC is not specified.

R

The starting row. The first row (0) is used if R is not specified.

NR

The number of rows. The number of table-entries is used if NR is not specified.

Outputs:

Xi

An array, vector or number containing values of column C+i (i=0..NC-1).

Function:

Copy content of table-item to data outputs (e.g. to display values stored in table in a graph).