Release Notes

v1.3.0

New features

  • Add pks_indices argument to AutoEMASdofProblem and poles_extraction function to specify the indices of peaks to consider during pole extraction using Sdof methods.

  • peaksplot is renamed to peaks_plot to avoid name conflict with the peaksplot function from Peaks.jl.

  • Add ods to compute Operational Deflection Shapes (ODS) using either the response spectrum or the cross-spectral density matrix.

Breaking changes

  • Rename c2r_modeshape function to real_normalization for clarity.

  • Sdof EMA methods now take a pks_indices argument to specify the indices of peaks to consider during pole extraction and bypass automatic peak detection.

v1.2.0

Minor changes

  • Fix bugs in eigenmode function for state-space models.

  • Fix bugs in comac function.

Breaking changes

  • Change PLSCF algorithm name to pLSCF in poles_extraction function.

  • Remove ismat argument from solve function of DirectFRFProblem, ModalFRFProblem, StateSpaceFRFProblem and StateSpaceModalFRFProblem. The output FRF is now always returned as a 3D array with dimensions (no. outputs, no. inputs, no. frequencies).

  • Remove ismat argument from impulse_response function for modal time solvers. The output is now always returned as a 3D array with dimensions (no. dofs, no. dofs, no. frequencies).

  • Add progress argument to stabilization function to control the display of the progress bar during stabilization analysis.

  • Add width, min_prom and max_prom arguments to poles_extraction function and AutoEMASdofProblem to specify the half-width of the peaks and the minimum and maximum peak prominence for pole extraction methods.

  • Add peaksplot to visualization functions to inspect peak detection in pole extraction methods.

v1.1.4

  • Add linkxaxes! function in stabilization_plot to link x-axes of poles and indicator plots when zooming.

v1.1.3

  • Solve some type instability issues in Modal extraction functions.

v1.1.2

  • Add ToeplitzMatrices packages to compute the Hankel matrix in LSCE.

v1.1.1

  • Minor bug fix in msf function.

v1.1.0

Breaking changes

  • Window functions
    • Add flattri function to generate a flat-triangular window
  • Modal extraction
    • Structure simplification. EMASdofProblem and EMAMdofProblem structures are now EMAProblem
    • Structure simplification. EMASdofSolution and EMAMdofSolution structures are now EMASolution
    • Add xcorr function to compute the cross-correlation matrix of a signal or between two signals
    • Add psd_from_tf function to compute the full Power Spectral Density (PSD) matrix of multiple signals from transfer function estimates and input PSDs
    • Add half_psd function to compute the half Power Spectral Density (PSD) matrix from the full PSD matrix or from time-domain signals
    • Rename EMAMdofStabilization structure to StabilizationAnalysis for clarity and generality
    • dpi argument of modeshape_extraction function is now passed as keyword arguments instead of positional arguments (for both Sdof and Mdof methods)
    • type argument argument of modeshape_extraction function (Mdof methods) has been renamed to modetype for clarity
    • Add OMAProblem structure to perform Operational Modal Analysis (OMA)
    • Add modes_extraction function for OMAProblem to extract modal parameters using Covariance-based SSI (CovSSI) and Data-based SSI (DataSSI) methods
    • Add halfspec_reconstruction function to reconstruct half-spectrum from extracted modal parameters from residues and poles for OMA and EMA-based methods
    • Add compute_residuals function for OMAProblem to compute the lower and upper residuals of the half-spectrum
    • Add display_poles argument to stabilization_plot function to choose which poles to display in the stabilization diagram plot

v1.0.0

Breaking changes

  • Sdof solvers
    • Refactor SdofHarmonicTimeProblem, SdofForcedTimeProblem and SdofFrequencyProblem to comply with DifferentialEquations.jl conventions

New features

  • Signal processing
    • Add csd function to compute the Cross Spectral Density (CSD) between two signals or between multiple input and output signals
    • Add support for matrix inputs in tfestimate function to compute the Frequency Response Function (FRF) between multiple input and output signals
    • Refactor tfestimate, welch, csd and spectrum functions to accept window functions instead of pre-computed window vectors
    • Add nfft parameter to tfestimate, welch, csd and spectrum functions to specify the number of FFT points to be used
  • Modal extraction
    • Add LSFit() method for modal parameter extraction using least squares fitting of the frequency response function around the resonance peak
    • Add AutoEMASdofProblem and AutoEMAMdofProblem structures and solve functions to perform automatic modal extraction based on Sdof or Mdof approximations
    • Solutions of AutoEMA problems are stored in EMASdofSolution or EMAMdofSolution structures containing the poles and the modal parameters
    • Add poles_extraction function to extract system poles using different Mdof methods:
      • Least-Squares Complex Exponential (LSCE) method
      • Least-Squares Complex Frequency-domain (LSCF) method
      • Polyreference Least-Squares Complex Frequency-domain (pLSCF) method
    • Add modeshape_extraction function to extract mode shapes from residues and poles using Mdof methods
    • Add stabilization function to perform stabilization diagram analysis using Mdof methods
    • Add stabilization_plot function to visualize stabilization diagrams
    • Stabilization results are now stored in the EMAMdofStabilization structure for plotting and further analysis
    • Add frf_reconstruction function to reconstruct FRFs from extracted modal parameters
    • Add compute_residuals function to compute the lower and upper residuals of the FRF
    • Add mode2residues function to compute residues from real modes information
    • Add modal extraction indicators:
      • Modal Overlap Factor (MOF)
      • Mode Overcomplexity Value (MOV)
      • Mode Phase Collinearity (MPC)
      • Mode Complexity Factor (MCF)
      • Mode Phase Deviation (MPD)
      • Modal Scale Factor (MSF)
      • 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)
    • Utils
      • Add modal2poles and poles2modal functions to convert between modal parameters and system poles

v0.3.0

Breaking change

  • Modify the implementation of the force window following PR #5. Thanks to @JakeZw for proposing this PR.

v0.2.0

Breaking change

  • Refactor of the visualization extension following issue #3. Theming has been removed from the plotting functions (function theme_choice is now exported).

v0.1.2

v0.1.1

  • Bug fixes in State space solvers

v0.1.0

  • Initial release of the package