# Performance in Mandelbrot Set Computation¶

## General Description¶

I want to have a nice poster of a Mandelbrot set, say 75×50 cm². At 300 DPI printing resolution, I need to compute a lot of pixels:

$\frac{75}{2.54} \cdot \frac{50}{2.54} \cdot 300^2 = 52\,312\,605$

The computation shall not take forever. When it takes 1000 nano seconds to compute one pixel, then it will take almost one minute for the whole image.

Computing a pixel in a Mandelbrot set is not hard. The set is defined on the complex plane $$\mathbb C$$ with an iterative procedure. Take the point $$z_0 \in \mathbb C$$. Then iterate:

$z_{n+1} = z_n^2 + z_0 \,.$

Sometimes one also calls $$z_0 = c$$ and write that equation as

$z_{n+1} = z_n^2 + c \,.$

The point $$c$$ belongs to the Mandelbrot set if that does not diverge for $$n \to \infty$$. The number $$c = 1$$ does not belong to the set, it diverges. However, $$c = -1$$ is contained in the set. The iteration will be $$-1$$, $$0$$, $$-1$$, and repeat itself. Once a number has $$|z_n| > 2$$, we know that it will diverge.

In order to create a pixel image, one maps the pixels to complex numbers. Then one iterates until $$|z_n| > R$$ for some $$R \geq 2$$. I have chosen $$R = 5$$ for my examples. Then I note the iteration number where $$|z_n|$$ exceeds the radius. That is the value that I note for the pixel. After 100 iterations, I stop. If it has not diverged, I put in the number 100.

An image is created by taking the logarithm of the iteration number and spreading the values from black to white:

## First Python Implementation¶

Implemententing this in Python is not that hard. I need two loops over the height and width of the image. The numbers lx and ly give the number of pixels in the directions. Then I have a minimum real and imaginary part and a step size d.

for i in range(lx):
for j in range(ly):
x = re_min + i * d
y = im_min + j * d

c = x + 1.0j * y
z = 0.0 + 0.0j

for it in range(100):
z = z**2 + c
a = np.abs(z)

iters[i, j] = it
break


There is some helper code around, but that is the main code. I stop iterating when it has diverged.

This simple Python implementation takes 59000 nano seconds per pixel on my laptop. This means that the whole poster will take around an hour to compute! That is doable, but can it be done faster?

## NumPy Implementation¶

Python itself is not that fast. It is not really the language, more the implementation of the language. Either way, it just takes too long to compute the data for the poster.

The NumPy array implementation for Python is written in C and performs the internal loops in compiled C functions. So although the programmer does not have to deal with C, it still uses C below.

Writing the algorithm in Python with NumPy could look like this:

for i in range(100):
z = z**2 + c
a = np.abs(z)
selection = (a >= radius) & (iters == 0)
sel = np.where(selection)
iters[sel] = i
if selection.all():
break


The first two lines in the for loop are to be read as arrays. We take all the values for $$z$$ and square them. Then we add the whole array of $$c$$ onto that. The loops are now compiled C code. The following lines then look at the elements where the absolute value exceeds the radius and where there are no iterations written down. Then it writes down the current iteration number into those fields.

The problem with this approch is that a lot of useless work is done. Even when some pixel already has its value, the complex multiplications are still done. This is a waste.

Still, this implementation only needs 2800 nano seconds per pixel. That is a speedup of 21, which is great! I just do not see any way to make it faster within Python, though.

## First C/C++ Implementation¶

Using a native compiled language like C or C++ can make this much faster. For this we take an array escape_iter which is linearized. Then we loop over height and width and perform the same computation as before. The code looks as follows:

for (size_t y = 0; y < ly; ++y) {
for (size_t x = 0; x < lx; ++x) {
double z_re = 0.0;
double z_im = 0.0;
for (size_t iter = 0; iter < max_iter; ++iter) {
auto const new_z_re = z_re * z_re - z_im * z_im + c_re(x);
auto const new_z_im = 2 * z_re * z_im + c_im(y);

z_re = new_z_re;
z_im = new_z_im;

auto const abs = z_re * z_re + z_im * z_im;

escape_iter[idx(x, y)] = iter;
break;
}
}
}
}


