Struct VibrationAnalysis 

pub struct VibrationAnalysis { /* private fields */ }

Vibration analysis

Implementations

impl VibrationAnalysis

pub fn new() -> Self

pub fn initialize(&mut self) -> Result<(), EngineeringError>

pub fn free_vibration(&self) -> &FreeVibration

Borrow the free-vibration sub-component.

pub fn free_vibration_mut(&mut self) -> &mut FreeVibration

Mutably borrow the free-vibration sub-component.

pub fn forced_vibration(&self) -> &ForcedVibration

Borrow the forced-vibration sub-component.

pub fn forced_vibration_mut(&mut self) -> &mut ForcedVibration

Mutably borrow the forced-vibration sub-component.

pub fn random_vibration(&self) -> &RandomVibration

Borrow the random-vibration sub-component.

pub fn random_vibration_mut(&mut self) -> &mut RandomVibration

Mutably borrow the random-vibration sub-component.

pub fn analyze_free( &mut self, stiffness: &[f64], mass_diag: &[f64], num_dofs: usize, ) -> Result<FreeVibration, EngineeringError>

Undamped free-vibration analysis of an num_dofs-DOF lumped-mass system. Delegates to the same generalized eigenproblem as modal analysis (K φ = ω² M φ, wired to symmetric_eigen via [solve_modal_eigen]) and packs the result into FreeVibration: natural_frequencies are the natural angular frequencies ω (rad/s), ascending, with their mass- normalized mode shapes and zero damping ratios (undamped). Cached into self.free_vibration.

pub fn natural_frequency_sdof( &self, stiffness: f64, mass: f64, ) -> Result<f64, EngineeringError>

Single-DOF undamped natural angular frequency ω = √(k/m) (rad/s).

pub fn analyze_harmonic_sdof( &mut self, mass: f64, damping: f64, stiffness: f64, force_amplitude: f64, excitation_freqs: &[f64], ) -> Result<ForcedVibration, EngineeringError>

Steady-state harmonic (forced-vibration) response of a damped single-DOF oscillator m·ẍ + c·ẋ + k·x = F₀·sin(ωt). For each excitation angular frequency ω (rad/s) in excitation_freqs, returns the response amplitude X(ω) = F₀ / √((k − m·ω²)² + (c·ω)²) and the phase lag φ(ω) = atan2(c·ω, k − m·ω²) (rad). Genuine closed-form frequency-response function; no fabricated values. Fills and returns ForcedVibration.