Actual source code: pdvec.c

petsc-main 2021-04-20
Report Typos and Errors

  2: /*
  3:      Code for some of the parallel vector primatives.
  4: */
  5: #include <../src/vec/vec/impls/mpi/pvecimpl.h>
  6: #include <petsc/private/viewerimpl.h>
  7: #include <petsc/private/viewerhdf5impl.h>
  8: #include <petsc/private/glvisviewerimpl.h>
  9: #include <petsc/private/glvisvecimpl.h>

 11: PetscErrorCode VecDestroy_MPI(Vec v)
 12: {
 13:   Vec_MPI        *x = (Vec_MPI*)v->data;

 17: #if defined(PETSC_USE_LOG)
 18:   PetscLogObjectState((PetscObject)v,"Length=%D",v->map->N);
 19: #endif
 20:   if (!x) return(0);
 21:   PetscFree(x->array_allocated);

 23:   /* Destroy local representation of vector if it exists */
 24:   if (x->localrep) {
 25:     VecDestroy(&x->localrep);
 26:     VecScatterDestroy(&x->localupdate);
 27:   }
 28:   VecAssemblyReset_MPI(v);

 30:   /* Destroy the stashes: note the order - so that the tags are freed properly */
 31:   VecStashDestroy_Private(&v->bstash);
 32:   VecStashDestroy_Private(&v->stash);
 33:   PetscFree(v->data);
 34:   return(0);
 35: }

 37: PetscErrorCode VecView_MPI_ASCII(Vec xin,PetscViewer viewer)
 38: {
 39:   PetscErrorCode    ierr;
 40:   PetscInt          i,work = xin->map->n,cnt,len,nLen;
 41:   PetscMPIInt       j,n = 0,size,rank,tag = ((PetscObject)viewer)->tag;
 42:   MPI_Status        status;
 43:   PetscScalar       *values;
 44:   const PetscScalar *xarray;
 45:   const char        *name;
 46:   PetscViewerFormat format;

 49:   MPI_Comm_size(PetscObjectComm((PetscObject)xin),&size);
 50:   PetscViewerGetFormat(viewer,&format);
 51:   if (format == PETSC_VIEWER_LOAD_BALANCE) {
 52:     PetscInt nmax = 0,nmin = xin->map->n,navg;
 53:     for (i=0; i<(PetscInt)size; i++) {
 54:       nmax = PetscMax(nmax,xin->map->range[i+1] - xin->map->range[i]);
 55:       nmin = PetscMin(nmin,xin->map->range[i+1] - xin->map->range[i]);
 56:     }
 57:     navg = xin->map->N/size;
 58:     PetscViewerASCIIPrintf(viewer,"  Load Balance - Local vector size Min %D  avg %D  max %D\n",nmin,navg,nmax);
 59:     return(0);
 60:   }

 62:   VecGetArrayRead(xin,&xarray);
 63:   /* determine maximum message to arrive */
 64:   MPI_Comm_rank(PetscObjectComm((PetscObject)xin),&rank);
 65:   MPI_Reduce(&work,&len,1,MPIU_INT,MPI_MAX,0,PetscObjectComm((PetscObject)xin));
 66:   if (format == PETSC_VIEWER_ASCII_GLVIS) { rank = 0, len = 0; } /* no parallel distributed write support from GLVis */
 67:   if (!rank) {
 68:     PetscMalloc1(len,&values);
 69:     /*
 70:         MATLAB format and ASCII format are very similar except
 71:         MATLAB uses %18.16e format while ASCII uses %g
 72:     */
 73:     if (format == PETSC_VIEWER_ASCII_MATLAB) {
 74:       PetscObjectGetName((PetscObject)xin,&name);
 75:       PetscViewerASCIIPrintf(viewer,"%s = [\n",name);
 76:       for (i=0; i<xin->map->n; i++) {
 77: #if defined(PETSC_USE_COMPLEX)
 78:         if (PetscImaginaryPart(xarray[i]) > 0.0) {
 79:           PetscViewerASCIIPrintf(viewer,"%18.16e + %18.16ei\n",(double)PetscRealPart(xarray[i]),(double)PetscImaginaryPart(xarray[i]));
 80:         } else if (PetscImaginaryPart(xarray[i]) < 0.0) {
 81:           PetscViewerASCIIPrintf(viewer,"%18.16e - %18.16ei\n",(double)PetscRealPart(xarray[i]),-(double)PetscImaginaryPart(xarray[i]));
 82:         } else {
 83:           PetscViewerASCIIPrintf(viewer,"%18.16e\n",(double)PetscRealPart(xarray[i]));
 84:         }
 85: #else
 86:         PetscViewerASCIIPrintf(viewer,"%18.16e\n",(double)xarray[i]);
 87: #endif
 88:       }
 89:       /* receive and print messages */
 90:       for (j=1; j<size; j++) {
 91:         MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,PetscObjectComm((PetscObject)xin),&status);
 92:         MPI_Get_count(&status,MPIU_SCALAR,&n);
 93:         for (i=0; i<n; i++) {
 94: #if defined(PETSC_USE_COMPLEX)
 95:           if (PetscImaginaryPart(values[i]) > 0.0) {
 96:             PetscViewerASCIIPrintf(viewer,"%18.16e + %18.16ei\n",(double)PetscRealPart(values[i]),(double)PetscImaginaryPart(values[i]));
 97:           } else if (PetscImaginaryPart(values[i]) < 0.0) {
 98:             PetscViewerASCIIPrintf(viewer,"%18.16e - %18.16ei\n",(double)PetscRealPart(values[i]),-(double)PetscImaginaryPart(values[i]));
 99:           } else {
100:             PetscViewerASCIIPrintf(viewer,"%18.16e\n",(double)PetscRealPart(values[i]));
101:           }
102: #else
103:           PetscViewerASCIIPrintf(viewer,"%18.16e\n",(double)values[i]);
104: #endif
105:         }
106:       }
107:       PetscViewerASCIIPrintf(viewer,"];\n");

109:     } else if (format == PETSC_VIEWER_ASCII_SYMMODU) {
110:       for (i=0; i<xin->map->n; i++) {
111: #if defined(PETSC_USE_COMPLEX)
112:         PetscViewerASCIIPrintf(viewer,"%18.16e %18.16e\n",(double)PetscRealPart(xarray[i]),(double)PetscImaginaryPart(xarray[i]));
113: #else
114:         PetscViewerASCIIPrintf(viewer,"%18.16e\n",(double)xarray[i]);
115: #endif
116:       }
117:       /* receive and print messages */
118:       for (j=1; j<size; j++) {
119:         MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,PetscObjectComm((PetscObject)xin),&status);
120:         MPI_Get_count(&status,MPIU_SCALAR,&n);
121:         for (i=0; i<n; i++) {
122: #if defined(PETSC_USE_COMPLEX)
123:           PetscViewerASCIIPrintf(viewer,"%18.16e %18.16e\n",(double)PetscRealPart(values[i]),(double)PetscImaginaryPart(values[i]));
124: #else
125:           PetscViewerASCIIPrintf(viewer,"%18.16e\n",(double)values[i]);
126: #endif
127:         }
128:       }
129:     } else if (format == PETSC_VIEWER_ASCII_VTK_DEPRECATED || format == PETSC_VIEWER_ASCII_VTK_CELL_DEPRECATED) {
130:       /*
131:         state 0: No header has been output
132:         state 1: Only POINT_DATA has been output
133:         state 2: Only CELL_DATA has been output
134:         state 3: Output both, POINT_DATA last
135:         state 4: Output both, CELL_DATA last
136:       */
137:       static PetscInt stateId     = -1;
138:       int             outputState = 0;
139:       int             doOutput    = 0;
140:       PetscBool       hasState;
141:       PetscInt        bs, b;

143:       if (stateId < 0) {
144:         PetscObjectComposedDataRegister(&stateId);
145:       }
146:       PetscObjectComposedDataGetInt((PetscObject) viewer, stateId, outputState, hasState);
147:       if (!hasState) outputState = 0;

149:       PetscObjectGetName((PetscObject)xin,&name);
150:       VecGetLocalSize(xin, &nLen);
151:       PetscMPIIntCast(nLen,&n);
152:       VecGetBlockSize(xin, &bs);
153:       if (format == PETSC_VIEWER_ASCII_VTK_DEPRECATED) {
154:         if (outputState == 0) {
155:           outputState = 1;
156:           doOutput    = 1;
157:         } else if (outputState == 1) doOutput = 0;
158:         else if (outputState == 2) {
159:           outputState = 3;
160:           doOutput    = 1;
161:         } else if (outputState == 3) doOutput = 0;
162:         else if (outputState == 4) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "Tried to output POINT_DATA again after intervening CELL_DATA");

164:         if (doOutput) {
165:           PetscViewerASCIIPrintf(viewer, "POINT_DATA %d\n", xin->map->N/bs);
166:         }
167:       } else {
168:         if (outputState == 0) {
169:           outputState = 2;
170:           doOutput    = 1;
171:         } else if (outputState == 1) {
172:           outputState = 4;
173:           doOutput    = 1;
174:         } else if (outputState == 2) doOutput = 0;
175:         else if (outputState == 3) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "Tried to output CELL_DATA again after intervening POINT_DATA");
176:         else if (outputState == 4) doOutput = 0;

