Allegro-MPI-Cave-Generator

Cellular automata project that procedurally generates a cave using simple rules and parallelization.

Purpose of the project

This is a project for the Parallel Algorithmsm course at my university (Unical).

It utilizes mpi to parallelize a cellular automata algorithm on a 2d cartesian grid.

Inspired by this video

How to build

dependencies

• c++ 17
• makefile
• allegro5 for rendering
• mpich or open-mpi for parellization

building

git clone https://github.com/Farfi55/Allegro-MPI-Cave-Generator.git
cd ./Allegro-MPI-Cave-Generator
make

Running

mpirun -np <n_procs> ./bin/cavegen [options]

for more info use: ./bin/cavegen -h

example

mpirun -np 6 bin/cavegen -c ./config/my_config.cfg -p -x 3 -y 2

• mpirun -np 6 bin/cavegen run program on 6 threads
• -c ./config/my_config.cfg load the specified config file
• -p: run in parallel mode
• -x 3: set 3 threads on the x axis
• -y 2: set 2 threads on the y axis

Configuration

when running you can set a custom configuration with the option -c config_file

for more info on the configuration options use cavegen -hc

showcase