Skip to main content

A library to generate fractals

Project description

FractPy: a Python library for generating fractals

PyPI License: MIT Documentation Status codecov Code style: black

This library currently implements the generation of following fractals:

  • Newton Fractal
    • For Newton Fractal, this library can currently be used only for polynomial functions with real powers.

FractPy relies on sympy, numpy, and matplotlib - all part of the standard scientific Python stack so is easy to install on all operating systems.

How do I install FractPy?

The recommended way to install fractpy is using Python Package index (PyPi), to install use the following command:

$ python -m pip install fractpy

How do I use FractPy?

Here is an example of generating Newton Fractal for :

from fractpy.models import NewtonFractal
model = NewtonFractal("x**8 - 4x**3 + x**2 - 6")
p = model.plot(-2, 2, -2, 2, (1000, 1000))

The above code will generate the following plot:

Full documentation is available here:

How can I contribute to FractPy?

After forking and cloning the forked repository on your computer, change the directory to fractpy and create a virtual environment:

$ cd fractpy
$ python -m venv env 

Activate the virtual environment and install tox:

$ . env/bin/activate
$ python -m pip install tox

Make the required changes and then run the tests using tox (Make sure to run the tests before opening a PR):

$ python -m tox -e dev


To build the documentation first install flit, which will help in installing the build requirements:

$ python -m pip installl flit
$ python -m flit install --symlink


$ cd docs
$ make html

Docs will be built in docs/_build directory.

All contributions are welcome, whether it be adding new methods of generating fractals, writing documentation, or fixing embarrassing bugs!

In the interest of fostering an open and welcoming environment, all contributors, maintainers and users are expected to abide by the Python code of conduct:

Getting Help

For more information or to ask questions about FractPy join our Slack Channel.


FractPy is fully open source. For more information about its license, see LICENSE.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fractpy-0.0.4.tar.gz (43.8 MB view hashes)

Uploaded source

Built Distribution

fractpy-0.0.4-py3-none-any.whl (8.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page