https://github.com/osbm/sphere-eversion-animation
https://github.com/osbm/sphere-eversion-animation
Last synced: 12 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/osbm/sphere-eversion-animation
- Owner: osbm
- License: gpl-3.0
- Created: 2023-11-06T09:29:15.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-05T15:46:57.000Z (almost 2 years ago)
- Last Synced: 2024-08-06T11:52:50.735Z (almost 2 years ago)
- Language: JavaScript
- Homepage: http://osmanbayram.com/sphere-eversion-animation/
- Size: 17.3 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Thurston's sphere eversion algorithm
Ported to javascript and visualized using [three.js](https://threejs.org/).
Here is the famous explainer video [Outside In](https://www.youtube.com/watch?v=wO61D9x6lNY). And more info about the source C++ program [here](https://profs.etsmtl.ca/mmcguffin/eversion/)
From what i can tell this algorithm almost forgotten on the internet. Almost 3/4 of the links i find are dead. I hope this project can help keep it alive.
## Credits
From the [original cpp code](https://github.com/osbm/sphereEversion-0.4-src/blob/main/generateGeometry.cpp#L2-L13) that generates the geometry:
```
This file is part of "sphereEversion",
a program by Michael McGuffin.
The code in this file was almost entirely taken
(with slight adaptations) from the source code of
"evert", a program written by Nathaniel Thurston.
evert's source code can be down loaded from
http://www.geom.umn.edu/docs/outreach/oi/software.html
http://www.geom.uiuc.edu/docs/outreach/oi/software.html
Grateful acknowledgements go out to Nathaniel Thurston,
Silvio Levy, and the Geometry Center (University of Minnesota)
for making evert's source code freely available to the public.
```
Initially i just ported the C++ code to the Javascript as you can see [here](https://github.com/osbm/sphere-eversion-animation/tree/basic_version). But with the contributions of [Joseph Faulkner](https://github.com/josephmfaulkner) this project has come to life. Please check him out, he is awesome. :)
## Try it Yourself
If you want to play with this app without downloading the source code, here's a demo link: [Sphere Eversion Demo](https://osmanbayram.com/sphere-eversion-animation/)
## Up and running
### Requirements
You don't necessarily need these same versions, but I'm listing the ones I used:
- git (version 2.34.1)
- node (version 21.4.0)
- npm (version 10.2.4)
### Commands
```
git clone https://github.com/osbm/sphere-eversion-animation.git
cd sphere-eversion-animation
npm install
npm start
```