NAME

sup_vec - create unit for vectorial superposition

PROTOTYPE

unitptr sup_vec( int n, int k, unitptr dest)

ARGUMENTS

int n
dimensionality of vectors to superpose
int k
number of vectors to be superposed
unitptr dest
host unit for newly created instance

RETURN VALUE:

unitptr u:
pointer to newly created unit

INTERFACE OF CREATED UNIT:

X_in[k]:
(input field 0) vector of k superposition coefficients
in_1[n]:
(input field 1) first vector of superposition

EXECUTION:

X_out=X_in[0]*in_1+X_in[1]*in_2+...X_in[k-1]*in_k

DESCRIPTION:

Creates a unit with one input field of k pins, and k input fields and one output field of n pins each. The created unit becomes a subunit of unit dest. The unit computes the linear superposition of the vectors at input fields 1..k with weighting coefficients specified at field 0. If n is specified as a negative integer, all fields the number of pins of which is specified by n are created as packed fields with ABS(n) pins. Input field 0 remains unpacked.

DEFAULT VALUES:

X_in[i]=1/k, i.e. formation of average.

FILE:

nst_math

FILE

/local/homes/rhaschke/nst7/man/../o.linx86_64//../nstsrc/nst_misc.c