vec_dnorm() — Apollo Domain/OS SR10.4.1

VEC_$DNORM                        Domain/OS                         VEC_$DNORM


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

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

     double vec_$dnorm(
          double *start_vec,
          long int &length)

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

     function vec_$dnorm(
          in start_vec: univ vec_$double_vector;
          in length: integer32): double;

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

           parameter (nvec = 10)

           real*8 start_vec(nvec), norm
           integer*4 length

           norm = vec_$dnorm(start_vec, length)

DESCRIPTION
     Vec_$dnorm returns the squared norm (the sum of the squares of the ele-
     ments) of the vector start_vec.  It differs from vec_$norm in that the
     argument vector is double-precision floating-point.

     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_$dnorm 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_$norm, vec_$dnorm_i,
     vec_$inorm, vec_$inorm_i, vec_$inorm16, vec_$inorm16_i.
Museum
