xref: /petsc/src/mat/impls/elemental/matelem.cxx (revision 8cc058d9cd56c1ccb3be12a47760ddfc446aaffc)
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 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 = PetscViewerASCIIPrintf(viewer,"Elemental run parameters:\n");CHKERRQ(ierr);
73       ierr = PetscViewerASCIIPrintf(viewer,"  allocated entries=%d\n",(*a->emat).AllocatedMemory());CHKERRQ(ierr);
74       ierr = PetscViewerASCIIPrintf(viewer,"  grid height=%d, grid width=%d\n",(*a->emat).Grid().Height(),(*a->emat).Grid().Width());CHKERRQ(ierr);
75       if (format == PETSC_VIEWER_ASCII_FACTOR_INFO) {
76         /* call elemental viewing function */
77         ierr = PetscPrintf(PetscObjectComm((PetscObject)viewer),"test matview_elemental 2\n");CHKERRQ(ierr);
78       }
79 
80     } else if (format == PETSC_VIEWER_DEFAULT) {
81       ierr = PetscViewerASCIIUseTabs(viewer,PETSC_FALSE);CHKERRQ(ierr);
82       ierr = PetscObjectPrintClassNamePrefixType((PetscObject)A,viewer,"Matrix Object");CHKERRQ(ierr);
83       a->emat->Print("Elemental matrix (cyclic ordering)");
84       ierr = PetscViewerASCIIUseTabs(viewer,PETSC_TRUE);CHKERRQ(ierr);
85       if (A->factortype == MAT_FACTOR_NONE){
86         Mat Adense;
87         ierr = PetscPrintf(PetscObjectComm((PetscObject)viewer),"Elemental matrix (explicit ordering)\n");CHKERRQ(ierr);
88         ierr = MatConvert(A,MATDENSE,MAT_INITIAL_MATRIX,&Adense);CHKERRQ(ierr);
89         ierr = MatView(Adense,viewer);CHKERRQ(ierr);
90         ierr = MatDestroy(&Adense);CHKERRQ(ierr);
91       }
92     } else SETERRQ(PetscObjectComm((PetscObject)viewer),PETSC_ERR_SUP,"Format");
93   } else {
94     /* convert to dense format and call MatView() */
95     Mat Adense;
96     ierr = PetscPrintf(PetscObjectComm((PetscObject)viewer),"Elemental matrix (explicit ordering)\n");CHKERRQ(ierr);
97     ierr = MatConvert(A,MATDENSE,MAT_INITIAL_MATRIX,&Adense);CHKERRQ(ierr);
98     ierr = MatView(Adense,viewer);CHKERRQ(ierr);
99     ierr = MatDestroy(&Adense);CHKERRQ(ierr);
100   }
101   PetscFunctionReturn(0);
102 }
103 
104 #undef __FUNCT__
105 #define __FUNCT__ "MatGetInfo_Elemental"
106 static PetscErrorCode MatGetInfo_Elemental(Mat A,MatInfoType flag,MatInfo *info)
107 {
108   Mat_Elemental  *a = (Mat_Elemental*)A->data;
109   PetscMPIInt    rank;
110 
111   PetscFunctionBegin;
112   MPI_Comm_rank(PetscObjectComm((PetscObject)A),&rank);
113 
114   /* if (!rank) printf("          .........MatGetInfo_Elemental ...\n"); */
115   info->block_size     = 1.0;
116 
117   if (flag == MAT_LOCAL) {
118     info->nz_allocated   = (double)(*a->emat).AllocatedMemory(); /* locally allocated */
119     info->nz_used        = info->nz_allocated;
120   } else if (flag == MAT_GLOBAL_MAX) {
121     //ierr = MPI_Allreduce(isend,irecv,5,MPIU_REAL,MPIU_MAX,PetscObjectComm((PetscObject)matin));CHKERRQ(ierr);
122     /* see MatGetInfo_MPIAIJ() for getting global info->nz_allocated! */
123     //SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP," MAT_GLOBAL_MAX not written yet");
124   } else if (flag == MAT_GLOBAL_SUM) {
125     //SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP," MAT_GLOBAL_SUM not written yet");
126     info->nz_allocated   = (double)(*a->emat).AllocatedMemory(); /* locally allocated */
127     info->nz_used        = info->nz_allocated; /* assume Elemental does accurate allocation */
128     //ierr = MPI_Allreduce(isend,irecv,1,MPIU_REAL,MPIU_SUM,PetscObjectComm((PetscObject)A));CHKERRQ(ierr);
129     //PetscPrintf(PETSC_COMM_SELF,"    ... [%d] locally allocated %g\n",rank,info->nz_allocated);
130   }
131 
132   info->nz_unneeded       = 0.0;
133   info->assemblies        = (double)A->num_ass;
134   info->mallocs           = 0;
135   info->memory            = ((PetscObject)A)->mem;
136   info->fill_ratio_given  = 0; /* determined by Elemental */
137   info->fill_ratio_needed = 0;
138   info->factor_mallocs    = 0;
139   PetscFunctionReturn(0);
140 }
141 
142 #undef __FUNCT__
143 #define __FUNCT__ "MatSetValues_Elemental"
144 static PetscErrorCode MatSetValues_Elemental(Mat A,PetscInt nr,const PetscInt *rows,PetscInt nc,const PetscInt *cols,const PetscScalar *vals,InsertMode imode)
145 {
146   PetscErrorCode ierr;
147   Mat_Elemental  *a = (Mat_Elemental*)A->data;
148   PetscMPIInt    rank;
149   PetscInt       i,j,rrank,ridx,crank,cidx;
150 
151   PetscFunctionBegin;
152   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)A),&rank);CHKERRQ(ierr);
153 
154   const elem::Grid &grid = a->emat->Grid();
155   for (i=0; i<nr; i++) {
156     PetscInt erow,ecol,elrow,elcol;
157     if (rows[i] < 0) continue;
158     P2RO(A,0,rows[i],&rrank,&ridx);
159     RO2E(A,0,rrank,ridx,&erow);
160     if (rrank < 0 || ridx < 0 || erow < 0) SETERRQ(PetscObjectComm((PetscObject)A),PETSC_ERR_PLIB,"Incorrect row translation");
161     for (j=0; j<nc; j++) {
162       if (cols[j] < 0) continue;
163       P2RO(A,1,cols[j],&crank,&cidx);
164       RO2E(A,1,crank,cidx,&ecol);
165       if (crank < 0 || cidx < 0 || ecol < 0) SETERRQ(PetscObjectComm((PetscObject)A),PETSC_ERR_PLIB,"Incorrect col translation");
166       if (erow % grid.MCSize() != grid.MCRank() || ecol % grid.MRSize() != grid.MRRank()){ /* off-proc entry */
167         if (imode != ADD_VALUES) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP,"Only ADD_VALUES to off-processor entry is supported");
168         /* 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); */
169         a->esubmat->Set(0,0, (PetscElemScalar)vals[i*nc+j]);
170         a->interface->Axpy(1.0,*(a->esubmat),erow,ecol);
171         continue;
172       }
173       elrow = erow / grid.MCSize();
174       elcol = ecol / grid.MRSize();
175       switch (imode) {
176       case INSERT_VALUES: a->emat->SetLocal(elrow,elcol,(PetscElemScalar)vals[i*nc+j]); break;
177       case ADD_VALUES: a->emat->UpdateLocal(elrow,elcol,(PetscElemScalar)vals[i*nc+j]); break;
178       default: SETERRQ1(PetscObjectComm((PetscObject)A),PETSC_ERR_SUP,"No support for InsertMode %d",(int)imode);
179       }
180     }
181   }
182   PetscFunctionReturn(0);
183 }
184 
185 #undef __FUNCT__
186 #define __FUNCT__ "MatMult_Elemental"
187 static PetscErrorCode MatMult_Elemental(Mat A,Vec X,Vec Y)
188 {
189   Mat_Elemental         *a = (Mat_Elemental*)A->data;
190   PetscErrorCode        ierr;
191   const PetscElemScalar *x;
192   PetscElemScalar       *y;
193   PetscElemScalar       one = 1,zero = 0;
194 
195   PetscFunctionBegin;
196   ierr = VecGetArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
197   ierr = VecGetArray(Y,(PetscScalar **)&y);CHKERRQ(ierr);
198   { /* Scoping so that constructor is called before pointer is returned */
199     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> xe(A->cmap->N,1,0,x,A->cmap->n,*a->grid);
200     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> ye(A->rmap->N,1,0,y,A->rmap->n,*a->grid);
201     elem::Gemv(elem::NORMAL,one,*a->emat,xe,zero,ye);
202   }
203   ierr = VecRestoreArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
204   ierr = VecRestoreArray(Y,(PetscScalar **)&y);CHKERRQ(ierr);
205   PetscFunctionReturn(0);
206 }
207 
208 #undef __FUNCT__
209 #define __FUNCT__ "MatMultTranspose_Elemental"
210 static PetscErrorCode MatMultTranspose_Elemental(Mat A,Vec X,Vec Y)
211 {
212   Mat_Elemental         *a = (Mat_Elemental*)A->data;
213   PetscErrorCode        ierr;
214   const PetscElemScalar *x;
215   PetscElemScalar       *y;
216   PetscElemScalar       one = 1,zero = 0;
217 
218   PetscFunctionBegin;
219   ierr = VecGetArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
220   ierr = VecGetArray(Y,(PetscScalar **)&y);CHKERRQ(ierr);
221   { /* Scoping so that constructor is called before pointer is returned */
222     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> xe(A->rmap->N,1,0,x,A->rmap->n,*a->grid);
223     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> ye(A->cmap->N,1,0,y,A->cmap->n,*a->grid);
224     elem::Gemv(elem::TRANSPOSE,one,*a->emat,xe,zero,ye);
225   }
226   ierr = VecRestoreArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
227   ierr = VecRestoreArray(Y,(PetscScalar **)&y);CHKERRQ(ierr);
228   PetscFunctionReturn(0);
229 }
230 
231 #undef __FUNCT__
232 #define __FUNCT__ "MatMultAdd_Elemental"
233 static PetscErrorCode MatMultAdd_Elemental(Mat A,Vec X,Vec Y,Vec Z)
234 {
235   Mat_Elemental         *a = (Mat_Elemental*)A->data;
236   PetscErrorCode        ierr;
237   const PetscElemScalar *x;
238   PetscElemScalar       *z;
239   PetscElemScalar       one = 1;
240 
241   PetscFunctionBegin;
242   if (Y != Z) {ierr = VecCopy(Y,Z);CHKERRQ(ierr);}
243   ierr = VecGetArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
244   ierr = VecGetArray(Z,(PetscScalar **)&z);CHKERRQ(ierr);
245   { /* Scoping so that constructor is called before pointer is returned */
246     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> xe(A->cmap->N,1,0,x,A->cmap->n,*a->grid);
247     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> ze(A->rmap->N,1,0,z,A->rmap->n,*a->grid);
248     elem::Gemv(elem::NORMAL,one,*a->emat,xe,one,ze);
249   }
250   ierr = VecRestoreArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
251   ierr = VecRestoreArray(Z,(PetscScalar **)&z);CHKERRQ(ierr);
252   PetscFunctionReturn(0);
253 }
254 
255 #undef __FUNCT__
256 #define __FUNCT__ "MatMultTransposeAdd_Elemental"
257 static PetscErrorCode MatMultTransposeAdd_Elemental(Mat A,Vec X,Vec Y,Vec Z)
258 {
259   Mat_Elemental         *a = (Mat_Elemental*)A->data;
260   PetscErrorCode        ierr;
261   const PetscElemScalar *x;
262   PetscElemScalar       *z;
263   PetscElemScalar       one = 1;
264 
265   PetscFunctionBegin;
266   if (Y != Z) {ierr = VecCopy(Y,Z);CHKERRQ(ierr);}
267   ierr = VecGetArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
268   ierr = VecGetArray(Z,(PetscScalar **)&z);CHKERRQ(ierr);
269   { /* Scoping so that constructor is called before pointer is returned */
270     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> xe(A->rmap->N,1,0,x,A->rmap->n,*a->grid);
271     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> ze(A->cmap->N,1,0,z,A->cmap->n,*a->grid);
272     elem::Gemv(elem::TRANSPOSE,one,*a->emat,xe,one,ze);
273   }
274   ierr = VecRestoreArrayRead(X,(const PetscScalar **)&x);CHKERRQ(ierr);
275   ierr = VecRestoreArray(Z,(PetscScalar **)&z);CHKERRQ(ierr);
276   PetscFunctionReturn(0);
277 }
278 
279 #undef __FUNCT__
280 #define __FUNCT__ "MatMatMultNumeric_Elemental"
281 static PetscErrorCode MatMatMultNumeric_Elemental(Mat A,Mat B,Mat C)
282 {
283   Mat_Elemental    *a = (Mat_Elemental*)A->data;
284   Mat_Elemental    *b = (Mat_Elemental*)B->data;
285   Mat_Elemental    *c = (Mat_Elemental*)C->data;
286   PetscElemScalar  one = 1,zero = 0;
287 
288   PetscFunctionBegin;
289   { /* Scoping so that constructor is called before pointer is returned */
290     elem::Gemm(elem::NORMAL,elem::NORMAL,one,*a->emat,*b->emat,zero,*c->emat);
291   }
292   C->assembled = PETSC_TRUE;
293   PetscFunctionReturn(0);
294 }
295 
296 #undef __FUNCT__
297 #define __FUNCT__ "MatMatMultSymbolic_Elemental"
298 static PetscErrorCode MatMatMultSymbolic_Elemental(Mat A,Mat B,PetscReal fill,Mat *C)
299 {
300   PetscErrorCode ierr;
301   Mat            Ce;
302   MPI_Comm       comm;
303 
304   PetscFunctionBegin;
305   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
306   ierr = MatCreate(comm,&Ce);CHKERRQ(ierr);
307   ierr = MatSetSizes(Ce,A->rmap->n,B->cmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
308   ierr = MatSetType(Ce,MATELEMENTAL);CHKERRQ(ierr);
309   ierr = MatSetUp(Ce);CHKERRQ(ierr);
310   *C = Ce;
311   PetscFunctionReturn(0);
312 }
313 
314 #undef __FUNCT__
315 #define __FUNCT__ "MatMatMult_Elemental"
316 static PetscErrorCode MatMatMult_Elemental(Mat A,Mat B,MatReuse scall,PetscReal fill,Mat *C)
317 {
318   PetscErrorCode ierr;
319 
320   PetscFunctionBegin;
321   if (scall == MAT_INITIAL_MATRIX){
322     ierr = MatMatMultSymbolic_Elemental(A,B,1.0,C);CHKERRQ(ierr);
323   }
324   ierr = MatMatMultNumeric_Elemental(A,B,*C);CHKERRQ(ierr);
325   PetscFunctionReturn(0);
326 }
327 
328 #undef __FUNCT__
329 #define __FUNCT__ "MatMatTransposeMultNumeric_Elemental"
330 static PetscErrorCode MatMatTransposeMultNumeric_Elemental(Mat A,Mat B,Mat C)
331 {
332   Mat_Elemental      *a = (Mat_Elemental*)A->data;
333   Mat_Elemental      *b = (Mat_Elemental*)B->data;
334   Mat_Elemental      *c = (Mat_Elemental*)C->data;
335   PetscElemScalar    one = 1,zero = 0;
336 
337   PetscFunctionBegin;
338   { /* Scoping so that constructor is called before pointer is returned */
339     elem::Gemm(elem::NORMAL,elem::TRANSPOSE,one,*a->emat,*b->emat,zero,*c->emat);
340   }
341   C->assembled = PETSC_TRUE;
342   PetscFunctionReturn(0);
343 }
344 
345 #undef __FUNCT__
346 #define __FUNCT__ "MatMatTransposeMultSymbolic_Elemental"
347 static PetscErrorCode MatMatTransposeMultSymbolic_Elemental(Mat A,Mat B,PetscReal fill,Mat *C)
348 {
349   PetscErrorCode ierr;
350   Mat            Ce;
351   MPI_Comm       comm;
352 
353   PetscFunctionBegin;
354   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
355   ierr = MatCreate(comm,&Ce);CHKERRQ(ierr);
356   ierr = MatSetSizes(Ce,A->rmap->n,B->rmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
357   ierr = MatSetType(Ce,MATELEMENTAL);CHKERRQ(ierr);
358   ierr = MatSetUp(Ce);CHKERRQ(ierr);
359   *C = Ce;
360   PetscFunctionReturn(0);
361 }
362 
363 #undef __FUNCT__
364 #define __FUNCT__ "MatMatTransposeMult_Elemental"
365 static PetscErrorCode MatMatTransposeMult_Elemental(Mat A,Mat B,MatReuse scall,PetscReal fill,Mat *C)
366 {
367   PetscErrorCode ierr;
368 
369   PetscFunctionBegin;
370   if (scall == MAT_INITIAL_MATRIX){
371     ierr = PetscLogEventBegin(MAT_MatTransposeMultSymbolic,A,B,0,0);CHKERRQ(ierr);
372     ierr = MatMatMultSymbolic_Elemental(A,B,1.0,C);CHKERRQ(ierr);
373     ierr = PetscLogEventEnd(MAT_MatTransposeMultSymbolic,A,B,0,0);CHKERRQ(ierr);
374   }
375   ierr = PetscLogEventBegin(MAT_MatTransposeMultNumeric,A,B,0,0);CHKERRQ(ierr);
376   ierr = MatMatTransposeMultNumeric_Elemental(A,B,*C);CHKERRQ(ierr);
377   ierr = PetscLogEventEnd(MAT_MatTransposeMultNumeric,A,B,0,0);CHKERRQ(ierr);
378   PetscFunctionReturn(0);
379 }
380 
381 #undef __FUNCT__
382 #define __FUNCT__ "MatGetDiagonal_Elemental"
383 static PetscErrorCode MatGetDiagonal_Elemental(Mat A,Vec D)
384 {
385   PetscInt        i,nrows,ncols,nD,rrank,ridx,crank,cidx;
386   Mat_Elemental   *a = (Mat_Elemental*)A->data;
387   PetscErrorCode  ierr;
388   PetscElemScalar v;
389   MPI_Comm        comm;
390 
391   PetscFunctionBegin;
392   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
393   ierr = MatGetSize(A,&nrows,&ncols);CHKERRQ(ierr);
394   nD = nrows>ncols ? ncols : nrows;
395   for (i=0; i<nD; i++) {
396     PetscInt erow,ecol;
397     P2RO(A,0,i,&rrank,&ridx);
398     RO2E(A,0,rrank,ridx,&erow);
399     if (rrank < 0 || ridx < 0 || erow < 0) SETERRQ(comm,PETSC_ERR_PLIB,"Incorrect row translation");
400     P2RO(A,1,i,&crank,&cidx);
401     RO2E(A,1,crank,cidx,&ecol);
402     if (crank < 0 || cidx < 0 || ecol < 0) SETERRQ(comm,PETSC_ERR_PLIB,"Incorrect col translation");
403     v = a->emat->Get(erow,ecol);
404     ierr = VecSetValues(D,1,&i,(PetscScalar*)&v,INSERT_VALUES);CHKERRQ(ierr);
405   }
406   ierr = VecAssemblyBegin(D);CHKERRQ(ierr);
407   ierr = VecAssemblyEnd(D);CHKERRQ(ierr);
408   PetscFunctionReturn(0);
409 }
410 
411 #undef __FUNCT__
412 #define __FUNCT__ "MatDiagonalScale_Elemental"
413 static PetscErrorCode MatDiagonalScale_Elemental(Mat X,Vec L,Vec R)
414 {
415   Mat_Elemental         *x = (Mat_Elemental*)X->data;
416   const PetscElemScalar *d;
417   PetscErrorCode        ierr;
418 
419   PetscFunctionBegin;
420   if (L == NULL) {
421     ierr = VecGetArrayRead(R,(const PetscScalar **)&d);CHKERRQ(ierr);
422     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> de(X->cmap->N,1,0,d,X->cmap->n,*x->grid);
423     elem::DiagonalScale(elem::RIGHT,elem::NORMAL,de,*x->emat);
424     ierr = VecRestoreArrayRead(R,(const PetscScalar **)&d);CHKERRQ(ierr);
425   } else {
426     ierr = VecGetArrayRead(L,(const PetscScalar **)&d);CHKERRQ(ierr);
427     elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> de(X->rmap->N,1,0,d,X->rmap->n,*x->grid);
428     elem::DiagonalScale(elem::LEFT,elem::NORMAL,de,*x->emat);
429     ierr = VecRestoreArrayRead(L,(const PetscScalar **)&d);CHKERRQ(ierr);
430   }
431   PetscFunctionReturn(0);
432 }
433 
434 #undef __FUNCT__
435 #define __FUNCT__ "MatScale_Elemental"
436 static PetscErrorCode MatScale_Elemental(Mat X,PetscScalar a)
437 {
438   Mat_Elemental  *x = (Mat_Elemental*)X->data;
439 
440   PetscFunctionBegin;
441   elem::Scal((PetscElemScalar)a,*x->emat);
442   PetscFunctionReturn(0);
443 }
444 
445 #undef __FUNCT__
446 #define __FUNCT__ "MatAXPY_Elemental"
447 static PetscErrorCode MatAXPY_Elemental(Mat Y,PetscScalar a,Mat X,MatStructure str)
448 {
449   Mat_Elemental  *x = (Mat_Elemental*)X->data;
450   Mat_Elemental  *y = (Mat_Elemental*)Y->data;
451 
452   PetscFunctionBegin;
453   elem::Axpy((PetscElemScalar)a,*x->emat,*y->emat);
454   PetscFunctionReturn(0);
455 }
456 
457 #undef __FUNCT__
458 #define __FUNCT__ "MatCopy_Elemental"
459 static PetscErrorCode MatCopy_Elemental(Mat A,Mat B,MatStructure str)
460 {
461   Mat_Elemental *a=(Mat_Elemental*)A->data;
462   Mat_Elemental *b=(Mat_Elemental*)B->data;
463 
464   PetscFunctionBegin;
465   elem::Copy(*a->emat,*b->emat);
466   PetscFunctionReturn(0);
467 }
468 
469 #undef __FUNCT__
470 #define __FUNCT__ "MatDuplicate_Elemental"
471 static PetscErrorCode MatDuplicate_Elemental(Mat A,MatDuplicateOption op,Mat *B)
472 {
473   Mat            Be;
474   MPI_Comm       comm;
475   Mat_Elemental  *a=(Mat_Elemental*)A->data;
476   PetscErrorCode ierr;
477 
478   PetscFunctionBegin;
479   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
480   ierr = MatCreate(comm,&Be);CHKERRQ(ierr);
481   ierr = MatSetSizes(Be,A->rmap->n,A->cmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
482   ierr = MatSetType(Be,MATELEMENTAL);CHKERRQ(ierr);
483   ierr = MatSetUp(Be);CHKERRQ(ierr);
484   *B = Be;
485   if (op == MAT_COPY_VALUES) {
486     Mat_Elemental *b=(Mat_Elemental*)Be->data;
487     elem::Copy(*a->emat,*b->emat);
488   }
489   Be->assembled = PETSC_TRUE;
490   PetscFunctionReturn(0);
491 }
492 
493 #undef __FUNCT__
494 #define __FUNCT__ "MatTranspose_Elemental"
495 static PetscErrorCode MatTranspose_Elemental(Mat A,MatReuse reuse,Mat *B)
496 {
497   Mat            Be;
498   PetscErrorCode ierr;
499   MPI_Comm       comm;
500   Mat_Elemental  *a = (Mat_Elemental*)A->data, *b;
501 
502   PetscFunctionBegin;
503   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
504   /* Only out-of-place supported */
505   if (reuse == MAT_INITIAL_MATRIX){
506     ierr = MatCreate(comm,&Be);CHKERRQ(ierr);
507     ierr = MatSetSizes(Be,A->cmap->n,A->rmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
508     ierr = MatSetType(Be,MATELEMENTAL);CHKERRQ(ierr);
509     ierr = MatSetUp(Be);CHKERRQ(ierr);
510     *B = Be;
511   }
512   b = (Mat_Elemental*)Be->data;
513   elem::Transpose(*a->emat,*b->emat);
514   Be->assembled = PETSC_TRUE;
515   PetscFunctionReturn(0);
516 }
517 
518 #undef __FUNCT__
519 #define __FUNCT__ "MatConjugate_Elemental"
520 static PetscErrorCode MatConjugate_Elemental(Mat A)
521 {
522   Mat_Elemental  *a = (Mat_Elemental*)A->data;
523 
524   PetscFunctionBegin;
525   elem::Conjugate(*a->emat);
526   PetscFunctionReturn(0);
527 }
528 
529 #undef __FUNCT__
530 #define __FUNCT__ "MatHermitianTranspose_Elemental"
531 static PetscErrorCode MatHermitianTranspose_Elemental(Mat A,MatReuse reuse,Mat *B)
532 {
533   Mat            Be;
534   PetscErrorCode ierr;
535   MPI_Comm       comm;
536   Mat_Elemental  *a = (Mat_Elemental*)A->data, *b;
537 
538   PetscFunctionBegin;
539   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
540   /* Only out-of-place supported */
541   if (reuse == MAT_INITIAL_MATRIX){
542     ierr = MatCreate(comm,&Be);CHKERRQ(ierr);
543     ierr = MatSetSizes(Be,A->cmap->n,A->rmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
544     ierr = MatSetType(Be,MATELEMENTAL);CHKERRQ(ierr);
545     ierr = MatSetUp(Be);CHKERRQ(ierr);
546     *B = Be;
547   }
548   b = (Mat_Elemental*)Be->data;
549   elem::Adjoint(*a->emat,*b->emat);
550   Be->assembled = PETSC_TRUE;
551   PetscFunctionReturn(0);
552 }
553 
554 #undef __FUNCT__
555 #define __FUNCT__ "MatSolve_Elemental"
556 static PetscErrorCode MatSolve_Elemental(Mat A,Vec B,Vec X)
557 {
558   Mat_Elemental     *a = (Mat_Elemental*)A->data;
559   PetscErrorCode    ierr;
560   PetscElemScalar   *x;
561 
562   PetscFunctionBegin;
563   ierr = VecCopy(B,X);CHKERRQ(ierr);
564   ierr = VecGetArray(X,(PetscScalar **)&x);CHKERRQ(ierr);
565   elem::DistMatrix<PetscElemScalar,elem::VC,elem::STAR> xe(A->rmap->N,1,0,x,A->rmap->n,*a->grid);
566   elem::DistMatrix<PetscElemScalar,elem::MC,elem::MR> xer = xe;
567   switch (A->factortype) {
568   case MAT_FACTOR_LU:
569     if ((*a->pivot).AllocatedMemory()) {
570       elem::SolveAfterLU(elem::NORMAL,*a->emat,*a->pivot,xer);
571       elem::Copy(xer,xe);
572     } else {
573       elem::SolveAfterLU(elem::NORMAL,*a->emat,xer);
574       elem::Copy(xer,xe);
575     }
576     break;
577   case MAT_FACTOR_CHOLESKY:
578     elem::SolveAfterCholesky(elem::UPPER,elem::NORMAL,*a->emat,xer);
579     elem::Copy(xer,xe);
580     break;
581   default:
582     SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP,"Unfactored Matrix or Unsupported MatFactorType");
583     break;
584   }
585   ierr = VecRestoreArray(X,(PetscScalar **)&x);CHKERRQ(ierr);
586   PetscFunctionReturn(0);
587 }
588 
589 #undef __FUNCT__
590 #define __FUNCT__ "MatSolveAdd_Elemental"
591 static PetscErrorCode MatSolveAdd_Elemental(Mat A,Vec B,Vec Y,Vec X)
592 {
593   PetscErrorCode    ierr;
594 
595   PetscFunctionBegin;
596   ierr = MatSolve_Elemental(A,B,X);CHKERRQ(ierr);
597   ierr = VecAXPY(X,1,Y);CHKERRQ(ierr);
598   PetscFunctionReturn(0);
599 }
600 
601 #undef __FUNCT__
602 #define __FUNCT__ "MatMatSolve_Elemental"
603 static PetscErrorCode MatMatSolve_Elemental(Mat A,Mat B,Mat X)
604 {
605   Mat_Elemental *a=(Mat_Elemental*)A->data;
606   Mat_Elemental *b=(Mat_Elemental*)B->data;
607   Mat_Elemental *x=(Mat_Elemental*)X->data;
608 
609   PetscFunctionBegin;
610   elem::Copy(*b->emat,*x->emat);
611   switch (A->factortype) {
612   case MAT_FACTOR_LU:
613     if ((*a->pivot).AllocatedMemory()) {
614       elem::SolveAfterLU(elem::NORMAL,*a->emat,*a->pivot,*x->emat);
615     } else {
616       elem::SolveAfterLU(elem::NORMAL,*a->emat,*x->emat);
617     }
618     break;
619   case MAT_FACTOR_CHOLESKY:
620     elem::SolveAfterCholesky(elem::UPPER,elem::NORMAL,*a->emat,*x->emat);
621     break;
622   default:
623     SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP,"Unfactored Matrix or Unsupported MatFactorType");
624     break;
625   }
626   PetscFunctionReturn(0);
627 }
628 
629 #undef __FUNCT__
630 #define __FUNCT__ "MatLUFactor_Elemental"
631 static PetscErrorCode MatLUFactor_Elemental(Mat A,IS row,IS col,const MatFactorInfo *info)
632 {
633   Mat_Elemental  *a = (Mat_Elemental*)A->data;
634 
635   PetscFunctionBegin;
636   if (info->dtcol){
637     elem::LU(*a->emat,*a->pivot);
638   } else {
639     elem::LU(*a->emat);
640   }
641   A->factortype = MAT_FACTOR_LU;
642   A->assembled  = PETSC_TRUE;
643   PetscFunctionReturn(0);
644 }
645 
646 #undef __FUNCT__
647 #define __FUNCT__ "MatLUFactorNumeric_Elemental"
648 static PetscErrorCode  MatLUFactorNumeric_Elemental(Mat F,Mat A,const MatFactorInfo *info)
649 {
650   PetscErrorCode ierr;
651 
652   PetscFunctionBegin;
653   ierr = MatCopy(A,F,SAME_NONZERO_PATTERN);CHKERRQ(ierr);
654   ierr = MatLUFactor_Elemental(F,0,0,info);CHKERRQ(ierr);
655   PetscFunctionReturn(0);
656 }
657 
658 #undef __FUNCT__
659 #define __FUNCT__ "MatLUFactorSymbolic_Elemental"
660 static PetscErrorCode  MatLUFactorSymbolic_Elemental(Mat F,Mat A,IS r,IS c,const MatFactorInfo *info)
661 {
662   PetscFunctionBegin;
663   /* F is create and allocated by MatGetFactor_elemental_petsc(), skip this routine. */
664   PetscFunctionReturn(0);
665 }
666 
667 #undef __FUNCT__
668 #define __FUNCT__ "MatCholeskyFactor_Elemental"
669 static PetscErrorCode MatCholeskyFactor_Elemental(Mat A,IS perm,const MatFactorInfo *info)
670 {
671   Mat_Elemental  *a = (Mat_Elemental*)A->data;
672   elem::DistMatrix<PetscElemScalar,elem::MC,elem::STAR> d;
673 
674   PetscFunctionBegin;
675   elem::Cholesky(elem::UPPER,*a->emat);
676   A->factortype = MAT_FACTOR_CHOLESKY;
677   A->assembled  = PETSC_TRUE;
678   PetscFunctionReturn(0);
679 }
680 
681 #undef __FUNCT__
682 #define __FUNCT__ "MatCholeskyFactorNumeric_Elemental"
683 static PetscErrorCode MatCholeskyFactorNumeric_Elemental(Mat F,Mat A,const MatFactorInfo *info)
684 {
685   PetscErrorCode ierr;
686 
687   PetscFunctionBegin;
688   ierr = MatCopy(A,F,SAME_NONZERO_PATTERN);CHKERRQ(ierr);
689   ierr = MatCholeskyFactor_Elemental(F,0,info);CHKERRQ(ierr);
690   PetscFunctionReturn(0);
691 }
692 
693 #undef __FUNCT__
694 #define __FUNCT__ "MatCholeskyFactorSymbolic_Elemental"
695 static PetscErrorCode MatCholeskyFactorSymbolic_Elemental(Mat F,Mat A,IS perm,const MatFactorInfo *info)
696 {
697   PetscFunctionBegin;
698   /* F is create and allocated by MatGetFactor_elemental_petsc(), skip this routine. */
699   PetscFunctionReturn(0);
700 }
701 
702 #undef __FUNCT__
703 #define __FUNCT__ "MatFactorGetSolverPackage_elemental_elemental"
704 PetscErrorCode MatFactorGetSolverPackage_elemental_elemental(Mat A,const MatSolverPackage *type)
705 {
706   PetscFunctionBegin;
707   *type = MATSOLVERELEMENTAL;
708   PetscFunctionReturn(0);
709 }
710 
711 #undef __FUNCT__
712 #define __FUNCT__ "MatGetFactor_elemental_elemental"
713 static PetscErrorCode MatGetFactor_elemental_elemental(Mat A,MatFactorType ftype,Mat *F)
714 {
715   Mat            B;
716   PetscErrorCode ierr;
717 
718   PetscFunctionBegin;
719   /* Create the factorization matrix */
720   ierr = MatCreate(PetscObjectComm((PetscObject)A),&B);CHKERRQ(ierr);
721   ierr = MatSetSizes(B,A->rmap->n,A->cmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
722   ierr = MatSetType(B,MATELEMENTAL);CHKERRQ(ierr);
723   ierr = MatSetUp(B);CHKERRQ(ierr);
724   B->factortype = ftype;
725   ierr = PetscObjectComposeFunction((PetscObject)B,"MatFactorGetSolverPackage_C","MatFactorGetSolverPackage_elemental_elemental",MatFactorGetSolverPackage_elemental_elemental);CHKERRQ(ierr);
726   *F            = B;
727   PetscFunctionReturn(0);
728 }
729 
730 #undef __FUNCT__
731 #define __FUNCT__ "MatNorm_Elemental"
732 static PetscErrorCode MatNorm_Elemental(Mat A,NormType type,PetscReal *nrm)
733 {
734   Mat_Elemental *a=(Mat_Elemental*)A->data;
735 
736   PetscFunctionBegin;
737   switch (type){
738   case NORM_1:
739     *nrm = elem::Norm(*a->emat,elem::ONE_NORM);
740     break;
741   case NORM_FROBENIUS:
742     *nrm = elem::Norm(*a->emat,elem::FROBENIUS_NORM);
743     break;
744   case NORM_INFINITY:
745     *nrm = elem::Norm(*a->emat,elem::INFINITY_NORM);
746     break;
747   default:
748     printf("Error: unsupported norm type!\n");
749   }
750   PetscFunctionReturn(0);
751 }
752 
753 #undef __FUNCT__
754 #define __FUNCT__ "MatZeroEntries_Elemental"
755 static PetscErrorCode MatZeroEntries_Elemental(Mat A)
756 {
757   Mat_Elemental *a=(Mat_Elemental*)A->data;
758 
759   PetscFunctionBegin;
760   elem::Zero(*a->emat);
761   PetscFunctionReturn(0);
762 }
763 
764 #undef __FUNCT__
765 #define __FUNCT__ "MatGetOwnershipIS_Elemental"
766 static PetscErrorCode MatGetOwnershipIS_Elemental(Mat A,IS *rows,IS *cols)
767 {
768   Mat_Elemental  *a = (Mat_Elemental*)A->data;
769   PetscErrorCode ierr;
770   PetscInt       i,m,shift,stride,*idx;
771 
772   PetscFunctionBegin;
773   if (rows) {
774     m = a->emat->LocalHeight();
775     shift = a->emat->ColShift();
776     stride = a->emat->ColStride();
777     ierr = PetscMalloc(m*sizeof(PetscInt),&idx);CHKERRQ(ierr);
778     for (i=0; i<m; i++) {
779       PetscInt rank,offset;
780       E2RO(A,0,shift+i*stride,&rank,&offset);
781       RO2P(A,0,rank,offset,&idx[i]);
782     }
783     ierr = ISCreateGeneral(PETSC_COMM_SELF,m,idx,PETSC_OWN_POINTER,rows);CHKERRQ(ierr);
784   }
785   if (cols) {
786     m = a->emat->LocalWidth();
787     shift = a->emat->RowShift();
788     stride = a->emat->RowStride();
789     ierr = PetscMalloc(m*sizeof(PetscInt),&idx);CHKERRQ(ierr);
790     for (i=0; i<m; i++) {
791       PetscInt rank,offset;
792       E2RO(A,1,shift+i*stride,&rank,&offset);
793       RO2P(A,1,rank,offset,&idx[i]);
794     }
795     ierr = ISCreateGeneral(PETSC_COMM_SELF,m,idx,PETSC_OWN_POINTER,cols);CHKERRQ(ierr);
796   }
797   PetscFunctionReturn(0);
798 }
799 
800 #undef __FUNCT__
801 #define __FUNCT__ "MatConvert_Elemental_Dense"
802 static PetscErrorCode MatConvert_Elemental_Dense(Mat A,MatType newtype,MatReuse reuse,Mat *B)
803 {
804   Mat                Bmpi;
805   Mat_Elemental      *a = (Mat_Elemental*)A->data;
806   MPI_Comm           comm;
807   PetscErrorCode     ierr;
808   PetscInt           rrank,ridx,crank,cidx,nrows,ncols,i,j;
809   PetscElemScalar    v;
810   PetscBool          s1,s2,s3;
811 
812   PetscFunctionBegin;
813   ierr = PetscObjectGetComm((PetscObject)A,&comm);CHKERRQ(ierr);
814   ierr = PetscStrcmp(newtype,MATDENSE,&s1);CHKERRQ(ierr);
815   ierr = PetscStrcmp(newtype,MATSEQDENSE,&s2);CHKERRQ(ierr);
816   ierr = PetscStrcmp(newtype,MATMPIDENSE,&s3);CHKERRQ(ierr);
817   if (!s1 && !s2 && !s3) SETERRQ(comm,PETSC_ERR_SUP,"Unsupported New MatType: must be MATDENSE, MATSEQDENSE or MATMPIDENSE");
818   ierr = MatCreate(comm,&Bmpi);CHKERRQ(ierr);
819   ierr = MatSetSizes(Bmpi,A->rmap->n,A->cmap->n,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
820   ierr = MatSetType(Bmpi,MATDENSE);CHKERRQ(ierr);
821   ierr = MatSetUp(Bmpi);CHKERRQ(ierr);
822   ierr = MatGetSize(A,&nrows,&ncols);CHKERRQ(ierr);
823   for (i=0; i<nrows; i++) {
824     PetscInt erow,ecol;
825     P2RO(A,0,i,&rrank,&ridx);
826     RO2E(A,0,rrank,ridx,&erow);
827     if (rrank < 0 || ridx < 0 || erow < 0) SETERRQ(comm,PETSC_ERR_PLIB,"Incorrect row translation");
828     for (j=0; j<ncols; j++) {
829       P2RO(A,1,j,&crank,&cidx);
830       RO2E(A,1,crank,cidx,&ecol);
831       if (crank < 0 || cidx < 0 || ecol < 0) SETERRQ(comm,PETSC_ERR_PLIB,"Incorrect col translation");
832       v = a->emat->Get(erow,ecol);
833       ierr = MatSetValues(Bmpi,1,&i,1,&j,(PetscScalar *)&v,INSERT_VALUES);CHKERRQ(ierr);
834     }
835   }
836   ierr = MatAssemblyBegin(Bmpi,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
837   ierr = MatAssemblyEnd(Bmpi,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
838   if (reuse == MAT_REUSE_MATRIX) {
839     ierr = MatHeaderReplace(A,Bmpi);CHKERRQ(ierr);
840   } else {
841     *B = Bmpi;
842   }
843   PetscFunctionReturn(0);
844 }
845 
846 #undef __FUNCT__
847 #define __FUNCT__ "MatDestroy_Elemental"
848 static PetscErrorCode MatDestroy_Elemental(Mat A)
849 {
850   Mat_Elemental      *a = (Mat_Elemental*)A->data;
851   PetscErrorCode     ierr;
852   Mat_Elemental_Grid *commgrid;
853   PetscBool          flg;
854   MPI_Comm           icomm;
855 
856   PetscFunctionBegin;
857   a->interface->Detach();
858   delete a->interface;
859   delete a->esubmat;
860   delete a->emat;
861 
862   elem::mpi::Comm cxxcomm(PetscObjectComm((PetscObject)A));
863   ierr = PetscCommDuplicate(cxxcomm,&icomm,NULL);CHKERRQ(ierr);
864   ierr = MPI_Attr_get(icomm,Petsc_Elemental_keyval,(void**)&commgrid,(int*)&flg);CHKERRQ(ierr);
865   if (--commgrid->grid_refct == 0) {
866     delete commgrid->grid;
867     ierr = PetscFree(commgrid);CHKERRQ(ierr);
868   }
869   ierr = PetscCommDestroy(&icomm);CHKERRQ(ierr);
870   ierr = PetscObjectComposeFunction((PetscObject)A,"MatGetOwnershipIS_C","",NULL);CHKERRQ(ierr);
871   ierr = PetscObjectComposeFunction((PetscObject)A,"MatGetFactor_petsc_C","",NULL);CHKERRQ(ierr);
872   ierr = PetscObjectComposeFunction((PetscObject)A,"MatFactorGetSolverPackage_C","",NULL);CHKERRQ(ierr);
873   ierr = PetscFree(A->data);CHKERRQ(ierr);
874   PetscFunctionReturn(0);
875 }
876 
877 #undef __FUNCT__
878 #define __FUNCT__ "MatSetUp_Elemental"
879 PetscErrorCode MatSetUp_Elemental(Mat A)
880 {
881   Mat_Elemental  *a = (Mat_Elemental*)A->data;
882   PetscErrorCode ierr;
883   PetscMPIInt    rsize,csize;
884 
885   PetscFunctionBegin;
886   ierr = PetscLayoutSetUp(A->rmap);CHKERRQ(ierr);
887   ierr = PetscLayoutSetUp(A->cmap);CHKERRQ(ierr);
888 
889   a->emat->ResizeTo(A->rmap->N,A->cmap->N);CHKERRQ(ierr);
890   elem::Zero(*a->emat);
891 
892   ierr = MPI_Comm_size(A->rmap->comm,&rsize);CHKERRQ(ierr);
893   ierr = MPI_Comm_size(A->cmap->comm,&csize);CHKERRQ(ierr);
894   if (csize != rsize) SETERRQ(PetscObjectComm((PetscObject)A),PETSC_ERR_ARG_INCOMP,"Cannot use row and column communicators of different sizes");
895   a->commsize = rsize;
896   a->mr[0] = A->rmap->N % rsize; if (!a->mr[0]) a->mr[0] = rsize;
897   a->mr[1] = A->cmap->N % csize; if (!a->mr[1]) a->mr[1] = csize;
898   a->m[0]  = A->rmap->N / rsize + (a->mr[0] != rsize);
899   a->m[1]  = A->cmap->N / csize + (a->mr[1] != csize);
900   PetscFunctionReturn(0);
901 }
902 
903 #undef __FUNCT__
904 #define __FUNCT__ "MatAssemblyBegin_Elemental"
905 PetscErrorCode MatAssemblyBegin_Elemental(Mat A, MatAssemblyType type)
906 {
907   Mat_Elemental  *a = (Mat_Elemental*)A->data;
908 
909   PetscFunctionBegin;
910   a->interface->Detach();
911   a->interface->Attach(elem::LOCAL_TO_GLOBAL,*(a->emat));
912   PetscFunctionReturn(0);
913 }
914 
915 #undef __FUNCT__
916 #define __FUNCT__ "MatAssemblyEnd_Elemental"
917 PetscErrorCode MatAssemblyEnd_Elemental(Mat A, MatAssemblyType type)
918 {
919   PetscFunctionBegin;
920   /* Currently does nothing */
921   PetscFunctionReturn(0);
922 }
923 
924 /* -------------------------------------------------------------------*/
925 static struct _MatOps MatOps_Values = {
926        MatSetValues_Elemental,
927        0,
928        0,
929        MatMult_Elemental,
930 /* 4*/ MatMultAdd_Elemental,
931        MatMultTranspose_Elemental,
932        MatMultTransposeAdd_Elemental,
933        MatSolve_Elemental,
934        MatSolveAdd_Elemental,
935        0, //MatSolveTranspose_Elemental,
936 /*10*/ 0, //MatSolveTransposeAdd_Elemental,
937        MatLUFactor_Elemental,
938        MatCholeskyFactor_Elemental,
939        0,
940        MatTranspose_Elemental,
941 /*15*/ MatGetInfo_Elemental,
942        0,
943        MatGetDiagonal_Elemental,
944        MatDiagonalScale_Elemental,
945        MatNorm_Elemental,
946 /*20*/ MatAssemblyBegin_Elemental,
947        MatAssemblyEnd_Elemental,
948        0, //MatSetOption_Elemental,
949        MatZeroEntries_Elemental,
950 /*24*/ 0,
951        MatLUFactorSymbolic_Elemental,
952        MatLUFactorNumeric_Elemental,
953        MatCholeskyFactorSymbolic_Elemental,
954        MatCholeskyFactorNumeric_Elemental,
955 /*29*/ MatSetUp_Elemental,
956        0,
957        0,
958        0,
959        0,
960 /*34*/ MatDuplicate_Elemental,
961        0,
962        0,
963        0,
964        0,
965 /*39*/ MatAXPY_Elemental,
966        0,
967        0,
968        0,
969        MatCopy_Elemental,
970 /*44*/ 0,
971        MatScale_Elemental,
972        0,
973        0,
974        0,
975 /*49*/ 0,
976        0,
977        0,
978        0,
979        0,
980 /*54*/ 0,
981        0,
982        0,
983        0,
984        0,
985 /*59*/ 0,
986        MatDestroy_Elemental,
987        MatView_Elemental,
988        0,
989        0,
990 /*64*/ 0,
991        0,
992        0,
993        0,
994        0,
995 /*69*/ 0,
996        0,
997        MatConvert_Elemental_Dense,
998        0,
999        0,
1000 /*74*/ 0,
1001        0,
1002        0,
1003        0,
1004        0,
1005 /*79*/ 0,
1006        0,
1007        0,
1008        0,
1009        0,
1010 /*84*/ 0,
1011        0,
1012        0,
1013        0,
1014        0,
1015 /*89*/ MatMatMult_Elemental,
1016        MatMatMultSymbolic_Elemental,
1017        MatMatMultNumeric_Elemental,
1018        0,
1019        0,
1020 /*94*/ 0,
1021        MatMatTransposeMult_Elemental,
1022        MatMatTransposeMultSymbolic_Elemental,
1023        MatMatTransposeMultNumeric_Elemental,
1024        0,
1025 /*99*/ 0,
1026        0,
1027        0,
1028        MatConjugate_Elemental,
1029        0,
1030 /*104*/0,
1031        0,
1032        0,
1033        0,
1034        0,
1035 /*109*/MatMatSolve_Elemental,
1036        0,
1037        0,
1038        0,
1039        0,
1040 /*114*/0,
1041        0,
1042        0,
1043        0,
1044        0,
1045 /*119*/0,
1046        MatHermitianTranspose_Elemental,
1047        0,
1048        0,
1049        0,
1050 /*124*/0,
1051        0,
1052        0,
1053        0,
1054        0,
1055 /*129*/0,
1056        0,
1057        0,
1058        0,
1059        0,
1060 /*134*/0,
1061        0,
1062        0,
1063        0,
1064        0
1065 };
1066 
1067 /*MC
1068    MATELEMENTAL = "elemental" - A matrix type for dense matrices using the Elemental package
1069 
1070    Options Database Keys:
1071 . -mat_type elemental - sets the matrix type to "elemental" during a call to MatSetFromOptions()
1072 . -mat_elemental_grid_height - sets Grid Height
1073 . -mat_elemental_grid_width - sets Grid Width
1074 
1075   Level: beginner
1076 
1077 .seealso: MATDENSE
1078 M*/
1079 
1080 #undef __FUNCT__
1081 #define __FUNCT__ "MatCreate_Elemental"
1082 PETSC_EXTERN PetscErrorCode MatCreate_Elemental(Mat A)
1083 {
1084   Mat_Elemental      *a;
1085   PetscErrorCode     ierr;
1086   PetscBool          flg,flg1,flg2;
1087   Mat_Elemental_Grid *commgrid;
1088   MPI_Comm           icomm;
1089   PetscInt           optv1,optv2;
1090 
1091   PetscFunctionBegin;
1092   ierr = PetscElementalInitializePackage(NULL);CHKERRQ(ierr);
1093   ierr = PetscMemcpy(A->ops,&MatOps_Values,sizeof(struct _MatOps));CHKERRQ(ierr);
1094   A->insertmode = NOT_SET_VALUES;
1095 
1096   ierr = PetscNewLog(A,Mat_Elemental,&a);CHKERRQ(ierr);
1097   A->data = (void*)a;
1098 
1099   /* Set up the elemental matrix */
1100   elem::mpi::Comm cxxcomm(PetscObjectComm((PetscObject)A));
1101 
1102   /* Grid needs to be shared between multiple Mats on the same communicator, implement by attribute caching on the MPI_Comm */
1103   if (Petsc_Elemental_keyval == MPI_KEYVAL_INVALID) {
1104     ierr = MPI_Keyval_create(MPI_NULL_COPY_FN,MPI_NULL_DELETE_FN,&Petsc_Elemental_keyval,(void*)0);
1105   }
1106   ierr = PetscCommDuplicate(cxxcomm,&icomm,NULL);CHKERRQ(ierr);
1107   ierr = MPI_Attr_get(icomm,Petsc_Elemental_keyval,(void**)&commgrid,(int*)&flg);CHKERRQ(ierr);
1108   if (!flg) {
1109     ierr = PetscNewLog(A,Mat_Elemental_Grid,&commgrid);CHKERRQ(ierr);
1110 
1111     ierr = PetscOptionsBegin(PetscObjectComm((PetscObject)A),((PetscObject)A)->prefix,"Elemental Options","Mat");CHKERRQ(ierr);
1112     /* displayed default grid sizes (CommSize,1) are set by us arbitrarily until elem::Grid() is called */
1113     ierr = PetscOptionsInt("-mat_elemental_grid_height","Grid Height","None",elem::mpi::CommSize(cxxcomm),&optv1,&flg1);CHKERRQ(ierr);
1114     ierr = PetscOptionsInt("-mat_elemental_grid_width","Grid Width","None",1,&optv2,&flg2);CHKERRQ(ierr);
1115     if (flg1 || flg2) {
1116       if (optv1*optv2 != elem::mpi::CommSize(cxxcomm)) {
1117         SETERRQ(PetscObjectComm((PetscObject)A),PETSC_ERR_ARG_INCOMP,"Grid Height times Grid Width must equal CommSize");
1118       }
1119       commgrid->grid = new elem::Grid(cxxcomm,optv1,optv2); /* use user-provided grid sizes */
1120     } else {
1121       commgrid->grid = new elem::Grid(cxxcomm); /* use Elemental default grid sizes */
1122     }
1123     commgrid->grid_refct = 1;
1124     ierr = MPI_Attr_put(icomm,Petsc_Elemental_keyval,(void*)commgrid);CHKERRQ(ierr);
1125     PetscOptionsEnd();
1126   } else {
1127     commgrid->grid_refct++;
1128   }
1129   ierr = PetscCommDestroy(&icomm);CHKERRQ(ierr);
1130   a->grid      = commgrid->grid;
1131   a->emat      = new elem::DistMatrix<PetscElemScalar>(*a->grid);
1132   a->esubmat   = new elem::Matrix<PetscElemScalar>(1,1);
1133   a->interface = new elem::AxpyInterface<PetscElemScalar>;
1134   a->pivot     = new elem::DistMatrix<PetscInt,elem::VC,elem::STAR>;
1135 
1136   /* build cache for off array entries formed */
1137   a->interface->Attach(elem::LOCAL_TO_GLOBAL,*(a->emat));
1138 
1139   ierr = PetscObjectComposeFunction((PetscObject)A,"MatGetOwnershipIS_C","MatGetOwnershipIS_Elemental",MatGetOwnershipIS_Elemental);CHKERRQ(ierr);
1140   ierr = PetscObjectComposeFunction((PetscObject)A,"MatGetFactor_elemental_C","MatGetFactor_elemental_elemental",MatGetFactor_elemental_elemental);CHKERRQ(ierr);
1141 
1142   ierr = PetscObjectChangeTypeName((PetscObject)A,MATELEMENTAL);CHKERRQ(ierr);
1143   PetscFunctionReturn(0);
1144 }
1145 
1146