Vector Operations#
All normal RTL expressions can be used with vector modes; they are interpreted as operating on each part of the vector independently. Additionally, there are a few new expressions to describe specific vector operations.
(vec_merge:m vec1 vec2 items)
This describes a merge operation between two vectors. The result is a vector of mode
m
; its elements are selected from eithervec1
orvec2
. Which elements are selected is described byitems
, which is a bit mask represented by aconst_int
; a zero bit indicates the corresponding element in the result vector is taken fromvec2
while a set bit indicates it is taken fromvec1
.(vec_select:m vec1 selection)
This describes an operation that selects parts of a vector.
vec1
is the source vector, andselection
is aparallel
that contains aconst_int
(or another expression, if the selection can be made at runtime) for each of the subparts of the result vector, giving the number of the source subpart that should be stored into it. The result modem
is either the submode for a single element ofvec1
(if only one subpart is selected), or another vector mode with that element submode (if multiple subparts are selected).(vec_concat:m x1 x2)
Describes a vector concat operation. The result is a concatenation of the vectors or scalars
x1
andx2
; its length is the sum of the lengths of the two inputs.(vec_duplicate:m x)
This operation converts a scalar into a vector or a small vector into a larger one by duplicating the input values. The output vector mode must have the same submodes as the input vector mode or the scalar modes, and the number of output parts must be an integer multiple of the number of input parts.
(vec_series:m base step)
This operation creates a vector in which element
i
is equal tobase + i*step
.m
must be a vector integer mode.