buddhabrot/README.md

Buddhabrot

This is a very simple binary to create images of the Mandelbrot set and Buddhabrot set. The final goal is to use the Metropolis-Hastings sampling algorithm and Simulated Annealing.

Building the project

You need Meson to build the project, and I recommend using Ninja as a build system. Issue the following commands:

42sh$ meson build
42sh$ ninja -C build

This compiles the buddhabrot binary at the root of the build directory.

Using the binary

By default, the binary writes the output image to its standard output, in the PPM file format.

You can choose which visualisation you want by using the -r options with either buddhabrot or mandelbrot. Use -m to choose the maximum number of iterated samples.

You can specify the height and width of the image by using -h and -w.

Sample usage:

42sh$ ./buddhabrot -r buddhabrot -o out.ppm  -m 1000 -h 1080 -w 1920

Creating images

The binary outputs a grayscale image of the buddhabrot for the given sampling rate.

The project's logo has been created by outputting three different buddhabrot sets for 100, 1000, and 10000 samples. Once done, use the following command to create the image (using ImageMagick).

42sh$ convert \
    10000.ppm -channel R \
    1000.ppm -channel G \
    100.ppm -channel B \
    -combine -channel RGB \
    -alpha off -colorspace sRGB \
    out.png