DMSubDomainHookRemove#

remove a callback from the list to be run when restricting a problem to subdomain DMs with DMCreateDomainDecomposition()

Synopsis#

#include "petscdm.h"          
#include "petscdmlabel.h"     
#include "petscds.h"     
PetscErrorCode DMSubDomainHookRemove(DM global, PetscErrorCode (*ddhook)(DM dm, DM block, PetscCtx ctx), PetscErrorCode (*restricthook)(DM dm, VecScatter oscatter, VecScatter gscatter, DM block, PetscCtx ctx), PetscCtx ctx)

Logically Collective; No Fortran Support

Input Parameters#

  • global - global DM

  • ddhook - function to run to pass data to the decomposition DM upon its creation

  • restricthook - function to run to update data on block solve (at the beginning of the block solve)

  • ctx - [optional] application context for provide data for the hooks (may be NULL)

Calling sequence of ddhook#

  • dm - global DM

  • block - subdomain DM

  • ctx - optional application function context

Calling sequence of restricthook#

  • dm - global DM

  • oscatter - scatter to the outer (with ghost and overlap points) sub vector

  • gscatter - scatter to sub vector values only owned locally

  • block - subdomain DM

  • ctx - optional application function context

See Also#

DM Basics, DM, DMSubDomainHookAdd(), SNESFASGetInterpolation(), SNESFASGetInjection(), PetscObjectCompose(), PetscContainerCreate(), DMCreateDomainDecomposition()

Level#

advanced

Location#

src/dm/interface/dm.c


Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages