#include /*I "petscsys.h" */ #include #undef __FUNCT__ #define __FUNCT__ "PetscViewerAMSOpen" /*@C PetscViewerAMSOpen - Opens an AMS memory snooper PetscViewer. Collective on MPI_Comm Input Parameters: + comm - the MPI communicator - name - name of AMS communicator being created if NULL is passed defaults to PETSc Output Parameter: . lab - the PetscViewer Options Database Keys: + -ams_port - port number where you are running AMS client . -xxx_view ams - publish the object xxx . -xxx_ams_block - blocks the program at the end of a critical point (for KSP and SNES it is the end of a solve) until the user unblocks the the problem with an external tool that access the object with the AMS - -ams_java - open JAVA AMS client Level: advanced Fortran Note: This routine is not supported in Fortran. See the matlab/petsc directory in the AMS installation for one example of external tools that can monitor PETSc objects that have been published. Notes: Unlike other viewers that only access the object being viewed on the call to XXXView(object,viewer) the AMS viewer allows one to view the object asynchronously as the program continues to run. One can remove AMS access to the object with a call to PetscObjectAMSViewOff(). Information about the AMS is available via http://www.mcs.anl.gov/ams. Concepts: AMS Concepts: Argonne Memory Snooper Concepts: Asynchronous Memory Snooper .seealso: PetscViewerDestroy(), PetscViewerStringSPrintf(), PETSC_VIEWER_AMS_(), PetscObjectAMSBlock(), PetscObjectAMSViewOff(), PetscObjectAMSTakeAccess(), PetscObjectAMSGrantAccess() @*/ PetscErrorCode PetscViewerAMSOpen(MPI_Comm comm,const char name[],PetscViewer *lab) { PetscErrorCode ierr; PetscFunctionBegin; ierr = PetscViewerCreate(comm,lab);CHKERRQ(ierr); ierr = PetscViewerSetType(*lab,PETSCVIEWERAMS);CHKERRQ(ierr); ierr = PetscViewerAMSSetCommName(*lab,name);CHKERRQ(ierr); PetscFunctionReturn(0); } #undef __FUNCT__ #define __FUNCT__ "PetscObjectViewAMS" /*@C PetscObjectViewAMS - View the base portion of any object with an AMS viewer Collective on PetscObject Input Parameters: + obj - the Petsc variable Thus must be cast with a (PetscObject), for example, PetscObjectSetName((PetscObject)mat,name); - viewer - the AMS viewer Level: advanced Concepts: publishing object .seealso: PetscObjectSetName(), PetscObjectAMSViewOff() @*/ PetscErrorCode PetscObjectViewAMS(PetscObject obj,PetscViewer viewer) { PetscErrorCode ierr; AMS_Memory amem; AMS_Comm acomm; PetscFunctionBegin; PetscValidHeader(obj,1); if (obj->classid == PETSC_VIEWER_CLASSID) PetscFunctionReturn(0); if (obj->amsmem != -1) PetscFunctionReturn(0); ierr = PetscObjectName(obj);CHKERRQ(ierr); ierr = PetscViewerAMSGetAMSComm(viewer,&acomm);CHKERRQ(ierr); PetscStackCallAMS(AMS_Memory_create,(acomm,obj->name,&amem)); obj->amsmem = (int)amem; PetscStackCallAMS(AMS_Memory_take_access,(amem)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"Class",&obj->class_name,1,AMS_STRING,AMS_READ,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"Type",&obj->type_name,1,AMS_STRING,AMS_READ,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"Id",&obj->id,1,AMS_INT,AMS_READ,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"ParentId",&obj->parentid,1,AMS_INT,AMS_READ,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"Name",&obj->name,1,AMS_STRING,AMS_READ,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"Publish Block",&obj->amspublishblock,1,AMS_BOOLEAN,AMS_READ,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_add_field,(amem,"Block",&obj->amsblock,1,AMS_BOOLEAN,AMS_WRITE,AMS_COMMON,AMS_REDUCT_UNDEF)); PetscStackCallAMS(AMS_Memory_publish,(amem)); PetscStackCallAMS(AMS_Memory_grant_access,(amem)); PetscFunctionReturn(0); }