Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

dgsvj0 (3p)

Name

dgsvj0 - processor for the routine sgesvj

Synopsis

SUBROUTINE  DGSVJ0(JOBV,  M, N, A, LDA, D, SVA, MV, V, LDV, EPS, SFMIN,
TOL, NSWEEP, WORK, LWORK, INFO)


CHARACTER*1 JOBV

INTEGER INFO, LDA, LDV, LWORK, M, MV, N, NSWEEP

DOUBLE PRECISION EPS, SFMIN, TOL

DOUBLE PRECISION A(LDA,*), SVA(N), D(N), V(LDV,*), WORK(LWORK)


SUBROUTINE DGSVJ0_64(JOBV, M, N, A, LDA,  D,  SVA,  MV,  V,  LDV,  EPS,
SFMIN, TOL, NSWEEP, WORK, LWORK, INFO)


CHARACTER*1 JOBV

INTEGER*8 INFO, LDA, LDV, LWORK, M, MV, N, NSWEEP

DOUBLE PRECISION EPS, SFMIN, TOL

DOUBLE PRECISION A(LDA,*), SVA(N), D(N), V(LDV,*), WORK(LWORK)


F95 INTERFACE
SUBROUTINE  GSVJ0(JOBV,  M,  N, A, LDA, D, SVA, MV, V, LDV, EPS, SFMIN,
TOL, NSWEEP, WORK, LWORK, INFO)


INTEGER :: M, N, LDA, MV, LDV, NSWEEP, LWORK, INFO

CHARACTER(LEN=1) :: JOBV

REAL(8), DIMENSION(:,:) :: A, V

REAL(8), DIMENSION(:) :: D, SVA, WORK

REAL(8) :: TOL, EPS, SFMIN


SUBROUTINE GSVJ0_64(JOBV, M, N, A, LDA, D, SVA, MV, V, LDV, EPS, SFMIN,
TOL, NSWEEP, WORK, LWORK, INFO)


INTEGER(8) :: M, N, LDA, MV, LDV, NSWEEP, LWORK, INFO

CHARACTER(LEN=1) :: JOBV

REAL(8), DIMENSION(:,:) :: A, V

REAL(8), DIMENSION(:) :: D, SVA, WORK

REAL(8) :: TOL, EPS, SFMIN


C INTERFACE
#include <sunperf.h>

void  dgsvj0  (char  jobv, int m, int n, double *a, int lda, double *d,
double *sva, int mv, double *v, int ldv, double  eps,  double
sfmin, double tol, int nsweep, int *info);


void  dgsvj0_64 (char jobv, long m, long n, double *a, long lda, double
*d, double *sva, long mv, double *v, long  ldv,  double  eps,
double sfmin, double tol, long nsweep, long *info);

Description

Oracle Solaris Studio Performance Library                           dgsvj0(3P)



NAME
       dgsvj0 - pre-processor for the routine sgesvj


SYNOPSIS
       SUBROUTINE  DGSVJ0(JOBV,  M, N, A, LDA, D, SVA, MV, V, LDV, EPS, SFMIN,
                 TOL, NSWEEP, WORK, LWORK, INFO)


       CHARACTER*1 JOBV

       INTEGER INFO, LDA, LDV, LWORK, M, MV, N, NSWEEP

       DOUBLE PRECISION EPS, SFMIN, TOL

       DOUBLE PRECISION A(LDA,*), SVA(N), D(N), V(LDV,*), WORK(LWORK)


       SUBROUTINE DGSVJ0_64(JOBV, M, N, A, LDA,  D,  SVA,  MV,  V,  LDV,  EPS,
                 SFMIN, TOL, NSWEEP, WORK, LWORK, INFO)


       CHARACTER*1 JOBV

       INTEGER*8 INFO, LDA, LDV, LWORK, M, MV, N, NSWEEP

       DOUBLE PRECISION EPS, SFMIN, TOL

       DOUBLE PRECISION A(LDA,*), SVA(N), D(N), V(LDV,*), WORK(LWORK)


   F95 INTERFACE
       SUBROUTINE  GSVJ0(JOBV,  M,  N, A, LDA, D, SVA, MV, V, LDV, EPS, SFMIN,
                 TOL, NSWEEP, WORK, LWORK, INFO)


       INTEGER :: M, N, LDA, MV, LDV, NSWEEP, LWORK, INFO

       CHARACTER(LEN=1) :: JOBV

       REAL(8), DIMENSION(:,:) :: A, V

       REAL(8), DIMENSION(:) :: D, SVA, WORK

       REAL(8) :: TOL, EPS, SFMIN


       SUBROUTINE GSVJ0_64(JOBV, M, N, A, LDA, D, SVA, MV, V, LDV, EPS, SFMIN,
                 TOL, NSWEEP, WORK, LWORK, INFO)


       INTEGER(8) :: M, N, LDA, MV, LDV, NSWEEP, LWORK, INFO

       CHARACTER(LEN=1) :: JOBV

       REAL(8), DIMENSION(:,:) :: A, V

       REAL(8), DIMENSION(:) :: D, SVA, WORK

       REAL(8) :: TOL, EPS, SFMIN


   C INTERFACE
       #include <sunperf.h>

       void  dgsvj0  (char  jobv, int m, int n, double *a, int lda, double *d,
                 double *sva, int mv, double *v, int ldv, double  eps,  double
                 sfmin, double tol, int nsweep, int *info);


       void  dgsvj0_64 (char jobv, long m, long n, double *a, long lda, double
                 *d, double *sva, long mv, double *v, long  ldv,  double  eps,
                 double sfmin, double tol, long nsweep, long *info);


