xref: /petsc/src/mat/impls/elemental/matelem.cxx (revision d2daa67e8f804e5a37933ccb80a5373b912323aa)
1 #include <../src/mat/impls/elemental/matelemimpl.h> /*I "petscmat.h" I*/
2 
3 /*
4     The variable Petsc_Elemental_keyval is used to indicate an MPI attribute that
5   is attached to a communicator, in this case the attribute is a Mat_Elemental_Grid
6 */
7 static PetscMPIInt Petsc_Elemental_keyval = MPI_KEYVAL_INVALID;
8 
9 #undef __FUNCT__
10 #define __FUNCT__ "PetscElementalInitializePackage"
11 /*@C
12    PetscElementalInitializePackage - Initialize Elemental package
13 
14    Logically Collective
15 
16    Input Arguments:
17 .  path - the dynamic library path or PETSC_NULL
18 
19    Level: developer
20 
21 .seealso: MATELEMENTAL, PetscElementalFinalizePackage()
22 @*/
23 PetscErrorCode PetscElementalInitializePackage(const char *path)
24 {
25   PetscErrorCode ierr;
26 
27   PetscFunctionBegin;
28   if (elem::Initialized()) PetscFunctionReturn(0);
29   { /* We have already initialized MPI, so this song and dance is just to pass these variables (which won't be used by Elemental) through the interface that needs references */
30     int zero = 0;
31     char **nothing = 0;
32     elem::Initialize(zero,nothing);
33   }
34   ierr = PetscRegisterFinalize(PetscElementalFinalizePackage);CHKERRQ(ierr);
35   PetscFunctionReturn(0);
36 }
37 
38 #undef __FUNCT__
39 #define __FUNCT__ "PetscElementalFinalizePackage"
40 /*@C
41    PetscElementalFinalizePackage - Finalize Elemental package
42 
43    Logically Collective
44 
45    Level: developer
46 
47 .seealso: MATELEMENTAL, PetscElementalInitializePackage()
48 @*/
49 PetscErrorCode PetscElementalFinalizePackage(void)
50 {
51 
52   PetscFunctionBegin;
53   elem::Finalize();
54   PetscFunctionReturn(0);
55 }
56 
57 #undef __FUNCT__
58 #define __FUNCT__ "MatView_Elemental"
59 static PetscErrorCode MatView_Elemental(Mat A,PetscViewer viewer)
60 {
61   PetscErrorCode ierr;
62   Mat_Elemental  *a = (Mat_Elemental*)A->data;
63   PetscBool      iascii;
64 
65   PetscFunctionBegin;
66   ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&iascii);CHKERRQ(ierr);
67   if (iascii) {
68     PetscViewerFormat format;
69     ierr = PetscViewerGetFormat(viewer,&format);CHKERRQ(ierr);
70     if (format == PETSC_VIEWER_ASCII_INFO) {
71       /* call elemental viewing function */
72       ierr = PetscPrintf(((PetscObject)viewer)->comm,"allocated entries=%d\n",(*a->emat).AllocatedMemory());CHKERRQ(ierr);
73       ierr = PetscPrintf(((PetscObject)viewer)->comm,"grid height=%d, grid width=%d\n",(*a->emat).Grid().Height(),(*a->emat).Grid().Width());CHKERRQ(ierr);
74       if (format == PETSC_VIEWER_ASCII_FACTOR_INFO) {
75         /* call elemental viewing function */
76         ierr = PetscPrintf(((PetscObject)viewer)->comm,"test matview_elemental 2\n");CHKERRQ(ierr);
77       }
78 
79     } else if (format == PETSC_VIEWER_DEFAULT) {
80       ierr = PetscViewerASCIIUseTabs(viewer,PETSC_FALSE);CHKERRQ(ierr);
81       ierr = PetscObjectPrintClassNamePrefixType((PetscObject)A,viewer,"Matrix Object");CHKERRQ(ierr);
82       a->emat->Print("Elemental matrix (cyclic ordering)");
83       ierr = PetscViewerASCIIUseTabs(viewer,PETSC_TRUE);CHKERRQ(ierr);
84       if (A->factortype == MAT_FACTOR_NONE){
85         Mat Aaij;
86         ierr = PetscPrintf(((PetscObject)viewer)->comm,"Elemental matrix (explicit ordering)\n");CHKERRQ(ierr);
87         ierr = MatComputeExplicitOperator(A,&Aaij);CHKERRQ(ierr);
88         ierr = MatView(Aaij,viewer);CHKERRQ(ierr);
89         ierr = MatDestroy(&Aaij);CHKERRQ(ierr);
90       }
91     } else SETERRQ(((PetscObject)viewer)->comm,PETSC_ERR_SUP,"Format");
92   } else {
93     /* convert to aij/mpidense format and call MatView() */
94     Mat Aaij;
95     ierr = PetscPrintf(((PetscObject)viewer)->comm,"Elemental matrix (explicit ordering)\n");CHKERRQ(ierr);
96     ierr = MatComputeExplicitOperator(A,&Aaij);CHKERRQ(ierr);
97     ierr = MatView(Aaij,viewer);CHKERRQ(ierr);
98     ierr = MatDestroy(&Aaij);CHKERRQ(ierr);
99   }
100   PetscFunctionReturn(0);
101 }
102 
103 #undef __FUNCT__
104 #define __FUNCT__ "MatGetInfo_Elemental"
105 static PetscErrorCode MatGetInfo_Elemental(Mat F,MatInfoType flag,MatInfo *info)
106 {
107   PetscFunctionBegin;
108   /* this routine is called by PCSetUp_LU(). It does nothing yet. */
109   PetscFunctionReturn(0);
110 }
111 
112 #undef __FUNCT__
113 #define __FUNCT__ "MatSetValues_Elemental"
114 static PetscErrorCode MatSetValues_Elemental(Mat A,PetscInt nr,const PetscInt *rows,PetscInt nc,const PetscInt *cols,const PetscScalar *vals,InsertMode imode)
115 {
116   PetscErrorCode ierr;
117   Mat_Elemental  *a = (Mat_Elemental*)A->data;
118   PetscMPIInt    rank;
119   PetscInt       i,j,rrank,ridx,crank,cidx;
120 
121   PetscFunctionBegin;
122   ierr = MPI_Comm_rank(((PetscObject)A)->comm,&rank);CHKERRQ(ierr);
123 
124   const elem::Grid &grid = a->emat->Grid();
125   for (i=0; i<nr; i++) {
126     PetscInt erow,ecol,elrow,elcol;
127     if (rows[i] < 0) continue;
128     P2RO(A,0,rows[i],&rrank,&ridx);
129     RO2E(A,0,rrank,ridx,&erow);
130     if (rrank < 0 || ridx < 0 || erow < 0) SETERRQ(((PetscObject)A)->comm,PETSC_ERR_PLIB,"Incorrect row translation");
131     for (j=0; j<nc; j++) {
132       if (cols[j] < 0) continue;
133       P2RO(A,1,cols[j],&crank,&cidx);
134       RO2E(A,1,crank,cidx,&ecol);
135       if (crank < 0 || cidx < 0 || ecol < 0) SETERRQ(((PetscObject)A)->comm,PETSC_ERR_PLIB,"Incorrect col translation");
136       if (erow % grid.MCSize() != grid.MCRank() || ecol % grid.MRSize() != grid.MRRank()){ /* off-proc entry */
137         if (imode != ADD_VALUES) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP,"Only ADD_VALUES to off-processor entry is supported");
138         /* PetscPrintf(PETSC_COMM_SELF,"[%D] add off-proc entry (%D,%D, %g) (%D %D)\n",rank,rows[i],cols[j],*(vals+i*nc),erow,ecol); */
139         a->esubmat->Set(0,0, vals[i*nc+j]);
140         a->interface->Axpy(1.0,*(a->esubmat),erow,ecol);
141         continue;
142       }
143       elrow = erow / grid.MCSize();
144       elcol = ecol / grid.MRSize();
145       switch (imode) {
146       case INSERT_VALUES: a->emat->SetLocal(elrow,elcol,vals[i*nc+j]); break;
147       case ADD_VALUES: a->emat->UpdateLocal(elrow,elcol,vals[i*nc+j]); break;
148       default: SETERRQ1(((PetscObject)A)->comm,PETSC_ERR_SUP,"No support for InsertMode %d",(int)imode);
149       }
150     }
151   }
152   PetscFunctionReturn(0);
153 }
154 
155 #undef __FUNCT__
156 #define __FUNCT__ "MatMult_Elemental"
157 static PetscErrorCode MatMult_Elemental(Mat A,Vec X,Vec Y)
158 {
159   Mat_Elemental     *a = (Mat_Elemental*)A->data;
160   PetscErrorCode    ierr;
161   const PetscScalar *x;
162   PetscScalar       *y;
163   PetscScalar       one = 1,zero = 0;
164 
165   PetscFunctionBegin;
166   ierr = VecGetArrayRead(X,&x);CHKERRQ(ierr);
167   ierr = VecGetArray(Y,&y);CHKERRQ(ierr);
168   { /* Scoping so that constructor is called before pointer is returned */
169     elem::DistMatrix<PetscScalar,elem::VC,elem::STAR> xe(A->cmap->N,1,0,x,A->cmap->n,*a->grid);
170     elem::DistMatrix<PetscScalar,elem::VC,elem::STAR> ye(A->rmap->N,1,0,y,A->rmap->n,*a->grid);
171     elem::Gemv(elem::NORMAL,one,*a->emat,xe,zero,ye);
172   }
173   ierr = VecRestoreArrayRead(X,&x);CHKERRQ(ierr);
174   ierr = VecRestoreArray(Y,&y);CHKERRQ(ierr);
175   PetscFunctionReturn(0);
176 }
177 
178 #undef __FUNCT__
179 #define __FUNCT__ "MatMultAdd_Elemental"
180 static PetscErrorCode MatMultAdd_Elemental(Mat A,Vec X,Vec Y,Vec Z)
181 {
182   Mat_Elemental     *a = (Mat_Elemental*)A->data;
183   PetscErrorCode    ierr;
184   const PetscScalar *x;
185   PetscScalar       *z;
186   PetscScalar       one = 1.0;
187 
188   PetscFunctionBegin;
189   if (Y != Z) {ierr = VecCopy(Y,Z);CHKERRQ(ierr);}
190   ierr = VecGetArrayRead(X,&x);CHKERRQ(ierr);
191   ierr = VecGetArray(Z,&z);CHKERRQ(ierr);
192   { /* Scoping so that constructor is called before pointer is returned */
193     elem::DistMatrix<PetscScalar,elem::VC,elem::STAR> xe(A->cmap->N,1,0,x,A->cmap->n,*a->grid);
194     elem::DistMatrix<PetscScalar,elem::VC,elem::STAR> ze(A->rmap->N,1,0,z,A->rmap->n,*a->grid);
195     elem::Gemv(elem::NORMAL,one,*a->emat,xe,one,ze);
196   }
197   ierr = VecRestoreArrayRead(X,&x);CHKERRQ(ierr);
198   ierr = VecRestoreArray(Z,&z);CHKERRQ(ierr);
199   PetscFunctionReturn(0);
200 }
201 
202 #undef __FUNCT__
203 #define __FUNCT__ "MatMatMultNumeric_Elemental"
204 static PetscErrorCode MatMatMultNumeric_Elemental(Mat A,Mat B,Mat C)
205 {
206   Mat_Elemental  *a = (Mat_Elemental*)A->data;
207   Mat_Elemental  *b = (Mat_Elemental*)B->data;
208   Mat_Elemental  *c = (Mat_Elemental*)C->data;
209   PetscScalar    one = 1.0,zero = 0.0;
210 
211   PetscFunctionBegin;
212   { /* Scoping so that constructor is called before pointer is returned */
213     elem::Gemm(elem::NORMAL,elem::NORMAL,one,*a->emat,*b->emat,zero,*c->emat);
214   }
215   C->assembled = PETSC_TRUE;
216   PetscFunctionReturn(0);
217 }
218 
219 #undef __FUNCT__
220 #define __FUNCT__ "MatMatMultSymbolic_Elemental"
221 static PetscErrorCode MatMatMultSymbolic_Elemental(Mat A,Mat B,PetscReal fill,Mat *C)
222 {
223   PetscErrorCode ierr;
224   Mat            Ce;
225   MPI_Comm       comm=((PetscObject)A)->comm;
226 
227   PetscFunctionBegin;
228   ierr = MatCreate(comm,&Ce);CHKERRQ(ierr);
229   ierr = MatSetSizes(Ce,A->rmap->n,B->cmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
230   ierr = MatSetType(Ce,MATELEMENTAL);CHKERRQ(ierr);
231   ierr = MatSetUp(Ce);CHKERRQ(ierr);
232   *C = Ce;
233   PetscFunctionReturn(0);
234 }
235 
236 #undef __FUNCT__
237 #define __FUNCT__ "MatMatMult_Elemental"
238 static PetscErrorCode MatMatMult_Elemental(Mat A,Mat B,MatReuse scall,PetscReal fill,Mat *C)
239 {
240   PetscErrorCode ierr;
241 
242   PetscFunctionBegin;
243   if (scall == MAT_INITIAL_MATRIX){
244     ierr = PetscLogEventBegin(MAT_MatMultSymbolic,A,B,0,0);CHKERRQ(ierr);
245     ierr = MatMatMultSymbolic_Elemental(A,B,1.0,C);CHKERRQ(ierr);
246     ierr = PetscLogEventEnd(MAT_MatMultSymbolic,A,B,0,0);CHKERRQ(ierr);
247   }
248   ierr = PetscLogEventBegin(MAT_MatMultNumeric,A,B,0,0);CHKERRQ(ierr);
249   ierr = MatMatMultNumeric_Elemental(A,B,*C);CHKERRQ(ierr);
250   ierr = PetscLogEventEnd(MAT_MatMultNumeric,A,B,0,0);CHKERRQ(ierr);
251   PetscFunctionReturn(0);
252 }
253 
254 #undef __FUNCT__
255 #define __FUNCT__ "MatScale_Elemental"
256 static PetscErrorCode MatScale_Elemental(Mat X,PetscScalar a)
257 {
258   Mat_Elemental  *x = (Mat_Elemental*)X->data;
259 
260   PetscFunctionBegin;
261   elem::Scal(a,*x->emat);
262   PetscFunctionReturn(0);
263 }
264 
265 #undef __FUNCT__
266 #define __FUNCT__ "MatAXPY_Elemental"
267 static PetscErrorCode MatAXPY_Elemental(Mat Y,PetscScalar a,Mat X,MatStructure str)
268 {
269   Mat_Elemental  *x = (Mat_Elemental*)X->data;
270   Mat_Elemental  *y = (Mat_Elemental*)Y->data;
271 
272   PetscFunctionBegin;
273   elem::Axpy(a,*x->emat,*y->emat);
274   PetscFunctionReturn(0);
275 }
276 
277 #undef __FUNCT__
278 #define __FUNCT__ "MatCopy_Elemental"
279 static PetscErrorCode MatCopy_Elemental(Mat A,Mat B,MatStructure str)
280 {
281   Mat_Elemental *a=(Mat_Elemental*)A->data;
282   Mat_Elemental *b=(Mat_Elemental*)B->data;
283 
284   PetscFunctionBegin;
285   elem::Copy(*a->emat,*b->emat);
286   PetscFunctionReturn(0);
287 }
288 
289 #undef __FUNCT__
290 #define __FUNCT__ "MatTranspose_Elemental"
291 static PetscErrorCode MatTranspose_Elemental(Mat A,MatReuse reuse,Mat *B)
292 {
293   /* Only out-of-place supported */
294   Mat            Be;
295   PetscErrorCode ierr;
296   MPI_Comm       comm=((PetscObject)A)->comm;
297   Mat_Elemental  *a = (Mat_Elemental*)A->data, *b;
298 
299   PetscFunctionBegin;
300   if (reuse == MAT_INITIAL_MATRIX){
301     ierr = MatCreate(comm,&Be);CHKERRQ(ierr);
302     ierr = MatSetSizes(Be,A->cmap->n,A->rmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
303     ierr = MatSetType(Be,MATELEMENTAL);CHKERRQ(ierr);
304     ierr = MatSetUp(Be);CHKERRQ(ierr);
305     *B = Be;
306   }
307   b = (Mat_Elemental*)Be->data;
308   elem::Transpose(*a->emat,*b->emat);
309   Be->assembled = PETSC_TRUE;
310   PetscFunctionReturn(0);
311 }
312 
313 #undef __FUNCT__
314 #define __FUNCT__ "MatSolve_Elemental"
315 static PetscErrorCode MatSolve_Elemental(Mat A,Vec B,Vec X)
316 {
317   Mat_Elemental     *a = (Mat_Elemental*)A->data;
318   PetscErrorCode    ierr;
319   PetscScalar       *x;
320 
321   PetscFunctionBegin;
322   ierr = VecCopy(B,X);CHKERRQ(ierr);
323   ierr = VecGetArray(X,&x);CHKERRQ(ierr);
324   elem::DistMatrix<PetscScalar,elem::VC,elem::STAR> xe(A->rmap->N,1,0,x,A->rmap->n,*a->grid);
325   elem::DistMatrix<PetscScalar,elem::MC,elem::MR> xer = xe;
326   switch (A->factortype) {
327   case MAT_FACTOR_LU:
328     if ((*a->pivot).AllocatedMemory()) {
329       elem::SolveAfterLU(elem::NORMAL,*a->emat,*a->pivot,xer);
330       elem::Copy(xer,xe);
331     } else {
332       elem::SolveAfterLU(elem::NORMAL,*a->emat,xer);
333       elem::Copy(xer,xe);
334     }
335     break;
336   case MAT_FACTOR_CHOLESKY:
337     elem::SolveAfterCholesky(elem::UPPER,elem::NORMAL,*a->emat,xer);
338     elem::Copy(xer,xe);
339     break;
340   default:
341     SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP,"Unfactored Matrix or Unsupported MatFactorType");
342     break;
343   }
344   ierr = VecRestoreArray(X,&x);CHKERRQ(ierr);
345   PetscFunctionReturn(0);
346 }
347 
348 #undef __FUNCT__
349 #define __FUNCT__ "MatMatSolve_Elemental"
350 static PetscErrorCode MatMatSolve_Elemental(Mat A,Mat B,Mat X)
351 {
352   Mat_Elemental *a=(Mat_Elemental*)A->data;
353   Mat_Elemental *b=(Mat_Elemental*)B->data;
354   Mat_Elemental *x=(Mat_Elemental*)X->data;
355 
356   PetscFunctionBegin;
357   elem::Copy(*b->emat,*x->emat);
358   switch (A->factortype) {
359   case MAT_FACTOR_LU:
360     if ((*a->pivot).AllocatedMemory()) {
361       elem::SolveAfterLU(elem::NORMAL,*a->emat,*a->pivot,*x->emat);
362     } else {
363       elem::SolveAfterLU(elem::NORMAL,*a->emat,*x->emat);
364     }
365     break;
366   case MAT_FACTOR_CHOLESKY:
367     elem::SolveAfterCholesky(elem::UPPER,elem::NORMAL,*a->emat,*x->emat);
368     break;
369   default:
370     SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP,"Unfactored Matrix or Unsupported MatFactorType");
371     break;
372   }
373   PetscFunctionReturn(0);
374 }
375 
376 #undef __FUNCT__
377 #define __FUNCT__ "MatLUFactor_Elemental"
378 static PetscErrorCode MatLUFactor_Elemental(Mat A,IS row,IS col,const MatFactorInfo *info)
379 {
380   Mat_Elemental  *a = (Mat_Elemental*)A->data;
381 
382   PetscFunctionBegin;
383   if (info->dtcol){
384     elem::LU(*a->emat,*a->pivot);
385   } else {
386     elem::LU(*a->emat);
387   }
388   A->factortype = MAT_FACTOR_LU;
389   A->assembled  = PETSC_TRUE;
390   PetscFunctionReturn(0);
391 }
392 
393 #undef __FUNCT__
394 #define __FUNCT__ "MatLUFactorNumeric_Elemental"
395 static PetscErrorCode  MatLUFactorNumeric_Elemental(Mat F,Mat A,const MatFactorInfo *info)
396 {
397   PetscErrorCode ierr;
398 
399   PetscFunctionBegin;
400   ierr = MatCopy(A,F,SAME_NONZERO_PATTERN);CHKERRQ(ierr);
401   ierr = MatLUFactor_Elemental(F,0,0,info);CHKERRQ(ierr);
402   PetscFunctionReturn(0);
403 }
404 
405 #undef __FUNCT__
406 #define __FUNCT__ "MatLUFactorSymbolic_Elemental"
407 static PetscErrorCode  MatLUFactorSymbolic_Elemental(Mat F,Mat A,IS r,IS c,const MatFactorInfo *info)
408 {
409   PetscFunctionBegin;
410   /* F is create and allocated by MatGetFactor_elemental_petsc(), skip this routine. */
411   PetscFunctionReturn(0);
412 }
413 
414 #undef __FUNCT__
415 #define __FUNCT__ "MatCholeskyFactor_Elemental"
416 static PetscErrorCode MatCholeskyFactor_Elemental(Mat A,IS perm,const MatFactorInfo *info)
417 {
418   Mat_Elemental  *a = (Mat_Elemental*)A->data;
419   elem::DistMatrix<PetscScalar,elem::MC,elem::STAR> d;
420 
421   PetscFunctionBegin;
422   elem::Cholesky(elem::UPPER,*a->emat);
423   // if (info->dtcol){
424   //   /* A = U^T * U for SPD Matrix A */
425   //   printf("Cholesky Factorization for SPD Matrices...\n");
426   //   elem::Cholesky(elem::UPPER,*a->emat);
427   // } else {
428   //   /* A = U^T * D * U * for Symmetric Matrix A */
429   //   printf("LDL^T Factorization for Symmetric Matrices.\n");
430   //   printf("This routine does not pivot. Use with caution.\n");
431   //   elem::LDLT(*a->emat,d);
432   // }
433   A->factortype = MAT_FACTOR_CHOLESKY;
434   A->assembled  = PETSC_TRUE;
435   PetscFunctionReturn(0);
436 }
437 
438 #undef __FUNCT__
439 #define __FUNCT__ "MatCholeskyFactorNumeric_Elemental"
440 static PetscErrorCode MatCholeskyFactorNumeric_Elemental(Mat F,Mat A,const MatFactorInfo *info)
441 {
442   PetscErrorCode ierr;
443 
444   PetscFunctionBegin;
445   ierr = MatCopy(A,F,SAME_NONZERO_PATTERN);CHKERRQ(ierr);
446   ierr = MatCholeskyFactor_Elemental(F,0,info);CHKERRQ(ierr);
447   PetscFunctionReturn(0);
448 }
449 
450 #undef __FUNCT__
451 #define __FUNCT__ "MatCholeskyFactorSymbolic_Elemental"
452 static PetscErrorCode MatCholeskyFactorSymbolic_Elemental(Mat F,Mat A,IS perm,const MatFactorInfo *info)
453 {
454   PetscFunctionBegin;
455   /* F is create and allocated by MatGetFactor_elemental_petsc(), skip this routine. */
456   PetscFunctionReturn(0);
457 }
458 
459 EXTERN_C_BEGIN
460 #undef __FUNCT__
461 #define __FUNCT__ "MatGetFactor_elemental_petsc"
462 static PetscErrorCode MatGetFactor_elemental_petsc(Mat A,MatFactorType ftype,Mat *F)
463 {
464   Mat            B;
465   PetscErrorCode ierr;
466 
467   PetscFunctionBegin;
468   /* Create the factorization matrix */
469   ierr = MatCreate(((PetscObject)A)->comm,&B);CHKERRQ(ierr);
470   ierr = MatSetSizes(B,A->rmap->n,A->cmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
471   ierr = MatSetType(B,MATELEMENTAL);CHKERRQ(ierr);
472   ierr = MatSetUp(B);CHKERRQ(ierr);
473   B->factortype = ftype;
474   *F            = B;
475   PetscFunctionReturn(0);
476 }
477 EXTERN_C_END
478 
479 #undef __FUNCT__
480 #define __FUNCT__ "MatNorm_Elemental"
481 static PetscErrorCode MatNorm_Elemental(Mat A,NormType type,PetscReal *nrm)
482 {
483   Mat_Elemental *a=(Mat_Elemental*)A->data;
484 
485   PetscFunctionBegin;
486   switch (type){
487   case NORM_1:
488     *nrm = elem::Norm(*a->emat,elem::ONE_NORM);
489     break;
490   case NORM_FROBENIUS:
491     *nrm = elem::Norm(*a->emat,elem::FROBENIUS_NORM);
492     break;
493   case NORM_INFINITY:
494     *nrm = elem::Norm(*a->emat,elem::INFINITY_NORM);
495     break;
496   default:
497     printf("Error: unsupported norm type!\n");
498   }
499   PetscFunctionReturn(0);
500 }
501 
502 #undef __FUNCT__
503 #define __FUNCT__ "MatZeroEntries_Elemental"
504 static PetscErrorCode MatZeroEntries_Elemental(Mat A)
505 {
506   Mat_Elemental *a=(Mat_Elemental*)A->data;
507 
508   PetscFunctionBegin;
509   elem::Zero(*a->emat);
510   PetscFunctionReturn(0);
511 }
512 
513 EXTERN_C_BEGIN
514 #undef __FUNCT__
515 #define __FUNCT__ "MatGetOwnershipIS_Elemental"
516 static PetscErrorCode MatGetOwnershipIS_Elemental(Mat A,IS *rows,IS *cols)
517 {
518   Mat_Elemental  *a = (Mat_Elemental*)A->data;
519   PetscErrorCode ierr;
520   PetscInt       i,m,shift,stride,*idx;
521 
522   PetscFunctionBegin;
523   if (rows) {
524     m = a->emat->LocalHeight();
525     shift = a->emat->ColShift();
526     stride = a->emat->ColStride();
527     ierr = PetscMalloc(m*sizeof(PetscInt),&idx);CHKERRQ(ierr);
528     for (i=0; i<m; i++) {
529       PetscInt rank,offset;
530       E2RO(A,0,shift+i*stride,&rank,&offset);
531       RO2P(A,0,rank,offset,&idx[i]);
532     }
533     ierr = ISCreateGeneral(PETSC_COMM_SELF,m,idx,PETSC_OWN_POINTER,rows);CHKERRQ(ierr);
534   }
535   if (cols) {
536     m = a->emat->LocalWidth();
537     shift = a->emat->RowShift();
538     stride = a->emat->RowStride();
539     ierr = PetscMalloc(m*sizeof(PetscInt),&idx);CHKERRQ(ierr);
540     for (i=0; i<m; i++) {
541       PetscInt rank,offset;
542       E2RO(A,1,shift+i*stride,&rank,&offset);
543       RO2P(A,1,rank,offset,&idx[i]);
544     }
545     ierr = ISCreateGeneral(PETSC_COMM_SELF,m,idx,PETSC_OWN_POINTER,cols);CHKERRQ(ierr);
546   }
547   PetscFunctionReturn(0);
548 }
549 EXTERN_C_END
550 
551 #undef __FUNCT__
552 #define __FUNCT__ "MatDestroy_Elemental"
553 static PetscErrorCode MatDestroy_Elemental(Mat A)
554 {
555   Mat_Elemental      *a = (Mat_Elemental*)A->data;
556   PetscErrorCode     ierr;
557   Mat_Elemental_Grid *commgrid;
558   PetscBool          flg;
559   MPI_Comm           icomm;
560 
561   PetscFunctionBegin;
562   a->interface->Detach();
563   delete a->interface;
564   delete a->esubmat;
565   delete a->emat;
566 
567   elem::mpi::Comm cxxcomm(((PetscObject)A)->comm);
568   ierr = PetscCommDuplicate(cxxcomm,&icomm,PETSC_NULL);CHKERRQ(ierr);
569   ierr = MPI_Attr_get(icomm,Petsc_Elemental_keyval,(void**)&commgrid,(int*)&flg);CHKERRQ(ierr);
570   if (--commgrid->grid_refct == 0) {
571     delete commgrid->grid;
572     ierr = PetscFree(commgrid);CHKERRQ(ierr);
573   }
574   ierr = PetscCommDestroy(&icomm);CHKERRQ(ierr);
575   ierr = PetscObjectComposeFunctionDynamic((PetscObject)A,"MatGetOwnershipIS_C","",PETSC_NULL);CHKERRQ(ierr);
576   ierr = PetscObjectComposeFunctionDynamic((PetscObject)A,"MatGetFactor_petsc_C","",PETSC_NULL);CHKERRQ(ierr);
577   ierr = PetscFree(A->data);CHKERRQ(ierr);
578   PetscFunctionReturn(0);
579 }
580 
581 #undef __FUNCT__
582 #define __FUNCT__ "MatSetUp_Elemental"
583 PetscErrorCode MatSetUp_Elemental(Mat A)
584 {
585   Mat_Elemental  *a = (Mat_Elemental*)A->data;
586   PetscErrorCode ierr;
587   PetscMPIInt    rsize,csize;
588 
589   PetscFunctionBegin;
590   ierr = PetscLayoutSetUp(A->rmap);CHKERRQ(ierr);
591   ierr = PetscLayoutSetUp(A->cmap);CHKERRQ(ierr);
592 
593   a->emat->ResizeTo(A->rmap->N,A->cmap->N);CHKERRQ(ierr);
594   elem::Zero(*a->emat);
595 
596   ierr = MPI_Comm_size(A->rmap->comm,&rsize);CHKERRQ(ierr);
597   ierr = MPI_Comm_size(A->cmap->comm,&csize);CHKERRQ(ierr);
598   if (csize != rsize) SETERRQ(((PetscObject)A)->comm,PETSC_ERR_ARG_INCOMP,"Cannot use row and column communicators of different sizes");
599   a->commsize = rsize;
600   a->mr[0] = A->rmap->N % rsize; if (!a->mr[0]) a->mr[0] = rsize;
601   a->mr[1] = A->cmap->N % csize; if (!a->mr[1]) a->mr[1] = csize;
602   a->m[0] = A->rmap->N / rsize + (a->mr[0] != rsize);
603   a->m[1] = A->cmap->N / csize + (a->mr[1] != csize);
604   PetscFunctionReturn(0);
605 }
606 
607 #undef __FUNCT__
608 #define __FUNCT__ "MatAssemblyBegin_Elemental"
609 PetscErrorCode MatAssemblyBegin_Elemental(Mat A, MatAssemblyType type)
610 {
611   Mat_Elemental  *a = (Mat_Elemental*)A->data;
612 
613   PetscFunctionBegin;
614   a->interface->Detach();
615   a->interface->Attach(elem::LOCAL_TO_GLOBAL,*(a->emat));
616   PetscFunctionReturn(0);
617 }
618 
619 #undef __FUNCT__
620 #define __FUNCT__ "MatAssemblyEnd_Elemental"
621 PetscErrorCode MatAssemblyEnd_Elemental(Mat A, MatAssemblyType type)
622 {
623   PetscFunctionBegin;
624   /* Currently does nothing */
625   PetscFunctionReturn(0);
626 }
627 
628 /*MC
629    MATELEMENTAL = "elemental" - A matrix type for dense matrices using the Elemental package
630 
631    Options Database Keys:
632 . -mat_type elemental - sets the matrix type to "elemental" during a call to MatSetFromOptions()
633 
634   Level: beginner
635 
636 .seealso: MATDENSE,MatCreateElemental()
637 M*/
638 EXTERN_C_BEGIN
639 #undef __FUNCT__
640 #define __FUNCT__ "MatCreate_Elemental"
641 PETSC_EXTERN_C PetscErrorCode MatCreate_Elemental(Mat A)
642 {
643   Mat_Elemental      *a;
644   PetscErrorCode     ierr;
645   PetscBool          flg;
646   Mat_Elemental_Grid *commgrid;
647   MPI_Comm           icomm;
648 
649   PetscFunctionBegin;
650   ierr = PetscElementalInitializePackage(PETSC_NULL);CHKERRQ(ierr);
651 
652   ierr = PetscNewLog(A,Mat_Elemental,&a);CHKERRQ(ierr);
653   A->data = (void*)a;
654 
655   A->ops->getinfo         = MatGetInfo_Elemental;
656   A->ops->view            = MatView_Elemental;
657   A->ops->destroy         = MatDestroy_Elemental;
658   A->ops->setup           = MatSetUp_Elemental;
659   A->ops->setvalues       = MatSetValues_Elemental;
660   A->ops->mult            = MatMult_Elemental;
661   A->ops->multadd         = MatMultAdd_Elemental;
662   A->ops->matmult         = MatMatMult_Elemental;
663   A->ops->matmultsymbolic = MatMatMultSymbolic_Elemental;
664   A->ops->matmultnumeric  = MatMatMultNumeric_Elemental;
665   A->ops->assemblybegin   = MatAssemblyBegin_Elemental;
666   A->ops->assemblyend     = MatAssemblyEnd_Elemental;
667   A->ops->scale           = MatScale_Elemental;
668   A->ops->axpy            = MatAXPY_Elemental;
669   A->ops->lufactor        = MatLUFactor_Elemental;
670   A->ops->lufactorsymbolic = MatLUFactorSymbolic_Elemental;
671   A->ops->lufactornumeric  = MatLUFactorNumeric_Elemental;
672   A->ops->matsolve        = MatMatSolve_Elemental;
673   A->ops->copy            = MatCopy_Elemental;
674   A->ops->transpose       = MatTranspose_Elemental;
675   A->ops->norm            = MatNorm_Elemental;
676   A->ops->solve           = MatSolve_Elemental;
677   A->ops->zeroentries     = MatZeroEntries_Elemental;
678   A->ops->choleskyfactor  = MatCholeskyFactor_Elemental;
679   A->ops->choleskyfactorsymbolic = MatCholeskyFactorSymbolic_Elemental;
680   A->ops->choleskyfactornumeric  = MatCholeskyFactorNumeric_Elemental;
681 
682   A->insertmode = NOT_SET_VALUES;
683 
684   /* Set up the elemental matrix */
685   elem::mpi::Comm cxxcomm(((PetscObject)A)->comm);
686 
687   /* Grid needs to be shared between multiple Mats on the same communicator, implement by attribute caching on the MPI_Comm */
688   if (Petsc_Elemental_keyval == MPI_KEYVAL_INVALID) {
689     ierr = MPI_Keyval_create(MPI_NULL_COPY_FN,MPI_NULL_DELETE_FN,&Petsc_Elemental_keyval,(void*)0);
690   }
691   ierr = PetscCommDuplicate(cxxcomm,&icomm,PETSC_NULL);CHKERRQ(ierr);
692   ierr = MPI_Attr_get(icomm,Petsc_Elemental_keyval,(void**)&commgrid,(int*)&flg);CHKERRQ(ierr);
693   if (!flg) {
694     ierr = PetscNewLog(A,Mat_Elemental_Grid,&commgrid);CHKERRQ(ierr);
695     commgrid->grid       = new elem::Grid(cxxcomm);
696     commgrid->grid_refct = 1;
697     ierr = MPI_Attr_put(icomm,Petsc_Elemental_keyval,(void*)commgrid);CHKERRQ(ierr);
698   } else {
699     commgrid->grid_refct++;
700   }
701   ierr = PetscCommDestroy(&icomm);CHKERRQ(ierr);
702   a->grid      = commgrid->grid;
703   a->emat      = new elem::DistMatrix<PetscScalar>(*a->grid);
704   a->esubmat   = new elem::Matrix<PetscScalar>(1,1);
705   a->interface = new elem::AxpyInterface<PetscScalar>;
706   a->pivot     = new elem::DistMatrix<PetscInt,elem::VC,elem::STAR>;
707 
708   /* build cache for off array entries formed */
709   a->interface->Attach(elem::LOCAL_TO_GLOBAL,*(a->emat));
710 
711   ierr = PetscObjectComposeFunctionDynamic((PetscObject)A,"MatGetOwnershipIS_C","MatGetOwnershipIS_Elemental",MatGetOwnershipIS_Elemental);CHKERRQ(ierr);
712   ierr = PetscObjectComposeFunctionDynamic((PetscObject)A,"MatGetFactor_petsc_C","MatGetFactor_elemental_petsc",MatGetFactor_elemental_petsc);CHKERRQ(ierr);
713 
714   ierr = PetscObjectChangeTypeName((PetscObject)A,MATELEMENTAL);CHKERRQ(ierr);
715   PetscFunctionReturn(0);
716 }
717 EXTERN_C_END
718