178:         if (doOutput) {
179:           PetscViewerASCIIPrintf(viewer, "CELL_DATA %d\n", xin->map->N/bs);
180:         }
181:       }
182:       PetscObjectComposedDataSetInt((PetscObject) viewer, stateId, outputState);
183:       if (name) {
184:         if (bs == 3) {
185:           PetscViewerASCIIPrintf(viewer, "VECTORS %s double\n", name);
186:         } else {
187:           PetscViewerASCIIPrintf(viewer, "SCALARS %s double %d\n", name, bs);
188:         }
189:       } else {
190:         PetscViewerASCIIPrintf(viewer, "SCALARS scalars double %d\n", bs);
191:       }
192:       if (bs != 3) {
193:         PetscViewerASCIIPrintf(viewer, "LOOKUP_TABLE default\n");
194:       }
195:       for (i=0; i<n/bs; i++) {
196:         for (b=0; b<bs; b++) {
197:           if (b > 0) {
198:             PetscViewerASCIIPrintf(viewer," ");
199:           }
200:           PetscViewerASCIIPrintf(viewer,"%g",(double)PetscRealPart(xarray[i*bs+b]));
201:         }
202:         PetscViewerASCIIPrintf(viewer,"\n");
203:       }
204:       for (j=1; j<size; j++) {
205:         MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,PetscObjectComm((PetscObject)xin),&status);
206:         MPI_Get_count(&status,MPIU_SCALAR,&n);
207:         for (i=0; i<n/bs; i++) {
208:           for (b=0; b<bs; b++) {
209:             if (b > 0) {
210:               PetscViewerASCIIPrintf(viewer," ");
211:             }
212:             PetscViewerASCIIPrintf(viewer,"%g",(double)PetscRealPart(values[i*bs+b]));
213:           }
214:           PetscViewerASCIIPrintf(viewer,"\n");
215:         }
216:       }
217:     } else if (format == PETSC_VIEWER_ASCII_VTK_COORDS_DEPRECATED) {
218:       PetscInt bs, b;

220:       VecGetLocalSize(xin, &nLen);
221:       PetscMPIIntCast(nLen,&n);
222:       VecGetBlockSize(xin, &bs);
223:       if ((bs < 1) || (bs > 3)) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "VTK can only handle 3D objects, but vector dimension is %d", bs);

225:       for (i=0; i<n/bs; i++) {
226:         for (b=0; b<bs; b++) {
227:           if (b > 0) {
228:             PetscViewerASCIIPrintf(viewer," ");
229:           }
230:           PetscViewerASCIIPrintf(viewer,"%g",(double)PetscRealPart(xarray[i*bs+b]));
231:         }
232:         for (b=bs; b<3; b++) {
233:           PetscViewerASCIIPrintf(viewer," 0.0");
234:         }
235:         PetscViewerASCIIPrintf(viewer,"\n");
236:       }
237:       for (j=1; j<size; j++) {
238:         MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,PetscObjectComm((PetscObject)xin),&status);
239:         MPI_Get_count(&status,MPIU_SCALAR,&n);
240:         for (i=0; i<n/bs; i++) {
241:           for (b=0; b<bs; b++) {
242:             if (b > 0) {
243:               PetscViewerASCIIPrintf(viewer," ");
244:             }
245:             PetscViewerASCIIPrintf(viewer,"%g",(double)PetscRealPart(values[i*bs+b]));
246:           }
247:           for (b=bs; b<3; b++) {
248:             PetscViewerASCIIPrintf(viewer," 0.0");
249:           }
250:           PetscViewerASCIIPrintf(viewer,"\n");
251:         }
252:       }
253:     } else if (format == PETSC_VIEWER_ASCII_PCICE) {
254:       PetscInt bs, b, vertexCount = 1;

256:       VecGetLocalSize(xin, &nLen);
257:       PetscMPIIntCast(nLen,&n);
258:       VecGetBlockSize(xin, &bs);
259:       if ((bs < 1) || (bs > 3)) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "PCICE can only handle up to 3D objects, but vector dimension is %d", bs);

