White box / Algorithms and implementation / Matrix and spectral solvers

Modal sparse/dense eigensolvers

Algorithm / execution · assumptions, essential equations, full derivation, algorithm, code and verification references.

Browse another sheet Algorithms and implementation / Matrix and spectral solvers
Algorithms and implementationMatrix and spectral solversSheet 3 / 3
Algorithm / executionDENSE ROUTE SIZE-LIMITED

The normal sparse eigenroute calls ARPACK/eigsh; dense conversion is explicit and limited by active DOFs.

01 Model and scope

The sparse route extracts only selected generalized eigenpairs, often around a spectral shift. Dense conversion stores all matrix entries and costs roughly O(n²) memory and O(n³) work, so the active-DOF cap is part of the method boundary.

Route assumptions and calculation checks

  1. Mode count, spectral shift, tolerance, iteration limit, and dense DOF cap are input parameters.
  2. ARPACK non-convergence, excessive residual, or degraded mass orthogonality is not a pass.
  3. Rotating QEP uses a different dense complex solve and remains experimental.

02 Essential equations and symbols

Kφ=λMφK \varphi{} = \lambda{} M \varphi{}Sparse route:  eigsh(K,M,k=modes,σ=shift)\text{Sparse route:}\; eigsh(K, M, k=modes, \sigma{}=shift)DensestoragegrowsO(n2);denseeigensolveworkgrowsO(n3)Dense storage grows O(n^2); dense eigensolve work grows O(n^3)

Definitions and conventions

Kφ=λMφK\varphi{} = \lambda{}M\varphi{}
Generalized structural eigenproblem.
kk
Requested number of modes.
σ\sigma{}
Spectral shift used by the sparse extraction.
nn
Number of active degrees of freedom.
Modal sparse/dense eigensolvers · method mapSparse extraction and explicitly bounded dense conversion use different cost and memory contracts; the rotating QEP is separate.
4 detailed steps

03 Step by step derivation

Follow the assumptions, equations and discrete operations in order. The full explanation stays visible.

1 · Choose a sparse extraction or a bounded dense route

The modal problem is generalized: Kφ=λMφ. Sparse extraction requests a limited set of eigenpairs near a target shift; it avoids constructing a full dense matrix. Dense conversion is explicit and guarded by an active-DOF cap.

Kϕ=λMϕ\mathbf K\boldsymbol\phi=\lambda\mathbf M\boldsymbol\phisparse: eigsh⁡(K,M,k=m,σ=s)\text{sparse: }\operatorname{eigsh}(\mathbf K,\mathbf M,k=m,\sigma=s)

2 · Understand why dense size changes quickly

A dense n×n matrix stores n² entries, while a dense eigensolve requires work that grows cubically with n. The cap is therefore part of the solver contract and protects memory/runtime; it is not a cosmetic configuration option.

dense storage=O(n2),dense eigensolve=O(n3)\text{dense storage}=O(n^2),\qquad\text{dense eigensolve}=O(n^3)

3 · Check the returned spectrum

Verify convergence flags, eigenpair residuals, requested mode count, positive mass, and mass orthogonality. A sparse solver that returns a partial set or a loose residual must report that outcome. Shift selection influences which part of the spectrum is extracted.

ri=∥Kϕi−λiMϕi∥2max⁡(∥Kϕi∥2,∣λi∣∥Mϕi∥2,1)r_i=\frac{\|\mathbf K\boldsymbol\phi_i-\lambda_i\mathbf M\boldsymbol\phi_i\|_2}{\max(\|\mathbf K\boldsymbol\phi_i\|_2,|\lambda_i|\|\mathbf M\boldsymbol\phi_i\|_2,1)}

4 · Keep the rotating QEP separate

The rotating quadratic pencil contains a gyroscopic term and generally complex eigenpairs. It uses a distinct bounded dense route; classical ARPACK generalized symmetric settings and qualification claims do not transfer to that problem.

04 Algorithm and implementation

This sheet provides explanatory references rather than an inline source excerpt. Use the labeled sources to inspect the precise boundary.

05 Verification and limitations

DENSE ROUTE SIZE-LIMITED

The formulation and its explanatory checks do not by themselves establish a qualified application domain. Consult the capability matrix and the applicable recorded case.

Recorded repository calculations

See this method in a calculation.

Each case keeps its mesh, measured quantities, source record and limitations attached to the result.

Browse every calculation case →

06 Sources and related sheets

Continue the reasoning

Back to sheet contents ↑