1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
|
---
:name: dpbtrf
:md5sum: 6355622b2a30fa00a4fe3d46a1c18912
:category: :subroutine
:arguments:
- uplo:
:type: char
:intent: input
- n:
:type: integer
:intent: input
- kd:
:type: integer
:intent: input
- ab:
:type: doublereal
:intent: input/output
:dims:
- ldab
- n
- ldab:
:type: integer
:intent: input
- info:
:type: integer
:intent: output
:substitutions: {}
:fortran_help: " SUBROUTINE DPBTRF( UPLO, N, KD, AB, LDAB, INFO )\n\n\
* Purpose\n\
* =======\n\
*\n\
* DPBTRF computes the Cholesky factorization of a real symmetric\n\
* positive definite band matrix A.\n\
*\n\
* The factorization has the form\n\
* A = U**T * U, if UPLO = 'U', or\n\
* A = L * L**T, if UPLO = 'L',\n\
* where U is an upper triangular matrix and L is lower triangular.\n\
*\n\n\
* Arguments\n\
* =========\n\
*\n\
* UPLO (input) CHARACTER*1\n\
* = 'U': Upper triangle of A is stored;\n\
* = 'L': Lower triangle of A is stored.\n\
*\n\
* N (input) INTEGER\n\
* The order of the matrix A. N >= 0.\n\
*\n\
* KD (input) INTEGER\n\
* The number of superdiagonals of the matrix A if UPLO = 'U',\n\
* or the number of subdiagonals if UPLO = 'L'. KD >= 0.\n\
*\n\
* AB (input/output) DOUBLE PRECISION array, dimension (LDAB,N)\n\
* On entry, the upper or lower triangle of the symmetric band\n\
* matrix A, stored in the first KD+1 rows of the array. The\n\
* j-th column of A is stored in the j-th column of the array AB\n\
* as follows:\n\
* if UPLO = 'U', AB(kd+1+i-j,j) = A(i,j) for max(1,j-kd)<=i<=j;\n\
* if UPLO = 'L', AB(1+i-j,j) = A(i,j) for j<=i<=min(n,j+kd).\n\
*\n\
* On exit, if INFO = 0, the triangular factor U or L from the\n\
* Cholesky factorization A = U**T*U or A = L*L**T of the band\n\
* matrix A, in the same storage format as A.\n\
*\n\
* LDAB (input) INTEGER\n\
* The leading dimension of the array AB. LDAB >= KD+1.\n\
*\n\
* INFO (output) INTEGER\n\
* = 0: successful exit\n\
* < 0: if INFO = -i, the i-th argument had an illegal value\n\
* > 0: if INFO = i, the leading minor of order i is not\n\
* positive definite, and the factorization could not be\n\
* completed.\n\
*\n\n\
* Further Details\n\
* ===============\n\
*\n\
* The band storage scheme is illustrated by the following example, when\n\
* N = 6, KD = 2, and UPLO = 'U':\n\
*\n\
* On entry: On exit:\n\
*\n\
* * * a13 a24 a35 a46 * * u13 u24 u35 u46\n\
* * a12 a23 a34 a45 a56 * u12 u23 u34 u45 u56\n\
* a11 a22 a33 a44 a55 a66 u11 u22 u33 u44 u55 u66\n\
*\n\
* Similarly, if UPLO = 'L' the format of A is as follows:\n\
*\n\
* On entry: On exit:\n\
*\n\
* a11 a22 a33 a44 a55 a66 l11 l22 l33 l44 l55 l66\n\
* a21 a32 a43 a54 a65 * l21 l32 l43 l54 l65 *\n\
* a31 a42 a53 a64 * * l31 l42 l53 l64 * *\n\
*\n\
* Array elements marked * are not used by the routine.\n\
*\n\
* Contributed by\n\
* Peter Mayes and Giuseppe Radicati, IBM ECSEC, Rome, March 23, 1989\n\
*\n\
* =====================================================================\n\
*\n"
|