261:       PetscViewerASCIIPrintf(viewer,"%D\n", xin->map->N/bs);
262:       for (i=0; i<n/bs; i++) {
263:         PetscViewerASCIIPrintf(viewer,"%7D   ", vertexCount++);
264:         for (b=0; b<bs; b++) {
265:           if (b > 0) {
266:             PetscViewerASCIIPrintf(viewer," ");
267:           }
268: #if !defined(PETSC_USE_COMPLEX)
269:           PetscViewerASCIIPrintf(viewer,"% 12.5E",(double)xarray[i*bs+b]);
270: #endif
271:         }
272:         PetscViewerASCIIPrintf(viewer,"\n");
273:       }
274:       for (j=1; j<size; j++) {
275:         MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,PetscObjectComm((PetscObject)xin),&status);
276:         MPI_Get_count(&status,MPIU_SCALAR,&n);
277:         for (i=0; i<n/bs; i++) {
278:           PetscViewerASCIIPrintf(viewer,"%7D   ", vertexCount++);
279:           for (b=0; b<bs; b++) {
280:             if (b > 0) {
281:               PetscViewerASCIIPrintf(viewer," ");
282:             }
283: #if !defined(PETSC_USE_COMPLEX)
284:             PetscViewerASCIIPrintf(viewer,"% 12.5E",(double)values[i*bs+b]);
285: #endif
286:           }
287:           PetscViewerASCIIPrintf(viewer,"\n");
288:         }
289:       }
290:     } else if (format == PETSC_VIEWER_ASCII_GLVIS) {
291:       /* GLVis ASCII visualization/dump: this function mimicks mfem::GridFunction::Save() */
292:       const PetscScalar       *array;
293:       PetscInt                i,n,vdim, ordering = 1; /* mfem::FiniteElementSpace::Ordering::byVDIM */
294:       PetscContainer          glvis_container;
295:       PetscViewerGLVisVecInfo glvis_vec_info;
296:       PetscViewerGLVisInfo    glvis_info;
297:       PetscErrorCode          ierr;

299:       /* mfem::FiniteElementSpace::Save() */
300:       VecGetBlockSize(xin,&vdim);
301:       PetscViewerASCIIPrintf(viewer,"FiniteElementSpace\n");
302:       PetscObjectQuery((PetscObject)xin,"_glvis_info_container",(PetscObject*)&glvis_container);
303:       if (!glvis_container) SETERRQ(PetscObjectComm((PetscObject)xin),PETSC_ERR_PLIB,"Missing GLVis container");
304:       PetscContainerGetPointer(glvis_container,(void**)&glvis_vec_info);
305:       PetscViewerASCIIPrintf(viewer,"%s\n",glvis_vec_info->fec_type);
306:       PetscViewerASCIIPrintf(viewer,"VDim: %d\n",vdim);
307:       PetscViewerASCIIPrintf(viewer,"Ordering: %d\n",ordering);
308:       PetscViewerASCIIPrintf(viewer,"\n");
309:       /* mfem::Vector::Print() */
310:       PetscObjectQuery((PetscObject)viewer,"_glvis_info_container",(PetscObject*)&glvis_container);
311:       if (!glvis_container) SETERRQ(PetscObjectComm((PetscObject)viewer),PETSC_ERR_PLIB,"Missing GLVis container");
312:       PetscContainerGetPointer(glvis_container,(void**)&glvis_info);
313:       if (glvis_info->enabled) {
314:         VecGetLocalSize(xin,&n);
315:         VecGetArrayRead(xin,&array);
316:         for (i=0;i<n;i++) {
317:           PetscViewerASCIIPrintf(viewer,glvis_info->fmt,(double)PetscRealPart(array[i]));
318:           PetscViewerASCIIPrintf(viewer,"\n");
319:         }
320:         VecRestoreArrayRead(xin,&array);
321:       }
322:     } else if (format == PETSC_VIEWER_ASCII_INFO || format == PETSC_VIEWER_ASCII_INFO_DETAIL) {
323:       /* No info */
324:     } else {
325:       if (format != PETSC_VIEWER_ASCII_COMMON) {PetscViewerASCIIPrintf(viewer,"Process [%d]\n",rank);}
326:       cnt = 0;
327:       for (i=0; i<xin->map->n; i++) {
328:         if (format == PETSC_VIEWER_ASCII_INDEX) {
329:           PetscViewerASCIIPrintf(viewer,"%D: ",cnt++);
330:         }
331: #if defined(PETSC_USE_COMPLEX)
332:         if (PetscImaginaryPart(xarray[i]) > 0.0) {
333:           PetscViewerASCIIPrintf(viewer,"%g + %g i\n",(double)PetscRealPart(xarray[i]),(double)PetscImaginaryPart(xarray[i]));
334:         } else if (PetscImaginaryPart(xarray[i]) < 0.0) {
335:           PetscViewerASCIIPrintf(viewer,"%g - %g i\n",(double)PetscRealPart(xarray[i]),-(double)PetscImaginaryPart(xarray[i]));
336:         } else {
337:           PetscViewerASCIIPrintf(viewer,"%g\n",(double)PetscRealPart(xarray[i]));
338:         }
339: #else
340:         PetscViewerASCIIPrintf(viewer,"%g\n",(double)xarray[i]);
341: #endif
342:       }
343:       /* receive and print messages */
344:       for (j=1; j<size; j++) {
345:         MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,PetscObjectComm((PetscObject)xin),&status);
346:         MPI_Get_count(&status,MPIU_SCALAR,&n);
347:         if (format != PETSC_VIEWER_ASCII_COMMON) {
348:           PetscViewerASCIIPrintf(viewer,"Process [%d]\n",j);
349:         }
350:         for (i=0; i<n; i++) {
351:           if (format == PETSC_VIEWER_ASCII_INDEX) {
352:             PetscViewerASCIIPrintf(viewer,"%D: ",cnt++);
353:           }
354: #if defined(PETSC_USE_COMPLEX)
355:           if (PetscImaginaryPart(values[i]) > 0.0) {
356:             PetscViewerASCIIPrintf(viewer,"%g + %g i\n",(double)PetscRealPart(values[i]),(double)PetscImaginaryPart(values[i]));
357:           } else if (PetscImaginaryPart(values[i]) < 0.0) {
358:             PetscViewerASCIIPrintf(viewer,"%g - %g i\n",(double)PetscRealPart(values[i]),-(double)PetscImaginaryPart(values[i]));
359:           } else {
360:             PetscViewerASCIIPrintf(viewer,"%g\n",(double)PetscRealPart(values[i]));
361:           }
362: #else
363:           PetscViewerASCIIPrintf(viewer,"%g\n",(double)values[i]);
364: #endif
365:         }
366:       }
367:     }
368:     PetscFree(values);
369:   } else {
370:     if (format == PETSC_VIEWER_ASCII_INFO || format == PETSC_VIEWER_ASCII_INFO_DETAIL) {
371:       /* Rank 0 is not trying to receive anything, so don't send anything */
372:     } else {
373:       if (format == PETSC_VIEWER_ASCII_MATLAB || format == PETSC_VIEWER_ASCII_VTK_DEPRECATED || format == PETSC_VIEWER_ASCII_VTK_CELL_DEPRECATED) {
374:         /* this may be a collective operation so make sure everyone calls it */
375:         PetscObjectGetName((PetscObject)xin,&name);
376:       }
377:       MPI_Send((void*)xarray,xin->map->n,MPIU_SCALAR,0,tag,PetscObjectComm((PetscObject)xin));
378:     }
379:   }
380:   PetscViewerFlush(viewer);
381:   VecRestoreArrayRead(xin,&xarray);
382:   return(0);
383: }

