1: #pragma once
  2: #include <petscksp.h>
  3: #include <petsc/private/pcimpl.h>
  4: #include <petsc/private/pcmgimpl.h>
  5: #include <petscmatcoarsen.h>
  6: #include <petsc/private/matimpl.h>

  8: struct _PCGAMGOps {
  9:   PetscErrorCode (*creategraph)(PC, Mat, Mat *);
 10:   PetscErrorCode (*coarsen)(PC, Mat *, PetscCoarsenData **);
 11:   PetscErrorCode (*prolongator)(PC, Mat, PetscCoarsenData *, Mat *);
 12:   PetscErrorCode (*optprolongator)(PC, Mat, Mat *);
 13:   PetscErrorCode (*createlevel)(PC, Mat, PetscInt, Mat *, Mat *, PetscMPIInt *, IS *, PetscBool);
 14:   PetscErrorCode (*createdefaultdata)(PC, Mat); /* for data methods that have a default (SA) */
 15:   PetscErrorCode (*setfromoptions)(PC, PetscOptionItems);
 16:   PetscErrorCode (*destroy)(PC);
 17:   PetscErrorCode (*view)(PC, PetscViewer);
 18: };
 19: /* Private context for the GAMG preconditioner */
 20: typedef struct gamg_TAG {
 21:   PCGAMGType       type;
 22:   PetscInt         Nlevels;
 23:   PetscBool        repart;
 24:   PetscBool        reuse_prol;
 25:   PetscBool        use_aggs_in_asm;
 26:   PetscBool        use_parallel_coarse_grid_solver;
 27:   PCGAMGLayoutType layout_type;
 28:   PetscBool        cpu_pin_coarse_grids;
 29:   PetscInt         min_eq_proc;
 30:   PetscInt         asm_hem_aggs;
 31:   MatCoarsen       asm_crs; /* used to generate ASM aggregates */
 32:   PetscInt         coarse_eq_limit;
 33:   PetscReal        threshold_scale;
 34:   PetscReal        threshold[PETSC_MG_MAXLEVELS]; /* common quantity to many AMG methods so keep it up here */
 35:   PetscInt         level_reduction_factors[PETSC_MG_MAXLEVELS];
 36:   PetscInt         current_level; /* stash construction state */
 37:   /* these 4 are all related to the method data and should be in the subctx */
 38:   PetscInt   data_sz; /* nloc*data_rows*data_cols */
 39:   PetscInt   data_cell_rows;
 40:   PetscInt   data_cell_cols;
 41:   PetscInt   orig_data_cell_rows;
 42:   PetscInt   orig_data_cell_cols;
 43:   PetscReal *data;                     /* [data_sz] blocked vector of vertex data on fine grid (coordinates/nullspace) */
 44:   PetscReal *orig_data;                /* cache data */
 45:   PetscReal  prolongator_filter;       /* base threshold for filtering the prolongator on the finest level */
 46:   PetscReal  prolongator_filter_scale; /* per-level multiplier: effective threshold on level l is prolongator_filter * prolongator_filter_scale^l */

 48:   struct _PCGAMGOps *ops;
 49:   char              *gamg_type_name;

 51:   void *subctx;

 53:   PetscBool use_sa_esteig;
 54:   PetscReal emin, emax;
 55:   PetscBool recompute_esteig;
 56:   PetscInt  injection_index_size;
 57:   PetscInt  injection_index[MAT_COARSEN_STRENGTH_INDEX_SIZE];
 58: } PC_GAMG;

 60: /* hooks create derivied classes */
 61: PetscErrorCode PCCreateGAMG_GEO(PC);
 62: PetscErrorCode PCCreateGAMG_AGG(PC);
 63: PetscErrorCode PCCreateGAMG_Classical(PC);

 65: PetscErrorCode PCDestroy_GAMG(PC);

 67: /* helper methods */
 68: PetscErrorCode PCGAMGGetDataWithGhosts(Mat, PetscInt, PetscReal[], PetscInt *, PetscReal **);

 70: enum tag {
 71:   GAMG_SETUP = 0,
 72:   GAMG_MESH,
 73:   GAMG_MATRIX,
 74:   GAMG_GRAPH,
 75:   GAMG_COARSEN,
 76:   GAMG_SQUARE,
 77:   GAMG_MIS,
 78:   GAMG_PROL,
 79:   GAMG_PROLA,
 80:   GAMG_PROLB,
 81:   GAMG_OPT,
 82:   GAMG_OPTSM,
 83:   GAMG_LEVEL,
 84:   GAMG_PTAP,
 85:   GAMG_REDUCE,
 86:   GAMG_REPART,
 87:   SET13,
 88:   SET14,
 89:   SET15,
 90:   GAMG_NUM_SET
 91: };
 92: PETSC_EXTERN PetscLogEvent petsc_gamg_setup_events[GAMG_NUM_SET];
 93: PETSC_EXTERN PetscLogEvent petsc_gamg_setup_matmat_events[PETSC_MG_MAXLEVELS][3];