TABLE2OUT

From STX Wiki
< Programmer Guide‎ | SPU Reference
Revision as of 15:05, 17 May 2010 by 193.171.195.8 (talk) (initial import)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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).