rougier/pendulum — explained in plain English
Analysis updated 2026-07-18 · repo last pushed 2018-09-03
Watch a double pendulum simulation to visually understand how chaotic systems behave.
Use as a teaching aid for physics students learning about chaos theory and sensitivity to initial conditions.
Study the code as a starting example for building animated physics visualizations with matplotlib.
| rougier/pendulum | alex72-py/aria-termux | anime0t4ku/gentleman | |
|---|---|---|---|
| Stars | 20 | 20 | 20 |
| Language | Python | Python | Python |
| Last pushed | 2018-09-03 | — | — |
| Maintenance | Dormant | — | — |
| Setup difficulty | easy | moderate | moderate |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | general | developer | general |
Figures from each repo's GitHub metadata at analysis time.
README doesn't document customization, check the source code to adjust pendulum length, weight, or starting angle.
This is a Python program that simulates and visualizes a double pendulum, that's a pendulum with another pendulum attached to its end, and animates it in real time so you can watch it swing around. A double pendulum is a classic physics system that looks simple but behaves in surprisingly complex ways. Unlike a regular pendulum that swings back and forth predictably, a double pendulum can swing chaotically, with the second weight moving in wild, unpredictable arcs depending on tiny changes in starting position. The program calculates the physics of how each part moves, then uses matplotlib (a Python plotting library) to draw and animate the motion frame by frame, creating a smooth visualization you can watch on your screen. This kind of project is useful for a few reasons. Physics students and teachers use it to understand how chaotic systems work, it's a great visual proof that simple rules can create complex behavior. People interested in animation or data visualization might use it as a starting point for learning how to create animated graphics in Python. It's also just satisfying to watch something that looks physically realistic move around on screen. If you're learning physics simulations or matplotlib, this gives you a concrete working example to study and build on. The README doesn't provide much additional detail about how to run it or customize it, so you'd likely need to check the actual code files to learn how to adjust things like the pendulum length, weight, or starting angle.
A Python program that simulates and animates a chaotic double pendulum in real time using matplotlib, showing how simple physics rules create unpredictable motion.
Mainly Python. The stack also includes Python, Matplotlib.
Dormant — no commits in 2+ years (last push 2018-09-03).
Setup difficulty is rated easy, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.