xref: /petsc/src/mat/interface/dlregismat.c (revision 8154be41cdf971cfe7e5d28dc9f337960e443860)
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",
15cd6b891eSBarry Smith               "CHECK_COMPRESSED_ROW",
164cb17eb5SBarry Smith               "IGNORE_LOWER_TRIANGULAR","ERROR_LOWER_TRIANGULAR","GETROW_UPPERTRIANGULAR","SPD","NO_OFF_PROC_ENTRIES","NO_OFF_PROC_ZERO_ROWS","MatOption","MAT_",0};
17f4db908eSBarry Smith const char *MatFactorShiftTypes[] = {"NONE","NONZERO","POSITIVE_DEFINITE","INBLOCKS","MatFactorShiftType","PC_FACTOR_",0};
18290bbb0aSBarry Smith 
197087cfbeSBarry Smith extern PetscErrorCode  MatMFFDInitializePackage(const char[]);
20ace3abfcSBarry Smith static PetscBool  MatPackageInitialized = PETSC_FALSE;
21b022a5c1SBarry Smith #undef __FUNCT__
22b022a5c1SBarry Smith #define __FUNCT__ "MatFinalizePackage"
23b022a5c1SBarry Smith /*@C
2460154eb2SBarry Smith   MatFinalizePackage - This function destroys everything in the Petsc interface to the Mat 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 @*/
327087cfbeSBarry Smith PetscErrorCode  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 @*/
627087cfbeSBarry Smith PetscErrorCode  MatInitializePackage(const char path[])
631153da11SBarry Smith {
641153da11SBarry Smith   char              logList[256];
651153da11SBarry Smith   char              *className;
66ace3abfcSBarry Smith   PetscBool         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 */
750700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix",&MAT_CLASSID);CHKERRQ(ierr);
760700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix FD Coloring",&MAT_FDCOLORING_CLASSID);CHKERRQ(ierr);
770700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix Partitioning",&MAT_PARTITIONING_CLASSID);CHKERRQ(ierr);
780700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix Null Space",&MAT_NULLSPACE_CLASSID);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 */
850700a824SBarry Smith   ierr = PetscLogEventRegister("MatMult",          MAT_CLASSID,&MAT_Mult);CHKERRQ(ierr);
860700a824SBarry Smith   ierr = PetscLogEventRegister("MatMults",         MAT_CLASSID,&MAT_Mults);CHKERRQ(ierr);
870700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultConstr",    MAT_CLASSID,&MAT_MultConstrained);CHKERRQ(ierr);
880700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultAdd",       MAT_CLASSID,&MAT_MultAdd);CHKERRQ(ierr);
890700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTranspose", MAT_CLASSID,&MAT_MultTranspose);CHKERRQ(ierr);
900700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTrConstr",  MAT_CLASSID,&MAT_MultTransposeConstrained);CHKERRQ(ierr);
910700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTrAdd",     MAT_CLASSID,&MAT_MultTransposeAdd);CHKERRQ(ierr);
920700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolve",         MAT_CLASSID,&MAT_Solve);CHKERRQ(ierr);
930700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolves",        MAT_CLASSID,&MAT_Solves);CHKERRQ(ierr);
940700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveAdd",      MAT_CLASSID,&MAT_SolveAdd);CHKERRQ(ierr);
950700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveTranspos", MAT_CLASSID,&MAT_SolveTranspose);CHKERRQ(ierr);
960700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveTrAdd",    MAT_CLASSID,&MAT_SolveTransposeAdd);CHKERRQ(ierr);
970700a824SBarry Smith   ierr = PetscLogEventRegister("MatSOR",           MAT_CLASSID,&MAT_SOR);CHKERRQ(ierr);
980700a824SBarry Smith   ierr = PetscLogEventRegister("MatForwardSolve",  MAT_CLASSID,&MAT_ForwardSolve);CHKERRQ(ierr);
990700a824SBarry Smith   ierr = PetscLogEventRegister("MatBackwardSolve", MAT_CLASSID,&MAT_BackwardSolve);CHKERRQ(ierr);
1000700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactor",      MAT_CLASSID,&MAT_LUFactor);CHKERRQ(ierr);
1010700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactorSym",   MAT_CLASSID,&MAT_LUFactorSymbolic);CHKERRQ(ierr);
1020700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactorNum",   MAT_CLASSID,&MAT_LUFactorNumeric);CHKERRQ(ierr);
1030700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholeskyFctr",  MAT_CLASSID,&MAT_CholeskyFactor);CHKERRQ(ierr);
1040700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholFctrSym",   MAT_CLASSID,&MAT_CholeskyFactorSymbolic);CHKERRQ(ierr);
1050700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholFctrNum",   MAT_CLASSID,&MAT_CholeskyFactorNumeric);CHKERRQ(ierr);
1060700a824SBarry Smith   ierr = PetscLogEventRegister("MatILUFactor",     MAT_CLASSID,&MAT_ILUFactor);CHKERRQ(ierr);
1070700a824SBarry Smith   ierr = PetscLogEventRegister("MatILUFactorSym",  MAT_CLASSID,&MAT_ILUFactorSymbolic);CHKERRQ(ierr);
1080700a824SBarry Smith   ierr = PetscLogEventRegister("MatICCFactorSym",  MAT_CLASSID,&MAT_ICCFactorSymbolic);CHKERRQ(ierr);
1090700a824SBarry Smith   ierr = PetscLogEventRegister("MatCopy",          MAT_CLASSID,&MAT_Copy);CHKERRQ(ierr);
1100700a824SBarry Smith   ierr = PetscLogEventRegister("MatConvert",       MAT_CLASSID,&MAT_Convert);CHKERRQ(ierr);
1110700a824SBarry Smith   ierr = PetscLogEventRegister("MatScale",         MAT_CLASSID,&MAT_Scale);CHKERRQ(ierr);
1120700a824SBarry Smith   ierr = PetscLogEventRegister("MatAssemblyBegin", MAT_CLASSID,&MAT_AssemblyBegin);CHKERRQ(ierr);
1130700a824SBarry Smith   ierr = PetscLogEventRegister("MatAssemblyEnd",   MAT_CLASSID,&MAT_AssemblyEnd);CHKERRQ(ierr);
1140700a824SBarry Smith   ierr = PetscLogEventRegister("MatSetValues",     MAT_CLASSID,&MAT_SetValues);CHKERRQ(ierr);
1150700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetValues",     MAT_CLASSID,&MAT_GetValues);CHKERRQ(ierr);
1160700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRow",        MAT_CLASSID,&MAT_GetRow);CHKERRQ(ierr);
1170700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRowIJ",      MAT_CLASSID,&MAT_GetRowIJ);CHKERRQ(ierr);
1180700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSubMatrice", MAT_CLASSID,&MAT_GetSubMatrices);CHKERRQ(ierr);
1190700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetColoring",   MAT_CLASSID,&MAT_GetColoring);CHKERRQ(ierr);
1200700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetOrdering",   MAT_CLASSID,&MAT_GetOrdering);CHKERRQ(ierr);
1210700a824SBarry Smith   ierr = PetscLogEventRegister("MatIncreaseOvrlp", MAT_CLASSID,&MAT_IncreaseOverlap);CHKERRQ(ierr);
1220700a824SBarry Smith   ierr = PetscLogEventRegister("MatPartitioning",  MAT_PARTITIONING_CLASSID,&MAT_Partitioning);CHKERRQ(ierr);
1230700a824SBarry Smith   ierr = PetscLogEventRegister("MatZeroEntries",   MAT_CLASSID,&MAT_ZeroEntries);CHKERRQ(ierr);
1240700a824SBarry Smith   ierr = PetscLogEventRegister("MatLoad",          MAT_CLASSID,&MAT_Load);CHKERRQ(ierr);
1250700a824SBarry Smith   ierr = PetscLogEventRegister("MatView",          MAT_CLASSID,&MAT_View);CHKERRQ(ierr);
1260700a824SBarry Smith   ierr = PetscLogEventRegister("MatAXPY",          MAT_CLASSID,&MAT_AXPY);CHKERRQ(ierr);
1270700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorCreate", MAT_FDCOLORING_CLASSID,&MAT_FDColoringCreate);CHKERRQ(ierr);
1280700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorApply",  MAT_FDCOLORING_CLASSID,&MAT_FDColoringApply);CHKERRQ(ierr);
1290700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorFunc",   MAT_FDCOLORING_CLASSID,&MAT_FDColoringFunction);CHKERRQ(ierr);
1300700a824SBarry Smith   ierr = PetscLogEventRegister("MatTranspose",     MAT_CLASSID,&MAT_Transpose);CHKERRQ(ierr);
1310700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMult",       MAT_CLASSID,&MAT_MatMult);CHKERRQ(ierr);
1320700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatSolve",      MAT_CLASSID,&MAT_MatSolve);CHKERRQ(ierr);
1330700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultSym",    MAT_CLASSID,&MAT_MatMultSymbolic);CHKERRQ(ierr);
1340700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultNum",    MAT_CLASSID,&MAT_MatMultNumeric);CHKERRQ(ierr);
1350700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAP",          MAT_CLASSID,&MAT_PtAP);CHKERRQ(ierr);
1360700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAPSymbolic",  MAT_CLASSID,&MAT_PtAPSymbolic);CHKERRQ(ierr);
1370700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAPNumeric",   MAT_CLASSID,&MAT_PtAPNumeric);CHKERRQ(ierr);
1380700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrans",  MAT_CLASSID,&MAT_MatMultTranspose);CHKERRQ(ierr);
1390700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnSym" ,MAT_CLASSID,&MAT_MatMultTransposeSymbolic);CHKERRQ(ierr);
1400700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnNum", MAT_CLASSID,&MAT_MatMultTransposeNumeric);CHKERRQ(ierr);
1410700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRedundant",  MAT_CLASSID,&MAT_GetRedundantMatrix);CHKERRQ(ierr);
1420700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSeqNZStrct", MAT_CLASSID,&MAT_GetSequentialNonzeroStructure);CHKERRQ(ierr);
14382d44351SHong Zhang   ierr = PetscLogEventRegister("MatGetMultiProcBlock", MAT_CLASSID,&MAT_GetMultiProcBlock);CHKERRQ(ierr);
1444ebed01fSBarry Smith 
1454ebed01fSBarry Smith   /* these may be specific to MPIAIJ matrices */
1460700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPINumeric",MAT_CLASSID,&MAT_Seqstompinum);
1470700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPISymbolic",MAT_CLASSID,&MAT_Seqstompisym);
1480700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPI",MAT_CLASSID,&MAT_Seqstompi);
1490700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMat",MAT_CLASSID,&MAT_Getlocalmat);
1500700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMatCondensed",MAT_CLASSID,&MAT_Getlocalmatcondensed);
1510700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetBrowsOfAcols",MAT_CLASSID,&MAT_GetBrowsOfAcols);
1520700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetBrAoCol",MAT_CLASSID,&MAT_GetBrowsOfAocols);
1534ebed01fSBarry Smith 
1540700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Symbolic",MAT_CLASSID,&MAT_Applypapt_symbolic);CHKERRQ(ierr);
1550700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Numeric",MAT_CLASSID,&MAT_Applypapt_numeric);CHKERRQ(ierr);
1560700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt",MAT_CLASSID,&MAT_Applypapt);CHKERRQ(ierr);
1574ebed01fSBarry Smith 
1580700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTrans",MAT_CLASSID,&MAT_Getsymtranspose);CHKERRQ(ierr);
1590700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTransR",MAT_CLASSID,&MAT_Getsymtransreduced);CHKERRQ(ierr);
1600700a824SBarry Smith   ierr = PetscLogEventRegister("MatTranspose_SeqAIJ_FAST",MAT_CLASSID,&MAT_Transpose_SeqAIJ);CHKERRQ(ierr);
161*8154be41SBarry Smith   ierr = PetscLogEventRegister("MatCUSPCopyTo",MAT_CLASSID,&MAT_CUSPCopyToGPU);CHKERRQ(ierr);
1624ebed01fSBarry Smith 
1631153da11SBarry Smith   /* Turn off high traffic events by default */
1641153da11SBarry Smith   ierr = PetscLogEventSetActiveAll(MAT_SetValues, PETSC_FALSE);CHKERRQ(ierr);
1651153da11SBarry Smith   /* Process info exclusions */
1666cf91177SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-info_exclude", logList, 256, &opt);CHKERRQ(ierr);
1671153da11SBarry Smith   if (opt) {
1681153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1691153da11SBarry Smith     if (className) {
1700700a824SBarry Smith       ierr = PetscInfoDeactivateClass(MAT_CLASSID);CHKERRQ(ierr);
1711153da11SBarry Smith     }
1721153da11SBarry Smith   }
1731153da11SBarry Smith   /* Process summary exclusions */
1741153da11SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-log_summary_exclude", logList, 256, &opt);CHKERRQ(ierr);
1751153da11SBarry Smith   if (opt) {
1761153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1771153da11SBarry Smith     if (className) {
1780700a824SBarry Smith       ierr = PetscLogEventDeactivateClass(MAT_CLASSID);CHKERRQ(ierr);
1791153da11SBarry Smith     }
1801153da11SBarry Smith   }
181b022a5c1SBarry Smith   ierr = PetscRegisterFinalize(MatFinalizePackage);CHKERRQ(ierr);
1821153da11SBarry Smith   PetscFunctionReturn(0);
1831153da11SBarry Smith }
1841153da11SBarry Smith 
1851153da11SBarry Smith #ifdef PETSC_USE_DYNAMIC_LIBRARIES
1861153da11SBarry Smith EXTERN_C_BEGIN
1871153da11SBarry Smith #undef __FUNCT__
1881153da11SBarry Smith #define __FUNCT__ "PetscDLLibraryRegister_petscmat"
1891153da11SBarry Smith /*
1901153da11SBarry Smith   PetscDLLibraryRegister - This function is called when the dynamic library it is in is opened.
1911153da11SBarry Smith 
1923f92711fSBarry Smith   This one registers all the matrix methods that are in the basic PETSc Matrix library.
1931153da11SBarry Smith 
1941153da11SBarry Smith   Input Parameter:
1951153da11SBarry Smith   path - library path
1961153da11SBarry Smith  */
1977087cfbeSBarry Smith PetscErrorCode  PetscDLLibraryRegister_petscmat(const char path[])
1981153da11SBarry Smith {
1991153da11SBarry Smith   PetscErrorCode ierr;
2001153da11SBarry Smith 
2011153da11SBarry Smith   PetscFunctionBegin;
2021153da11SBarry Smith   ierr = MatInitializePackage(path);CHKERRQ(ierr);
2031153da11SBarry Smith   PetscFunctionReturn(0);
2041153da11SBarry Smith }
2051153da11SBarry Smith EXTERN_C_END
2061153da11SBarry Smith 
2071153da11SBarry Smith 
2081153da11SBarry Smith #endif /* PETSC_USE_DYNAMIC_LIBRARIES */
209