Multidimensional arrays

Vector Memory

Vector Extract

Use the "Vector Memory" object to create multidimensional arrays and the "Vector Extract" object to get single vectors out of the multidimensional arrays.

To create a multidimensional array call the vector memory object several times with different input vectors. The input vectors may differ in length between each call as the length of each vector is also memorized. All vectors are stored in an internal buffer and appear as a specially coded numerical vector on the output, which can be used as input for the vector exctract object to extract the vectors again.

Multiple multidimensional arrays can be created at the same time. For each variable name specified in the property dialog a floating point array variable is created on input and on output. All input variables must be connected when calling the vector memory object, but need not to have the same length. The integer output variable "Vector count" returns the number of vectors currently in each multidimensional array. Multidimensional arrays can be stacked, i.e. the output of a vector memory can act as input of another vector memory. If "Stack only" is checked in the property dialog, no multidimensional array is created but all vectors are only stacked behind each other.

For extracting the vectors connect a multidimensional array to the "Vector extract" object. Here also multiple arrays can be handled at a time which are named in the property dialog. The vector number to be extracted is specified via the "Vector number" property. The indexed vector appears on the corresponding output variable, the "ok" output variables contain a 1 if extraction has worked or 0 if not. The latter can happen if the index is too big or the input variable has a wrong format. The output variables "count" contain the number of vectors contained in the corresponding multidimensional arrays.

Multidimensional arrays can directly act as input for graphic display objects to display an unlimited number of graphs at the same time. They can also be passed to ASCII-output and -import objects to read and write ASCII files with dynamic column count. For handling multidimensional arrays in calculator objects, use the TMultiVecCreator and TMultiVecExtractor classes. They can encode and decode the format used for the multidimensional arrays.

The Vimms User Manual