385: PetscErrorCode VecView_MPI_Binary(Vec xin,PetscViewer viewer)
386: {
387:   return VecView_Binary(xin,viewer);
388: }

390: #include <petscdraw.h>
391: PetscErrorCode VecView_MPI_Draw_LG(Vec xin,PetscViewer viewer)
392: {
393:   PetscDraw         draw;
394:   PetscBool         isnull;
395:   PetscDrawLG       lg;
396:   PetscMPIInt       i,size,rank,n,N,*lens = NULL,*disp = NULL;
397:   PetscReal         *values, *xx = NULL,*yy = NULL;
398:   const PetscScalar *xarray;
399:   int               colors[] = {PETSC_DRAW_RED};
400:   PetscErrorCode    ierr;

403:   PetscViewerDrawGetDraw(viewer,0,&draw);
404:   PetscDrawIsNull(draw,&isnull);
405:   if (isnull) return(0);
406:   MPI_Comm_rank(PetscObjectComm((PetscObject)xin),&rank);
407:   MPI_Comm_size(PetscObjectComm((PetscObject)xin),&size);
408:   PetscMPIIntCast(xin->map->n,&n);
409:   PetscMPIIntCast(xin->map->N,&N);

411:   VecGetArrayRead(xin,&xarray);
412: #if defined(PETSC_USE_COMPLEX)
413:   PetscMalloc1(n+1,&values);
414:   for (i=0; i<n; i++) values[i] = PetscRealPart(xarray[i]);
415: #else
416:   values = (PetscReal*)xarray;
417: #endif
418:   if (!rank) {
419:     PetscMalloc2(N,&xx,N,&yy);
420:     for (i=0; i<N; i++) xx[i] = (PetscReal)i;
421:     PetscMalloc2(size,&lens,size,&disp);
422:     for (i=0; i<size; i++) lens[i] = (PetscMPIInt)xin->map->range[i+1] - (PetscMPIInt)xin->map->range[i];
423:     for (i=0; i<size; i++) disp[i] = (PetscMPIInt)xin->map->range[i];
424:   }
425:   MPI_Gatherv(values,n,MPIU_REAL,yy,lens,disp,MPIU_REAL,0,PetscObjectComm((PetscObject)xin));
426:   PetscFree2(lens,disp);
427: #if defined(PETSC_USE_COMPLEX)
428:   PetscFree(values);
429: #endif
430:   VecRestoreArrayRead(xin,&xarray);

432:   PetscViewerDrawGetDrawLG(viewer,0,&lg);
433:   PetscDrawLGReset(lg);
434:   PetscDrawLGSetDimension(lg,1);
435:   PetscDrawLGSetColors(lg,colors);
436:   if (!rank) {
437:     PetscDrawLGAddPoints(lg,N,&xx,&yy);
438:     PetscFree2(xx,yy);
439:   }
440:   PetscDrawLGDraw(lg);
441:   PetscDrawLGSave(lg);
442:   return(0);
443: }

445: PetscErrorCode  VecView_MPI_Draw(Vec xin,PetscViewer viewer)
446: {
447:   PetscErrorCode    ierr;
448:   PetscMPIInt       rank,size,tag = ((PetscObject)viewer)->tag;
449:   PetscInt          i,start,end;
450:   MPI_Status        status;
451:   PetscReal         min,max,tmp = 0.0;
452:   PetscDraw         draw;
453:   PetscBool         isnull;
454:   PetscDrawAxis     axis;
455:   const PetscScalar *xarray;

458:   PetscViewerDrawGetDraw(viewer,0,&draw);
459:   PetscDrawIsNull(draw,&isnull);
460:   if (isnull) return(0);
461:   MPI_Comm_size(PetscObjectComm((PetscObject)xin),&size);
462:   MPI_Comm_rank(PetscObjectComm((PetscObject)xin),&rank);

464:   VecMin(xin,NULL,&min);
465:   VecMax(xin,NULL,&max);
466:   if (min == max) {
467:     min -= 1.e-5;
468:     max += 1.e-5;
469:   }

471:   PetscDrawCheckResizedWindow(draw);
472:   PetscDrawClear(draw);

474:   PetscDrawAxisCreate(draw,&axis);
475:   PetscDrawAxisSetLimits(axis,0.0,(PetscReal)xin->map->N,min,max);
476:   PetscDrawAxisDraw(axis);
477:   PetscDrawAxisDestroy(&axis);

479:   /* draw local part of vector */
480:   VecGetArrayRead(xin,&xarray);
481:   VecGetOwnershipRange(xin,&start,&end);
482:   if (rank < size-1) { /* send value to right */
483:     MPI_Send((void*)&xarray[xin->map->n-1],1,MPIU_REAL,rank+1,tag,PetscObjectComm((PetscObject)xin));
484:   }
485:   if (rank) { /* receive value from right */
486:     MPI_Recv(&tmp,1,MPIU_REAL,rank-1,tag,PetscObjectComm((PetscObject)xin),&status);
487:   }
488:   PetscDrawCollectiveBegin(draw);
489:   if (rank) {
490:     PetscDrawLine(draw,(PetscReal)start-1,tmp,(PetscReal)start,PetscRealPart(xarray[0]),PETSC_DRAW_RED);
491:   }
492:   for (i=1; i<xin->map->n; i++) {
493:     PetscDrawLine(draw,(PetscReal)(i-1+start),PetscRealPart(xarray[i-1]),(PetscReal)(i+start),PetscRealPart(xarray[i]),PETSC_DRAW_RED);
494:   }
495:   PetscDrawCollectiveEnd(draw);
496:   VecRestoreArrayRead(xin,&xarray);

498:   PetscDrawFlush(draw);
499:   PetscDrawPause(draw);
500:   PetscDrawSave(draw);
501:   return(0);
502: }

