GranE

Granular Eigenvalue

Purpose

A new project focusing on the eigenvalue problem of granular packings. This project is a continuation of the work in Granular Mechanics Acoustics

Documentation

The project wiki is the main reference: one page per function in src/ with default syntax, every option, and runnable examples.

Getting Started

1. Clone the repo and open the project root in MATLAB:

   addpath('src')

2. Generate a packing with pack (2D or 3D, Hooke or Hertz, optional friction):

   pack

3. Compute damped eigenmodes with processEigenModesDampedPara (parallel sweep over packing × damping), or build the K, Γ, M matrices yourself with matSpringDampMass.

4. Plot and inspect the results:

   • Attenuation vs. frequency with plotModes
   • Wave speed with eigenWavespeed
   • Saved variables described in the output files page

5. For batch runs on a cluster, see the runner scripts in hpc/ (see the wiki workflow page for details).

Roadmap

• 2D packing generation
• 3D packing generation
• Hertzian contacts