Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

dsymv (3p)

Name

dsymv - vector operation y := alpha*A*x + beta*y

Synopsis

SUBROUTINE DSYMV(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY)

CHARACTER*1 UPLO
INTEGER N, LDA, INCX, INCY
DOUBLE PRECISION ALPHA, BETA
DOUBLE PRECISION A(LDA,*), X(*), Y(*)

SUBROUTINE DSYMV_64(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY)

CHARACTER*1 UPLO
INTEGER*8 N, LDA, INCX, INCY
DOUBLE PRECISION ALPHA, BETA
DOUBLE PRECISION A(LDA,*), X(*), Y(*)




F95 INTERFACE
SUBROUTINE SYMV(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY)

CHARACTER(LEN=1) :: UPLO
INTEGER :: N, LDA, INCX, INCY
REAL(8) :: ALPHA, BETA
REAL(8), DIMENSION(:) :: X, Y
REAL(8), DIMENSION(:,:) :: A

SUBROUTINE SYMV_64(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y,
INCY)

CHARACTER(LEN=1) :: UPLO
INTEGER(8) :: N, LDA, INCX, INCY
REAL(8) :: ALPHA, BETA
REAL(8), DIMENSION(:) :: X, Y
REAL(8), DIMENSION(:,:) :: A




C INTERFACE
#include <sunperf.h>

void  dsymv(char  uplo, int n, double alpha, double *a, int lda, double
*x, int incx, double beta, double *y, int incy);

void dsymv_64(char uplo, long n, double alpha,  double  *a,  long  lda,
double *x, long incx, double beta, double *y, long incy);

Description

Oracle Solaris Studio Performance Library                            dsymv(3P)



NAME
       dsymv - perform the matrix-vector operation   y := alpha*A*x + beta*y


SYNOPSIS
       SUBROUTINE DSYMV(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY)

       CHARACTER*1 UPLO
       INTEGER N, LDA, INCX, INCY
       DOUBLE PRECISION ALPHA, BETA
       DOUBLE PRECISION A(LDA,*), X(*), Y(*)

       SUBROUTINE DSYMV_64(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY)

       CHARACTER*1 UPLO
       INTEGER*8 N, LDA, INCX, INCY
       DOUBLE PRECISION ALPHA, BETA
       DOUBLE PRECISION A(LDA,*), X(*), Y(*)




   F95 INTERFACE
       SUBROUTINE SYMV(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY)

       CHARACTER(LEN=1) :: UPLO
       INTEGER :: N, LDA, INCX, INCY
       REAL(8) :: ALPHA, BETA
       REAL(8), DIMENSION(:) :: X, Y
       REAL(8), DIMENSION(:,:) :: A

       SUBROUTINE SYMV_64(UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y,
              INCY)

       CHARACTER(LEN=1) :: UPLO
       INTEGER(8) :: N, LDA, INCX, INCY
       REAL(8) :: ALPHA, BETA
       REAL(8), DIMENSION(:) :: X, Y
       REAL(8), DIMENSION(:,:) :: A




   C INTERFACE
       #include <sunperf.h>

       void  dsymv(char  uplo, int n, double alpha, double *a, int lda, double
                 *x, int incx, double beta, double *y, int incy);

       void dsymv_64(char uplo, long n, double alpha,  double  *a,  long  lda,
                 double *x, long incx, double beta, double *y, long incy);



PURPOSE
       dsymv  performs  the  matrix-vector  operation y := alpha*A*x + beta*y,
       where alpha and beta are scalars, x and y are n element vectors  and  A
       is an n by n symmetric matrix.


ARGUMENTS
       UPLO (input)
                 On  entry, UPLO specifies whether the upper or lower triangu-
                 lar part of the array A is to be referenced as follows:

                 UPLO = 'U' or 'u'   Only the upper triangular part of A is to
                 be referenced.

                 UPLO = 'L' or 'l'   Only the lower triangular part of A is to
                 be referenced.

                 Unchanged on exit.


       N (input)
                 On entry, N specifies the order of the matrix  A.   N  >=  0.
                 Unchanged on exit.


       ALPHA (input)
                 On  entry,  ALPHA  specifies  the scalar alpha.  Unchanged on
                 exit.


       A (input)
                 Before entry with  UPLO = 'U' or 'u',  the  leading  n  by  n
                 upper  triangular  part of the array A must contain the upper
                 triangular part of the  symmetric  matrix  and  the  strictly
                 lower  triangular  part of A is not referenced.  Before entry
                 with UPLO = 'L' or 'l', the leading n by n  lower  triangular
                 part of the array A must contain the lower triangular part of
                 the symmetric matrix and the strictly upper  triangular  part
                 of A is not referenced.  Unchanged on exit.


       LDA (input)
                 On  entry, LDA specifies the first dimension of A as declared
                 in the calling (sub) program. LDA >= max( 1, n ).   Unchanged
                 on exit.


       X (input)
                 ( 1 + ( n - 1 )*abs( INCX ) ).  Before entry, the incremented
                 array X must contain the n element vector  x.   Unchanged  on
                 exit.


       INCX (input)
                 On entry, INCX specifies the increment for the elements of X.
                 INCX <> 0.  Unchanged on exit.


       BETA (input)
                 On entry, BETA specifies the scalar beta. When BETA  is  sup-
                 plied  as zero then Y need not be set on input.  Unchanged on
                 exit.


       Y (input/output)
                 ( 1 + ( n - 1 )*abs( INCY ) ).  Before entry, the incremented
                 array  Y  must  contain the n element vector y. On exit, Y is
                 overwritten by the updated vector y.


       INCY (input)
                 On entry, INCY specifies the increment for the elements of Y.
                 INCY <> 0.  Unchanged on exit.




                                  7 Nov 2015                         dsymv(3P)