504: #if defined(PETSC_HAVE_MATLAB_ENGINE)
505: PetscErrorCode VecView_MPI_Matlab(Vec xin,PetscViewer viewer)
506: {
507:   PetscErrorCode    ierr;
508:   PetscMPIInt       rank,size,*lens;
509:   PetscInt          i,N = xin->map->N;
510:   const PetscScalar *xarray;
511:   PetscScalar       *xx;

514:   VecGetArrayRead(xin,&xarray);
515:   MPI_Comm_rank(PetscObjectComm((PetscObject)xin),&rank);
516:   MPI_Comm_size(PetscObjectComm((PetscObject)xin),&size);
517:   if (!rank) {
518:     PetscMalloc1(N,&xx);
519:     PetscMalloc1(size,&lens);
520:     for (i=0; i<size; i++) lens[i] = xin->map->range[i+1] - xin->map->range[i];

522:     MPI_Gatherv((void*)xarray,xin->map->n,MPIU_SCALAR,xx,lens,xin->map->range,MPIU_SCALAR,0,PetscObjectComm((PetscObject)xin));
523:     PetscFree(lens);

525:     PetscObjectName((PetscObject)xin);
526:     PetscViewerMatlabPutArray(viewer,N,1,xx,((PetscObject)xin)->name);

528:     PetscFree(xx);
529:   } else {
530:     MPI_Gatherv((void*)xarray,xin->map->n,MPIU_SCALAR,0,0,0,MPIU_SCALAR,0,PetscObjectComm((PetscObject)xin));
531:   }
532:   VecRestoreArrayRead(xin,&xarray);
533:   return(0);
534: }
535: #endif

537: #if defined(PETSC_HAVE_ADIOS)
538: #include <adios.h>
539: #include <adios_read.h>
540: #include <petsc/private/vieweradiosimpl.h>
541: #include <petsc/private/viewerimpl.h>

543: PetscErrorCode VecView_MPI_ADIOS(Vec xin, PetscViewer viewer)
544: {
545:   PetscViewer_ADIOS *adios = (PetscViewer_ADIOS*)viewer->data;
546:   PetscErrorCode    ierr;
547:   const char        *vecname;
548:   int64_t           id;
549:   PetscInt          n,N,rstart;
550:   const PetscScalar *array;
551:   char              nglobalname[16],nlocalname[16],coffset[16];

554:   PetscObjectGetName((PetscObject) xin, &vecname);

556:   VecGetLocalSize(xin,&n);
557:   VecGetSize(xin,&N);
558:   VecGetOwnershipRange(xin,&rstart,NULL);

560:   sprintf(nlocalname,"%d",(int)n);
561:   sprintf(nglobalname,"%d",(int)N);
562:   sprintf(coffset,"%d",(int)rstart);
563:   id   = adios_define_var(Petsc_adios_group,vecname,"",adios_double,nlocalname,nglobalname,coffset);
564:   VecGetArrayRead(xin,&array);
565:   adios_write_byid(adios->adios_handle,id,array);
566:   VecRestoreArrayRead(xin,&array);

568:   return(0);
569: }
570: #endif

572: #if defined(PETSC_HAVE_HDF5)
573: PetscErrorCode VecView_MPI_HDF5(Vec xin, PetscViewer viewer)
574: {
575:   PetscViewer_HDF5  *hdf5 = (PetscViewer_HDF5*) viewer->data;
576:   /* TODO: It looks like we can remove the H5Sclose(filespace) and H5Dget_space(dset_id). Why do we do this? */
577:   hid_t             filespace; /* file dataspace identifier */
578:   hid_t             chunkspace; /* chunk dataset property identifier */
579:   hid_t             dset_id;   /* dataset identifier */
580:   hid_t             memspace;  /* memory dataspace identifier */
581:   hid_t             file_id;
582:   hid_t             group;
583:   hid_t             memscalartype; /* scalar type for mem (H5T_NATIVE_FLOAT or H5T_NATIVE_DOUBLE) */
584:   hid_t             filescalartype; /* scalar type for file (H5T_NATIVE_FLOAT or H5T_NATIVE_DOUBLE) */
585:   PetscInt          bs = PetscAbs(xin->map->bs);
586:   hsize_t           dim;
587:   hsize_t           maxDims[4], dims[4], chunkDims[4], count[4], offset[4];
588:   PetscInt          timestep;
589:   PetscInt          low;
590:   hsize_t           chunksize;
591:   const PetscScalar *x;
592:   const char        *vecname;
593:   PetscErrorCode    ierr;
594:   PetscBool         dim2;
595:   PetscBool         spoutput;

598:   PetscViewerHDF5OpenGroup(viewer, &file_id, &group);
599:   PetscViewerHDF5GetTimestep(viewer, &timestep);
600:   PetscViewerHDF5GetBaseDimension2(viewer,&dim2);
601:   PetscViewerHDF5GetSPOutput(viewer,&spoutput);

603:   /* Create the dataspace for the dataset.
604:    *
605:    * dims - holds the current dimensions of the dataset
606:    *
607:    * maxDims - holds the maximum dimensions of the dataset (unlimited
608:    * for the number of time steps with the current dimensions for the
609:    * other dimensions; so only additional time steps can be added).
610:    *
611:    * chunkDims - holds the size of a single time step (required to
612:    * permit extending dataset).
613:    */
614:   dim = 0;
615:   chunksize = 1;
616:   if (timestep >= 0) {
617:     dims[dim]      = timestep+1;
618:     maxDims[dim]   = H5S_UNLIMITED;
619:     chunkDims[dim] = 1;
620:     ++dim;
621:   }
622:   PetscHDF5IntCast(xin->map->N/bs,dims + dim);

624:   maxDims[dim]   = dims[dim];
625:   chunkDims[dim] = PetscMax(1, dims[dim]);
626:   chunksize      *= chunkDims[dim];
627:   ++dim;
628:   if (bs > 1 || dim2) {
629:     dims[dim]      = bs;
630:     maxDims[dim]   = dims[dim];
631:     chunkDims[dim] = PetscMax(1, dims[dim]);
632:     chunksize      *= chunkDims[dim];
633:     ++dim;
634:   }
635: #if defined(PETSC_USE_COMPLEX)
636:   dims[dim]      = 2;
637:   maxDims[dim]   = dims[dim];
638:   chunkDims[dim] = PetscMax(1, dims[dim]);
639:   chunksize      *= chunkDims[dim];
640:   /* hdf5 chunks must be less than 4GB */
641:   if (chunksize > PETSC_HDF5_MAX_CHUNKSIZE/64) {
642:     if (bs > 1 || dim2) {
643:       if (chunkDims[dim-2] > (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/128))) {
644:         chunkDims[dim-2] = (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/128));
645:       } if (chunkDims[dim-1] > (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/128))) {
646:         chunkDims[dim-1] = (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/128));
647:       }
648:     } else {
649:       chunkDims[dim-1] = PETSC_HDF5_MAX_CHUNKSIZE/128;
650:     }
651:   }
652:   ++dim;
653: #else
654:   /* hdf5 chunks must be less than 4GB */
655:   if (chunksize > PETSC_HDF5_MAX_CHUNKSIZE/64) {
656:     if (bs > 1 || dim2) {
657:       if (chunkDims[dim-2] > (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/64))) {
658:         chunkDims[dim-2] = (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/64));
659:       } if (chunkDims[dim-1] > (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/64))) {
660:         chunkDims[dim-1] = (PetscInt)PetscSqrtReal((PetscReal)(PETSC_HDF5_MAX_CHUNKSIZE/64));
661:       }
662:     } else {
663:       chunkDims[dim-1] = PETSC_HDF5_MAX_CHUNKSIZE/64;
664:     }
665:   }
666: #endif


