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)
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.
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.
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).
v1.11 is out. This minor release adds five Makie apps designed for pedagogical purposes:
Free Response of a 1-DOF System: This application simulates the free response of a single degree of freedom system, allowing users to observe how the system behaves when it is displaced from its equilibrium position and then released.
Forced Response of a 1-DOF System: This application simulates the forced response of a single degree of freedom system, allowing users to observe how the system responds to an external force applied to it.
Free Response of a 2-DOF System: This application simulates the free response of a two degree of freedom system, allowing users to observe how the system behaves when it is displaced from its equilibrium position and then released.
Forced Response of a 2-DOF System: This application simulates the forced response of a two degree of freedom system, allowing users to observe how the system responds to an external force applied to it.
Newmark Method for a 2-DOF System: This application implements the Newmark method for simulating the response of a two degree of freedom system, allowing users to observe how the system responds to various parameters.
Don’t hesitate to play with it and give me some feedbacks! You can also propose other apps.
I have some experience in random vibrations. During my Phd, I developed a method for modeling the vibro-acoustic response of structures submitted to random excitations like Turbulent Boundary Layer or Diffuse Acoustic Field.
Great documentation and cool package! One question: I am having a hard time finding some tutorials or examples on how to use this package. I think your docs (which are already very nicely made!) could profit a lot from an easy-to-find beginner tutorial.
Your docs say “This package can be used for educational and research purposes.” That might imply it can’t be used for commercial purposes, but the license doesn’t appear to limit it that way. Is this sentence just a hint about academic origins?
I think that the MIT Licence allows commercial use. What I wanted to highlight was the original purposes of the package. Despite careful review and testing of the code, there is no guarantees that it is bug free. So, if someone wants to use it for commercial purposes, it is at its own risk (like any open source and free software).
Could you elaborate please ? I am very biaised as the author of the package and I am not the best to know what users really need.
I built the doc with the idea to provide an example for the most part of the functions, each building block. But if you had difficulties using the package, it means that it is not enough. I would be happy to improve the documentation with additional material.
I can highly recommend this talk by Chris Rackauckas where he explains what I am trying to communicate (from the timestamp up to approx. +3 mins):
Essentialy, imagine you are, like me, a beginner with respect to structural dynamics and especially StructuralVibration.jl: one or more self-contained tutorials or examples can quickly convey how the package is supposed to be used. After that, for specific questions, the broader docs are the main knowledge resource.
This release brings with a lot of bug fixes (see here for the complete list).
Apart from that, a collection of Tutorials is now available. These tutorials show how to use the package in various scenarios, and provide more insights on results interpretation.