[ANN] StructuralVibration.jl - v1.0.0

After some months of hard work, I am thrilled to announce the release of the v1 of StructuralVibration.jl.

In this release, I have polished the API to be consistent across the package, but also with SciML conventions. But the major addition to the package is a whole set of functions related to Experimental analysis (EMA). Among those, one can mention:

  • Sdof methods (peak picking, Nyquist circle and least-squares fit)
  • Mdof methods (Least-squares complex exponential, Least-squares complex frequency, Polyreference least-squares complex frequency)
  • Stabilization diagram
  • Quality and analysis indicators
  • FRF reconstruction

For the complete list, you can read the online documentation.

As usual, PRs and issues are welcome!

Finally, the package is referenced on Zenodo for citations :wink:

Congratulations!
great documentation. What did you use to generate it? It doesn’t look like Documenter.jl

Quarto. It is stated at the bottom of the page.

As mentionned by @zdenek_hurak, I use Quarto, because I already use it for publishing my lecture notes. It is very easy to use and very well documented.

v1.1.0 has just been released!

It contains some nice additions related to Operational Modal Analysis. I have implemented Stochastic System Identification methods and extended the EMA algorithms to deal with half-spectrum. Don’t hesitate to read the release notes for a description of the changes.

Hi all,

Just a short message to announce that v1.9.1. has been released.

To remind you what StructuralVibration.jl contains, here is a list of the current functionalities:

Mechanical models

  • Discrete models
    • Spring-mass-damper SDOF system
    • Spring-mass-damper MDOF system
    • FE models of bar, rod, strings and beams
  • Continuous models
    • Longitudinal bars
    • Torsional bars
    • Strings
    • Beams
    • Rectangular plates
    • Rectangular membranes
  • State space model
    • Continuous state-space representation
    • Discrete state-space representation
      • Zero-order hold (ZOH)
      • First-order hold (FOH)
      • Band-limited hold (BLH)
      • RK4

Vibration data generation

  • Excitation signals

    • Rectangular wave
    • Triangular wave
    • Hammer impact
    • Smoothed rectangular wave
    • Sine wave
    • Half-sine pulse
    • Harversine pulse
    • Swept sine wave
    • Gaussian pulse
    • Colored noise
  • Solution for SDOF systems

    • Free response
    • Forced response due to a harmonic force or a base motion
    • Forced response due to any external force or base motion (Duhamel’s integral)
  • Time-domain integration schemes for linear second order systems

    • Central difference scheme
    • RK4
    • Newmark-beta method
    • Linear acceleration method
    • Fox-Goodwin method
    • HHT
    • WBZ
    • Generalized-alpha
    • Mid-Point rule
  • Frequency-domain calculations for linear systems

    • Frequency spectrum
      • Modal summation
      • Direct method
    • Frequency response function (FRF)
      • Modal summation
      • Direct method
  • State-space solvers

    • Time domain
      • RK4 for continuous systems
      • ZOH, FOH, BLH, RK4 for discrete models
    • Frequency spectrum
      • Modal summation
      • Direct method
    • Frequency response function (FRF)
      • Modal summation
      • Direct method
  • Measurement noise

    • Additive Gaussian white noise (agwn) with a prescribed SNR
    • Additive Colored noise (acn)
    • Multiplicative noise
    • Mixed - agwn + multiplicative noise

Signal processing

  • Measurement noise variance estimation algorithms from noisy data

    • Regularization-based estimation
    • D’Errico’s method - Link to the Matlab version
    • SNR estimation from estimated measurement noise variance
  • Denoising algorithms

    • Regularization
    • Kalman filtering
  • Signal preprocessing

    • Detrending data using polynomial fit
    • Gradient calculation using interpolation
  • Signal estimation

    • Transfer functions estimation (H1, H2, H3, Hv)
    • Welch method (PSD, ESD, Autopower, Autopower linear)
    • Signal spectrum estimation

Modal analysis

  • Experimental Modal Analysis - SDOF methods

    • Peak picking method
    • Circle fit method
    • Least-squares fit method
  • Experimental Modal Analysis - MDOF methods

    • Least-squares complex exponential (LSCE)
    • Least-squares complex frequency (LSCF)
    • Polyreference least-squares complex frequency (PLSCF)
    • Stabilization diagram
  • Operational Modal Analysis - EMA-based methods

    • EMA-based approaches (LSCE, LSCF, PLSCF)
    • Frequency-spatial Domain Decomposition (FSDD)
    • Stochastic Subspace Identification (SSI)
      • Covariance-driven SSI (CovSSI)
      • Data-driven SSI (DataSSI)
  • Operational Modal Analysis - ODS-based methods

    • Extraction of Operational Deflection Shapes (ODS) from response spectra
    • Extraction of Operational Deflection Shapes (ODS) from cross-spectral density matrices
  • Analysis indicators

    • Modal Overlap Factor (MOF)
    • Mode overcomplexity value (MOV)
    • Mode Phase Collinearity (MPC)
    • Mode Complexity Factor (MCF)
    • Mean Phase Deviation (MPD)
    • Modal Assurance Criterion (MAC)
    • Coordinate Modal Assurance Criterion (COMAC)
    • Enhanced Coordinate Modal Assurance Criterion (ECOMAC)
    • Frequency Response Assurance Criterion (FRAC)
    • Complex Mode Indicator Function (CMIF)
    • Power Spectrum indicator function (PSIF)
  • Modal synthesis

    • Estimation of the FRF/Half-spectrum residuals
    • Reconstruct FRF/Half-spectrum from modal parameters
  • Modal density estimation

    • Finite difference method
    • Global polynomial fitting
    • LOWESS
    • Cubic spline interpolation

Visualization

  • Bode plot
  • 2D and 3D Nyquist plot
  • Waterfall plot
  • General 2D plot
  • Stabilization diagram for Modal Analysis
  • Peaks plot

v1.10.0 is out! This new release adds two extensions for manipulating meshes and animating a structural field (kinematic field, mode shape, ODS, …). These extensions requires Makie.jl and Meshes.jl.

A word of caution though. This update is limited to surface/boundary meshes (i.e. using triangular or quadrangular elements), because these extensions have primarily been developed for experimental modal analysis (EMA and OMA).