[ANN] StructuralVibration.jl - v1.0.0

Package Announcements
1

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:

11 Likes
2

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

1 Like
3

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

1 Like
4

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.

2 Likes
5

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.

6 Likes
6

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
5 Likes