669:   PetscStackCallHDF5Return(filespace,H5Screate_simple,(dim, dims, maxDims));

671: #if defined(PETSC_USE_REAL_SINGLE)
672:   memscalartype = H5T_NATIVE_FLOAT;
673:   filescalartype = H5T_NATIVE_FLOAT;
674: #elif defined(PETSC_USE_REAL___FLOAT128)
675: #error "HDF5 output with 128 bit floats not supported."
676: #elif defined(PETSC_USE_REAL___FP16)
677: #error "HDF5 output with 16 bit floats not supported."
678: #else
679:   memscalartype = H5T_NATIVE_DOUBLE;
680:   if (spoutput == PETSC_TRUE) filescalartype = H5T_NATIVE_FLOAT;
681:   else filescalartype = H5T_NATIVE_DOUBLE;
682: #endif

684:   /* Create the dataset with default properties and close filespace */
685:   PetscObjectGetName((PetscObject) xin, &vecname);
686:   if (H5Lexists(group, vecname, H5P_DEFAULT) < 1) {
687:     /* Create chunk */
688:     PetscStackCallHDF5Return(chunkspace,H5Pcreate,(H5P_DATASET_CREATE));
689:     PetscStackCallHDF5(H5Pset_chunk,(chunkspace, dim, chunkDims));

691:     PetscStackCallHDF5Return(dset_id,H5Dcreate2,(group, vecname, filescalartype, filespace, H5P_DEFAULT, chunkspace, H5P_DEFAULT));
692:     PetscStackCallHDF5(H5Pclose,(chunkspace));
693:   } else {
694:     PetscStackCallHDF5Return(dset_id,H5Dopen2,(group, vecname, H5P_DEFAULT));
695:     PetscStackCallHDF5(H5Dset_extent,(dset_id, dims));
696:   }
697:   PetscStackCallHDF5(H5Sclose,(filespace));

699:   /* Each process defines a dataset and writes it to the hyperslab in the file */
700:   dim = 0;
701:   if (timestep >= 0) {
702:     count[dim] = 1;
703:     ++dim;
704:   }
705:   PetscHDF5IntCast(xin->map->n/bs,count + dim);
706:   ++dim;
707:   if (bs > 1 || dim2) {
708:     count[dim] = bs;
709:     ++dim;
710:   }
711: #if defined(PETSC_USE_COMPLEX)
712:   count[dim] = 2;
713:   ++dim;
714: #endif
715:   if (xin->map->n > 0 || H5_VERSION_GE(1,10,0)) {
716:     PetscStackCallHDF5Return(memspace,H5Screate_simple,(dim, count, NULL));
717:   } else {
718:     /* Can't create dataspace with zero for any dimension, so create null dataspace. */
719:     PetscStackCallHDF5Return(memspace,H5Screate,(H5S_NULL));
720:   }

722:   /* Select hyperslab in the file */
723:   VecGetOwnershipRange(xin, &low, NULL);
724:   dim  = 0;
725:   if (timestep >= 0) {
726:     offset[dim] = timestep;
727:     ++dim;
728:   }
729:   PetscHDF5IntCast(low/bs,offset + dim);
730:   ++dim;
731:   if (bs > 1 || dim2) {
732:     offset[dim] = 0;
733:     ++dim;
734:   }
735: #if defined(PETSC_USE_COMPLEX)
736:   offset[dim] = 0;
737:   ++dim;
738: #endif
739:   if (xin->map->n > 0 || H5_VERSION_GE(1,10,0)) {
740:     PetscStackCallHDF5Return(filespace,H5Dget_space,(dset_id));
741:     PetscStackCallHDF5(H5Sselect_hyperslab,(filespace, H5S_SELECT_SET, offset, NULL, count, NULL));
742:   } else {
743:     /* Create null filespace to match null memspace. */
744:     PetscStackCallHDF5Return(filespace,H5Screate,(H5S_NULL));
745:   }

747:   VecGetArrayRead(xin, &x);
748:   PetscStackCallHDF5(H5Dwrite,(dset_id, memscalartype, memspace, filespace, hdf5->dxpl_id, x));
749:   PetscStackCallHDF5(H5Fflush,(file_id, H5F_SCOPE_GLOBAL));
750:   VecRestoreArrayRead(xin, &x);

752:   /* Close/release resources */
753:   PetscStackCallHDF5(H5Gclose,(group));
754:   PetscStackCallHDF5(H5Sclose,(filespace));
755:   PetscStackCallHDF5(H5Sclose,(memspace));
756:   PetscStackCallHDF5(H5Dclose,(dset_id));