Compiled with GCC using -O3, this will get us to 92 nano seconds per pixel! In comparison with first Python version, that is now a factor 641 faster.

From here it is relatively easy to distribute the pixels onto the various cores of my CPU. Just adding a single OpenMP directive does the trick. The following line gets added before the for loops:

#pragma omp parallel for collapse(2)


On my laptop, it now takes only 45 nano seconds per pixel. The speedup is already at 1311. This is a day-and-night difference to the first Python implementation!

## SIMD Optimization¶

One can do slightly better than that. The current data layout is not really suited for using SIMD, the vector units in the CPU. My laptop CPU (Intel Sandy Bridge) supports the AVX instruction set and can do operations with four floating point numbers (double precision) at the same time. Since I want to do the same computation for each pixel, one should be able to make use of that. It could become up to four times as fast as before.

One caveat is that now all the code can be put into vector instructions. When doing so, one is doing more work than needed. A group of four pixels has to be iterated until the last one has diverged. In the beautiful parts of the sets, that could happen often. However, the other computations are virtually for free, so there is no harm in it.

Programming this is more cumbersome, though. One needs to introduce arrays that have the same size as the vector length. They also have to be aligned properly such that they can be loaded in one go. Then I need to do extra work and keep track of the finished pixels. All this adds some overhead to the code. The implementation is here:

#pragma omp parallel for collapse(2)
for (size_t y = 0; y < ly; ++y) {
for (size_t bx = 0; bx < blocks_x; ++bx) {
alignas(veclen * sizeof(bool)) bool finished[veclen] = {false};
alignas(veclen * sizeof(bool)) bool written[veclen] = {false};

alignas(veclen * sizeof(double)) double z_re[veclen] = {0.0};
alignas(veclen * sizeof(double)) double z_im[veclen] = {0.0};
alignas(veclen * sizeof(double)) double new_z_re[veclen];
alignas(veclen * sizeof(double)) double new_z_im[veclen];

alignas(veclen * sizeof(double)) double c_re[veclen] = {0.0};
for (size_t v = 0; v < veclen; ++v) {
c_re[v] = get_c_re(bx, v);
}
double c_im = get_c_im(y);

for (size_t iter = 0; iter < max_iter; ++iter) {
#pragma omp simd aligned(z_re, z_im, new_z_re, new_z_im, finished)
for (size_t v = 0; v < veclen; ++v) {
new_z_re[v] =
z_re[v] * z_re[v] - z_im[v] * z_im[v] + c_re[v];
new_z_im[v] = 2 * z_re[v] * z_im[v] + c_im;

z_re[v] = new_z_re[v];
z_im[v] = new_z_im[v];

auto const abs = z_re[v] * z_re[v] + z_im[v] * z_im[v];

if (!finished[v] && unlikely(abs > radius)) {
finished[v] = true;
escape_iter[idx(bx, y) * veclen + v] = iter;
}
}

bool all_finished = true;
for (size_t v = 0; v < veclen; ++v) {
all_finished &= finished[v];
}

if (all_finished) {
break;
}
}
}
}


All in all it seems to be worth it. One pixel is down to 33 nano seconds. The overall speedup is 1787, which means that my poster only takes in the order of a minute to compute.

## Conclusion¶

The Python version was the easiest to implement. It did not run very fast, though. Using a language that allows to get closer to the machine (like C or C++) exposes more opportunities to make it faster. If performance is top priority, then C or C++ give the tools to make it fast.

One should not neglect algorithmic efficiency, though. Choosing a more efficient algorithm usually gives greater improvements than tuning the performance of an implementation.

A summary of the various implementations:

Implementation Nano Seconds per Pixel Speedup
Python simple 59000 1
Python NumPy 2800 21
C++ 92 641
git clone git://github.com/martin-ueding/mandelbrot-performance.git