xref: /petsc/src/mat/interface/dlregismat.c (revision c6db04a5321582041def2b1e244c75985478b3ef)
11153da11SBarry Smith 
2*c6db04a5SJed Brown #include <private/matimpl.h>
31153da11SBarry Smith 
4ea5af983SLisandro Dalcin const char *MatOptions[] = {"ROW_ORIENTED","NEW_NONZERO_LOCATIONS",
54e0d8c25SBarry Smith               "SYMMETRIC",
64e0d8c25SBarry Smith               "STRUCTURALLY_SYMMETRIC",
7dc5b3d67SBarry Smith               "NEW_DIAGONALS",
84e0d8c25SBarry Smith               "IGNORE_OFF_PROC_ENTRIES",
94e0d8c25SBarry Smith               "NEW_NONZERO_LOCATION_ERR",
10290bbb0aSBarry Smith               "NEW_NONZERO_ALLOCATION_ERR","USE_HASH_TABLE",
11290bbb0aSBarry Smith               "KEEP_ZEROED_ROWS","IGNORE_ZERO_ENTRIES","USE_INODES",
124e0d8c25SBarry Smith               "HERMITIAN",
134e0d8c25SBarry Smith               "SYMMETRY_ETERNAL",
14cd6b891eSBarry Smith               "CHECK_COMPRESSED_ROW",
154cb17eb5SBarry Smith               "IGNORE_LOWER_TRIANGULAR","ERROR_LOWER_TRIANGULAR","GETROW_UPPERTRIANGULAR","SPD","NO_OFF_PROC_ENTRIES","NO_OFF_PROC_ZERO_ROWS","MatOption","MAT_",0};
16f4db908eSBarry Smith const char *MatFactorShiftTypes[] = {"NONE","NONZERO","POSITIVE_DEFINITE","INBLOCKS","MatFactorShiftType","PC_FACTOR_",0};
17290bbb0aSBarry Smith 
187087cfbeSBarry Smith extern PetscErrorCode  MatMFFDInitializePackage(const char[]);
19ace3abfcSBarry Smith static PetscBool  MatPackageInitialized = PETSC_FALSE;
20b022a5c1SBarry Smith #undef __FUNCT__
21b022a5c1SBarry Smith #define __FUNCT__ "MatFinalizePackage"
22b022a5c1SBarry Smith /*@C
2360154eb2SBarry Smith   MatFinalizePackage - This function destroys everything in the Petsc interface to the Mat package. It is
24b022a5c1SBarry Smith   called from PetscFinalize().
25b022a5c1SBarry Smith 
26b022a5c1SBarry Smith   Level: developer
27b022a5c1SBarry Smith 
28b022a5c1SBarry Smith .keywords: Petsc, destroy, package, mathematica
29b022a5c1SBarry Smith .seealso: PetscFinalize()
30b022a5c1SBarry Smith @*/
317087cfbeSBarry Smith PetscErrorCode  MatFinalizePackage(void)
32b022a5c1SBarry Smith {
33b022a5c1SBarry Smith   PetscFunctionBegin;
34b022a5c1SBarry Smith   MatPackageInitialized            = PETSC_FALSE;
35b022a5c1SBarry Smith   MatRegisterAllCalled             = PETSC_FALSE;
36b022a5c1SBarry Smith   MatList                          = PETSC_NULL;
37b022a5c1SBarry Smith   MatOrderingRegisterAllCalled     = PETSC_FALSE;
38b022a5c1SBarry Smith   MatOrderingList                  = PETSC_NULL;
39b022a5c1SBarry Smith   MatColoringList                  = PETSC_NULL;
40b022a5c1SBarry Smith   MatColoringRegisterAllCalled     = PETSC_FALSE;
41b022a5c1SBarry Smith   MatPartitioningList              = PETSC_NULL;
42b022a5c1SBarry Smith   MatPartitioningRegisterAllCalled = PETSC_FALSE;
43b022a5c1SBarry Smith   PetscFunctionReturn(0);
44b022a5c1SBarry Smith }
45e5beb14aSMatthew Knepley 
461153da11SBarry Smith #undef __FUNCT__
471153da11SBarry Smith #define __FUNCT__ "MatInitializePackage"
481153da11SBarry Smith /*@C
491153da11SBarry Smith   MatInitializePackage - This function initializes everything in the Mat package. It is called
501153da11SBarry Smith   from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to MatCreate()
511153da11SBarry Smith   when using static libraries.
521153da11SBarry Smith 
531153da11SBarry Smith   Input Parameter:
541153da11SBarry Smith   path - The dynamic library path, or PETSC_NULL
551153da11SBarry Smith 
561153da11SBarry Smith   Level: developer
571153da11SBarry Smith 
581153da11SBarry Smith .keywords: Mat, initialize, package
591153da11SBarry Smith .seealso: PetscInitialize()
601153da11SBarry Smith @*/
617087cfbeSBarry Smith PetscErrorCode  MatInitializePackage(const char path[])
621153da11SBarry Smith {
631153da11SBarry Smith   char              logList[256];
641153da11SBarry Smith   char              *className;
65ace3abfcSBarry Smith   PetscBool         opt;
661153da11SBarry Smith   PetscErrorCode    ierr;
671153da11SBarry Smith 
681153da11SBarry Smith   PetscFunctionBegin;
69b022a5c1SBarry Smith   if (MatPackageInitialized) PetscFunctionReturn(0);
70b022a5c1SBarry Smith   MatPackageInitialized = PETSC_TRUE;
71cce0b1b2SLisandro Dalcin   /* Inialize subpackage */
72cce0b1b2SLisandro Dalcin   ierr = MatMFFDInitializePackage(path);CHKERRQ(ierr);
731153da11SBarry Smith   /* Register Classes */
740700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix",&MAT_CLASSID);CHKERRQ(ierr);
750700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix FD Coloring",&MAT_FDCOLORING_CLASSID);CHKERRQ(ierr);
760700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix Partitioning",&MAT_PARTITIONING_CLASSID);CHKERRQ(ierr);
770700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix Null Space",&MAT_NULLSPACE_CLASSID);CHKERRQ(ierr);
781153da11SBarry Smith   /* Register Constructors */
791153da11SBarry Smith   ierr = MatRegisterAll(path);CHKERRQ(ierr);
80cce0b1b2SLisandro Dalcin   ierr = MatOrderingRegisterAll(path);CHKERRQ(ierr);
81cce0b1b2SLisandro Dalcin   ierr = MatColoringRegisterAll(path);CHKERRQ(ierr);
82cce0b1b2SLisandro Dalcin   ierr = MatPartitioningRegisterAll(path);CHKERRQ(ierr);
831153da11SBarry Smith   /* Register Events */
840700a824SBarry Smith   ierr = PetscLogEventRegister("MatMult",          MAT_CLASSID,&MAT_Mult);CHKERRQ(ierr);
850700a824SBarry Smith   ierr = PetscLogEventRegister("MatMults",         MAT_CLASSID,&MAT_Mults);CHKERRQ(ierr);
860700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultConstr",    MAT_CLASSID,&MAT_MultConstrained);CHKERRQ(ierr);
870700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultAdd",       MAT_CLASSID,&MAT_MultAdd);CHKERRQ(ierr);
880700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTranspose", MAT_CLASSID,&MAT_MultTranspose);CHKERRQ(ierr);
890700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTrConstr",  MAT_CLASSID,&MAT_MultTransposeConstrained);CHKERRQ(ierr);
900700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTrAdd",     MAT_CLASSID,&MAT_MultTransposeAdd);CHKERRQ(ierr);
910700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolve",         MAT_CLASSID,&MAT_Solve);CHKERRQ(ierr);
920700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolves",        MAT_CLASSID,&MAT_Solves);CHKERRQ(ierr);
930700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveAdd",      MAT_CLASSID,&MAT_SolveAdd);CHKERRQ(ierr);
940700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveTranspos", MAT_CLASSID,&MAT_SolveTranspose);CHKERRQ(ierr);
950700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveTrAdd",    MAT_CLASSID,&MAT_SolveTransposeAdd);CHKERRQ(ierr);
960700a824SBarry Smith   ierr = PetscLogEventRegister("MatSOR",           MAT_CLASSID,&MAT_SOR);CHKERRQ(ierr);
970700a824SBarry Smith   ierr = PetscLogEventRegister("MatForwardSolve",  MAT_CLASSID,&MAT_ForwardSolve);CHKERRQ(ierr);
980700a824SBarry Smith   ierr = PetscLogEventRegister("MatBackwardSolve", MAT_CLASSID,&MAT_BackwardSolve);CHKERRQ(ierr);
990700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactor",      MAT_CLASSID,&MAT_LUFactor);CHKERRQ(ierr);
1000700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactorSym",   MAT_CLASSID,&MAT_LUFactorSymbolic);CHKERRQ(ierr);
1010700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactorNum",   MAT_CLASSID,&MAT_LUFactorNumeric);CHKERRQ(ierr);
1020700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholeskyFctr",  MAT_CLASSID,&MAT_CholeskyFactor);CHKERRQ(ierr);
1030700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholFctrSym",   MAT_CLASSID,&MAT_CholeskyFactorSymbolic);CHKERRQ(ierr);
1040700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholFctrNum",   MAT_CLASSID,&MAT_CholeskyFactorNumeric);CHKERRQ(ierr);
1050700a824SBarry Smith   ierr = PetscLogEventRegister("MatILUFactor",     MAT_CLASSID,&MAT_ILUFactor);CHKERRQ(ierr);
1060700a824SBarry Smith   ierr = PetscLogEventRegister("MatILUFactorSym",  MAT_CLASSID,&MAT_ILUFactorSymbolic);CHKERRQ(ierr);
1070700a824SBarry Smith   ierr = PetscLogEventRegister("MatICCFactorSym",  MAT_CLASSID,&MAT_ICCFactorSymbolic);CHKERRQ(ierr);
1080700a824SBarry Smith   ierr = PetscLogEventRegister("MatCopy",          MAT_CLASSID,&MAT_Copy);CHKERRQ(ierr);
1090700a824SBarry Smith   ierr = PetscLogEventRegister("MatConvert",       MAT_CLASSID,&MAT_Convert);CHKERRQ(ierr);
1100700a824SBarry Smith   ierr = PetscLogEventRegister("MatScale",         MAT_CLASSID,&MAT_Scale);CHKERRQ(ierr);
1110700a824SBarry Smith   ierr = PetscLogEventRegister("MatAssemblyBegin", MAT_CLASSID,&MAT_AssemblyBegin);CHKERRQ(ierr);
1120700a824SBarry Smith   ierr = PetscLogEventRegister("MatAssemblyEnd",   MAT_CLASSID,&MAT_AssemblyEnd);CHKERRQ(ierr);
1130700a824SBarry Smith   ierr = PetscLogEventRegister("MatSetValues",     MAT_CLASSID,&MAT_SetValues);CHKERRQ(ierr);
1140700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetValues",     MAT_CLASSID,&MAT_GetValues);CHKERRQ(ierr);
1150700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRow",        MAT_CLASSID,&MAT_GetRow);CHKERRQ(ierr);
1160700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRowIJ",      MAT_CLASSID,&MAT_GetRowIJ);CHKERRQ(ierr);
1170700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSubMatrice", MAT_CLASSID,&MAT_GetSubMatrices);CHKERRQ(ierr);
1180700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetColoring",   MAT_CLASSID,&MAT_GetColoring);CHKERRQ(ierr);
1190700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetOrdering",   MAT_CLASSID,&MAT_GetOrdering);CHKERRQ(ierr);
1200700a824SBarry Smith   ierr = PetscLogEventRegister("MatIncreaseOvrlp", MAT_CLASSID,&MAT_IncreaseOverlap);CHKERRQ(ierr);
1210700a824SBarry Smith   ierr = PetscLogEventRegister("MatPartitioning",  MAT_PARTITIONING_CLASSID,&MAT_Partitioning);CHKERRQ(ierr);
1220700a824SBarry Smith   ierr = PetscLogEventRegister("MatZeroEntries",   MAT_CLASSID,&MAT_ZeroEntries);CHKERRQ(ierr);
1230700a824SBarry Smith   ierr = PetscLogEventRegister("MatLoad",          MAT_CLASSID,&MAT_Load);CHKERRQ(ierr);
1240700a824SBarry Smith   ierr = PetscLogEventRegister("MatView",          MAT_CLASSID,&MAT_View);CHKERRQ(ierr);
1250700a824SBarry Smith   ierr = PetscLogEventRegister("MatAXPY",          MAT_CLASSID,&MAT_AXPY);CHKERRQ(ierr);
1260700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorCreate", MAT_FDCOLORING_CLASSID,&MAT_FDColoringCreate);CHKERRQ(ierr);
1270700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorApply",  MAT_FDCOLORING_CLASSID,&MAT_FDColoringApply);CHKERRQ(ierr);
1280700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorFunc",   MAT_FDCOLORING_CLASSID,&MAT_FDColoringFunction);CHKERRQ(ierr);
1290700a824SBarry Smith   ierr = PetscLogEventRegister("MatTranspose",     MAT_CLASSID,&MAT_Transpose);CHKERRQ(ierr);
1300700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMult",       MAT_CLASSID,&MAT_MatMult);CHKERRQ(ierr);
1310700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatSolve",      MAT_CLASSID,&MAT_MatSolve);CHKERRQ(ierr);
1320700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultSym",    MAT_CLASSID,&MAT_MatMultSymbolic);CHKERRQ(ierr);
1330700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultNum",    MAT_CLASSID,&MAT_MatMultNumeric);CHKERRQ(ierr);
1340700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAP",          MAT_CLASSID,&MAT_PtAP);CHKERRQ(ierr);
1350700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAPSymbolic",  MAT_CLASSID,&MAT_PtAPSymbolic);CHKERRQ(ierr);
1360700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAPNumeric",   MAT_CLASSID,&MAT_PtAPNumeric);CHKERRQ(ierr);
1370700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrans",  MAT_CLASSID,&MAT_MatMultTranspose);CHKERRQ(ierr);
1380700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnSym" ,MAT_CLASSID,&MAT_MatMultTransposeSymbolic);CHKERRQ(ierr);
1390700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnNum", MAT_CLASSID,&MAT_MatMultTransposeNumeric);CHKERRQ(ierr);
1400700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRedundant",  MAT_CLASSID,&MAT_GetRedundantMatrix);CHKERRQ(ierr);
1410700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSeqNZStrct", MAT_CLASSID,&MAT_GetSequentialNonzeroStructure);CHKERRQ(ierr);
14282d44351SHong Zhang   ierr = PetscLogEventRegister("MatGetMultiProcBlock", MAT_CLASSID,&MAT_GetMultiProcBlock);CHKERRQ(ierr);
1434ebed01fSBarry Smith 
1444ebed01fSBarry Smith   /* these may be specific to MPIAIJ matrices */
1450700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPINumeric",MAT_CLASSID,&MAT_Seqstompinum);
1460700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPISymbolic",MAT_CLASSID,&MAT_Seqstompisym);
1470700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPI",MAT_CLASSID,&MAT_Seqstompi);
1480700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMat",MAT_CLASSID,&MAT_Getlocalmat);
1490700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMatCondensed",MAT_CLASSID,&MAT_Getlocalmatcondensed);
1500700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetBrowsOfAcols",MAT_CLASSID,&MAT_GetBrowsOfAcols);
1510700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetBrAoCol",MAT_CLASSID,&MAT_GetBrowsOfAocols);
1524ebed01fSBarry Smith 
1530700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Symbolic",MAT_CLASSID,&MAT_Applypapt_symbolic);CHKERRQ(ierr);
1540700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Numeric",MAT_CLASSID,&MAT_Applypapt_numeric);CHKERRQ(ierr);
1550700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt",MAT_CLASSID,&MAT_Applypapt);CHKERRQ(ierr);
1564ebed01fSBarry Smith 
1570700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTrans",MAT_CLASSID,&MAT_Getsymtranspose);CHKERRQ(ierr);
1580700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTransR",MAT_CLASSID,&MAT_Getsymtransreduced);CHKERRQ(ierr);
1590700a824SBarry Smith   ierr = PetscLogEventRegister("MatTranspose_SeqAIJ_FAST",MAT_CLASSID,&MAT_Transpose_SeqAIJ);CHKERRQ(ierr);
1608154be41SBarry Smith   ierr = PetscLogEventRegister("MatCUSPCopyTo",MAT_CLASSID,&MAT_CUSPCopyToGPU);CHKERRQ(ierr);
1614ebed01fSBarry Smith 
1621153da11SBarry Smith   /* Turn off high traffic events by default */
1631153da11SBarry Smith   ierr = PetscLogEventSetActiveAll(MAT_SetValues, PETSC_FALSE);CHKERRQ(ierr);
1641153da11SBarry Smith   /* Process info exclusions */
1656cf91177SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-info_exclude", logList, 256, &opt);CHKERRQ(ierr);
1661153da11SBarry Smith   if (opt) {
1671153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1681153da11SBarry Smith     if (className) {
1690700a824SBarry Smith       ierr = PetscInfoDeactivateClass(MAT_CLASSID);CHKERRQ(ierr);
1701153da11SBarry Smith     }
1711153da11SBarry Smith   }
1721153da11SBarry Smith   /* Process summary exclusions */
1731153da11SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-log_summary_exclude", logList, 256, &opt);CHKERRQ(ierr);
1741153da11SBarry Smith   if (opt) {
1751153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1761153da11SBarry Smith     if (className) {
1770700a824SBarry Smith       ierr = PetscLogEventDeactivateClass(MAT_CLASSID);CHKERRQ(ierr);
1781153da11SBarry Smith     }
1791153da11SBarry Smith   }
180b022a5c1SBarry Smith   ierr = PetscRegisterFinalize(MatFinalizePackage);CHKERRQ(ierr);
1811153da11SBarry Smith   PetscFunctionReturn(0);
1821153da11SBarry Smith }
1831153da11SBarry Smith 
1841153da11SBarry Smith #ifdef PETSC_USE_DYNAMIC_LIBRARIES
1851153da11SBarry Smith EXTERN_C_BEGIN
1861153da11SBarry Smith #undef __FUNCT__
1871153da11SBarry Smith #define __FUNCT__ "PetscDLLibraryRegister_petscmat"
1881153da11SBarry Smith /*
1891153da11SBarry Smith   PetscDLLibraryRegister - This function is called when the dynamic library it is in is opened.
1901153da11SBarry Smith 
1913f92711fSBarry Smith   This one registers all the matrix methods that are in the basic PETSc Matrix library.
1921153da11SBarry Smith 
1931153da11SBarry Smith   Input Parameter:
1941153da11SBarry Smith   path - library path
1951153da11SBarry Smith  */
1967087cfbeSBarry Smith PetscErrorCode  PetscDLLibraryRegister_petscmat(const char path[])
1971153da11SBarry Smith {
1981153da11SBarry Smith   PetscErrorCode ierr;
1991153da11SBarry Smith 
2001153da11SBarry Smith   PetscFunctionBegin;
2011153da11SBarry Smith   ierr = MatInitializePackage(path);CHKERRQ(ierr);
2021153da11SBarry Smith   PetscFunctionReturn(0);
2031153da11SBarry Smith }
2041153da11SBarry Smith EXTERN_C_END
2051153da11SBarry Smith 
2061153da11SBarry Smith 
2071153da11SBarry Smith #endif /* PETSC_USE_DYNAMIC_LIBRARIES */
208