758: #if defined(PETSC_USE_COMPLEX)
759:   {
760:     PetscBool   tru = PETSC_TRUE;
761:     PetscViewerHDF5WriteObjectAttribute(viewer,(PetscObject)xin,"complex",PETSC_BOOL,&tru);
762:   }
763: #endif
764:   PetscInfo1(xin,"Wrote Vec object with name %s\n",vecname);
765:   return(0);
766: }
767: #endif

769: PETSC_EXTERN PetscErrorCode VecView_MPI(Vec xin,PetscViewer viewer)
770: {
772:   PetscBool      iascii,isbinary,isdraw;
773: #if defined(PETSC_HAVE_MATHEMATICA)
774:   PetscBool      ismathematica;
775: #endif
776: #if defined(PETSC_HAVE_HDF5)
777:   PetscBool      ishdf5;
778: #endif
779: #if defined(PETSC_HAVE_MATLAB_ENGINE)
780:   PetscBool      ismatlab;
781: #endif
782: #if defined(PETSC_HAVE_ADIOS)
783:   PetscBool      isadios;
784: #endif
785:   PetscBool      isglvis;

788:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&iascii);
789:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERBINARY,&isbinary);
790:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERDRAW,&isdraw);
791: #if defined(PETSC_HAVE_MATHEMATICA)
792:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERMATHEMATICA,&ismathematica);
793: #endif
794: #if defined(PETSC_HAVE_HDF5)
795:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERHDF5,&ishdf5);
796: #endif
797: #if defined(PETSC_HAVE_MATLAB_ENGINE)
798:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERMATLAB,&ismatlab);
799: #endif
800:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERGLVIS,&isglvis);
801: #if defined(PETSC_HAVE_ADIOS)
802:   PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERADIOS,&isadios);
803: #endif
804:   if (iascii) {
805:     VecView_MPI_ASCII(xin,viewer);
806:   } else if (isbinary) {
807:     VecView_MPI_Binary(xin,viewer);
808:   } else if (isdraw) {
809:     PetscViewerFormat format;
810:     PetscViewerGetFormat(viewer,&format);
811:     if (format == PETSC_VIEWER_DRAW_LG) {
812:       VecView_MPI_Draw_LG(xin,viewer);
813:     } else {
814:       VecView_MPI_Draw(xin,viewer);
815:     }
816: #if defined(PETSC_HAVE_MATHEMATICA)
817:   } else if (ismathematica) {
818:     PetscViewerMathematicaPutVector(viewer,xin);
819: #endif
820: #if defined(PETSC_HAVE_HDF5)
821:   } else if (ishdf5) {
822:     VecView_MPI_HDF5(xin,viewer);
823: #endif
824: #if defined(PETSC_HAVE_ADIOS)
825:   } else if (isadios) {
826:     VecView_MPI_ADIOS(xin,viewer);
827: #endif
828: #if defined(PETSC_HAVE_MATLAB_ENGINE)
829:   } else if (ismatlab) {
830:     VecView_MPI_Matlab(xin,viewer);
831: #endif
832:   } else if (isglvis) {
833:     VecView_GLVis(xin,viewer);
834:   }
835:   return(0);
836: }

838: PetscErrorCode VecGetSize_MPI(Vec xin,PetscInt *N)
839: {
841:   *N = xin->map->N;
842:   return(0);
843: }

845: PetscErrorCode VecGetValues_MPI(Vec xin,PetscInt ni,const PetscInt ix[],PetscScalar y[])
846: {
847:   const PetscScalar *xx;
848:   PetscInt          i,tmp,start = xin->map->range[xin->stash.rank];
849:   PetscErrorCode    ierr;

852:   VecGetArrayRead(xin,&xx);
853:   for (i=0; i<ni; i++) {
854:     if (xin->stash.ignorenegidx && ix[i] < 0) continue;
855:     tmp = ix[i] - start;
856:     if (PetscUnlikelyDebug(tmp < 0 || tmp >= xin->map->n)) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Can only get local values, trying %D",ix[i]);
857:     y[i] = xx[tmp];
858:   }
859:   VecRestoreArrayRead(xin,&xx);
860:   return(0);
861: }

863: PetscErrorCode VecSetValues_MPI(Vec xin,PetscInt ni,const PetscInt ix[],const PetscScalar y[],InsertMode addv)
864: {
866:   PetscMPIInt    rank    = xin->stash.rank;
867:   PetscInt       *owners = xin->map->range,start = owners[rank];
868:   PetscInt       end     = owners[rank+1],i,row;
869:   PetscScalar    *xx;

872:   if (PetscDefined(USE_DEBUG)) {
873:     if (xin->stash.insertmode == INSERT_VALUES && addv == ADD_VALUES) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"You have already inserted values; you cannot now add");
874:     else if (xin->stash.insertmode == ADD_VALUES && addv == INSERT_VALUES) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"You have already added values; you cannot now insert");
875:   }
876:   VecGetArray(xin,&xx);
877:   xin->stash.insertmode = addv;

879:   if (addv == INSERT_VALUES) {
880:     for (i=0; i<ni; i++) {
881:       if (xin->stash.ignorenegidx && ix[i] < 0) continue;
882:       if (PetscUnlikelyDebug(ix[i] < 0)) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Out of range index value %D cannot be negative",ix[i]);
883:       if ((row = ix[i]) >= start && row < end) {
884:         xx[row-start] = y[i];
885:       } else if (!xin->stash.donotstash) {
886:         if (PetscUnlikelyDebug(ix[i] >= xin->map->N)) SETERRQ2(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Out of range index value %D maximum %D",ix[i],xin->map->N);
887:         VecStashValue_Private(&xin->stash,row,y[i]);
888:       }
889:     }
890:   } else {
891:     for (i=0; i<ni; i++) {
892:       if (xin->stash.ignorenegidx && ix[i] < 0) continue;
893:       if (PetscUnlikelyDebug(ix[i] < 0)) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Out of range index value %D cannot be negative",ix[i]);
894:       if ((row = ix[i]) >= start && row < end) {
895:         xx[row-start] += y[i];
896:       } else if (!xin->stash.donotstash) {
897:         if (PetscUnlikelyDebug(ix[i] >= xin->map->N)) SETERRQ2(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Out of range index value %D maximum %D",ix[i],xin->map->N);
898:         VecStashValue_Private(&xin->stash,row,y[i]);
899:       }
900:     }
901:   }
902:   VecRestoreArray(xin,&xx);
903:   return(0);
904: }

906: PetscErrorCode VecSetValuesBlocked_MPI(Vec xin,PetscInt ni,const PetscInt ix[],const PetscScalar yin[],InsertMode addv)
907: {
908:   PetscMPIInt    rank    = xin->stash.rank;
909:   PetscInt       *owners = xin->map->range,start = owners[rank];
911:   PetscInt       end = owners[rank+1],i,row,bs = PetscAbs(xin->map->bs),j;
912:   PetscScalar    *xx,*y = (PetscScalar*)yin;

915:   VecGetArray(xin,&xx);
916:   if (PetscDefined(USE_DEBUG)) {
917:     if (xin->stash.insertmode == INSERT_VALUES && addv == ADD_VALUES) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"You have already inserted values; you cannot now add");
918:     else if (xin->stash.insertmode == ADD_VALUES && addv == INSERT_VALUES) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"You have already added values; you cannot now insert");
919:   }
920:   xin->stash.insertmode = addv;

