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.)
basics/— Prof. Morlier's own material, corrected and enhanced. Each topic has a solved reference notebook and a matching_Exercisesnotebook 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).
| # | 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 |
| # | Chapter | Covers |
|---|---|---|
| 8 | Fourier transform & frequency domain | DFT/FFT, spectral leakage, windowing, power spectral density, experimental FRF estimation |
| 9 | Lagrange prerequisites — matrix calculus |
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 |
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.
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 directlyThis site is built with Jupyter Book (the MyST-based v2 engine).
pip install jupyter-book
jupyter-book build --html # builds into _build/htmlA 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.pyEvery 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.
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>/.
- 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 repositoryLagrange_Mechanics_Derivations. Chapter 9 also points to Jason Moore's Python-basedresonanceteaching notebooks (UC Davis ENG 122) for further practice.
MIT — see LICENSE. Figures reused from the original lecture notes remain the property of their original author/sources.