xref: /petsc/src/mat/utils/zerodiag.c (revision 647798804180922dfb980ca29d2b49fa46af1416)
1 #define PETSCMAT_DLL
2 
3 /*
4     This file contains routines to reorder a matrix so that the diagonal
5     elements are nonzero.
6  */
7 
8 #include "private/matimpl.h"       /*I  "petscmat.h"  I*/
9 
10 #define SWAP(a,b) {PetscInt _t; _t = a; a = b; b = _t; }
11 
12 #undef __FUNCT__
13 #define __FUNCT__ "MatReorderForNonzeroDiagonal"
14 /*@
15     MatReorderForNonzeroDiagonal - Changes matrix ordering to remove
16     zeros from diagonal. This may help in the LU factorization to
17     prevent a zero pivot.
18 
19     Collective on Mat
20 
21     Input Parameters:
22 +   mat  - matrix to reorder
23 -   rmap,cmap - row and column permutations.  Usually obtained from
24                MatGetOrdering().
25 
26     Level: intermediate
27 
28     Notes:
29     This is not intended as a replacement for pivoting for matrices that
30     have ``bad'' structure. It is only a stop-gap measure. Should be called
31     after a call to MatGetOrdering(), this routine changes the column
32     ordering defined in cis.
33 
34     Only works for SeqAIJ matrices
35 
36     Options Database Keys (When using KSP):
37 .      -pc_factor_nonzeros_along_diagonal
38 
39     Algorithm Notes:
40     Column pivoting is used.
41 
42     1) Choice of column is made by looking at the
43        non-zero elements in the troublesome row for columns that are not yet
44        included (moving from left to right).
45 
46     2) If (1) fails we check all the columns to the left of the current row
47        and see if one of them has could be swapped. It can be swapped if
48        its corresponding row has a non-zero in the column it is being
49        swapped with; to make sure the previous nonzero diagonal remains
50        nonzero
51 
52 
53 @*/
54 PetscErrorCode  MatReorderForNonzeroDiagonal(Mat mat,PetscReal abstol,IS ris,IS cis)
55 {
56   PetscErrorCode ierr;
57 
58   PetscFunctionBegin;
59   ierr = PetscTryMethod(mat,"MatReorderForNonzeroDiagonal_C",(Mat,PetscReal,IS,IS),(mat,abstol,ris,cis));CHKERRQ(ierr);
60   PetscFunctionReturn(0);
61 }
62 
63 extern PetscErrorCode MatGetRow_SeqAIJ(Mat,PetscInt,PetscInt*,PetscInt**,PetscScalar**);
64 extern PetscErrorCode MatRestoreRow_SeqAIJ(Mat,PetscInt,PetscInt*,PetscInt**,PetscScalar**);
65 
66 #include "../src/vec/is/impls/general/general.h"
67 
68 EXTERN_C_BEGIN
69 #undef __FUNCT__
70 #define __FUNCT__ "MatReorderForNonzeroDiagonal_SeqAIJ"
71 PetscErrorCode  MatReorderForNonzeroDiagonal_SeqAIJ(Mat mat,PetscReal abstol,IS ris,IS cis)
72 {
73   PetscErrorCode ierr;
74   PetscInt       prow,k,nz,n,repl,*j,*col,*row,m,*icol,nnz,*jj,kk;
75   PetscScalar    *v,*vv;
76   PetscReal      repla;
77   IS             icis;
78 
79   PetscFunctionBegin;
80   /* access the indices of the IS directly, because it changes them */
81   row  = ((IS_General*)ris->data)->idx;
82   col  = ((IS_General*)cis->data)->idx;
83   ierr = ISInvertPermutation(cis,PETSC_DECIDE,&icis);CHKERRQ(ierr);
84   icol  = ((IS_General*)icis->data)->idx;
85   ierr = MatGetSize(mat,&m,&n);CHKERRQ(ierr);
86 
87   for (prow=0; prow<n; prow++) {
88     ierr = MatGetRow_SeqAIJ(mat,row[prow],&nz,&j,&v);CHKERRQ(ierr);
89     for (k=0; k<nz; k++) {if (icol[j[k]] == prow) break;}
90     if (k >= nz || PetscAbsScalar(v[k]) <= abstol) {
91       /* Element too small or zero; find the best candidate */
92       repla = (k >= nz) ? 0.0 : PetscAbsScalar(v[k]);
93       /*
94           Look for a later column we can swap with this one
95       */
96       for (k=0; k<nz; k++) {
97 	if (icol[j[k]] > prow && PetscAbsScalar(v[k]) > repla) {
98           /* found a suitable later column */
99 	  repl  = icol[j[k]];
100           SWAP(icol[col[prow]],icol[col[repl]]);
101           SWAP(col[prow],col[repl]);
102           goto found;
103         }
104       }
105       /*
106            Did not find a suitable later column so look for an earlier column
107 	   We need to be sure that we don't introduce a zero in a previous
108 	   diagonal
109       */
110       for (k=0; k<nz; k++) {
111         if (icol[j[k]] < prow && PetscAbsScalar(v[k]) > repla) {
112           /* See if this one will work */
113           repl  = icol[j[k]];
114           ierr = MatGetRow_SeqAIJ(mat,row[repl],&nnz,&jj,&vv);CHKERRQ(ierr);
115           for (kk=0; kk<nnz; kk++) {
116             if (icol[jj[kk]] == prow && PetscAbsScalar(vv[kk]) > abstol) {
117               ierr = MatRestoreRow_SeqAIJ(mat,row[repl],&nnz,&jj,&vv);CHKERRQ(ierr);
118               SWAP(icol[col[prow]],icol[col[repl]]);
119               SWAP(col[prow],col[repl]);
120               goto found;
121 	    }
122           }
123           ierr = MatRestoreRow_SeqAIJ(mat,row[repl],&nnz,&jj,&vv);CHKERRQ(ierr);
124         }
125       }
126       /*
127           No column  suitable; instead check all future rows
128           Note: this will be very slow
129       */
130       for (k=prow+1; k<n; k++) {
131         ierr = MatGetRow_SeqAIJ(mat,row[k],&nnz,&jj,&vv);CHKERRQ(ierr);
132         for (kk=0; kk<nnz; kk++) {
133           if (icol[jj[kk]] == prow && PetscAbsScalar(vv[kk]) > abstol) {
134             /* found a row */
135             SWAP(row[prow],row[k]);
136             goto found;
137           }
138         }
139         ierr = MatRestoreRow_SeqAIJ(mat,row[k],&nnz,&jj,&vv);CHKERRQ(ierr);
140       }
141 
142       found:;
143     }
144     ierr = MatRestoreRow_SeqAIJ(mat,row[prow],&nz,&j,&v);CHKERRQ(ierr);
145   }
146   ierr = ISDestroy(icis);CHKERRQ(ierr);
147   PetscFunctionReturn(0);
148 }
149 EXTERN_C_END
150 
151 
152