LASSQ - 5.2 English - 68552

AOCL API Guide (68552)

Document ID
68552
Release Date
2025-12-29
Version
5.2 English
template<typename T>
void lassq(integer *n, T *x, integer *incx, T *scale, T *sumsq)#

LASSQ updates a sum of squares represented in scaled form.

Purpose:

  LASSQ  returns the values  scl  and  smsq  such that

     ( scl**2)*smsq = x( 1)**2 +...+ x( n)**2 + ( scale**2)*sumsq,

  where  x( i) = X( 1 + ( i - 1)*INCX). The value of  sumsq  is
  assumed to be non-negative and  scl  returns the value

     scl = fla_max( scale, abs( x( i))).

  scale and sumsq must be supplied in SCALE and SUMSQ and
  scl and smsq are overwritten on SCALE and SUMSQ respectively.

  The routine makes only one pass through the vector x.
Parameters:
  • N[in]

    N is INTEGER

    The number of elements to be used from the vector X.

  • X[in]

    X is REAL array, dimension (1+(N-1)*INCX)

    The vector for which a scaled sum of squares is computed.

    x( i) = X( 1 + ( i - 1)*INCX), 1 <= i <= n.
  • INCX[in]

    INCX is INTEGER

    The increment between successive values of the vector X. INCX > 0.

  • SCALE[inout]

    SCALE is REAL

    On entry, the value scale in the equation above.

    On exit, SCALE is overwritten with scl , the scaling factor for the sum of squares.
  • SUMSQ[inout]

    SUMSQ is REAL

    On entry, the value sumsq in the equation above.

    On exit, SUMSQ is overwritten with smsq , the basic sum of squares from which scl has been factored out.
template<typename T, typename Ta>
void lassq(integer *n, T *x, integer *incx, Ta *scale, Ta *sumsq)#