ICAM Virtual Machine V19 - Kxcad.net

4.4.5.5 Vector Functions
$FVADD Vector addition
$FVANG Angle (degrees) between two vectors
$FVCROSS Vector cross product
$FVDOT Vector dot product
$FVLEN Vector length
$FVMULT Vector multiplication
$FVNORM Vector normalization
$FVROTN Normalized vector rotation
$FVSUB Vector subtraction
Virtual Machine Reference, Model Customization
Simulation Macro Functions, Vector Functions
All vector functions work with sequences of length 2 or 3 that typically define the XY or XYZ
components (commonly referred to as the IJK components) of a vector. With the exception of the
angle and cross product functions, vector functions can take vectors of any length. For those
functions that take 2 input vectors, both vectors should have the same length. Vector functions
that return a vector do so by returning a sequence with the same length as that of the shortest
input vector.
Vectors can be constructed using the $FSEQ function or the { } sequence operators. For example,
the following are equivalent:
V1=$FSEQ(0,0,1)
V1={0,0,1}
It is important to note that vectors are sequences and not arrays. Vector functions do not work
with arrays.
The $FVADD Function
result=$FVADD(v1,v2)
Returns: Sequence
This function adds two arbitrarily long vector sequences v1 and v2, and returns the result as a
vector sequence.
The $FVANG Function
result=$FVANG(v1,v2)
Returns: Sequence or $NULL
This function returns the angle in degrees between two vector sequences v1 and v2. The input
vectors v1 and v2 must be sequences of length 2 or 3 only (a diagnostic is output and a value of
$NULL is returned if the input vectors have less than 2 or more than 3 elements). They should
also have a non-zero length to return a meaningful result.
ICAM Technologies Corporation – Proprietary 159