Skip to content
jomorlierPublic

About

Materials for my FISA course on Vibration and Finite Element Analysis (VFEA)

Resources

Stars

9 stars

Watchers

1 watching

Forks

Repository files navigation

VFEA Part 1 — Vibration (Python edition)

Made with Jupyter License: MIT

A Python / Jupyter-notebook edition of VFEA Part 1: Vibration, the lecture notes written by Professor Joseph Morlier (ISAE-SUPAERO) to accompany the live vibration lessons of the VFEA course (Vibration and Finite Element Analysis). The original "student version" is a tufte-handout LaTeX book with in-class MATLAB exercises; this edition ports everything to Python (numpy, scipy, sympy, matplotlib, python-control), corrects a couple of transcription slips found along the way, adds numerical cross-checks throughout, and renders the whole thing as a browsable Jupyter Book / GitHub Pages website — inspired by the structure of Prof. Marcelo Maiarocha's PEC00025 (Introduction to Vibration Theory, PPGEC/UFRGS).

📖 Open the rendered website (replace jomorlier above with your GitHub username/organization once this repo is pushed — see "Publishing to GitHub Pages" below.)

Structure

  • basics/ — Prof. Morlier's own material, corrected and enhanced. Each topic has a solved reference notebook and a matching _Exercises notebook with the code blanked out (# TODO), exactly like the original in-class MATLAB skeletons.
  • advanced/ — topics not in the original notes but standard in a complete first vibrations course (and present in PEC00025): the Fourier transform / frequency-domain analysis of signals, Lagrange's equations, and the vibration of plates.
  • images/ — figures reused from the original lecture notes.
  • references/ — bibliography (references.bib).

Table of contents

Basics

# Chapter Covers
0 Introduction How to use this book, acknowledgements
1 SDOF — Free vibration (exercises) EoM, damping ratio, over/critically/under-damped motion, logarithmic decrement
2 SDOF — Forced vibration & FRF (exercises) Transfer function, Bode plot, sinusoidal forcing, resonance, Laplace transform
3 Duhamel, impulse response, base excitation (exercises) Convolution / Duhamel's integral, impulse response, base excitation, vibration absorbers
4 State space & numerical integration (exercises) State-space form, free/forced response, solve_ivp (the ode45 equivalent)
5 MDOF — eigenproblem & modal analysis (exercises) Generalized eigenvalue problem, orthogonality, modal coordinates, proportional damping
6 Continuous systems — rods & beams (exercises) Wave equation, Euler-Bernoulli beam, characteristic equation, mode shapes
7 Engineer's toolbox (exercises) Symmetric eigenvalue reformulation, Gershgorin's theorem, Rayleigh-Ritz quotient

Advanced

# Chapter Covers
8 Fourier transform & frequency domain DFT/FFT, spectral leakage, windowing, power spectral density, experimental FRF estimation
9 Lagrange prerequisites — matrix calculus $\partial(x^\mathsf{T}Mx)/\partial x=2Mx$, Hessian-based $M,C,K$ extraction, matrix form $M\ddot q+C\dot q+Kq=F$, and a 9-notebook Lagrange gallery translated to Python/sympy from Kelly's MATLAB repo
10 Lagrange's equations & fundamental principles Energy methods, virtual work, double-pendulum worked example
11 Vibration of plates Thin-plate equation, simply-supported rectangular plate modes

Corrections made to the original notes

While porting the material, a couple of small transcription slips in the original handwritten derivations were found and fixed (see the ⚠️ Correcting the original notes callouts in the notebooks themselves for the full explanation):

  • Chapter 5 (MDOF): the modal damping ratio $\zeta_2$ for the proportionally-damped 2-DOF example used the wrong coefficient (0.2 instead of 0.4) — fixed, and cross-checked against the original notes' own downstream numeric answer ($\omega_{d2}\approx1.99$), which only comes out right with the corrected value.
  • Chapter 7 (Engineer's toolbox): a handwritten exercise reused the damping matrix values where the stiffness matrix was intended — fixed, and cross-checked against the original notes' own stated result for $\tilde K$.

Every notebook in this repository has been numerically executed end-to-end, and most solved notebooks include an explicit cross-check (e.g. an independent numerical integration, or a closed-form limit) confirming the derived formulas actually match code.

Running locally

git clone <this-repo-url>
cd VFEA-vibration
pip install -r requirements.txt        # or: conda env create -f environment.yml
jupyter lab                            # open and run any notebook directly

Building / publishing the website

This site is built with Jupyter Book (the MyST-based v2 engine).

pip install jupyter-book
jupyter-book build --html              # builds into _build/html

A pre-rendered, dependency-free fallback is also included at site_preview/ (plain nbconvert --to html exports plus a hand-written index.html) — open site_preview/index.html directly in a browser with no build step at all. Regenerate it any time with:

python build_site_preview.py

Every notebook has a matching jupytext .py (percent format) companion file next to it. These stay in sync with the .ipynb and produce much cleaner git diffs when you edit a notebook's code — pair them with jupytext --sync notebook.ipynb after editing either file.

Publishing to GitHub Pages

A ready-to-use GitHub Actions workflow is included at .github/workflows/deploy.yml: push this repository to GitHub, enable Pages under Settings → Pages → Source: GitHub Actions, and every push to main will rebuild and publish the site automatically at https://<your-username>.github.io/<repo-name>/.

Acknowledgements

  • Original LaTeX lecture notes and MATLAB exercises: Prof. Joseph Morlier, ISAE-SUPAERO (joseph.morlier@isae-supaero.fr). Largely inspired by Park's lecture notes and by the textbooks of Inman, Blevins, Rao and Champaney.
  • Site structure and basics/advanced split inspired by PEC00025 (Prof. Marcelo Maiarocha, PPGEC/UFRGS).
  • Chapter 9's Lagrange gallery re-derives, in Python/sympy, the systems described in Matthew Kelly's MATLAB repository Lagrange_Mechanics_Derivations. Chapter 9 also points to Jason Moore's Python-based resonance teaching notebooks (UC Davis ENG 122) for further practice.

License

MIT — see LICENSE. Figures reused from the original lecture notes remain the property of their original author/sources.

About

Materials for my FISA course on Vibration and Finite Element Analysis (VFEA)

Resources

Stars

9 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages