Package: pymandel
PyMandelCurrent Status|Installation|How to Use|Command Line Utility|Author & LicensePyMandel is a free, open-source graphical Mandelbrot and Julia Set rendering application written entirely in Python 3 and tkinter 8.6, with metadata import/export, basic animation functionality and performance enhancement viaNumbaJIT compilation, parallelisation and caching.The application plots fractals in an expandable window and allows the user to save the image as a .png file. It automatically saves the metadata (settings) associated with an image and provides a facility to import that metadata at a later date to reproduce it. It supports popular variants such as 'Burning Ship' and 'Tricorn'.It also includes both GUI and command line facilities to automatically create sequences of 'deep zoom' or 'spinning Julia Set' images which can be converted into animated GIF files or short videos using external open source tools (e.g. GIMP or OpenShot).Current StatusPyMandel is intended as free, open-source educational fun. We're not looking to compete with the likes of Ultra Fractal © here, but contributions are very welcome - please refer toCONTRIBUTING.MD.Animated Mandelbrot Zoom sequenceThis 178 frame, 10 fps sequence was automatically generated using themandelclicommand line utility and converted into an animated GIF file using GIMP. The entire sequence took about 35 seconds to render and save.mandelcli --filename zoom --width 400 --height 300 --frames 178 --zoom 0.75 --zoominc 1.2 --zxoffset -0.743643887037158704752191506114774 --zyoffset 0.131825904205311970493132056385139 --theme Colorcet_CET_C1Animated Julia Spin sequencesThese 400 frame, 20 fps sequences were automatically generated using the GUI's SPIN function and converted into animated GIF files using GIMP. The second sequence illustrates a Julia Set with exponent = 3.Sample Metadata{"pymandel": {
    "filename": "C:/Users/myuser/Downloads/mandela.png", 
    "created": "Apr 08 2020 19:43:41 GMT Standard Time", 
    "settype": "Mandelbrot",
    "setvar": "Standard",
    "zoom": 7500000000.0,
    "zoominc": 1.2,
    "frames": 10,
    "escradius": 2,
    "exponent": 2,
    "maxiter": 20000, 
    "zxoffset": -0.7491649396736062, 
    "zyoffset": 0.071803172645556,
    "cxoffset": 0, 
    "cyoffset": 0, 
    "theme": "Colorcet_CET_C1",
    "shift": 0
    }
}InstallationIn the following,python&piprefer to the Python 3 executables. You may need to typepython3orpip3, depending on your particular environment. It is also recommended that
the Python 3 scripts (bin) and site_packages directories are included in your PATH (most standard Python installation packages should do this automatically).DependenciesPyMandel is compatible with Python >=3.8 <=3.12.On Windows and MacOS, pip, tkinter and the necessary imaging libraries are generally packaged with Python.  On some Linux distributions like Ubuntu 18+ and Raspberry Pi OS, they may need to be installed separately, e.g.:sudoaptinstallpython3-pippython3-tkpython3-pilpython3-pil.imagetklibjpeg-devzlib1g-devIf you're installing Python 3 from source, you may also need to install the tkinter development library (refer tohttp://wiki.python.org/moin/TkInterfor further details):sudoaptinstalltk-devel1. Install using pipThe easiest way to install the latest version of PyMandel is viapip:python3-mpipinstall--upgradepymandelIf required,PyMandelcan also be installed into a virtual environment, e.g.python3-mpipinstall--user--upgradevirtualenv
python3-mvirtualenvenvsourceenv/bin/activate(orenv\Scripts\activateonWindows)(env)python3-mpipinstall--upgradepymandel
...
deactivateTo run the application, if the Python 3 scripts (bin) directory is in your PATH, simply type (all lowercase):pymandelIf desired, you can add a shortcut to this command to your desktop or favourites menu.Alternatively, if the Python 3 site_packages directory is in your PATH, you can type (all lowercase):python3-mpymandelNB:if the Python 3 scripts (bin) or site_packages directories arenotin your PATH, you will need
to add the fully-qualified path topymandelin the commands above.Tip: to find the site_packages location, typepip3 show pymandeland look for theLocation:entry in the response, e.g.Linux:Location: /home/username/.local/lib/python3.12/site-packagesMacOS:Location: /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packagesWindows:Location: c:\users\username\appdata\roaming\python\python312\lib\site-packagesTip:To create an application launcher for linux distributions like Ubuntu, create a text file namedpymandel.desktopwith the following content (edited for your particular environment) and copy this to the/home/user/.local/share/applicationsfolder, e.g.[Desktop Entry]
Type=Application
Terminal=false
Name=PyMandel
Icon=/home/user/.local/lib/python3.11/site-packages/pygpsclient/resources/pymandel.png
Exec=/home/user/.local/bin/pymandel2. Manual installationThe following Python libraries are required (these will be installed automatically if using pip to install PyMandel):python3-mpipinstall--upgradenumbanumpyPillowTo install PyMandel manually, download and unzip this repository and type:python3-m/path_to_folder/foldername/pymandele.g. if you downloaded and unzipped to a folder namedPyMandel-1.0.12, type:python3-m/path_to_folder/PyMandel-1.0.12/pymandelPerformance OptimisationsThe application makes use ofNumbajust in time (jit) compilation, caching and parallelisation techniques, in conjunction with Numpy image arrays, to dramatically improve calculation and rendering times relative to standard Python, particularly on multi-core CPUs.NB:The very first time the program is used after installation, jit compilation and caching will delay the first plot by a couple of seconds, but thereafter the rendering should start instantly.How To UseSettings can be entered manually (or imported from a previously saved metadata file) to plot a fractal image using the specified parameters.Use the mouse wheel to zoom in and out at the current cursor location. There may be some lag at very high resolutions or where a substantial part of the image is within the set (i.e. black).Left-click, drag and release to zoom into a drawn rectangular area.Left-click momentarily to zoom in at the current cursor location by the Zoom Increment amount (e.g. a Zoom Increment of 10 will zoom in tenfold)Shift & Left-click to zoom out by the same amount.Right-clicking anywhere in the plot area will centre the image at that point using the currently specified zoom level.NB:Pressing Alt-L (left-hand Alt key) or Ctrl-L (left-hand Ctrl key) while left-clicking in Mandelbrot mode will automatically switch to Julia mode and plot the Julia Set corresponding to the cx, cy offset at the cursor location. Useful points of interest can be found anywhere around the perimeter of the Mandelbrot set.Pressing the Left ◀ or Right ▶ arrow keys in Julia mode will rotate the Julia Set clockwise or anti-clockwise about its origin (the SPIN animation function does this automatically).PLOT button - plot the image using current settings.Cancel button - cancel the current plot operation.Reset button - reset the parameters to the default values.Save button - save the currently displayed image as a PNG file. You will be prompted for a directory on first use. A corresponding metadata json file will also be saved containing the parameters that were used to create the image, allowing it to be reproduced at a later date.File..Import Settings - import previously saved metadata. You will be prompted to select a json file to import. Some sample *.json files can be found in theImagesfolderZoom button - automatically create and save a sequence of images at increasing zoom levels, which can be converted externally into an animation (e.g. GIF or short video).Spin button - in Julia mode only, automatically creates and saves a 360 degree 'spinning Julia Set' sequence. Increasing the number of frames will result in a slower but more detailed spin animation.Options..Hide/Show Status - toggles the Status Bar on or off.Options..Hide/Show Settings - toggles the Settings panel on or off.Help..How To - display how to use instructions.Help..About - display help screen with links to license and source code.Settings:Set Type (Mode). Select from Mandelbrot or Julia.Set Variant. Select from Standard, Tricorn or BurningShip.Zoom level. The application currently uses standard 64-bit double precision and the maximum practical zoom level before floating-point errors cause pixelation is around 2 x 1013(20 million million).ZX axis offset in Real or 'Re' dimensional units (typically in the range -2.0 to 1.2).ZY axis offset in Imaginary or 'Im' dimensional units (typically in the range -1.2 to 1.2).CX axis offset of the Julia Set in Real or 'Re' dimensional units.CY axis offset of the Julia Set in Imaginary or 'Im' dimensional units.Max Iterations. Maximum number of iterations, which broadly equates to the fineness or resolution of the image. It will also affect the colour rendition in most themes. Higher zoom levels will typically require a higher number of iterations to produce a detailed image.Auto. If checked, maximum iterations will be automatically calculated according to the current zoom level.Escape Radius. The escape radius (defaults to 2, but higher values can produce more expansive color gradients).Exponent. The iteration exponent (normally 2 for the classic Mandelbrot, but higher exponents yield other radially symmetric forms at the cost of increased rendering time).Theme - a list of color rendering themes is provided. These are based on a variety of rendering algorithms, including cyclic colormap indexing; HSV derivations; banded RGB maps and simple grayscale. The code allows additional algorithms to be easily added.Theme Shift - this modifies the characteristics of certain themes, typically by shifting the hue along the spectrum or color map index. Its effect will depend on the specific rendering algorithm used.An image filename for saved images, metadata and animation frames.Frames. The number of animation frames to create.Zoom Increment. The zoom increment between frames (e.g. an increment of 1.5 means each successive frame is zoomed in 1.5x as much as the previous one; set Zoom Increment < 1 to zoom out). Used for left-click zooms and animations. For animations, the number of iterations is also automatically increased with the zoom level in accordance with a predefined algorithm.Command Line Utilitiesmandelcli.pymandelcliis a command line equivalent to the GUI's Animate function. If PyMandel has been installed usingpipand the Python 3 scripts (bin) directory is in the user's PATH, it can be invoked thus:mandelcli--width480--height480--frames20This will produce a sequence of 20 .png images. Typemandelcli -hfor a list of available parameters.It can import settings from a previously saved metadata file using the import parameter e.g.--import filename.json.In addition to producing animated sequences, the command line utility can be used to create single images at a much higher pixel resolution than would be available via the GUI application on a standard monitor, though render time may be significant e.g. this example produces an 8K resolution image which takes about a minute to render:mandelcli--filename8kres--width7680--height4320--zoom207011--maxiter7000--zxoffset-0.7428301078839413--zyoffset0.14078514286474172--themeTropical256SuggestionUse the PyMandel GUI at moderate resolutions to explore fractals and find a location and configuration you like, save the image & metadata, and then use themandelclicommand line utility to import the metadata and create a much higher resolution version of the same image e.g for desktop wallpaper, printing or sharing.make_colormap.pymake_colormapis a simple command line utility for generating PyMandel-compatible numpy RGB arrays from image files containing suitable color gradients (e.g. created using GIMP's gradient tool) or even photographs with interesting color palettes. If PyMandel has been installed usingpipand the Python 3 scripts (bin) directory is in the user's PATH, it can be invoked thus:make_colormap--mapnamemymap--inputimage.png--outputmymap_colormap.py--levels256Pass-hor-helpfor a list of available parameters.Author and LicenseGPLv3 LicenseCopyright (c) 2020, SEMU Consulting
All rights reserved.semuadmin@semuconsulting.comThe HoloVizColorcet color mapslibrary has been harvested for some of the color rendering themes. These color maps are released under a Creative Commons Attribution 4.0 International Public License (CC-BY) - seeColorcet License Conditionsfor details.NB:for convenience the selected Colorcet assets (256-depth cyclic color maps) were converted into numpy rgb arrays in colormaps.py and the library itself is not actually used at runtime.PyMandelis maintained entirely by volunteers. If you find it useful, a small donation would be greatly appreciated!You may also like this - an onlineJavaScript version of a Fractal Generatorwith similar functionality:https://www.algolvariables.com/fractals/index.html