Table C-8 summarizes the BLAS Level 1 Extended Set routines. For more information on these routines (including mapping and inlining information), see your performance guide.
| Routines | Information | |||
|---|---|---|---|---|
| IxAMIN [1] | Description: | These functions return the index of the first selected element of an array argument that has the minimum absolute value. | ||
| Syntax: | y = IxAMIN (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| ISAMIN | REAL*4 | INTEGER*4 | ||
| IDAMIN | REAL*8 | INTEGER*4 | ||
| ICAMIN | COMPLEX*8 | INTEGER*4 | ||
| IZAMIN | COMPLEX*16 | INTEGER*4 | ||
| IxMAX | Description: | These functions return the index of the first selected element of an array argument that has the maximum value. | ||
| Syntax: | y = IxMAX (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| ISMAX | REAL*4 | INTEGER*4 | ||
| IDMAX | REAL*8 | INTEGER*4 | ||
| ICMAX | COMPLEX*8 | INTEGER*4 | ||
| IZMAX | COMPLEX*16 | INTEGER*4 | ||
| IxMIN | Description: | These functions return the index of the first selected element of an array argument that has the minimum value. | ||
| Syntax: | y = IxMIN (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| ISMIN | REAL*4 | INTEGER*4 | ||
| IDMIN | REAL*8 | INTEGER*4 | ||
| ICMIN | COMPLEX*8 | INTEGER*4 | ||
| IZMIN | COMPLEX*16 | INTEGER*4 | ||
| xAMAX [1] | Description: | These functions return the first selected element of an array argument that has the maximum absolute value. | ||
| Syntax: | y= xAMAX (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SAMAX | REAL*4 | REAL*4 | ||
| DAMAX | REAL*8 | REAL*8 | ||
| CAMAX | COMPLEX*8 | COMPLEX*8 | ||
| ZAMAX | COMPLEX*16 | COMPLEX*16 | ||
| xAMIN [1] | Description: | These functions return the first selected element of an array argument that has the minimum absolute value. | ||
| Syntax: | y = xAMIN (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SAMIN | REAL*4 | REAL*4 | ||
| DAMIN | REAL*8 | REAL*8 | ||
| CAMIN | COMPLEX*8 | COMPLEX*8 | ||
| ZAMIN | COMPLEX*16 | COMPLEX*16 | ||
| xMAX | Description: | These functions return the first selected element of an array argument that has the maximum value. | ||
| Syntax: | y = xMAX (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SMAX | REAL*4 | REAL*4 | ||
| DMAX | REAL*8 | REAL*8 | ||
| CMAX | COMPLEX*8 | COMPLEX*8 | ||
| ZMAX | COMPLEX*16 | COMPLEX*16 | ||
| xMIN | Description: | These functions return the first selected element of an array argument that has the minimum value. | ||
| Syntax: | y = xMIN (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SMIN | REAL*4 | REAL*4 | ||
| DMIN | REAL*8 | REAL*8 | ||
| CMIN | COMPLEX*8 | COMPLEX*8 | ||
| ZMIN | COMPLEX*16 | COMPLEX*16 | ||
| xNORM2 [2,3] | Description: | These functions return the Euclidean norm of an array that is the square root of the sum of the squares of the absolute values of the array elements. | ||
| Syntax: | y = xNORM2 (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SNORM2 | REAL*4 | REAL*4 | ||
| DNORM2 | REAL*8 | REAL*8 | ||
| SCNORM2 | COMPLEX*8 | REAL*4 | ||
| DZNORM2 | COMPLEX*16 | REAL*8 | ||
| xNRSQ [2] | Description: | These functions return the sum of the squares of the absolute values of the elements of an array. | ||
| Syntax: | y = xNRSQ (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SNRSQ | REAL*4 | REAL*4 | ||
| DNRSQ | REAL*8 | REAL*8 | ||
| SCNRSQ | COMPLEX*8 | REAL*4 | ||
| DZNRSQ | COMPLEX*16 | REAL*8 | ||
| xSET | Description: | These subroutines set all selected elements of an array to a scalar value. | ||
| Syntax: | CALL xSET (n, a, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| a | Scalar value to be stored in all selected elements of the array. | |||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Subroutines: | Name | Scalar | Array Argument | |
| SSET | REAL*4 | REAL*4 | ||
| DSET | REAL*8 | REAL*8 | ||
| CSET | COMPLEX*8 | COMPLEX*8 | ||
| ZSET | COMPLEX*16 | COMPLEX*16 | ||
| xSUM | Description: | These functions return the sum of the selected elements of an array. | ||
| Syntax: | y = xSUM (n, x, incx) | |||
| Arguments: | n | Integer number of element to be accessed in the array. | ||
| x | Array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the array. | |||
| Specific Functions: | Name | Array Argument | Result | |
| SSUM | REAL*4 | REAL*4 | ||
| DSUM | REAL*8 | REAL*8 | ||
| CSUM | COMPLEX*8 | COMPLEX*8 | ||
| ZSUM | COMPLEX*16 | COMPLEX*16 | ||
| xVCAL | Description: | These subroutines scale the elements of one array by a scalar value and store the results in another array. | ||
| Syntax: | CALL xVCAL (n, a, x, incx, y, incy) | |||
| Arguments: | n | Integer number of elements to be accessed in the arrays. | ||
| a | Scalar multiplier for input array. | |||
| x | Input array containing the elements to be scaled (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the input array. | |||
| y | Output array to store the scaled elements (or array reference to the first such element). | |||
| incy | Integer index increment to use in selecting the elements in the output array. | |||
| Specific Subroutines: | Name | Scalar | Array Arguments | |
| SVCAL | REAL*4 | REAL*4 | ||
| DVCAL | REAL*8 | REAL*8 | ||
| CVCAL | COMPLEX*8 | COMPLEX*8 | ||
| CSVCAL | REAL*4 | COMPLEX*8 | ||
| ZVCAL | COMPLEX*16 | COMPLEX*16 | ||
| ZDVCAL | REAL*8 | COMPLEX*16 | ||
| xZAXPY [4] | Description: | These subroutines multiply one array by a scalar value, add another array, and store the result in a third array. | ||
| Syntax: | CALL xZAXPY (n, a, x, incx, y, incy, z, incz) | |||
| Arguments: | n | Integer number of elements to be accessed in the arrays. | ||
| a | Scalar multiplier for array x. | |||
| x | First input array containing the elements to be accessed (or array reference to the first such element). | |||
| incx | Integer index increment to use in selecting the elements in the first input array. | |||
| y | Second input array containing the elements to be accessed (or array reference to the first such element). | |||
| incy | Integer index increment to use in selecting the elements in the second input array. | |||
| z | Output array to contain the resulting elements (or array reference to the first such element). | |||
| incz | Integer index increment to use in selecting the elements in the output array. | |||
| Specific Subroutines: | Name | Scalar | Array Arguments | |
| SZAXPY | REAL*4 | REAL*4 | ||
| DZAXPY | REAL*8 | REAL*8 | ||
| CZAXPY | COMPLEX*8 | COMPLEX*8 | ||
| ZZAXPY | COMPLEX*16 | COMPLEX*16 | ||
|
[1] For the purpose of these functions, the absolute value of a complex number is defined as the sum of the absolute values of the real and imaginary parts. [2] For the purposes of these functions, the absolute value of a complex value is the square root of the sum of the squares of the real and imaginary parts. [3] Unlike the BLAS1 (Basic Set) xNRM2 functions, the xNORM2 functions assume that intermediate underflow or overflow exceptions will not occur. [4] The elements in array x are multiplied by scalar a and then added to the corresponding elements of array y; the results are stored in array z. | ||||