solve_evp_complex_2stage_single.3 5.49 KB
Newer Older
1
.TH "solve_evp_complex_2stage_single" 3 "Wed May 17 2017" "ELPA" \" -*- nroff -*-
2 3 4
.ad l
.nh
.SH NAME
5
solve_evp_complex_2stage_single \- solve the single-precision complex eigenvalue problem with the 2-stage ELPA solver (legacy interface)
6 7 8 9 10 11 12 13 14
.br

.SH SYNOPSIS
.br
.SS FORTRAN INTERFACE
use elpa1
use elpa2
.br
.br
Andreas Marek's avatar
Andreas Marek committed
15
.RI  "success = \fBsolve_evp_real_2stage_single\fP (na, nev, a(lda,matrixCols), ev(nev), q(ldq, matrixCols), ldq, nblk, matrixCols, mpi_comm_rows, mpi_comm_cols, mpi_comm_all, THIS_COMPLEX_ELPA_KERNEL, useGPU)"
16 17 18
.br
.RI " "
.br
Andreas Marek's avatar
Andreas Marek committed
19
.RI "With the definitions of the input and output variables:"
20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39

.br
.RI "integer,     intent(in)    \fBna\fP:            global dimension of quadratic matrix \fBa\fP to solve"
.br
.RI "integer,     intent(in)    \fBnev\fP:           number of eigenvalues to be computed; the first \fBnev\fP eigenvalules are calculated"
.br
.RI "complex*8,   intent(inout) \fBa\fP:             locally distributed part of the matrix \fBa\fP. The local dimensions are \fBlda\fP x \fBmatrixCols\fP"
.br
.RI "integer,     intent(in)    \fBlda\fP:           leading dimension of locally distributed matrix \fBa\fP"
.br
.RI "real*4,      intent(inout) \fBev\fP:            on output the first \fBnev\fP computed eigenvalues"
.br
.RI "complex*8,   intent(inout) \fBq\fP:             on output the first \fBnev\fP computed eigenvectors"
.br
.RI "integer,     intent(in)    \fBldq\fP:           leading dimension of matrix \fBq\fP which stores the eigenvectors"
.br
.RI "integer,     intent(in)    \fBnblk\fP:          blocksize of block cyclic distributin, must be the same in both directions"
.br
.RI "integer,     intent(in)    \fBmatrixCols\fP:    number of columns of locally distributed matrices \fBa\fP and \fBq\fP"
.br
40
.RI "integer,     intent(in)    \fBmpi_comm_rows\fP: communicator for communication in rows. Constructed with \fBelpa_get_communicators\fP(3)"
41
.br
42
.RI "integer,     intent(in)    \fBmpi_comm_cols\fP: communicator for communication in colums. Constructed with \fBelpa_get_communicators\fP(3)"
43 44 45
.br
.RI "integer,     intent(in)    \fBmpi_comm_all\fP:  communicator for all processes in the processor set involved in ELPA"
.br
Andreas Marek's avatar
Andreas Marek committed
46 47
.RI "logical, intent(in), optional: \fBuseGPU\fP:    decide whether GPUs should be used or not"
.br
48 49 50
.RI "logical                    \fBsuccess\fP:       return value indicating success or failure"
.br
.SS C INTERFACE
51
#include "elpa_legacy.h"
52 53 54 55
.br
#include <complex.h>

.br
Andreas Marek's avatar
Andreas Marek committed
56
.RI "success = \fBsolve_evp_complex_2stage_single_precision\fP (\fBint\fP na, \fBint\fP nev, \fBcomplex *\fPa, \fBint\fP lda, \fB float *\fPev, \fBcomplex *\fPq, \fBint\fP ldq, \fBint\fP nblk, \fBint\fP matrixCols, \fBint\fP mpi_comm_rows, \fBint\fP mpi_comm_cols, \fBint\fP mpi_comm_all, \fBint\fP THIS_ELPA_COMPLEX_KERNEL, \fBint\fP useGPU);"
57 58 59
.br
.RI " "
.br
Andreas Marek's avatar
Andreas Marek committed
60
.RI "With the definitions of the input and output variables:"
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80

.br
.RI "int             \fBna\fP:            global dimension of quadratic matrix \fBa\fP to solve"
.br
.RI "int             \fBnev\fP:           number of eigenvalues to be computed; the first \fBnev\fP eigenvalules are calculated"
.br
.RI "complex        *\fBa\fP:             pointer to locally distributed part of the matrix \fBa\fP. The local dimensions are \fBlda\fP x \fBmatrixCols\fP"
.br
.RI "int             \fBlda\fP:           leading dimension of locally distributed matrix \fBa\fP"
.br
.RI "float          *\fBev\fP:            pointer to memory containing on output the first \fBnev\fP computed eigenvalues"
.br
.RI "complex        *\fBq\fP:             pointer to memory containing on output the first \fBnev\fP computed eigenvectors"
.br
.RI "int             \fBldq\fP:           leading dimension of matrix \fBq\fP which stores the eigenvectors"
.br
.RI "int             \fBnblk\fP:          blocksize of block cyclic distributin, must be the same in both directions"
.br
.RI "int             \fBmatrixCols\fP:    number of columns of locally distributed matrices \fBa\fP and \fBq\fP"
.br
81
.RI "int             \fBmpi_comm_rows\fP: communicator for communication in rows. Constructed with \fBelpa_get_communicators\fP(3)"
82
.br
83
.RI "int             \fBmpi_comm_cols\fP: communicator for communication in colums. Constructed with \fBelpa_get_communicators\fP(3)"
84 85 86
.br
.RI "int             \fBmpi_comm_all\fP:  communicator for all processes in the processor set involved in ELPA"
.br
Andreas Marek's avatar
Andreas Marek committed
87 88
.RI "int             \fBuseGPU\fP:        decide whether GPUs should be used or not"
.br
89 90 91
.RI "int             \fBsuccess\fP:       return value indicating success (1) or failure (0)

.SH DESCRIPTION
92
Solve the complex eigenvalue problem with the 2-stage solver. The ELPA communicators \fBmpi_comm_rows\fP and \fBmpi_comm_cols\fP are obtained with the \fBelpa_get_communicators\fP(3) function. The distributed quadratic marix \fBa\fP has global dimensions \fBna\fP x \fBna\fP, and a local size \fBlda\fP x \fBmatrixCols\fP. The solver will compute the first \fBnev\fP eigenvalues, which will be stored on exit in \fBev\fP. The eigenvectors corresponding to the eigenvalues will be stored in \fBq\fP. All memory of the arguments must be allocated outside the call to the solver.
93
.br
94 95
This function is part of the legacy API of the ELPA library. Better use the current API.
.br
96
.SH "SEE ALSO"
97 98 99 100 101 102
.br
Old interface:
\fBelpa_get_communicators\fP(3) \fBsolve_evp_real_1stage_double\fP(3) \fBsolve_evp_real_1stage_single\fP(3) \fBsolve_evp_complex_1stage_double\fP(3) \fBsolve_evp_complex_1stage_single\fP(3) \fBsolve_evp_real_2stage_double\fP(3) \fBsolve_evp_real_2stage_single\fP(3) \fBsolve_evp_complex_2stage_double\fP(3)
.br
Current interface:
\fBelpa2_print_kernels\fP(1)