Vibration Tutorial v0.1.1

Downloads

Standalone builds need no Python install. Download the one for your system, unpack it and run it.
They are not code-signed, so the operating system warns the first time you open one.

System	File	How to run
Windows 10/11 (64-bit)	vib-tutorial-*-windows-x64.zip	Unzip, then run vib-tutorial\vib-tutorial.exe. If SmartScreen says "Windows protected your PC", click More info → Run anyway.
macOS (Apple Silicon)	vib-tutorial-*-macos-arm64.zip	Unzip to get Vibration Tutorial.app. If macOS says the app "is damaged" or "can't be opened", run xattr -dr com.apple.quarantine "Vibration Tutorial.app" in Terminal once, then open it.
Linux (x86-64)	vib-tutorial-*-linux-x86_64.tar.gz	tar xzf vib-tutorial-*-linux-x86_64.tar.gz, then run vib-tutorial/vib-tutorial. Needs an X11 or Wayland desktop.

If a build doesn't run on your system (for example an Intel Mac), run from source with
uv instead: uvx --from git+https://github.com/WookieLumberjack/vib_tutorial@TAG vib-tutorial,
with TAG replaced by this release's tag.

This software is for educational use only, with no warranty; see the README's disclaimer.

What's Changed

• Fix the intermittent macOS segfault in the GUI tests; build macOS again by @WookieLumberjack in #38
• Bump the version to 0.1.1 by @WookieLumberjack in #39

Full Changelog: v0.1.0...v0.1.1

Vibration Tutorial v0.1.0

Downloads

Standalone builds need no Python install. Download the one for your system, unpack it and run it.
They are not code-signed, so the operating system warns the first time you open one.

System	File	How to run
Windows 10/11 (64-bit)	vib-tutorial-*-windows-x64.zip	Unzip, then run vib-tutorial\vib-tutorial.exe. If SmartScreen says "Windows protected your PC", click More info → Run anyway.
Linux (x86-64)	vib-tutorial-*-linux-x86_64.tar.gz	tar xzf vib-tutorial-*-linux-x86_64.tar.gz, then run vib-tutorial/vib-tutorial. Needs an X11 or Wayland desktop.

On macOS, or if a build doesn't run on your system, run from source with
uv instead: uvx --from git+https://github.com/WookieLumberjack/vib_tutorial@TAG vib-tutorial,
with TAG replaced by this release's tag.

This software is for educational use only, with no warranty; see the README's disclaimer.

What's Changed

• Add state-space (2N complex modes) modal analysis method by @WookieLumberjack in #1
• Update README with screenshots, feature overview and math summary by @WookieLumberjack in #2
• Add Craig-Bampton substructuring page by @WookieLumberjack in #3
• README: add substructuring ideas for extension by @WookieLumberjack in #4
• Add FRF matrix page: every receptance term and its modal build-up by @WookieLumberjack in #5
• Plot the motion in modal coordinates by @WookieLumberjack in #6
• Energy bars: stored energy, an exact energy balance, and energy by mode by @WookieLumberjack in #7
• Fix crash on the Basis (T) tab when changing the number of masses by @WookieLumberjack in #8
• README: retake the modal-coordinates screenshot with the app's white theme by @WookieLumberjack in #9
• Substructuring: free-interface component mode synthesis (Rubin, MacNeal) by @WookieLumberjack in #10
• Virtual modal test page: measure the FRF from simulated force and response signals by @WookieLumberjack in #11
• Virtual modal test: modal parameter extraction (peak picking, circle fit, LSCF + LSFD) by @WookieLumberjack in #12
• Energy time histories as a third Plot coordinates option by @WookieLumberjack in #13
• Element forces as a fourth Plot coordinates option by @WookieLumberjack in #14
• Drag a mass with the mouse and let go (pluck) by @WookieLumberjack in #15
• Chirp forcing and base excitation (ground motion) by @WookieLumberjack in #16
• Seed the modal-extraction GUI test so it is not flaky by @WookieLumberjack in #17
• Colour themes: Light, Dark, Solarized, Nord, and System by @WookieLumberjack in #18
• Stepped sine: draw samples as dots with the fitted sine through them by @WookieLumberjack in #19
• Stabilization: deselect poles, and a Clear poles button by @WookieLumberjack in #20
• Modal test: playback speed, drawing each record as it is recorded by @WookieLumberjack in #21
• Modal test: remember the playback speed between launches by @WookieLumberjack in #22
• Presets: vibration absorber, tuned mass damper, and a TMD on a building by @WookieLumberjack in #23
• Substructuring: simulate the reduced model beside the full one in time by @WookieLumberjack in #24
• Substructuring: several interfaces, three or more substructures by @WookieLumberjack in #25
• Substructuring: back expansion of the interior DOFs after the coupled solve by @WookieLumberjack in #26
• Substructuring: fix lag on the Time response and Back expansion tabs by @WookieLumberjack in #27
• Pause the Simulation page's run while another page shows by @WookieLumberjack in #28
• Add a Modal coupling page: two halves of the chain, one mode each, joined as a 2-DOF system by @WookieLumberjack in #29
• Modal coupling: FRF at the free end, both sides alone, readable μ axis by @WookieLumberjack in #30
• Readable log axes, Modal coupling before CMS, fresh README screenshots by @WookieLumberjack in #31
• Public release prep: MIT license, disclaimer, no-warranty notice by @WookieLumberjack in #32
• Add SECURITY.md by @WookieLumberjack in #33
• Add release builds: standalone apps for Linux, Windows and macOS by @WookieLumberjack in #34
• Fix the macOS release build: test failures and Node 20 actions by @WookieLumberjack in #35
• Detect defective eigenvalues however rounding splits them by @WookieLumberjack in #36
• Pause macOS release builds until its GUI-test segfault is fixed by @WookieLumberjack in #37

New Contributors

• @WookieLumberjack made their first contribution in #1

Full Changelog: https://github.com/WookieLumberjack/vib_tutorial/commits/v0.1.0