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. |