vec_norm() — Apollo Domain/OS SR10.3.5

VEC_$NORM                         Domain/OS                          VEC_$NORM


NAME
     vec_$norm - squared norm (sum the squares of the elements) a single-
     precision vector

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/vec.h>

     float vec_$norm(
          float *start_vec,
          long int &length)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/vec.ins.pas';

     function vec_$norm(
          in start_vec: univ vec_$real_vector;
          in length: integer32): real;

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/vec.ins.ftn'

           parameter (nvec = 10)

           real start_vec(nvec), norm
           integer*4 length

           norm = vec_$norm(start_vec, length)

DESCRIPTION
     Vec_$norm returns the squared norm (the sum of the squares of the ele-
     ments) of the vector start_vec.

     start_vec
          The vector whose squared norm you want.

     length
          The number of elements to be operated on;  normally the same as the
          number of elements in the vector.

NOTES
     When vec_$norm is used to operate on matrixes in C and Pascal, start_vec
     is a row vector; in FORTRAN, it is a column vector.

     As in all the vec_$ calls,  the result array must not overlap any of the
     input arrays; the result array may be identical to an input, but must not
     contain any subset  of it.   Because of pipelining, using overlapping
     input and output arrays may cause incorrect results.


SEE ALSO
     vec_$sum, vec_$asum, vec_$dot, vec_$norm_i, vec_$dnorm, vec_$dnorm_i,
     vec_$inorm, vec_$inorm_i, vec_$inorm16, vec_$inorm16_i.
Museum
