1 /* Portions of this code are under: 2 Copyright (c) 2022 Advanced Micro Devices, Inc. All rights reserved. 3 */ 4 #include <petsc/private/matimpl.h> 5 6 const char *MatOptions_Shifted[] = {"UNUSED_NONZERO_LOCATION_ERR", "ROW_ORIENTED", "NOT_A_VALID_OPTION", "SYMMETRIC", "STRUCTURALLY_SYMMETRIC", "FORCE_DIAGONAL_ENTRIES", "IGNORE_OFF_PROC_ENTRIES", "USE_HASH_TABLE", "KEEP_NONZERO_PATTERN", "IGNORE_ZERO_ENTRIES", "USE_INODES", "HERMITIAN", "SYMMETRY_ETERNAL", "NEW_NONZERO_LOCATION_ERR", "IGNORE_LOWER_TRIANGULAR", "ERROR_LOWER_TRIANGULAR", "GETROW_UPPERTRIANGULAR", "SPD", "NO_OFF_PROC_ZERO_ROWS", "NO_OFF_PROC_ENTRIES", "NEW_NONZERO_LOCATIONS", "NEW_NONZERO_ALLOCATION_ERR", "SUBSET_OFF_PROC_ENTRIES", "SUBMAT_SINGLEIS", "STRUCTURE_ONLY", "SORTED_FULL", "FORM_EXPLICIT_TRANSPOSE", "STRUCTURAL_SYMMETRY_ETERNAL", "SPD_ETERNAL", "MatOption", "MAT_", NULL}; 7 const char *const *MatOptions = MatOptions_Shifted + 2; 8 const char *const MatFactorShiftTypes[] = {"NONE", "NONZERO", "POSITIVE_DEFINITE", "INBLOCKS", "MatFactorShiftType", "PC_FACTOR_", NULL}; 9 const char *const MatStructures[] = {"DIFFERENT", "SUBSET", "SAME", "UNKNOWN", "MatStructure", "MAT_STRUCTURE_", NULL}; 10 const char *const MatFactorShiftTypesDetail[] = {NULL, "diagonal shift to prevent zero pivot", "Manteuffel shift", "diagonal shift on blocks to prevent zero pivot"}; 11 const char *const MPPTScotchStrategyTypes[] = {"DEFAULT", "QUALITY", "SPEED", "BALANCE", "SAFETY", "SCALABILITY", "MPPTScotchStrategyType", "MP_PTSCOTCH_", NULL}; 12 const char *const MPChacoGlobalTypes[] = {"", "MULTILEVEL", "SPECTRAL", "", "LINEAR", "RANDOM", "SCATTERED", "MPChacoGlobalType", "MP_CHACO_", NULL}; 13 const char *const MPChacoLocalTypes[] = {"", "KERNIGHAN", "NONE", "MPChacoLocalType", "MP_CHACO_", NULL}; 14 const char *const MPChacoEigenTypes[] = {"LANCZOS", "RQI", "MPChacoEigenType", "MP_CHACO_", NULL}; 15 16 extern PetscErrorCode MatMFFDInitializePackage(void); 17 extern PetscErrorCode MatSolverTypeDestroy(void); 18 static PetscBool MatPackageInitialized = PETSC_FALSE; 19 /*@C 20 MatFinalizePackage - This function destroys everything in the Petsc interface to the `Mat` package. It is 21 called from `PetscFinalize()`. 22 23 Level: developer 24 25 .seealso: `Mat`, `PetscFinalize()`, `MatInitializePackage()` 26 @*/ 27 PetscErrorCode MatFinalizePackage(void) 28 { 29 MatRootName nnames, names = MatRootNameList; 30 31 PetscFunctionBegin; 32 PetscCall(MatSolverTypeDestroy()); 33 while (names) { 34 nnames = names->next; 35 PetscCall(PetscFree(names->rname)); 36 PetscCall(PetscFree(names->sname)); 37 PetscCall(PetscFree(names->mname)); 38 PetscCall(PetscFree(names)); 39 names = nnames; 40 } 41 PetscCall(PetscFunctionListDestroy(&MatList)); 42 PetscCall(PetscFunctionListDestroy(&MatOrderingList)); 43 PetscCall(PetscFunctionListDestroy(&MatColoringList)); 44 PetscCall(PetscFunctionListDestroy(&MatPartitioningList)); 45 PetscCall(PetscFunctionListDestroy(&MatCoarsenList)); 46 MatRootNameList = NULL; 47 MatPackageInitialized = PETSC_FALSE; 48 MatRegisterAllCalled = PETSC_FALSE; 49 MatOrderingRegisterAllCalled = PETSC_FALSE; 50 MatColoringRegisterAllCalled = PETSC_FALSE; 51 MatPartitioningRegisterAllCalled = PETSC_FALSE; 52 MatCoarsenRegisterAllCalled = PETSC_FALSE; 53 /* this is not ideal because it exposes SeqAIJ implementation details directly into the base Mat code */ 54 PetscCall(PetscFunctionListDestroy(&MatSeqAIJList)); 55 MatSeqAIJRegisterAllCalled = PETSC_FALSE; 56 PetscFunctionReturn(PETSC_SUCCESS); 57 } 58 59 #if defined(PETSC_HAVE_CUDA) 60 PETSC_INTERN PetscErrorCode MatSolverTypeRegister_DENSECUDA(void); 61 #endif 62 63 #if defined(PETSC_HAVE_HIP) 64 PETSC_INTERN PetscErrorCode MatSolverTypeRegister_DENSEHIP(void); 65 #endif 66 67 #if defined(PETSC_HAVE_MUMPS) 68 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_MUMPS(void); 69 #endif 70 #if defined(PETSC_HAVE_CUDA) 71 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_CUSPARSE(void); 72 #endif 73 #if defined(PETSC_HAVE_HIP) 74 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_HIPSPARSE(void); 75 #endif 76 #if defined(PETSC_HAVE_KOKKOS_KERNELS) 77 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_KOKKOS(void); 78 #endif 79 #if defined(PETSC_HAVE_VIENNACL) 80 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_ViennaCL(void); 81 #endif 82 #if defined(PETSC_HAVE_ELEMENTAL) 83 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_Elemental(void); 84 #endif 85 #if defined(PETSC_HAVE_SCALAPACK) 86 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_ScaLAPACK(void); 87 #endif 88 #if defined(PETSC_HAVE_MATLAB) 89 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_Matlab(void); 90 #endif 91 #if defined(PETSC_HAVE_ESSL) 92 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_Essl(void); 93 #endif 94 #if defined(PETSC_HAVE_SUPERLU) 95 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_SuperLU(void); 96 #endif 97 #if defined(PETSC_HAVE_STRUMPACK) 98 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_STRUMPACK(void); 99 #endif 100 #if defined(PETSC_HAVE_PASTIX) 101 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_Pastix(void); 102 #endif 103 #if defined(PETSC_HAVE_SUPERLU_DIST) 104 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_SuperLU_DIST(void); 105 #endif 106 #if defined(PETSC_HAVE_ELEMENTAL) 107 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_SparseElemental(void); 108 #endif 109 #if defined(PETSC_HAVE_MKL_PARDISO) 110 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_MKL_Pardiso(void); 111 #endif 112 #if defined(PETSC_HAVE_MKL_CPARDISO) 113 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_MKL_CPardiso(void); 114 #endif 115 #if defined(PETSC_HAVE_SUITESPARSE) 116 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_SuiteSparse(void); 117 #endif 118 #if defined(PETSC_HAVE_LUSOL) 119 PETSC_EXTERN PetscErrorCode MatSolverTypeRegister_Lusol(void); 120 #endif 121 122 PETSC_INTERN PetscErrorCode MatGetFactor_seqaij_petsc(Mat, MatFactorType, Mat *); 123 PETSC_INTERN PetscErrorCode MatGetFactor_seqbaij_petsc(Mat, MatFactorType, Mat *); 124 PETSC_INTERN PetscErrorCode MatGetFactor_seqsbaij_petsc(Mat, MatFactorType, Mat *); 125 PETSC_INTERN PetscErrorCode MatGetFactor_seqdense_petsc(Mat, MatFactorType, Mat *); 126 #if defined(PETSC_HAVE_CUDA) 127 PETSC_INTERN PetscErrorCode MatGetFactor_seqdense_cuda(Mat, MatFactorType, Mat *); 128 #endif 129 #if defined(PETSC_HAVE_HIP) 130 PETSC_INTERN PetscErrorCode MatGetFactor_seqdense_hip(Mat, MatFactorType, Mat *); 131 #endif 132 PETSC_INTERN PetscErrorCode MatGetFactor_constantdiagonal_petsc(Mat, MatFactorType, Mat *); 133 PETSC_INTERN PetscErrorCode MatGetFactor_seqaij_bas(Mat, MatFactorType, Mat *); 134 135 /*@C 136 MatInitializePackage - This function initializes everything in the `Mat` package. It is called 137 from `PetscDLLibraryRegister_petscmat()` when using dynamic libraries, and on the first call to `MatCreate()` 138 when using shared or static libraries. 139 140 Level: developer 141 142 .seealso: [](chapter_matrices), `Mat`, `PetscInitialize()`, `MatFinalizePackage()` 143 @*/ 144 PetscErrorCode MatInitializePackage(void) 145 { 146 char logList[256]; 147 PetscBool opt, pkg; 148 149 PetscFunctionBegin; 150 if (MatPackageInitialized) PetscFunctionReturn(PETSC_SUCCESS); 151 MatPackageInitialized = PETSC_TRUE; 152 /* Initialize subpackage */ 153 PetscCall(MatMFFDInitializePackage()); 154 /* Register Classes */ 155 PetscCall(PetscClassIdRegister("Matrix", &MAT_CLASSID)); 156 PetscCall(PetscClassIdRegister("Matrix FD Coloring", &MAT_FDCOLORING_CLASSID)); 157 PetscCall(PetscClassIdRegister("Matrix Coloring", &MAT_COLORING_CLASSID)); 158 PetscCall(PetscClassIdRegister("Matrix MatTranspose Coloring", &MAT_TRANSPOSECOLORING_CLASSID)); 159 PetscCall(PetscClassIdRegister("Matrix Partitioning", &MAT_PARTITIONING_CLASSID)); 160 PetscCall(PetscClassIdRegister("Matrix Coarsen", &MAT_COARSEN_CLASSID)); 161 PetscCall(PetscClassIdRegister("Matrix Null Space", &MAT_NULLSPACE_CLASSID)); 162 /* Register Constructors */ 163 PetscCall(MatRegisterAll()); 164 PetscCall(MatOrderingRegisterAll()); 165 PetscCall(MatColoringRegisterAll()); 166 PetscCall(MatPartitioningRegisterAll()); 167 PetscCall(MatCoarsenRegisterAll()); 168 PetscCall(MatSeqAIJRegisterAll()); 169 /* Register Events */ 170 PetscCall(PetscLogEventRegister("MatMult", MAT_CLASSID, &MAT_Mult)); 171 PetscCall(PetscLogEventRegister("MatMults", MAT_CLASSID, &MAT_Mults)); 172 PetscCall(PetscLogEventRegister("MatMultAdd", MAT_CLASSID, &MAT_MultAdd)); 173 PetscCall(PetscLogEventRegister("MatMultTranspose", MAT_CLASSID, &MAT_MultTranspose)); 174 PetscCall(PetscLogEventRegister("MatMultHermitian", MAT_CLASSID, &MAT_MultHermitianTranspose)); 175 PetscCall(PetscLogEventRegister("MatMultTrAdd", MAT_CLASSID, &MAT_MultTransposeAdd)); 176 PetscCall(PetscLogEventRegister("MatMultHTAdd", MAT_CLASSID, &MAT_MultHermitianTransposeAdd)); 177 PetscCall(PetscLogEventRegister("MatSolve", MAT_CLASSID, &MAT_Solve)); 178 PetscCall(PetscLogEventRegister("MatSolves", MAT_CLASSID, &MAT_Solves)); 179 PetscCall(PetscLogEventRegister("MatSolveAdd", MAT_CLASSID, &MAT_SolveAdd)); 180 PetscCall(PetscLogEventRegister("MatSolveTranspos", MAT_CLASSID, &MAT_SolveTranspose)); 181 PetscCall(PetscLogEventRegister("MatSolveTrAdd", MAT_CLASSID, &MAT_SolveTransposeAdd)); 182 PetscCall(PetscLogEventRegister("MatSOR", MAT_CLASSID, &MAT_SOR)); 183 PetscCall(PetscLogEventRegister("MatForwardSolve", MAT_CLASSID, &MAT_ForwardSolve)); 184 PetscCall(PetscLogEventRegister("MatBackwardSolve", MAT_CLASSID, &MAT_BackwardSolve)); 185 PetscCall(PetscLogEventRegister("MatLUFactor", MAT_CLASSID, &MAT_LUFactor)); 186 PetscCall(PetscLogEventRegister("MatLUFactorSym", MAT_CLASSID, &MAT_LUFactorSymbolic)); 187 PetscCall(PetscLogEventRegister("MatLUFactorNum", MAT_CLASSID, &MAT_LUFactorNumeric)); 188 PetscCall(PetscLogEventRegister("MatQRFactor", MAT_CLASSID, &MAT_QRFactor)); 189 PetscCall(PetscLogEventRegister("MatQRFactorSym", MAT_CLASSID, &MAT_QRFactorSymbolic)); 190 PetscCall(PetscLogEventRegister("MatQRFactorNum", MAT_CLASSID, &MAT_QRFactorNumeric)); 191 PetscCall(PetscLogEventRegister("MatCholeskyFctr", MAT_CLASSID, &MAT_CholeskyFactor)); 192 PetscCall(PetscLogEventRegister("MatCholFctrSym", MAT_CLASSID, &MAT_CholeskyFactorSymbolic)); 193 PetscCall(PetscLogEventRegister("MatCholFctrNum", MAT_CLASSID, &MAT_CholeskyFactorNumeric)); 194 PetscCall(PetscLogEventRegister("MatFctrFactSchur", MAT_CLASSID, &MAT_FactorFactS)); 195 PetscCall(PetscLogEventRegister("MatFctrInvSchur", MAT_CLASSID, &MAT_FactorInvS)); 196 PetscCall(PetscLogEventRegister("MatILUFactor", MAT_CLASSID, &MAT_ILUFactor)); 197 PetscCall(PetscLogEventRegister("MatILUFactorSym", MAT_CLASSID, &MAT_ILUFactorSymbolic)); 198 PetscCall(PetscLogEventRegister("MatICCFactorSym", MAT_CLASSID, &MAT_ICCFactorSymbolic)); 199 PetscCall(PetscLogEventRegister("MatCopy", MAT_CLASSID, &MAT_Copy)); 200 PetscCall(PetscLogEventRegister("MatConvert", MAT_CLASSID, &MAT_Convert)); 201 PetscCall(PetscLogEventRegister("MatScale", MAT_CLASSID, &MAT_Scale)); 202 PetscCall(PetscLogEventRegister("MatResidual", MAT_CLASSID, &MAT_Residual)); 203 PetscCall(PetscLogEventRegister("MatAssemblyBegin", MAT_CLASSID, &MAT_AssemblyBegin)); 204 PetscCall(PetscLogEventRegister("MatAssemblyEnd", MAT_CLASSID, &MAT_AssemblyEnd)); 205 PetscCall(PetscLogEventRegister("MatSetValues", MAT_CLASSID, &MAT_SetValues)); 206 PetscCall(PetscLogEventRegister("MatGetValues", MAT_CLASSID, &MAT_GetValues)); 207 PetscCall(PetscLogEventRegister("MatGetRow", MAT_CLASSID, &MAT_GetRow)); 208 PetscCall(PetscLogEventRegister("MatGetRowIJ", MAT_CLASSID, &MAT_GetRowIJ)); 209 PetscCall(PetscLogEventRegister("MatCreateSubMats", MAT_CLASSID, &MAT_CreateSubMats)); 210 PetscCall(PetscLogEventRegister("MatCreateSubMat", MAT_CLASSID, &MAT_CreateSubMat)); 211 PetscCall(PetscLogEventRegister("MatGetOrdering", MAT_CLASSID, &MAT_GetOrdering)); 212 PetscCall(PetscLogEventRegister("MatIncreaseOvrlp", MAT_CLASSID, &MAT_IncreaseOverlap)); 213 PetscCall(PetscLogEventRegister("MatPartitioning", MAT_PARTITIONING_CLASSID, &MAT_Partitioning)); 214 PetscCall(PetscLogEventRegister("MatPartitioningND", MAT_PARTITIONING_CLASSID, &MAT_PartitioningND)); 215 PetscCall(PetscLogEventRegister("MatCoarsen", MAT_COARSEN_CLASSID, &MAT_Coarsen)); 216 PetscCall(PetscLogEventRegister("MatZeroEntries", MAT_CLASSID, &MAT_ZeroEntries)); 217 PetscCall(PetscLogEventRegister("MatLoad", MAT_CLASSID, &MAT_Load)); 218 PetscCall(PetscLogEventRegister("MatView", MAT_CLASSID, &MAT_View)); 219 PetscCall(PetscLogEventRegister("MatAXPY", MAT_CLASSID, &MAT_AXPY)); 220 PetscCall(PetscLogEventRegister("MatFDColorCreate", MAT_FDCOLORING_CLASSID, &MAT_FDColoringCreate)); 221 PetscCall(PetscLogEventRegister("MatFDColorSetUp", MAT_FDCOLORING_CLASSID, &MAT_FDColoringSetUp)); 222 PetscCall(PetscLogEventRegister("MatFDColorApply", MAT_FDCOLORING_CLASSID, &MAT_FDColoringApply)); 223 PetscCall(PetscLogEventRegister("MatFDColorFunc", MAT_FDCOLORING_CLASSID, &MAT_FDColoringFunction)); 224 PetscCall(PetscLogEventRegister("MatTranspose", MAT_CLASSID, &MAT_Transpose)); 225 PetscCall(PetscLogEventRegister("MatMatSolve", MAT_CLASSID, &MAT_MatSolve)); 226 PetscCall(PetscLogEventRegister("MatMatTrSolve", MAT_CLASSID, &MAT_MatTrSolve)); 227 PetscCall(PetscLogEventRegister("MatMatMultSym", MAT_CLASSID, &MAT_MatMultSymbolic)); 228 PetscCall(PetscLogEventRegister("MatMatMultNum", MAT_CLASSID, &MAT_MatMultNumeric)); 229 PetscCall(PetscLogEventRegister("MatMatMatMultSym", MAT_CLASSID, &MAT_MatMatMultSymbolic)); 230 PetscCall(PetscLogEventRegister("MatMatMatMultNum", MAT_CLASSID, &MAT_MatMatMultNumeric)); 231 PetscCall(PetscLogEventRegister("MatPtAPSymbolic", MAT_CLASSID, &MAT_PtAPSymbolic)); 232 PetscCall(PetscLogEventRegister("MatPtAPNumeric", MAT_CLASSID, &MAT_PtAPNumeric)); 233 PetscCall(PetscLogEventRegister("MatRARtSym", MAT_CLASSID, &MAT_RARtSymbolic)); 234 PetscCall(PetscLogEventRegister("MatRARtNum", MAT_CLASSID, &MAT_RARtNumeric)); 235 PetscCall(PetscLogEventRegister("MatMatTrnMultSym", MAT_CLASSID, &MAT_MatTransposeMultSymbolic)); 236 PetscCall(PetscLogEventRegister("MatMatTrnMultNum", MAT_CLASSID, &MAT_MatTransposeMultNumeric)); 237 PetscCall(PetscLogEventRegister("MatTrnMatMultSym", MAT_CLASSID, &MAT_TransposeMatMultSymbolic)); 238 PetscCall(PetscLogEventRegister("MatTrnMatMultNum", MAT_CLASSID, &MAT_TransposeMatMultNumeric)); 239 PetscCall(PetscLogEventRegister("MatTrnColorCreate", MAT_CLASSID, &MAT_TransposeColoringCreate)); 240 PetscCall(PetscLogEventRegister("MatRedundantMat", MAT_CLASSID, &MAT_RedundantMat)); 241 PetscCall(PetscLogEventRegister("MatGetSeqNZStrct", MAT_CLASSID, &MAT_GetSeqNonzeroStructure)); 242 PetscCall(PetscLogEventRegister("MatGetMultiProcB", MAT_CLASSID, &MAT_GetMultiProcBlock)); 243 PetscCall(PetscLogEventRegister("MatSetRandom", MAT_CLASSID, &MAT_SetRandom)); 244 245 /* these may be specific to MPIAIJ matrices */ 246 PetscCall(PetscLogEventRegister("MatMPISumSeqNumeric", MAT_CLASSID, &MAT_Seqstompinum)); 247 PetscCall(PetscLogEventRegister("MatMPISumSeqSymbolic", MAT_CLASSID, &MAT_Seqstompisym)); 248 PetscCall(PetscLogEventRegister("MatMPISumSeq", MAT_CLASSID, &MAT_Seqstompi)); 249 PetscCall(PetscLogEventRegister("MatMPIConcateSeq", MAT_CLASSID, &MAT_Merge)); 250 PetscCall(PetscLogEventRegister("MatGetLocalMat", MAT_CLASSID, &MAT_Getlocalmat)); 251 PetscCall(PetscLogEventRegister("MatGetLocalMatCondensed", MAT_CLASSID, &MAT_Getlocalmatcondensed)); 252 PetscCall(PetscLogEventRegister("MatGetBrowsOfAcols", MAT_CLASSID, &MAT_GetBrowsOfAcols)); 253 PetscCall(PetscLogEventRegister("MatGetBrAoCol", MAT_CLASSID, &MAT_GetBrowsOfAocols)); 254 255 PetscCall(PetscLogEventRegister("MatApplyPAPt_Symbolic", MAT_CLASSID, &MAT_Applypapt_symbolic)); 256 PetscCall(PetscLogEventRegister("MatApplyPAPt_Numeric", MAT_CLASSID, &MAT_Applypapt_numeric)); 257 PetscCall(PetscLogEventRegister("MatApplyPAPt", MAT_CLASSID, &MAT_Applypapt)); 258 259 PetscCall(PetscLogEventRegister("MatGetSymTrans", MAT_CLASSID, &MAT_Getsymtranspose)); 260 PetscCall(PetscLogEventRegister("MatGetSymTransR", MAT_CLASSID, &MAT_Getsymtransreduced)); 261 PetscCall(PetscLogEventRegister("MatCUSPARSCopyTo", MAT_CLASSID, &MAT_CUSPARSECopyToGPU)); 262 PetscCall(PetscLogEventRegister("MatCUSPARSCopyFr", MAT_CLASSID, &MAT_CUSPARSECopyFromGPU)); 263 PetscCall(PetscLogEventRegister("MatCUSPARSSolAnl", MAT_CLASSID, &MAT_CUSPARSESolveAnalysis)); 264 PetscCall(PetscLogEventRegister("MatCUSPARSGenT", MAT_CLASSID, &MAT_CUSPARSEGenerateTranspose)); 265 PetscCall(PetscLogEventRegister("MatHIPSPARSCopyTo", MAT_CLASSID, &MAT_HIPSPARSECopyToGPU)); 266 PetscCall(PetscLogEventRegister("MatHIPSPARSCopyFr", MAT_CLASSID, &MAT_HIPSPARSECopyFromGPU)); 267 PetscCall(PetscLogEventRegister("MatHIPSPARSSolAnl", MAT_CLASSID, &MAT_HIPSPARSESolveAnalysis)); 268 PetscCall(PetscLogEventRegister("MatHIPSPARSGenT", MAT_CLASSID, &MAT_HIPSPARSEGenerateTranspose)); 269 PetscCall(PetscLogEventRegister("MatVCLCopyTo", MAT_CLASSID, &MAT_ViennaCLCopyToGPU)); 270 PetscCall(PetscLogEventRegister("MatDenseCopyTo", MAT_CLASSID, &MAT_DenseCopyToGPU)); 271 PetscCall(PetscLogEventRegister("MatDenseCopyFrom", MAT_CLASSID, &MAT_DenseCopyFromGPU)); 272 PetscCall(PetscLogEventRegister("MatSetValBatch", MAT_CLASSID, &MAT_SetValuesBatch)); 273 274 PetscCall(PetscLogEventRegister("MatColoringApply", MAT_COLORING_CLASSID, &MATCOLORING_Apply)); 275 PetscCall(PetscLogEventRegister("MatColoringComm", MAT_COLORING_CLASSID, &MATCOLORING_Comm)); 276 PetscCall(PetscLogEventRegister("MatColoringLocal", MAT_COLORING_CLASSID, &MATCOLORING_Local)); 277 PetscCall(PetscLogEventRegister("MatColoringIS", MAT_COLORING_CLASSID, &MATCOLORING_ISCreate)); 278 PetscCall(PetscLogEventRegister("MatColoringSetUp", MAT_COLORING_CLASSID, &MATCOLORING_SetUp)); 279 PetscCall(PetscLogEventRegister("MatColoringWeights", MAT_COLORING_CLASSID, &MATCOLORING_Weights)); 280 281 PetscCall(PetscLogEventRegister("MatSetPreallCOO", MAT_CLASSID, &MAT_PreallCOO)); 282 PetscCall(PetscLogEventRegister("MatSetValuesCOO", MAT_CLASSID, &MAT_SetVCOO)); 283 284 PetscCall(PetscLogEventRegister("MatH2OpusBuild", MAT_CLASSID, &MAT_H2Opus_Build)); 285 PetscCall(PetscLogEventRegister("MatH2OpusComp", MAT_CLASSID, &MAT_H2Opus_Compress)); 286 PetscCall(PetscLogEventRegister("MatH2OpusOrth", MAT_CLASSID, &MAT_H2Opus_Orthog)); 287 PetscCall(PetscLogEventRegister("MatH2OpusLR", MAT_CLASSID, &MAT_H2Opus_LR)); 288 289 /* Mark non-collective events */ 290 PetscCall(PetscLogEventSetCollective(MAT_SetValues, PETSC_FALSE)); 291 PetscCall(PetscLogEventSetCollective(MAT_SetValuesBatch, PETSC_FALSE)); 292 PetscCall(PetscLogEventSetCollective(MAT_GetRow, PETSC_FALSE)); 293 /* Turn off high traffic events by default */ 294 PetscCall(PetscLogEventSetActiveAll(MAT_SetValues, PETSC_FALSE)); 295 PetscCall(PetscLogEventSetActiveAll(MAT_GetValues, PETSC_FALSE)); 296 PetscCall(PetscLogEventSetActiveAll(MAT_GetRow, PETSC_FALSE)); 297 /* Process Info */ 298 { 299 PetscClassId classids[7]; 300 301 classids[0] = MAT_CLASSID; 302 classids[1] = MAT_FDCOLORING_CLASSID; 303 classids[2] = MAT_COLORING_CLASSID; 304 classids[3] = MAT_TRANSPOSECOLORING_CLASSID; 305 classids[4] = MAT_PARTITIONING_CLASSID; 306 classids[5] = MAT_COARSEN_CLASSID; 307 classids[6] = MAT_NULLSPACE_CLASSID; 308 PetscCall(PetscInfoProcessClass("mat", 7, classids)); 309 } 310 311 /* Process summary exclusions */ 312 PetscCall(PetscOptionsGetString(NULL, NULL, "-log_exclude", logList, sizeof(logList), &opt)); 313 if (opt) { 314 PetscCall(PetscStrInList("mat", logList, ',', &pkg)); 315 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_CLASSID)); 316 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_FDCOLORING_CLASSID)); 317 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_COLORING_CLASSID)); 318 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_TRANSPOSECOLORING_CLASSID)); 319 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_PARTITIONING_CLASSID)); 320 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_COARSEN_CLASSID)); 321 if (pkg) PetscCall(PetscLogEventExcludeClass(MAT_NULLSPACE_CLASSID)); 322 } 323 324 /* Register the PETSc built in factorization based solvers */ 325 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJ, MAT_FACTOR_LU, MatGetFactor_seqaij_petsc)); 326 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJ, MAT_FACTOR_CHOLESKY, MatGetFactor_seqaij_petsc)); 327 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJ, MAT_FACTOR_ILU, MatGetFactor_seqaij_petsc)); 328 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJ, MAT_FACTOR_ICC, MatGetFactor_seqaij_petsc)); 329 330 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJPERM, MAT_FACTOR_LU, MatGetFactor_seqaij_petsc)); 331 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJPERM, MAT_FACTOR_CHOLESKY, MatGetFactor_seqaij_petsc)); 332 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJPERM, MAT_FACTOR_ILU, MatGetFactor_seqaij_petsc)); 333 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJPERM, MAT_FACTOR_ICC, MatGetFactor_seqaij_petsc)); 334 335 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATCONSTANTDIAGONAL, MAT_FACTOR_LU, MatGetFactor_constantdiagonal_petsc)); 336 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATCONSTANTDIAGONAL, MAT_FACTOR_CHOLESKY, MatGetFactor_constantdiagonal_petsc)); 337 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATCONSTANTDIAGONAL, MAT_FACTOR_ILU, MatGetFactor_constantdiagonal_petsc)); 338 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATCONSTANTDIAGONAL, MAT_FACTOR_ICC, MatGetFactor_constantdiagonal_petsc)); 339 340 #if defined(PETSC_HAVE_MKL_SPARSE) 341 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJMKL, MAT_FACTOR_LU, MatGetFactor_seqaij_petsc)); 342 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJMKL, MAT_FACTOR_CHOLESKY, MatGetFactor_seqaij_petsc)); 343 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJMKL, MAT_FACTOR_ILU, MatGetFactor_seqaij_petsc)); 344 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJMKL, MAT_FACTOR_ICC, MatGetFactor_seqaij_petsc)); 345 346 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJMKL, MAT_FACTOR_LU, MatGetFactor_seqbaij_petsc)); 347 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJMKL, MAT_FACTOR_CHOLESKY, MatGetFactor_seqbaij_petsc)); 348 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJMKL, MAT_FACTOR_ILU, MatGetFactor_seqbaij_petsc)); 349 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJMKL, MAT_FACTOR_ICC, MatGetFactor_seqbaij_petsc)); 350 #endif 351 /* Above, we register the PETSc built-in factorization solvers for MATSEQAIJMKL. In the future, we may want to use 352 * some of the MKL-provided ones instead. */ 353 354 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJCRL, MAT_FACTOR_LU, MatGetFactor_seqaij_petsc)); 355 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJCRL, MAT_FACTOR_CHOLESKY, MatGetFactor_seqaij_petsc)); 356 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJCRL, MAT_FACTOR_ILU, MatGetFactor_seqaij_petsc)); 357 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQAIJCRL, MAT_FACTOR_ICC, MatGetFactor_seqaij_petsc)); 358 359 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJ, MAT_FACTOR_LU, MatGetFactor_seqbaij_petsc)); 360 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJ, MAT_FACTOR_CHOLESKY, MatGetFactor_seqbaij_petsc)); 361 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJ, MAT_FACTOR_ILU, MatGetFactor_seqbaij_petsc)); 362 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQBAIJ, MAT_FACTOR_ICC, MatGetFactor_seqbaij_petsc)); 363 364 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQSBAIJ, MAT_FACTOR_CHOLESKY, MatGetFactor_seqsbaij_petsc)); 365 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQSBAIJ, MAT_FACTOR_ICC, MatGetFactor_seqsbaij_petsc)); 366 367 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQDENSE, MAT_FACTOR_LU, MatGetFactor_seqdense_petsc)); 368 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQDENSE, MAT_FACTOR_ILU, MatGetFactor_seqdense_petsc)); 369 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQDENSE, MAT_FACTOR_CHOLESKY, MatGetFactor_seqdense_petsc)); 370 PetscCall(MatSolverTypeRegister(MATSOLVERPETSC, MATSEQDENSE, MAT_FACTOR_QR, MatGetFactor_seqdense_petsc)); 371 #if defined(PETSC_HAVE_CUDA) 372 PetscCall(MatSolverTypeRegister_DENSECUDA()); 373 #endif 374 #if defined(PETSC_HAVE_HIP) 375 PetscCall(MatSolverTypeRegister_DENSEHIP()); 376 #endif 377 378 PetscCall(MatSolverTypeRegister(MATSOLVERBAS, MATSEQAIJ, MAT_FACTOR_ICC, MatGetFactor_seqaij_bas)); 379 380 /* 381 Register the external package factorization based solvers 382 Eventually we don't want to have these hardwired here at compile time of PETSc 383 */ 384 #if defined(PETSC_HAVE_MUMPS) 385 PetscCall(MatSolverTypeRegister_MUMPS()); 386 #endif 387 #if defined(PETSC_HAVE_CUDA) 388 PetscCall(MatSolverTypeRegister_CUSPARSE()); 389 #endif 390 #if defined(PETSC_HAVE_HIP) 391 PetscCall(MatSolverTypeRegister_HIPSPARSE()); 392 #endif 393 #if defined(PETSC_HAVE_KOKKOS_KERNELS) 394 PetscCall(MatSolverTypeRegister_KOKKOS()); 395 #endif 396 #if defined(PETSC_HAVE_VIENNACL) 397 PetscCall(MatSolverTypeRegister_ViennaCL()); 398 #endif 399 #if defined(PETSC_HAVE_ELEMENTAL) 400 PetscCall(MatSolverTypeRegister_Elemental()); 401 #endif 402 #if defined(PETSC_HAVE_SCALAPACK) 403 PetscCall(MatSolverTypeRegister_ScaLAPACK()); 404 #endif 405 #if defined(PETSC_HAVE_MATLAB) 406 PetscCall(MatSolverTypeRegister_Matlab()); 407 #endif 408 #if defined(PETSC_HAVE_ESSL) 409 PetscCall(MatSolverTypeRegister_Essl()); 410 #endif 411 #if defined(PETSC_HAVE_SUPERLU) 412 PetscCall(MatSolverTypeRegister_SuperLU()); 413 #endif 414 #if defined(PETSC_HAVE_STRUMPACK) 415 PetscCall(MatSolverTypeRegister_STRUMPACK()); 416 #endif 417 #if defined(PETSC_HAVE_PASTIX) 418 PetscCall(MatSolverTypeRegister_Pastix()); 419 #endif 420 #if defined(PETSC_HAVE_SUPERLU_DIST) 421 PetscCall(MatSolverTypeRegister_SuperLU_DIST()); 422 #endif 423 #if defined(PETSC_HAVE_ELEMENTAL) 424 PetscCall(MatSolverTypeRegister_SparseElemental()); 425 #endif 426 #if defined(PETSC_HAVE_MKL_PARDISO) 427 PetscCall(MatSolverTypeRegister_MKL_Pardiso()); 428 #endif 429 #if defined(PETSC_HAVE_MKL_CPARDISO) 430 PetscCall(MatSolverTypeRegister_MKL_CPardiso()); 431 #endif 432 #if defined(PETSC_HAVE_SUITESPARSE) 433 PetscCall(MatSolverTypeRegister_SuiteSparse()); 434 #endif 435 #if defined(PETSC_HAVE_LUSOL) 436 PetscCall(MatSolverTypeRegister_Lusol()); 437 #endif 438 /* Register package finalizer */ 439 PetscCall(PetscRegisterFinalize(MatFinalizePackage)); 440 PetscFunctionReturn(PETSC_SUCCESS); 441 } 442 443 #if defined(PETSC_HAVE_DYNAMIC_LIBRARIES) 444 /* 445 PetscDLLibraryRegister - This function is called when the dynamic library it is in is opened. 446 447 This one registers all the matrix methods that are in the basic PETSc Matrix library. 448 449 */ 450 PETSC_EXTERN PetscErrorCode PetscDLLibraryRegister_petscmat(void) 451 { 452 PetscFunctionBegin; 453 PetscCall(MatInitializePackage()); 454 PetscFunctionReturn(PETSC_SUCCESS); 455 } 456 457 #endif /* PETSC_HAVE_DYNAMIC_LIBRARIES */ 458