xref: /petsc/src/mat/interface/dlregismat.c (revision f4db908e7a6c18ce1e61158591c338794c5acef1)
11153da11SBarry Smith #define PETSCMAT_DLL
21153da11SBarry Smith 
37c4f633dSBarry Smith #include "private/matimpl.h"
41153da11SBarry Smith 
5ea5af983SLisandro Dalcin const char *MatOptions[] = {"ROW_ORIENTED","NEW_NONZERO_LOCATIONS",
64e0d8c25SBarry Smith               "SYMMETRIC",
74e0d8c25SBarry Smith               "STRUCTURALLY_SYMMETRIC",
8dc5b3d67SBarry Smith               "NEW_DIAGONALS",
94e0d8c25SBarry Smith               "IGNORE_OFF_PROC_ENTRIES",
104e0d8c25SBarry Smith               "NEW_NONZERO_LOCATION_ERR",
11290bbb0aSBarry Smith               "NEW_NONZERO_ALLOCATION_ERR","USE_HASH_TABLE",
12290bbb0aSBarry Smith               "KEEP_ZEROED_ROWS","IGNORE_ZERO_ENTRIES","USE_INODES",
134e0d8c25SBarry Smith               "HERMITIAN",
144e0d8c25SBarry Smith               "SYMMETRY_ETERNAL",
154e0d8c25SBarry Smith               "USE_COMPRESSEDROW",
16290bbb0aSBarry Smith               "IGNORE_LOWER_TRIANGULAR","ERROR_LOWER_TRIANGULAR","GETROW_UPPERTRIANGULAR","MatOption","MAT_",0};
17*f4db908eSBarry Smith const char *MatFactorShiftTypes[] = {"NONE","NONZERO","POSITIVE_DEFINITE","INBLOCKS","MatFactorShiftType","PC_FACTOR_",0};
18290bbb0aSBarry Smith 
19e5beb14aSMatthew Knepley EXTERN PetscErrorCode PETSCMAT_DLLEXPORT MatMFFDInitializePackage(const char[]);
20b022a5c1SBarry Smith static PetscTruth MatPackageInitialized = PETSC_FALSE;
21b022a5c1SBarry Smith #undef __FUNCT__
22b022a5c1SBarry Smith #define __FUNCT__ "MatFinalizePackage"
23b022a5c1SBarry Smith /*@C
24b022a5c1SBarry Smith   MatFinalizePackage - This function destroys everything in the Petsc interface to the charactoristics package. It is
25b022a5c1SBarry Smith   called from PetscFinalize().
26b022a5c1SBarry Smith 
27b022a5c1SBarry Smith   Level: developer
28b022a5c1SBarry Smith 
29b022a5c1SBarry Smith .keywords: Petsc, destroy, package, mathematica
30b022a5c1SBarry Smith .seealso: PetscFinalize()
31b022a5c1SBarry Smith @*/
32b022a5c1SBarry Smith PetscErrorCode PETSC_DLLEXPORT MatFinalizePackage(void)
33b022a5c1SBarry Smith {
34b022a5c1SBarry Smith   PetscFunctionBegin;
35b022a5c1SBarry Smith   MatPackageInitialized            = PETSC_FALSE;
36b022a5c1SBarry Smith   MatRegisterAllCalled             = PETSC_FALSE;
37b022a5c1SBarry Smith   MatList                          = PETSC_NULL;
38b022a5c1SBarry Smith   MatOrderingRegisterAllCalled     = PETSC_FALSE;
39b022a5c1SBarry Smith   MatOrderingList                  = PETSC_NULL;
40b022a5c1SBarry Smith   MatColoringList                  = PETSC_NULL;
41b022a5c1SBarry Smith   MatColoringRegisterAllCalled     = PETSC_FALSE;
42b022a5c1SBarry Smith   MatPartitioningList              = PETSC_NULL;
43b022a5c1SBarry Smith   MatPartitioningRegisterAllCalled = PETSC_FALSE;
44b022a5c1SBarry Smith   PetscFunctionReturn(0);
45b022a5c1SBarry Smith }
46e5beb14aSMatthew Knepley 
471153da11SBarry Smith #undef __FUNCT__
481153da11SBarry Smith #define __FUNCT__ "MatInitializePackage"
491153da11SBarry Smith /*@C
501153da11SBarry Smith   MatInitializePackage - This function initializes everything in the Mat package. It is called
511153da11SBarry Smith   from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to MatCreate()
521153da11SBarry Smith   when using static libraries.
531153da11SBarry Smith 
541153da11SBarry Smith   Input Parameter:
551153da11SBarry Smith   path - The dynamic library path, or PETSC_NULL
561153da11SBarry Smith 
571153da11SBarry Smith   Level: developer
581153da11SBarry Smith 
591153da11SBarry Smith .keywords: Mat, initialize, package
601153da11SBarry Smith .seealso: PetscInitialize()
611153da11SBarry Smith @*/
62e5bd5246SBarry Smith PetscErrorCode PETSCMAT_DLLEXPORT MatInitializePackage(const char path[])
631153da11SBarry Smith {
641153da11SBarry Smith   char              logList[256];
651153da11SBarry Smith   char              *className;
661153da11SBarry Smith   PetscTruth        opt;
671153da11SBarry Smith   PetscErrorCode    ierr;
681153da11SBarry Smith 
691153da11SBarry Smith   PetscFunctionBegin;
70b022a5c1SBarry Smith   if (MatPackageInitialized) PetscFunctionReturn(0);
71b022a5c1SBarry Smith   MatPackageInitialized = PETSC_TRUE;
72cce0b1b2SLisandro Dalcin   /* Inialize subpackage */
73cce0b1b2SLisandro Dalcin   ierr = MatMFFDInitializePackage(path);CHKERRQ(ierr);
741153da11SBarry Smith   /* Register Classes */
759afaeae2SBarry Smith   ierr = PetscCookieRegister("Matrix",&MAT_COOKIE);CHKERRQ(ierr);
769afaeae2SBarry Smith   ierr = PetscCookieRegister("Matrix FD Coloring",&MAT_FDCOLORING_COOKIE);CHKERRQ(ierr);
779afaeae2SBarry Smith   ierr = PetscCookieRegister("Matrix Partitioning",&MAT_PARTITIONING_COOKIE);CHKERRQ(ierr);
789afaeae2SBarry Smith   ierr = PetscCookieRegister("Matrix Null Space",&MAT_NULLSPACE_COOKIE);CHKERRQ(ierr);
791153da11SBarry Smith   /* Register Constructors */
801153da11SBarry Smith   ierr = MatRegisterAll(path);CHKERRQ(ierr);
81cce0b1b2SLisandro Dalcin   ierr = MatOrderingRegisterAll(path);CHKERRQ(ierr);
82cce0b1b2SLisandro Dalcin   ierr = MatColoringRegisterAll(path);CHKERRQ(ierr);
83cce0b1b2SLisandro Dalcin   ierr = MatPartitioningRegisterAll(path);CHKERRQ(ierr);
841153da11SBarry Smith   /* Register Events */
858cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMult",          MAT_COOKIE,&MAT_Mult);CHKERRQ(ierr);
868cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMults",         MAT_COOKIE,&MAT_Mults);CHKERRQ(ierr);
878cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMultConstr",    MAT_COOKIE,&MAT_MultConstrained);CHKERRQ(ierr);
888cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMultAdd",       MAT_COOKIE,&MAT_MultAdd);CHKERRQ(ierr);
898cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMultTranspose", MAT_COOKIE,&MAT_MultTranspose);CHKERRQ(ierr);
908cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMultTrConstr",  MAT_COOKIE,&MAT_MultTransposeConstrained);CHKERRQ(ierr);
918cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMultTrAdd",     MAT_COOKIE,&MAT_MultTransposeAdd);CHKERRQ(ierr);
928cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatSolve",         MAT_COOKIE,&MAT_Solve);CHKERRQ(ierr);
938cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatSolves",        MAT_COOKIE,&MAT_Solves);CHKERRQ(ierr);
948cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatSolveAdd",      MAT_COOKIE,&MAT_SolveAdd);CHKERRQ(ierr);
958cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatSolveTranspos", MAT_COOKIE,&MAT_SolveTranspose);CHKERRQ(ierr);
968cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatSolveTrAdd",    MAT_COOKIE,&MAT_SolveTransposeAdd);CHKERRQ(ierr);
9741f059aeSBarry Smith   ierr = PetscLogEventRegister("MatSOR",           MAT_COOKIE,&MAT_SOR);CHKERRQ(ierr);
988cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatForwardSolve",  MAT_COOKIE,&MAT_ForwardSolve);CHKERRQ(ierr);
998cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatBackwardSolve", MAT_COOKIE,&MAT_BackwardSolve);CHKERRQ(ierr);
1008cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatLUFactor",      MAT_COOKIE,&MAT_LUFactor);CHKERRQ(ierr);
1018cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatLUFactorSym",   MAT_COOKIE,&MAT_LUFactorSymbolic);CHKERRQ(ierr);
1028cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatLUFactorNum",   MAT_COOKIE,&MAT_LUFactorNumeric);CHKERRQ(ierr);
1038cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatCholeskyFctr",  MAT_COOKIE,&MAT_CholeskyFactor);CHKERRQ(ierr);
1048cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatCholFctrSym",   MAT_COOKIE,&MAT_CholeskyFactorSymbolic);CHKERRQ(ierr);
1058cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatCholFctrNum",   MAT_COOKIE,&MAT_CholeskyFactorNumeric);CHKERRQ(ierr);
1068cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatILUFactor",     MAT_COOKIE,&MAT_ILUFactor);CHKERRQ(ierr);
1078cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatILUFactorSym",  MAT_COOKIE,&MAT_ILUFactorSymbolic);CHKERRQ(ierr);
1088cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatICCFactorSym",  MAT_COOKIE,&MAT_ICCFactorSymbolic);CHKERRQ(ierr);
1098cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatCopy",          MAT_COOKIE,&MAT_Copy);CHKERRQ(ierr);
1108cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatConvert",       MAT_COOKIE,&MAT_Convert);CHKERRQ(ierr);
1118cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatScale",         MAT_COOKIE,&MAT_Scale);CHKERRQ(ierr);
1128cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatAssemblyBegin", MAT_COOKIE,&MAT_AssemblyBegin);CHKERRQ(ierr);
1138cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatAssemblyEnd",   MAT_COOKIE,&MAT_AssemblyEnd);CHKERRQ(ierr);
1148cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatSetValues",     MAT_COOKIE,&MAT_SetValues);CHKERRQ(ierr);
1158cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetValues",     MAT_COOKIE,&MAT_GetValues);CHKERRQ(ierr);
1168cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetRow",        MAT_COOKIE,&MAT_GetRow);CHKERRQ(ierr);
1178cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetRowIJ",      MAT_COOKIE,&MAT_GetRowIJ);CHKERRQ(ierr);
1188cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetSubMatrice", MAT_COOKIE,&MAT_GetSubMatrices);CHKERRQ(ierr);
1198cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetColoring",   MAT_COOKIE,&MAT_GetColoring);CHKERRQ(ierr);
1208cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetOrdering",   MAT_COOKIE,&MAT_GetOrdering);CHKERRQ(ierr);
1218cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatIncreaseOvrlp", MAT_COOKIE,&MAT_IncreaseOverlap);CHKERRQ(ierr);
1228cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatPartitioning",  MAT_PARTITIONING_COOKIE,&MAT_Partitioning);CHKERRQ(ierr);
1238cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatZeroEntries",   MAT_COOKIE,&MAT_ZeroEntries);CHKERRQ(ierr);
1248cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatLoad",          MAT_COOKIE,&MAT_Load);CHKERRQ(ierr);
1258cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatView",          MAT_COOKIE,&MAT_View);CHKERRQ(ierr);
1268cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatAXPY",          MAT_COOKIE,&MAT_AXPY);CHKERRQ(ierr);
1278cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatFDColorCreate", MAT_FDCOLORING_COOKIE,&MAT_FDColoringCreate);CHKERRQ(ierr);
1288cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatFDColorApply",  MAT_FDCOLORING_COOKIE,&MAT_FDColoringApply);CHKERRQ(ierr);
1298cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatFDColorFunc",   MAT_FDCOLORING_COOKIE,&MAT_FDColoringFunction);CHKERRQ(ierr);
1308cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatTranspose",     MAT_COOKIE,&MAT_Transpose);CHKERRQ(ierr);
1318cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMatMult",       MAT_COOKIE,&MAT_MatMult);CHKERRQ(ierr);
1323639cd1fSBarry Smith   ierr = PetscLogEventRegister("MatMatSolve",      MAT_COOKIE,&MAT_MatSolve);CHKERRQ(ierr);
1338cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMatMultSym",    MAT_COOKIE,&MAT_MatMultSymbolic);CHKERRQ(ierr);
1348cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMatMultNum",    MAT_COOKIE,&MAT_MatMultNumeric);CHKERRQ(ierr);
1358cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatPtAP",          MAT_COOKIE,&MAT_PtAP);CHKERRQ(ierr);
1368cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatPtAPSymbolic",  MAT_COOKIE,&MAT_PtAPSymbolic);CHKERRQ(ierr);
1378cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatPtAPNumeric",   MAT_COOKIE,&MAT_PtAPNumeric);CHKERRQ(ierr);
1388cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrans",  MAT_COOKIE,&MAT_MatMultTranspose);CHKERRQ(ierr);
1398cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnSym" ,MAT_COOKIE,&MAT_MatMultTransposeSymbolic);CHKERRQ(ierr);
1408cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnNum", MAT_COOKIE,&MAT_MatMultTransposeNumeric);CHKERRQ(ierr);
1410fc9d207SBarry Smith   ierr = PetscLogEventRegister("MatGetRedundant",  MAT_COOKIE,&MAT_GetRedundantMatrix);CHKERRQ(ierr);
1420fc9d207SBarry Smith   ierr = PetscLogEventRegister("MatGetSeqNZStrct", MAT_COOKIE,&MAT_GetSequentialNonzeroStructure);CHKERRQ(ierr);
1434ebed01fSBarry Smith 
1444ebed01fSBarry Smith   /* these may be specific to MPIAIJ matrices */
1458cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPINumeric",MAT_COOKIE,&MAT_Seqstompinum);
1468cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPISymbolic",MAT_COOKIE,&MAT_Seqstompisym);
1478cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPI",MAT_COOKIE,&MAT_Seqstompi);
1488cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMat",MAT_COOKIE,&MAT_Getlocalmat);
1498cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMatCondensed",MAT_COOKIE,&MAT_Getlocalmatcondensed);
1508cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetBrowsOfAcols",MAT_COOKIE,&MAT_GetBrowsOfAcols);
1518cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatGetBrAoCol",MAT_COOKIE,&MAT_GetBrowsOfAocols);
1524ebed01fSBarry Smith 
1538cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Symbolic",MAT_COOKIE,&MAT_Applypapt_symbolic);CHKERRQ(ierr);
1548cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Numeric",MAT_COOKIE,&MAT_Applypapt_numeric);CHKERRQ(ierr);
1558cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt",MAT_COOKIE,&MAT_Applypapt);CHKERRQ(ierr);
1564ebed01fSBarry Smith 
1570fc9d207SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTrans",MAT_COOKIE,&MAT_Getsymtranspose);CHKERRQ(ierr);
1580fc9d207SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTransR",MAT_COOKIE,&MAT_Getsymtransreduced);CHKERRQ(ierr);
1598cbcd9ccSBarry Smith   ierr = PetscLogEventRegister("MatTranspose_SeqAIJ_FAST",MAT_COOKIE,&MAT_Transpose_SeqAIJ);CHKERRQ(ierr);
1604ebed01fSBarry Smith 
1611153da11SBarry Smith   /* Turn off high traffic events by default */
1621153da11SBarry Smith   ierr = PetscLogEventSetActiveAll(MAT_SetValues, PETSC_FALSE);CHKERRQ(ierr);
1631153da11SBarry Smith   /* Process info exclusions */
1646cf91177SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-info_exclude", logList, 256, &opt);CHKERRQ(ierr);
1651153da11SBarry Smith   if (opt) {
1661153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1671153da11SBarry Smith     if (className) {
1686cf91177SBarry Smith       ierr = PetscInfoDeactivateClass(MAT_COOKIE);CHKERRQ(ierr);
1691153da11SBarry Smith     }
1701153da11SBarry Smith   }
1711153da11SBarry Smith   /* Process summary exclusions */
1721153da11SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-log_summary_exclude", logList, 256, &opt);CHKERRQ(ierr);
1731153da11SBarry Smith   if (opt) {
1741153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1751153da11SBarry Smith     if (className) {
1761153da11SBarry Smith       ierr = PetscLogEventDeactivateClass(MAT_COOKIE);CHKERRQ(ierr);
1771153da11SBarry Smith     }
1781153da11SBarry Smith   }
179b022a5c1SBarry Smith   ierr = PetscRegisterFinalize(MatFinalizePackage);CHKERRQ(ierr);
1801153da11SBarry Smith   PetscFunctionReturn(0);
1811153da11SBarry Smith }
1821153da11SBarry Smith 
1831153da11SBarry Smith #ifdef PETSC_USE_DYNAMIC_LIBRARIES
1841153da11SBarry Smith EXTERN_C_BEGIN
1851153da11SBarry Smith #undef __FUNCT__
1861153da11SBarry Smith #define __FUNCT__ "PetscDLLibraryRegister_petscmat"
1871153da11SBarry Smith /*
1881153da11SBarry Smith   PetscDLLibraryRegister - This function is called when the dynamic library it is in is opened.
1891153da11SBarry Smith 
1903f92711fSBarry Smith   This one registers all the matrix methods that are in the basic PETSc Matrix library.
1911153da11SBarry Smith 
1921153da11SBarry Smith   Input Parameter:
1931153da11SBarry Smith   path - library path
1941153da11SBarry Smith  */
195e5bd5246SBarry Smith PetscErrorCode PETSCMAT_DLLEXPORT PetscDLLibraryRegister_petscmat(const char path[])
1961153da11SBarry Smith {
1971153da11SBarry Smith   PetscErrorCode ierr;
1981153da11SBarry Smith 
1991153da11SBarry Smith   ierr = PetscInitializeNoArguments(); if (ierr) return 1;
2001153da11SBarry Smith 
2011153da11SBarry Smith   PetscFunctionBegin;
2021153da11SBarry Smith   /*
2031153da11SBarry Smith       If we got here then PETSc was properly loaded
2041153da11SBarry Smith   */
2051153da11SBarry Smith   ierr = MatInitializePackage(path);CHKERRQ(ierr);
2061153da11SBarry Smith   PetscFunctionReturn(0);
2071153da11SBarry Smith }
2081153da11SBarry Smith EXTERN_C_END
2091153da11SBarry Smith 
2101153da11SBarry Smith 
2111153da11SBarry Smith #endif /* PETSC_USE_DYNAMIC_LIBRARIES */
212