1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
|
---
:name: classq
:md5sum: 98b03e0f8741f340e1c75a898eb65b7e
:category: :subroutine
:arguments:
- n:
:type: integer
:intent: input
- x:
:type: complex
:intent: input
:dims:
- n
- incx:
:type: integer
:intent: input
- scale:
:type: real
:intent: input/output
- sumsq:
:type: real
:intent: input/output
:substitutions: {}
:fortran_help: " SUBROUTINE CLASSQ( N, X, INCX, SCALE, SUMSQ )\n\n\
* Purpose\n\
* =======\n\
*\n\
* CLASSQ returns the values scl and ssq such that\n\
*\n\
* ( scl**2 )*ssq = x( 1 )**2 +...+ x( n )**2 + ( scale**2 )*sumsq,\n\
*\n\
* where x( i ) = abs( X( 1 + ( i - 1 )*INCX ) ). The value of sumsq is\n\
* assumed to be at least unity and the value of ssq will then satisfy\n\
*\n\
* 1.0 .le. ssq .le. ( sumsq + 2*n ).\n\
*\n\
* scale is assumed to be non-negative and scl returns the value\n\
*\n\
* scl = max( scale, abs( real( x( i ) ) ), abs( aimag( x( i ) ) ) ),\n\
* i\n\
*\n\
* scale and sumsq must be supplied in SCALE and SUMSQ respectively.\n\
* SCALE and SUMSQ are overwritten by scl and ssq respectively.\n\
*\n\
* The routine makes only one pass through the vector X.\n\
*\n\n\
* Arguments\n\
* =========\n\
*\n\
* N (input) INTEGER\n\
* The number of elements to be used from the vector X.\n\
*\n\
* X (input) COMPLEX array, dimension (N)\n\
* The vector x as described above.\n\
* x( i ) = X( 1 + ( i - 1 )*INCX ), 1 <= i <= n.\n\
*\n\
* INCX (input) INTEGER\n\
* The increment between successive values of the vector X.\n\
* INCX > 0.\n\
*\n\
* SCALE (input/output) REAL\n\
* On entry, the value scale in the equation above.\n\
* On exit, SCALE is overwritten with the value scl .\n\
*\n\
* SUMSQ (input/output) REAL\n\
* On entry, the value sumsq in the equation above.\n\
* On exit, SUMSQ is overwritten with the value ssq .\n\
*\n\n\
* =====================================================================\n\
*\n"
|