Skip to main content

StructuralVibration.jl


Generic badge MIT License Aqua QA DispatchDoctor DOI

StructuralVibration.jl is a Julia package designed to generate vibration data for mechanical systems. This package can be used for educational and research purposes. As a teacher, you can use it to illustrate vibration theory and its practical implementation. As a researcher, you can use it to test new methods on synthetic data.

TipNew to the package?

Start with the Getting started page: in ten minutes, it takes you from installation to your first modal identification. Then pick a tutorial matching your needs:

Warning

The package is under active development and is developed as part of my research activities on source identification in structural dynamics and acoustics.

Software design

StructuralVibration.jl is designed according to certain guidelines to ensure that it is user-friendly, efficient, extensible, and composable. These guidelines include:

  • Type stability: All of the package’s functions are designed to ensure type stability, allowing for efficient execution and better performance.

  • Type genericity: The package is designed to be type-generic, enabling users to work with various data types, such as Float64, ComplexF32, while maintaining performance and flexibility.

  • Composability: The package is design to be compatible with other Julia packages. For example, users can define a state-space model using StructuralVibration.jl and perform the resolution using another package such as DifferentialEquations.jl.

  • Reliability: StructuralVibration.jl includes a comprehensive documentation and a test suite that ensures the reliability and correctness of the package. The documentation provides detailed explanations of the theoretical background of the package’s features, as well as the API of the data types and functions implemented. Various examples are also provided to help users get started.

  • Modularity: The package is based on a modular architecture that clearly separates the different functionalities (Modelling & Simulation, Signal Processing, Modal Extraction, Visualization & Animation) and facilitates the maintenance and extension. The general architecture of the package is presented in .

General architecture of StructuralVibration.jl

Features

The package provides the following features:

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

Visualization

  • Bode plot
  • 2D and 3D Nyquist plot
  • Waterfall plot
  • General 2D plot
  • Mesh visualization
  • Mesh animation

Reproducibility

Project StructuralVibration v1.12.0
Status
  [717857b8] DSP v0.8.7
  [82cc6244] DataInterpolations v10.1.4
  [7a1cc6ca] FFTW v1.10.0
  [442a2c76] FastGaussQuadrature v1.3.0
  [429524aa] Optim v2.3.2
  [18e31ff7] Peaks v0.6.2
  [f27b6e38] Polynomials v4.1.6
  [92933f4c] ProgressMeter v1.13.0
  [aed68c70] SkipNan v0.2.0
  [276daf66] SpecialFunctions v2.9.1
  [10745b16] Statistics v1.11.5
  [c751599d] ToeplitzMatrices v0.8.5
  [37e2e46d] LinearAlgebra v1.13.0
  [9a3f8284] Random v1.11.0
Julia Version 1.13.3
Commit 67ac47b9cd8 (2026-10-25 15:28 UTC)
Build Info:
  Official https://julialang.org release
Platform Info:
  OS: macOS (arm64-apple-darwin27.0.0)
  CPU: 16 × Apple M4 Max
  WORD_SIZE: 64
  LLVM: libLLVM-20.1.8 (ORCJIT, apple-m4)
  GC: Built with stock GC
Threads: 1 default, 1 interactive, 1 GC (on 16 virtual cores)
Environment:
  JULIA_EDITOR = code
  JULIA_VSCODE_REPL = 1
  JULIA_PKG_SERVER = https://juliahub.com

License

This package is under MIT License.

How to cite this package

If you use StructuralVibration.jl in your research, please consider citing it as follows:

[1] M. AUCEJO and contributors, « StructuralVibration.jl ». Zenodo, 2026.