C.3.2 Extended Set (VAX only)

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.

Note: The Compaq Extended Math Library product may be needed to resolve references to Extended Set routines that are not expanded inline by the compiler.

Table C-8 BLAS Extended Set Routines (VAX only)

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.

Previous Page Next Page Table of Contents