Date: 2026-03-31T13:23:28+00:00

Actual source code: dlregiseps.c

      1: /*
      2:    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      3:    SLEPc - Scalable Library for Eigenvalue Problem Computations
      4:    Copyright (c) 2002-, Universitat Politecnica de Valencia, Spain

      6:    This file is part of SLEPc.
      7:    SLEPc is distributed under a 2-clause BSD license (see LICENSE).
      8:    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      9: */

     11: #include <slepc/private/epsimpl.h>

     13: static PetscBool EPSPackageInitialized = PETSC_FALSE;

     15: const char *EPSBalanceTypes[] = {"NONE","ONESIDE","TWOSIDE","USER","EPSBalance","EPS_BALANCE_",NULL};
     16: const char *EPSErrorTypes[] = {"ABSOLUTE","RELATIVE","BACKWARD","EPSErrorType","EPS_ERROR_",NULL};
     17: const char *EPSPowerShiftTypes[] = {"CONSTANT","RAYLEIGH","WILKINSON","EPSPowerShiftType","EPS_POWER_SHIFT_",NULL};
     18: const char *EPSKrylovSchurBSETypes[] = {"SHAO","GRUNING","PROJECTEDBSE","EPSKrylovSchurBSEType","EPS_KRYLOVSCHUR_BSE_",NULL};
     19: const char *EPSLanczosReorthogTypes[] = {"LOCAL","FULL","SELECTIVE","PERIODIC","PARTIAL","DELAYED","EPSLanczosReorthogType","EPS_LANCZOS_REORTHOG_",NULL};
     20: const char *EPSPRIMMEMethods[] = {"","DYNAMIC","DEFAULT_MIN_TIME","DEFAULT_MIN_MATVECS","ARNOLDI","GD","GD_PLUSK","GD_OLSEN_PLUSK","JD_OLSEN_PLUSK","RQI","JDQR","JDQMR","JDQMR_ETOL","SUBSPACE_ITERATION","LOBPCG_ORTHOBASIS","LOBPCG_ORTHOBASISW","EPSPRIMMEMethod","EPS_PRIMME_",NULL};
     21: const char *EPSCISSQuadRules[] = {"(not set yet)","TRAPEZOIDAL","CHEBYSHEV","EPSCISSQuadRule","EPS_CISS_QUADRULE_",NULL};
     22: const char *EPSCISSExtractions[] = {"RITZ","HANKEL","EPSCISSExtraction","EPS_CISS_EXTRACTION_",NULL};
     23: const char *EPSEVSLDOSMethods[] = {"KPM","LANCZOS","EPSEVSLDOSMethod","EPS_EVSL_DOS_",NULL};
     24: const char *EPSEVSLDampings[] = {"NONE","JACKSON","SIGMA","EPSEVSLDamping","EPS_EVSL_DAMPING_",NULL};
     25: const char *const EPSConvergedReasons_Shifted[] = {"","DIVERGED_SYMMETRY_LOST","DIVERGED_BREAKDOWN","DIVERGED_ITS","CONVERGED_ITERATING","CONVERGED_TOL","CONVERGED_USER","EPSConvergedReason","EPS_",NULL};
     26: const char *const*EPSConvergedReasons = EPSConvergedReasons_Shifted + 4;

     28: /*@C
     29:   EPSFinalizePackage - This function destroys everything in the SLEPc interface
     30:   to the `EPS` package. It is called from `SlepcFinalize()`.

     32:   Level: developer

     34: .seealso: [](ch:eps), `SlepcFinalize()`, `EPSInitializePackage()`
     35: @*/
     36: PetscErrorCode EPSFinalizePackage(void)
     37: {
     38:   PetscFunctionBegin;
     39:   PetscCall(PetscFunctionListDestroy(&EPSList));
     40:   PetscCall(PetscFunctionListDestroy(&EPSMonitorList));
     41:   PetscCall(PetscFunctionListDestroy(&EPSMonitorCreateList));
     42:   PetscCall(PetscFunctionListDestroy(&EPSMonitorDestroyList));
     43:   EPSPackageInitialized       = PETSC_FALSE;
     44:   EPSRegisterAllCalled        = PETSC_FALSE;
     45:   EPSMonitorRegisterAllCalled = PETSC_FALSE;
     46:   PetscFunctionReturn(PETSC_SUCCESS);
     47: }

     49: /*@C
     50:    EPSInitializePackage - This function initializes everything in the `EPS` package.
     51:    It is called from `PetscDLLibraryRegister_slepceps()` when using dynamic libraries, and
     52:    on the first call to `EPSCreate()` when using shared or static libraries.

     54:    Note:
     55:    This function never needs to be called by SLEPc users.

     57:    Level: developer

     59: .seealso: [](ch:eps), `EPS`, `SlepcInitialize()`, `EPSFinalizePackage()`
     60: @*/
     61: PetscErrorCode EPSInitializePackage(void)
     62: {
     63:   char           logList[256];
     64:   PetscBool      opt,pkg;
     65:   PetscClassId   classids[1];

     67:   PetscFunctionBegin;
     68:   if (EPSPackageInitialized) PetscFunctionReturn(PETSC_SUCCESS);
     69:   EPSPackageInitialized = PETSC_TRUE;
     70:   /* Register Classes */
     71:   PetscCall(PetscClassIdRegister("EPS Solver",&EPS_CLASSID));
     72:   /* Register Constructors */
     73:   PetscCall(EPSRegisterAll());
     74:   /* Register Monitors */
     75:   PetscCall(EPSMonitorRegisterAll());
     76:   /* Register Events */
     77:   PetscCall(PetscLogEventRegister("EPSSetUp",EPS_CLASSID,&EPS_SetUp));
     78:   PetscCall(PetscLogEventRegister("EPSSolve",EPS_CLASSID,&EPS_Solve));
     79:   PetscCall(PetscLogEventRegister("EPSCISS_SVD",EPS_CLASSID,&EPS_CISS_SVD));
     80:   /* Process Info */
     81:   classids[0] = EPS_CLASSID;
     82:   PetscCall(PetscInfoProcessClass("eps",1,&classids[0]));
     83:   /* Process summary exclusions */
     84:   PetscCall(PetscOptionsGetString(NULL,NULL,"-log_exclude",logList,sizeof(logList),&opt));
     85:   if (opt) {
     86:     PetscCall(PetscStrInList("eps",logList,',',&pkg));
     87:     if (pkg) PetscCall(PetscLogEventDeactivateClass(EPS_CLASSID));
     88:   }
     89:   /* Register package finalizer */
     90:   PetscCall(PetscRegisterFinalize(EPSFinalizePackage));
     91:   PetscFunctionReturn(PETSC_SUCCESS);
     92: }

     94: #if defined(PETSC_HAVE_DYNAMIC_LIBRARIES)
     95: /*
     96:   PetscDLLibraryRegister - This function is called when the dynamic library
     97:   it is in is opened.

     99:   This one registers all the EPS methods that are in the basic SLEPc libslepceps
    100:   library.
    101:  */
    102: SLEPC_EXTERN PetscErrorCode PetscDLLibraryRegister_slepceps(void)
    103: {
    104:   PetscFunctionBegin;
    105:   PetscCall(EPSInitializePackage());
    106:   PetscFunctionReturn(PETSC_SUCCESS);
    107: }
    108: #endif /* PETSC_HAVE_DYNAMIC_LIBRARIES */