PURPOSE
       dgsvj0  is  called  from DGESVJ as a pre-processor and that is its main
       purpose. It applies Jacobi rotations in the same way  as  DGESVJ  does,
       but  it  does  not  check  convergence (stopping criterion). Few tuning
       parameters (marked by [TP]) are available for the implementer.


ARGUMENTS
       JOBV (input)
                 JOBV is CHARACTER*1
                 Specifies whether the output from this procedure is  used  to
                 compute the matrix V:
                 =  'V': the product of the Jacobi rotations is accumulated by
                 postmulyiplying the N-by-N array V.
                 (See the description of V.)
                 = 'A': the product of the Jacobi rotations is accumulated  by
                 postmulyiplying the MV-by-N array V.
                 (See the descriptions of MV and V.)
                 = 'N': the Jacobi rotations are not accumulated.


       M (input)
                 M is INTEGER
                 The number of rows of the input matrix A.  M >= 0.


       N (input)
                 N is INTEGER
                 The number of columns of the input matrix A.
                 M >= N >= 0.


       A (input/output)
                 A is DOUBLE PRECISION array, dimension (LDA,N)
                 On entry, M-by-N matrix A, such that A*diag(D) represents the
                 input matrix.
                 On  exit,  A_onexit*D_onexit  represents  the  input   matrix
                 A*diag(D)  post-multiplied by a sequence of Jacobi rotations,
                 where the rotation threshold and the total number  of  sweeps
                 are given in TOL and NSWEEP, respectively.
                 (See the descriptions of D, TOL and NSWEEP.)


       LDA (input)
                 LDA is INTEGER
                 The leading dimension of the array A.
                 LDA >= max(1,M).


       D (input/output)
                 D is DOUBLE PRECISION array, dimension (N)
                 The  array  D  accumulates  the scaling factors from the fast
                 scaled Jacobi rotations.
                 On entry, A*diag(D) represents the input matrix.
                 On exit, A_onexit*diag(D_onexit) represents the input  matrix
                 post-multiplied  by a sequence of Jacobi rotations, where the
                 rotation threshold and the total number of sweeps  are  given
                 in TOL and NSWEEP, respectively.
                 (See the descriptions of A, TOL and NSWEEP.)


       SVA (input/output)
                 SVA is DOUBLE PRECISION array, dimension (N)
                 On  entry, SVA contains the Euclidean norms of the columns of
                 the matrix A*diag(D).
                 On exit, SVA contains the Euclidean norms of the  columns  of
                 the matrix onexit*diag(D_onexit).


       MV (input)
                 MV is INTEGER
                 If  JOBV  .EQ. 'A', then MV rows of V are post-multipled by a
                 sequence of Jacobi rotations.
                 If JOBV = 'N', then MV is not referenced.


       V (input/output)
                 V is DOUBLE PRECISION array, dimension (LDV,N)
                 If JOBV .EQ. 'V' then N rows of V  are  post-multipled  by  a
                 sequence of Jacobi rotations.
                 If  JOBV  .EQ.  'A' then MV rows of V are post-multipled by a
                 sequence of Jacobi rotations.
                 If JOBV = 'N', then V is not referenced.


       LDV (input)
                 LDV is INTEGER
                 The leading dimension of the array V, LDV >= 1.
                 If JOBV = 'V', LDV .GE. N.
                 If JOBV = 'A', LDV .GE. MV.


       EPS (input)
                 EPS is DOUBLE PRECISION
                 EPS = DLAMCH('Epsilon')


       SFMIN (input)
                 SFMIN is DOUBLE PRECISION
                 SFMIN = DLAMCH('Safe Minimum')


       TOL (input)
                 TOL is DOUBLE PRECISION
                 TOL is the threshold for Jacobi rotations. For a pair A(:,p),
                 A(:,q)  of pivot columns, the Jacobi rotation is applied only
                 if DABS(COS(angle(A(:,p),A(:,q)))) .GT. TOL.


       NSWEEP (input)
                 NSWEEP is INTEGER
                 NSWEEP is the number of sweeps of Jacobi rotations to be per-
                 formed.


       WORK (output)
                 WORK is DOUBLE PRECISION array, dimension (LWORK)


       LWORK (input)
                 LWORK is INTEGER
                 LWORK is the dimension of WORK. LWORK .GE. M.


       INFO (output)
                 INFO is INTEGER
                 = 0 : successful exit,
                 <  0  :  if  INFO = -i, then the i-th argument had an illegal
                 value.




                                  7 Nov 2015                        dgsvj0(3P)