15c6c1daeSBarry Smith 2af0996ceSBarry Smith #include <petsc/private/viewerimpl.h> /*I "petscviewer.h" I*/ 35c6c1daeSBarry Smith 4*b3fa1ec5SBarry Smith /*@C 53f08860eSBarry Smith PetscViewerGetSubViewer - Creates a new PetscViewer (same type as the old) 63f08860eSBarry Smith that lives on a subcommunicator 75c6c1daeSBarry Smith 85c6c1daeSBarry Smith Collective on PetscViewer 95c6c1daeSBarry Smith 105c6c1daeSBarry Smith Input Parameter: 113f08860eSBarry Smith . viewer - the PetscViewer to be reproduced 125c6c1daeSBarry Smith 135c6c1daeSBarry Smith Output Parameter: 145c6c1daeSBarry Smith . outviewer - new PetscViewer 155c6c1daeSBarry Smith 165c6c1daeSBarry Smith Level: advanced 175c6c1daeSBarry Smith 183f08860eSBarry Smith Notes: Call PetscViewerRestoreSubViewer() to return this PetscViewer, NOT PetscViewerDestroy() 195c6c1daeSBarry Smith 205c6c1daeSBarry Smith This is most commonly used to view a sequential object that is part of a 215c6c1daeSBarry Smith parallel object. For example block Jacobi PC view could use this to obtain a 225c6c1daeSBarry Smith PetscViewer that is used with the sequential KSP on one block of the preconditioner. 235c6c1daeSBarry Smith 245c6c1daeSBarry Smith Concepts: PetscViewer^sequential version 255c6c1daeSBarry Smith 263f08860eSBarry Smith .seealso: PetscViewerSocketOpen(), PetscViewerASCIIOpen(), PetscViewerDrawOpen(), PetscViewerRestoreSubViewer() 275c6c1daeSBarry Smith @*/ 283f08860eSBarry Smith PetscErrorCode PetscViewerGetSubViewer(PetscViewer viewer,MPI_Comm comm,PetscViewer *outviewer) 295c6c1daeSBarry Smith { 305c6c1daeSBarry Smith PetscErrorCode ierr; 315c6c1daeSBarry Smith PetscMPIInt size; 325c6c1daeSBarry Smith 335c6c1daeSBarry Smith PetscFunctionBegin; 345c6c1daeSBarry Smith PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,1); 355c6c1daeSBarry Smith PetscValidPointer(outviewer,2); 36ce94432eSBarry Smith ierr = MPI_Comm_size(PetscObjectComm((PetscObject)viewer),&size);CHKERRQ(ierr); 375c6c1daeSBarry Smith if (size == 1) { 385c6c1daeSBarry Smith ierr = PetscObjectReference((PetscObject)viewer);CHKERRQ(ierr); 395c6c1daeSBarry Smith *outviewer = viewer; 40559f443fSBarry Smith } else if (viewer->ops->getsubviewer) { 41559f443fSBarry Smith ierr = (*viewer->ops->getsubviewer)(viewer,comm,outviewer);CHKERRQ(ierr); 423f08860eSBarry Smith } else SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_SUP,"Cannot get SubViewer PetscViewer for type %s",((PetscObject)viewer)->type_name); 431575c14dSBarry Smith ierr = PetscViewerASCIIPushSynchronized(viewer);CHKERRQ(ierr); 445c6c1daeSBarry Smith PetscFunctionReturn(0); 455c6c1daeSBarry Smith } 465c6c1daeSBarry Smith 47*b3fa1ec5SBarry Smith /*@C 483f08860eSBarry Smith PetscViewerRestoreSubViewer - Restores a new PetscViewer obtained with PetscViewerGetSubViewer(). 495c6c1daeSBarry Smith 505c6c1daeSBarry Smith Collective on PetscViewer 515c6c1daeSBarry Smith 525c6c1daeSBarry Smith Input Parameters: 533f08860eSBarry Smith + viewer - the PetscViewer that was reproduced 545c6c1daeSBarry Smith - outviewer - new PetscViewer 555c6c1daeSBarry Smith 565c6c1daeSBarry Smith Level: advanced 575c6c1daeSBarry Smith 583f08860eSBarry Smith Notes: Call PetscViewerGetSubViewer() to get this PetscViewer, NOT PetscViewerCreate() 595c6c1daeSBarry Smith 603f08860eSBarry Smith .seealso: PetscViewerSocketOpen(), PetscViewerASCIIOpen(), PetscViewerDrawOpen(), PetscViewerGetSubViewer() 615c6c1daeSBarry Smith @*/ 623f08860eSBarry Smith PetscErrorCode PetscViewerRestoreSubViewer(PetscViewer viewer,MPI_Comm comm,PetscViewer *outviewer) 635c6c1daeSBarry Smith { 645c6c1daeSBarry Smith PetscErrorCode ierr; 655c6c1daeSBarry Smith PetscMPIInt size; 665c6c1daeSBarry Smith 675c6c1daeSBarry Smith PetscFunctionBegin; 685c6c1daeSBarry Smith PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,1); 695c6c1daeSBarry Smith 70ce94432eSBarry Smith ierr = MPI_Comm_size(PetscObjectComm((PetscObject)viewer),&size);CHKERRQ(ierr); 715c6c1daeSBarry Smith if (size == 1) { 725c6c1daeSBarry Smith ierr = PetscObjectDereference((PetscObject)viewer);CHKERRQ(ierr); 73c6228bbaSLisandro Dalcin if (outviewer) *outviewer = NULL; 74559f443fSBarry Smith } else if (viewer->ops->restoresubviewer) { 75559f443fSBarry Smith ierr = (*viewer->ops->restoresubviewer)(viewer,comm,outviewer);CHKERRQ(ierr); 765c6c1daeSBarry Smith } 771575c14dSBarry Smith ierr = PetscViewerASCIIPopSynchronized(viewer);CHKERRQ(ierr); 785c6c1daeSBarry Smith PetscFunctionReturn(0); 795c6c1daeSBarry Smith } 805c6c1daeSBarry Smith 81