xref: /petsc/src/mat/interface/dlregismat.c (revision 76478b6ee0a67b13827215edbf7beea09f738b42)
11153da11SBarry Smith 
2c6db04a5SJed 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 {
3301bebe75SBarry Smith   MatBaseName    nnames,names = MatBaseNameList;
3401bebe75SBarry Smith   PetscErrorCode ierr;
3501bebe75SBarry Smith 
36b022a5c1SBarry Smith   PetscFunctionBegin;
3701bebe75SBarry Smith   while (names) {
3801bebe75SBarry Smith     nnames = names->next;
3901bebe75SBarry Smith     ierr = PetscFree(names->bname);CHKERRQ(ierr);
4001bebe75SBarry Smith     ierr = PetscFree(names->sname);CHKERRQ(ierr);
4101bebe75SBarry Smith     ierr = PetscFree(names->mname);CHKERRQ(ierr);
4201bebe75SBarry Smith     ierr = PetscFree(names);CHKERRQ(ierr);
4301bebe75SBarry Smith     names = nnames;
4401bebe75SBarry Smith   }
45*76478b6eSJed Brown   MatBaseNameList                  = PETSC_NULL;
46b022a5c1SBarry Smith   MatPackageInitialized            = PETSC_FALSE;
47b022a5c1SBarry Smith   MatRegisterAllCalled             = PETSC_FALSE;
48b022a5c1SBarry Smith   MatList                          = PETSC_NULL;
49b022a5c1SBarry Smith   MatOrderingRegisterAllCalled     = PETSC_FALSE;
50b022a5c1SBarry Smith   MatOrderingList                  = PETSC_NULL;
51b022a5c1SBarry Smith   MatColoringList                  = PETSC_NULL;
52b022a5c1SBarry Smith   MatColoringRegisterAllCalled     = PETSC_FALSE;
53b022a5c1SBarry Smith   MatPartitioningList              = PETSC_NULL;
54b022a5c1SBarry Smith   MatPartitioningRegisterAllCalled = PETSC_FALSE;
55b022a5c1SBarry Smith   PetscFunctionReturn(0);
56b022a5c1SBarry Smith }
57e5beb14aSMatthew Knepley 
581153da11SBarry Smith #undef __FUNCT__
591153da11SBarry Smith #define __FUNCT__ "MatInitializePackage"
601153da11SBarry Smith /*@C
611153da11SBarry Smith   MatInitializePackage - This function initializes everything in the Mat package. It is called
621153da11SBarry Smith   from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to MatCreate()
631153da11SBarry Smith   when using static libraries.
641153da11SBarry Smith 
651153da11SBarry Smith   Input Parameter:
661153da11SBarry Smith   path - The dynamic library path, or PETSC_NULL
671153da11SBarry Smith 
681153da11SBarry Smith   Level: developer
691153da11SBarry Smith 
701153da11SBarry Smith .keywords: Mat, initialize, package
711153da11SBarry Smith .seealso: PetscInitialize()
721153da11SBarry Smith @*/
737087cfbeSBarry Smith PetscErrorCode  MatInitializePackage(const char path[])
741153da11SBarry Smith {
751153da11SBarry Smith   char              logList[256];
761153da11SBarry Smith   char              *className;
77ace3abfcSBarry Smith   PetscBool         opt;
781153da11SBarry Smith   PetscErrorCode    ierr;
791153da11SBarry Smith 
801153da11SBarry Smith   PetscFunctionBegin;
81b022a5c1SBarry Smith   if (MatPackageInitialized) PetscFunctionReturn(0);
82b022a5c1SBarry Smith   MatPackageInitialized = PETSC_TRUE;
83cce0b1b2SLisandro Dalcin   /* Inialize subpackage */
84cce0b1b2SLisandro Dalcin   ierr = MatMFFDInitializePackage(path);CHKERRQ(ierr);
851153da11SBarry Smith   /* Register Classes */
860700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix",&MAT_CLASSID);CHKERRQ(ierr);
870700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix FD Coloring",&MAT_FDCOLORING_CLASSID);CHKERRQ(ierr);
880700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix Partitioning",&MAT_PARTITIONING_CLASSID);CHKERRQ(ierr);
890700a824SBarry Smith   ierr = PetscClassIdRegister("Matrix Null Space",&MAT_NULLSPACE_CLASSID);CHKERRQ(ierr);
901153da11SBarry Smith   /* Register Constructors */
911153da11SBarry Smith   ierr = MatRegisterAll(path);CHKERRQ(ierr);
92cce0b1b2SLisandro Dalcin   ierr = MatOrderingRegisterAll(path);CHKERRQ(ierr);
93cce0b1b2SLisandro Dalcin   ierr = MatColoringRegisterAll(path);CHKERRQ(ierr);
94cce0b1b2SLisandro Dalcin   ierr = MatPartitioningRegisterAll(path);CHKERRQ(ierr);
951153da11SBarry Smith   /* Register Events */
960700a824SBarry Smith   ierr = PetscLogEventRegister("MatMult",          MAT_CLASSID,&MAT_Mult);CHKERRQ(ierr);
970700a824SBarry Smith   ierr = PetscLogEventRegister("MatMults",         MAT_CLASSID,&MAT_Mults);CHKERRQ(ierr);
980700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultConstr",    MAT_CLASSID,&MAT_MultConstrained);CHKERRQ(ierr);
990700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultAdd",       MAT_CLASSID,&MAT_MultAdd);CHKERRQ(ierr);
1000700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTranspose", MAT_CLASSID,&MAT_MultTranspose);CHKERRQ(ierr);
1010700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTrConstr",  MAT_CLASSID,&MAT_MultTransposeConstrained);CHKERRQ(ierr);
1020700a824SBarry Smith   ierr = PetscLogEventRegister("MatMultTrAdd",     MAT_CLASSID,&MAT_MultTransposeAdd);CHKERRQ(ierr);
1030700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolve",         MAT_CLASSID,&MAT_Solve);CHKERRQ(ierr);
1040700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolves",        MAT_CLASSID,&MAT_Solves);CHKERRQ(ierr);
1050700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveAdd",      MAT_CLASSID,&MAT_SolveAdd);CHKERRQ(ierr);
1060700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveTranspos", MAT_CLASSID,&MAT_SolveTranspose);CHKERRQ(ierr);
1070700a824SBarry Smith   ierr = PetscLogEventRegister("MatSolveTrAdd",    MAT_CLASSID,&MAT_SolveTransposeAdd);CHKERRQ(ierr);
1080700a824SBarry Smith   ierr = PetscLogEventRegister("MatSOR",           MAT_CLASSID,&MAT_SOR);CHKERRQ(ierr);
1090700a824SBarry Smith   ierr = PetscLogEventRegister("MatForwardSolve",  MAT_CLASSID,&MAT_ForwardSolve);CHKERRQ(ierr);
1100700a824SBarry Smith   ierr = PetscLogEventRegister("MatBackwardSolve", MAT_CLASSID,&MAT_BackwardSolve);CHKERRQ(ierr);
1110700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactor",      MAT_CLASSID,&MAT_LUFactor);CHKERRQ(ierr);
1120700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactorSym",   MAT_CLASSID,&MAT_LUFactorSymbolic);CHKERRQ(ierr);
1130700a824SBarry Smith   ierr = PetscLogEventRegister("MatLUFactorNum",   MAT_CLASSID,&MAT_LUFactorNumeric);CHKERRQ(ierr);
1140700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholeskyFctr",  MAT_CLASSID,&MAT_CholeskyFactor);CHKERRQ(ierr);
1150700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholFctrSym",   MAT_CLASSID,&MAT_CholeskyFactorSymbolic);CHKERRQ(ierr);
1160700a824SBarry Smith   ierr = PetscLogEventRegister("MatCholFctrNum",   MAT_CLASSID,&MAT_CholeskyFactorNumeric);CHKERRQ(ierr);
1170700a824SBarry Smith   ierr = PetscLogEventRegister("MatILUFactor",     MAT_CLASSID,&MAT_ILUFactor);CHKERRQ(ierr);
1180700a824SBarry Smith   ierr = PetscLogEventRegister("MatILUFactorSym",  MAT_CLASSID,&MAT_ILUFactorSymbolic);CHKERRQ(ierr);
1190700a824SBarry Smith   ierr = PetscLogEventRegister("MatICCFactorSym",  MAT_CLASSID,&MAT_ICCFactorSymbolic);CHKERRQ(ierr);
1200700a824SBarry Smith   ierr = PetscLogEventRegister("MatCopy",          MAT_CLASSID,&MAT_Copy);CHKERRQ(ierr);
1210700a824SBarry Smith   ierr = PetscLogEventRegister("MatConvert",       MAT_CLASSID,&MAT_Convert);CHKERRQ(ierr);
1220700a824SBarry Smith   ierr = PetscLogEventRegister("MatScale",         MAT_CLASSID,&MAT_Scale);CHKERRQ(ierr);
1230700a824SBarry Smith   ierr = PetscLogEventRegister("MatAssemblyBegin", MAT_CLASSID,&MAT_AssemblyBegin);CHKERRQ(ierr);
1240700a824SBarry Smith   ierr = PetscLogEventRegister("MatAssemblyEnd",   MAT_CLASSID,&MAT_AssemblyEnd);CHKERRQ(ierr);
1250700a824SBarry Smith   ierr = PetscLogEventRegister("MatSetValues",     MAT_CLASSID,&MAT_SetValues);CHKERRQ(ierr);
1260700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetValues",     MAT_CLASSID,&MAT_GetValues);CHKERRQ(ierr);
1270700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRow",        MAT_CLASSID,&MAT_GetRow);CHKERRQ(ierr);
1280700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRowIJ",      MAT_CLASSID,&MAT_GetRowIJ);CHKERRQ(ierr);
1290700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSubMatrice", MAT_CLASSID,&MAT_GetSubMatrices);CHKERRQ(ierr);
1300700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetColoring",   MAT_CLASSID,&MAT_GetColoring);CHKERRQ(ierr);
1310700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetOrdering",   MAT_CLASSID,&MAT_GetOrdering);CHKERRQ(ierr);
1320700a824SBarry Smith   ierr = PetscLogEventRegister("MatIncreaseOvrlp", MAT_CLASSID,&MAT_IncreaseOverlap);CHKERRQ(ierr);
1330700a824SBarry Smith   ierr = PetscLogEventRegister("MatPartitioning",  MAT_PARTITIONING_CLASSID,&MAT_Partitioning);CHKERRQ(ierr);
1340700a824SBarry Smith   ierr = PetscLogEventRegister("MatZeroEntries",   MAT_CLASSID,&MAT_ZeroEntries);CHKERRQ(ierr);
1350700a824SBarry Smith   ierr = PetscLogEventRegister("MatLoad",          MAT_CLASSID,&MAT_Load);CHKERRQ(ierr);
1360700a824SBarry Smith   ierr = PetscLogEventRegister("MatView",          MAT_CLASSID,&MAT_View);CHKERRQ(ierr);
1370700a824SBarry Smith   ierr = PetscLogEventRegister("MatAXPY",          MAT_CLASSID,&MAT_AXPY);CHKERRQ(ierr);
1380700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorCreate", MAT_FDCOLORING_CLASSID,&MAT_FDColoringCreate);CHKERRQ(ierr);
1390700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorApply",  MAT_FDCOLORING_CLASSID,&MAT_FDColoringApply);CHKERRQ(ierr);
1400700a824SBarry Smith   ierr = PetscLogEventRegister("MatFDColorFunc",   MAT_FDCOLORING_CLASSID,&MAT_FDColoringFunction);CHKERRQ(ierr);
1410700a824SBarry Smith   ierr = PetscLogEventRegister("MatTranspose",     MAT_CLASSID,&MAT_Transpose);CHKERRQ(ierr);
1420700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMult",       MAT_CLASSID,&MAT_MatMult);CHKERRQ(ierr);
1430700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatSolve",      MAT_CLASSID,&MAT_MatSolve);CHKERRQ(ierr);
1440700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultSym",    MAT_CLASSID,&MAT_MatMultSymbolic);CHKERRQ(ierr);
1450700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultNum",    MAT_CLASSID,&MAT_MatMultNumeric);CHKERRQ(ierr);
1460700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAP",          MAT_CLASSID,&MAT_PtAP);CHKERRQ(ierr);
1470700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAPSymbolic",  MAT_CLASSID,&MAT_PtAPSymbolic);CHKERRQ(ierr);
1480700a824SBarry Smith   ierr = PetscLogEventRegister("MatPtAPNumeric",   MAT_CLASSID,&MAT_PtAPNumeric);CHKERRQ(ierr);
1490700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrans",  MAT_CLASSID,&MAT_MatMultTranspose);CHKERRQ(ierr);
1500700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnSym" ,MAT_CLASSID,&MAT_MatMultTransposeSymbolic);CHKERRQ(ierr);
1510700a824SBarry Smith   ierr = PetscLogEventRegister("MatMatMultTrnNum", MAT_CLASSID,&MAT_MatMultTransposeNumeric);CHKERRQ(ierr);
1520700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetRedundant",  MAT_CLASSID,&MAT_GetRedundantMatrix);CHKERRQ(ierr);
1530700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSeqNZStrct", MAT_CLASSID,&MAT_GetSequentialNonzeroStructure);CHKERRQ(ierr);
15482d44351SHong Zhang   ierr = PetscLogEventRegister("MatGetMultiProcBlock", MAT_CLASSID,&MAT_GetMultiProcBlock);CHKERRQ(ierr);
1554ebed01fSBarry Smith 
1564ebed01fSBarry Smith   /* these may be specific to MPIAIJ matrices */
1570700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPINumeric",MAT_CLASSID,&MAT_Seqstompinum);
1580700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPISymbolic",MAT_CLASSID,&MAT_Seqstompisym);
1590700a824SBarry Smith   ierr = PetscLogEventRegister("MatMerge_SeqsToMPI",MAT_CLASSID,&MAT_Seqstompi);
1600700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMat",MAT_CLASSID,&MAT_Getlocalmat);
1610700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetLocalMatCondensed",MAT_CLASSID,&MAT_Getlocalmatcondensed);
1620700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetBrowsOfAcols",MAT_CLASSID,&MAT_GetBrowsOfAcols);
1630700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetBrAoCol",MAT_CLASSID,&MAT_GetBrowsOfAocols);
1644ebed01fSBarry Smith 
1650700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Symbolic",MAT_CLASSID,&MAT_Applypapt_symbolic);CHKERRQ(ierr);
1660700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt_Numeric",MAT_CLASSID,&MAT_Applypapt_numeric);CHKERRQ(ierr);
1670700a824SBarry Smith   ierr = PetscLogEventRegister("MatApplyPAPt",MAT_CLASSID,&MAT_Applypapt);CHKERRQ(ierr);
1684ebed01fSBarry Smith 
1690700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTrans",MAT_CLASSID,&MAT_Getsymtranspose);CHKERRQ(ierr);
1700700a824SBarry Smith   ierr = PetscLogEventRegister("MatGetSymTransR",MAT_CLASSID,&MAT_Getsymtransreduced);CHKERRQ(ierr);
1710700a824SBarry Smith   ierr = PetscLogEventRegister("MatTranspose_SeqAIJ_FAST",MAT_CLASSID,&MAT_Transpose_SeqAIJ);CHKERRQ(ierr);
1728154be41SBarry Smith   ierr = PetscLogEventRegister("MatCUSPCopyTo",MAT_CLASSID,&MAT_CUSPCopyToGPU);CHKERRQ(ierr);
1734ebed01fSBarry Smith 
1741153da11SBarry Smith   /* Turn off high traffic events by default */
1751153da11SBarry Smith   ierr = PetscLogEventSetActiveAll(MAT_SetValues, PETSC_FALSE);CHKERRQ(ierr);
1761153da11SBarry Smith   /* Process info exclusions */
1776cf91177SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-info_exclude", logList, 256, &opt);CHKERRQ(ierr);
1781153da11SBarry Smith   if (opt) {
1791153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1801153da11SBarry Smith     if (className) {
1810700a824SBarry Smith       ierr = PetscInfoDeactivateClass(MAT_CLASSID);CHKERRQ(ierr);
1821153da11SBarry Smith     }
1831153da11SBarry Smith   }
1841153da11SBarry Smith   /* Process summary exclusions */
1851153da11SBarry Smith   ierr = PetscOptionsGetString(PETSC_NULL, "-log_summary_exclude", logList, 256, &opt);CHKERRQ(ierr);
1861153da11SBarry Smith   if (opt) {
1871153da11SBarry Smith     ierr = PetscStrstr(logList, "mat", &className);CHKERRQ(ierr);
1881153da11SBarry Smith     if (className) {
1890700a824SBarry Smith       ierr = PetscLogEventDeactivateClass(MAT_CLASSID);CHKERRQ(ierr);
1901153da11SBarry Smith     }
1911153da11SBarry Smith   }
192b022a5c1SBarry Smith   ierr = PetscRegisterFinalize(MatFinalizePackage);CHKERRQ(ierr);
1931153da11SBarry Smith   PetscFunctionReturn(0);
1941153da11SBarry Smith }
1951153da11SBarry Smith 
1961153da11SBarry Smith #ifdef PETSC_USE_DYNAMIC_LIBRARIES
1971153da11SBarry Smith EXTERN_C_BEGIN
1981153da11SBarry Smith #undef __FUNCT__
1991153da11SBarry Smith #define __FUNCT__ "PetscDLLibraryRegister_petscmat"
2001153da11SBarry Smith /*
2011153da11SBarry Smith   PetscDLLibraryRegister - This function is called when the dynamic library it is in is opened.
2021153da11SBarry Smith 
2033f92711fSBarry Smith   This one registers all the matrix methods that are in the basic PETSc Matrix library.
2041153da11SBarry Smith 
2051153da11SBarry Smith   Input Parameter:
2061153da11SBarry Smith   path - library path
2071153da11SBarry Smith  */
2087087cfbeSBarry Smith PetscErrorCode  PetscDLLibraryRegister_petscmat(const char path[])
2091153da11SBarry Smith {
2101153da11SBarry Smith   PetscErrorCode ierr;
2111153da11SBarry Smith 
2121153da11SBarry Smith   PetscFunctionBegin;
2131153da11SBarry Smith   ierr = MatInitializePackage(path);CHKERRQ(ierr);
2141153da11SBarry Smith   PetscFunctionReturn(0);
2151153da11SBarry Smith }
2161153da11SBarry Smith EXTERN_C_END
2171153da11SBarry Smith 
2181153da11SBarry Smith 
2191153da11SBarry Smith #endif /* PETSC_USE_DYNAMIC_LIBRARIES */
220