diff --git a/.DS_Store b/.DS_Store index eff8958..8974229 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/README.md b/README.md index 72cbad4..94b7d1a 100644 --- a/README.md +++ b/README.md @@ -9,16 +9,30 @@ This is not a library, but rather a collection of standalone scripts! As such, t # Quick start guide #### Install these requirements -- [Python 3.6+](https://www.anaconda.com/distribution/) (tested on Python 3.6 and Python 3.7, macOS Catalina and Windows 10) +- [Python 3.6 to 3.10](https://www.anaconda.com/distribution/) - [Numpy](https://numpy.org) package : `pip install numpy` -- [Numba](https://numba.pydata.org) package : `pip install numba` +- [Numba](https://numba.pydata.org) package : `pip install numba` _(not functional on Python 3.11+ as of 2/8/2023)_ + +- For the Logistic Map user interface: + - [PyQt5](https://pypi.org/project/PyQt5/) : `pip install pyqt5` + - [PyQtGraph](https://pyqtgraph.readthedocs.io/en/latest/) : `pip install pyqtgraph` (Python 3.6, 3.7) or `pip install pyqtgraph==0.11.0rc0` (Python 3.8) + +- For the 3D Mandelbrot Set & Logistic Map Zoom: + - [Vispy](http://vispy.org) : `pip install vispy` + - [Matplotlib](https://matplotlib.org) : `pip install matplotlib` + - [PyOpenGL](https://pypi.org/project/PyOpenGL/) : `pip install pyopengl` + - [ffmpeg](https://www.ffmpeg.org) if you want to auto-stitch rendered frames to .movs + - macOS: [Install homebrew](https://brew.sh) then `brew install ffmpeg` + - Windows: [Install chocolatey](https://chocolatey.org) then `choco install ffmpeg` + +All in one: `pip install numpy numba pyqt5 pyqtgraph vispy matplotlib pyopengl` #### Run guide for total beginners 0. Open "Terminal" on macOS & Linux, "Powershell" or "Command Prompt" on Windows 1. Download this repository and unzip it or run `git clone https://github.com/jonnyhyman/Chaos.git` 2. Change directory into the folder where you extracted files `cd ~/route/to/your/folder` 3. Run the program you're interested in, like `python logistic_interactive.py` -4. To make changes to the code, install a text editor like [Atom](https://atom.io) and then open the file you want to edit. If this is your first python project, GO FOR IT, but also it might not be the easiest to get your head wrapped around (I use a lot of nuanced python functionality). +4. To make changes to the code, install a text editor like [Visual Studio Code](https://code.visualstudio.com) and then open the file you want to edit. If this is your first python project, GO FOR IT, but also it might not be the easiest to get your head wrapped around (I use a lot of nuanced python functionality). #### If you run into problems 0. Google the problem you're running into @@ -30,10 +44,6 @@ This is not a library, but rather a collection of standalone scripts! As such, t `python logistic_interactive.py` ![Interactive](https://github.com/jonnyhyman/Chaos/blob/master/images/logistic-interactive.png?raw=true) -#### Additional Requirements -- PyQt5 : `pip install pyqt5` -- PyQtGraph : `pip install pyqtgraph` (Python 3.6, 3.7) or `pip install pyqtgraph==0.11.0rc0` (Python 3.8) - This visualization creates a cobweb plot, time series graph, and bifurcation plot for visualizing the logistic map. The font pictured is "Avenir Next" which is licensed as part of macOS. Other OSes will see their default font. #### Shortcuts: @@ -48,15 +58,7 @@ This visualization creates a cobweb plot, time series graph, and bifurcation plo Here we see the Mandelbrot set on the x-y plane, and iterations of the Mandelbrot set in the z axis. This reveals the bifurcation plot beneath the Mandelbrot set! -Final visualization is accomplished by a volume rendering of 1000x1000x1000 voxels, oversampled by 16 to reduce aliasing. - -#### Additional Requirements -- [Vispy](http://vispy.org) : `pip install vispy` -- [Matplotlib](https://matplotlib.org) : `pip install matplotlib` -- [PyOpenGL](https://pypi.org/project/PyOpenGL/) : `pip install pyopengl` -- [ffmpeg](https://www.ffmpeg.org) if you want to auto-stitch rendered frames to .movs - - macOS: [Install homebrew](https://brew.sh) then `brew install ffmpeg` - - Windows: [Install chocolatey](https://chocolatey.org) then `choco install ffmpeg` +Final visualization is accomplished by a volume rendering of 1000x1000x1000 voxels, oversampled by 16 to reduce aliasing. At that resolution the visual _does not run in realtime_. ---- @@ -64,5 +66,4 @@ Final visualization is accomplished by a volume rendering of 1000x1000x1000 voxe `python logistic_zoom.py` ![Logistic Map Zoom GIF](https://github.com/jonnyhyman/Chaos/blob/master/images/logistic-zoom.gif?raw=true) -- [Vispy](http://vispy.org) : `pip install vispy` - - Note: The final version of the visualization used a custom version of Vispy, modified to improve the appearance of axes. I have not released this and don't plan to, but if you really need it please post in Issues a feature request. +- Note: The final version of the visualization used a custom version of Vispy, modified to improve the appearance of axes. I have not released this and don't plan to. \ No newline at end of file