1: /*
  2:   DMPatch, for domains covered by sets of patches.
  3: */
  4: #pragma once

  6: #include <petscdm.h>

  8: /* MANSEC = DM */
  9: /* SUBMANSEC = DMPatch */

 11: /*S
 12:   DMPATCH - `DM` object that encapsulates a domain divided into many patches

 14:   Level: intermediate

 16: .seealso: `DM`, `DMPatchCreate()`, `DMPatchSolve()`, `DMPatchZoom()`, `DMPatchGetPatchSize()`, `DMPatchSetPatchSize()`,
 17:           `DMPatchGetCommSize()`, `DMPatchSetCommSize()`, `DMPatchGetCoarse()`, `DMPatchCreateGrid()`
 18: S*/
 19: PETSC_EXTERN PetscErrorCode DMPatchCreate(MPI_Comm, DM *);

 21: PETSC_EXTERN PetscErrorCode DMPatchZoom(DM, MatStencil, MatStencil, MPI_Comm, DM *, PetscSF *, PetscSF *);
 22: PETSC_EXTERN PetscErrorCode DMPatchSolve(DM);
 23: PETSC_EXTERN PetscErrorCode DMPatchGetPatchSize(DM, MatStencil *);
 24: PETSC_EXTERN PetscErrorCode DMPatchSetPatchSize(DM, MatStencil);
 25: PETSC_EXTERN PetscErrorCode DMPatchGetCommSize(DM, MatStencil *);
 26: PETSC_EXTERN PetscErrorCode DMPatchSetCommSize(DM, MatStencil);
 27: PETSC_EXTERN PetscErrorCode DMPatchGetCoarse(DM, DM *);
 28: PETSC_EXTERN PetscErrorCode DMPatchCreateGrid(MPI_Comm, PetscInt, MatStencil, MatStencil, MatStencil, DM *);

 30: /*
 31:  * We want each patch to consist of an entire DM, DMDA at first
 32:  - We cannot afford to store much more than the data from a single patch in memory
 33:    - No global PetscSection, only PetscLayout
 34:    - Optional scatters
 35:    * There is a storable coarse level, which will also be a traditional DM (DMDA here)
 36:    * The local and global vectors correspond to a ghosted patch
 37:  * Need a way to activate a patch
 38:    * Jack in sizes for l/g vectors
 39:  - Need routine for viewing a full global vector
 40:  - Jed handles solver
 41: */