A simple gui based self-similar fractal generator
This project is aimed to provide a simple gui for drawing fractals so that anyone enthusiastic enough can give them a try.
I was exploring an awesome site which taught me how a turtle would draw amazing fractal curves. Perhaps I made a small script which would draw fractals pretty neatly but it had two issues :-
- It was slow as it took sleeps in between each step (huh is it a turtle or a rabbit) and even after turning the animations off, it was still slow due to implementation styles
- Python Turtle's audience is beginners to programming, so it limited the extendibility of the script
- I wanted to learn more about GUI programming, python packaging, good coding practices and other important stuff
- It had limited scope in scrolling, panning and zooming (the most fun things to do with a fractal)
- There is no pyfractal python library hehe
- A GUI (obviously)
- Exporting fractals to your desired format (namely svg, postscript and png)
- Loading and storing curve parameters for future endeavours
- Scrolling, panning and zooming to any extent
- Preview of base shape of fractal
- Drawing multiple fractals at once on a canvas
- Appending rules of several fractals (more people may consider it a bug, but i consider it a feature)
- Degree and radian support
A few of the fractal images are available to download/view in fractal_images in png and svg formats
NOTE: Pngs may get HUGE in size, deter from using them
pip3 install pyfractal
or
pip install pyfractal
should do the job depending on the distribution
Having issues installing? Feel free to report issue or simply clone the repository and run main.py
import pyfractal #import the module
pyfractal.GUI().run() #to run the main gui
A GUI should pop up
Pressing on the plus and minus buttons adds and removes entires for rule input
Press the Save Parameters button to save the parameters, a dialog box should appear asking for the name of the file to save
the parameters are stored in a json file
Press the Load Parameters button to load the parameters, a dialog box should appear asking for the name of the file. If the file is correctly formatted, you should see the parameters loaded onto the screen and list of rules added to the list.
NOTE
The rules are appended to the list of pre-written rules (this is a design choice, not a bug) , clear the pre-existing rules by repeatedly pressing minus button then loading from file.
Feed in/ load the rules, you will see the preview of base fractal image on the smaller canvas.
Enter your desired Recursion Depth and you will see your fractal drawn on the canvas
Pan/scale/scroll in the canvas according to your viewing preferences
NOTE
The rules/preview-canvas is update only once plus or minus button is pressed.
Start drawing fractal from a smaller recursion-depth. The size of fractal is exponential in the recursion depth. It is recommended that you keep Recursion depth to a single digit integer.
The project is almost built entirely on tkinter Besides using Pillow and canvasvg to save the canvas
Feel free to contribute/clone/Issue or Contact me
This is probably a VERY long list but here are key TODO's :-
- Curved Edges
- Adding option to curve the corners/edges to make the fractal smoother and to see more clearly the sweep of the fractal
- Adding splines instead of boring straight lines
- Conversion of degree to radians in input feild on pressing radio buttons (not really important but OK)
- Help Pages
- No amount of help pages is sufficient
- Menubar
- Adding a Menubar for easy access to resources and help pages
- More graphic options
- Color support for lines and fills
- Background color/image specification
- Animations
- Animating the turtle (why?? wasn't this the main purpose behind building this project) to momentarily enjoy the chaos caused by simple rules of life
- More types of fractals
- Grid based input
As described here
- Square grid
- Triangular grid
- A general lattice maybe?
- A general 3 dimensional lattice (okay I admit I am being too optimistic)
- Fractal type specifier
- Automatically specify self-avoiding, self-contacting(edge/vertex), self-crossing types from the base rules
- Dimension calculator
- Fractal tile extraction
- Extract tiles from tile-able fractals
- More toooooools
- Clone fractals
- Drag and drop items around on the canvas
The following links are pretty useful and helpful in learning more about fractals
- http://www.fractalcurves.com is the main inspiration behind this project
- https://www.youtube.com/watch?v=gB9n2gHsHN4 is a pretty interesting watch by 3Blue1Brown
- My website
- Feel free to give suggestions/recommendations/criticism on Discord or LinkedIn