Standalone executable: (Windows)

Head over to releases and download the latest executable, shapevolve.exe.

In the command line:

Change the directory using cd to where the executable is located.

Then, run shapevolve.exe path/to/image_file.png to run the program with an image as input.

You can also run shapevolve.exe -h to view additional options.

Module:

Install shapevolve from PyPI using the following command:

pip install shapevolve

Here is some sample code to demonstrate how to use the module.

from shapevolve.evolver import Evolver
from PIL import Image

evolver = Evolver(Image.open("path/to/image.png")) # Sets up the Evolver object.

genome = evolver.evolve() # Evolves the genome.

image = genome.render_scaled_image() # Gets a numpy array that represents the evolved image.

genome.save_genome("path/to/save_checkpoint.pkl") # Saves the genome for later use.

More sample code can be found in samples.py, here.

Here is a detailed API reference.

Third-party libraries used:

• NumPy for numerical computation with matrices

• ColorThief for grabbing color palettes from images

• Scikit-Image for computing image simularity

• OpenCV for building images from circles

• Pillow for image preprocessing

• Matplotlib for image display

• PyInstaller for building an executable file.

Built-in libraries used:

• Pickle for checkpoint saves and loads.

• Argparse for the CLI interface.