922:   if (addv == INSERT_VALUES) {
923:     for (i=0; i<ni; i++) {
924:       if ((row = bs*ix[i]) >= start && row < end) {
925:         for (j=0; j<bs; j++) xx[row-start+j] = y[j];
926:       } else if (!xin->stash.donotstash) {
927:         if (ix[i] < 0) { y += bs; continue; }
928:         if (PetscUnlikelyDebug(ix[i] >= xin->map->N)) SETERRQ2(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Out of range index value %D max %D",ix[i],xin->map->N);
929:         VecStashValuesBlocked_Private(&xin->bstash,ix[i],y);
930:       }
931:       y += bs;
932:     }
933:   } else {
934:     for (i=0; i<ni; i++) {
935:       if ((row = bs*ix[i]) >= start && row < end) {
936:         for (j=0; j<bs; j++) xx[row-start+j] += y[j];
937:       } else if (!xin->stash.donotstash) {
938:         if (ix[i] < 0) { y += bs; continue; }
939:         if (PetscUnlikelyDebug(ix[i] > xin->map->N)) SETERRQ2(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Out of range index value %D max %D",ix[i],xin->map->N);
940:         VecStashValuesBlocked_Private(&xin->bstash,ix[i],y);
941:       }
942:       y += bs;
943:     }
944:   }
945:   VecRestoreArray(xin,&xx);
946:   return(0);
947: }

949: /*
950:    Since nsends or nreceives may be zero we add 1 in certain mallocs
951: to make sure we never malloc an empty one.
952: */
953: PetscErrorCode VecAssemblyBegin_MPI(Vec xin)
954: {
956:   PetscInt       *owners = xin->map->range,*bowners,i,bs,nstash,reallocs;
957:   PetscMPIInt    size;
958:   InsertMode     addv;
959:   MPI_Comm       comm;

962:   PetscObjectGetComm((PetscObject)xin,&comm);
963:   if (xin->stash.donotstash) return(0);

965:   MPIU_Allreduce((PetscEnum*)&xin->stash.insertmode,(PetscEnum*)&addv,1,MPIU_ENUM,MPI_BOR,comm);
966:   if (addv == (ADD_VALUES|INSERT_VALUES)) SETERRQ(comm,PETSC_ERR_ARG_NOTSAMETYPE,"Some processors inserted values while others added");
967:   xin->stash.insertmode = addv; /* in case this processor had no cache */
968:   xin->bstash.insertmode = addv; /* Block stash implicitly tracks InsertMode of scalar stash */

970:   VecGetBlockSize(xin,&bs);
971:   MPI_Comm_size(PetscObjectComm((PetscObject)xin),&size);
972:   if (!xin->bstash.bowners && xin->map->bs != -1) {
973:     PetscMalloc1(size+1,&bowners);
974:     for (i=0; i<size+1; i++) bowners[i] = owners[i]/bs;
975:     xin->bstash.bowners = bowners;
976:   } else bowners = xin->bstash.bowners;

978:   VecStashScatterBegin_Private(&xin->stash,owners);
979:   VecStashScatterBegin_Private(&xin->bstash,bowners);
980:   VecStashGetInfo_Private(&xin->stash,&nstash,&reallocs);
981:   PetscInfo2(xin,"Stash has %D entries, uses %D mallocs.\n",nstash,reallocs);
982:   VecStashGetInfo_Private(&xin->bstash,&nstash,&reallocs);
983:   PetscInfo2(xin,"Block-Stash has %D entries, uses %D mallocs.\n",nstash,reallocs);
984:   return(0);
985: }

987: PetscErrorCode VecAssemblyEnd_MPI(Vec vec)
988: {
990:   PetscInt       base,i,j,*row,flg,bs;
991:   PetscMPIInt    n;
992:   PetscScalar    *val,*vv,*array,*xarray;

995:   if (!vec->stash.donotstash) {
996:     VecGetArray(vec,&xarray);
997:     VecGetBlockSize(vec,&bs);
998:     base = vec->map->range[vec->stash.rank];

1000:     /* Process the stash */
1001:     while (1) {
1002:       VecStashScatterGetMesg_Private(&vec->stash,&n,&row,&val,&flg);
1003:       if (!flg) break;
1004:       if (vec->stash.insertmode == ADD_VALUES) {
1005:         for (i=0; i<n; i++) xarray[row[i] - base] += val[i];
1006:       } else if (vec->stash.insertmode == INSERT_VALUES) {
1007:         for (i=0; i<n; i++) xarray[row[i] - base] = val[i];
1008:       } else SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_CORRUPT,"Insert mode is not set correctly; corrupted vector");
1009:     }
1010:     VecStashScatterEnd_Private(&vec->stash);

1012:     /* now process the block-stash */
1013:     while (1) {
1014:       VecStashScatterGetMesg_Private(&vec->bstash,&n,&row,&val,&flg);
1015:       if (!flg) break;
1016:       for (i=0; i<n; i++) {
1017:         array = xarray+row[i]*bs-base;
1018:         vv    = val+i*bs;
1019:         if (vec->stash.insertmode == ADD_VALUES) {
1020:           for (j=0; j<bs; j++) array[j] += vv[j];
1021:         } else if (vec->stash.insertmode == INSERT_VALUES) {
1022:           for (j=0; j<bs; j++) array[j] = vv[j];
1023:         } else SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_CORRUPT,"Insert mode is not set correctly; corrupted vector");
1024:       }
1025:     }
1026:     VecStashScatterEnd_Private(&vec->bstash);
1027:     VecRestoreArray(vec,&xarray);
1028:   }
1029:   vec->stash.insertmode = NOT_SET_VALUES;
1030:   return(0);
1031: }