ompSimpleParallelizer

A simple parallelizer for Open MP.

This script is used to parallelize with OpenMP. It makes a few asumptions:

• First one is that there is a makefile set up so running make will compile the program generating the executable file.
  
• Second, the same makefile has a make clean command that removes object and executable files.
  
• Third, you only need to use one directive at a time, not even between multiple lines.
  
• Fourth, you have created a text file containing one directive for each line of the file, whose path you will send to the script via the --directives param.
  

What this script does:

• Compiles and runs the original file to get sequential time.
  
• After that, parallelization begins. For each number of threads introduced, for each line chosen to be parallelized, the script will modify the original source file to include a directive from the directives file, and then run it and store the results, also modifying the number of threads to the current one in the loop.
  
• Then, the fastest run time will be extracted, referencing the number of threads used, the line it parallelized, and the directive used for it.
  
• Finally, the speedup and efficiency will be calculated with this fastest run time.
  

Script usage params:

    --help:         Display this guide.
    --source:       Path to parallelizable source file. It can be a relative or absolute path.
    --lines:        Lines where parallelization should be placed. Only one at a time will be used.
                    Line numbers must be separated with commas without spaces. First line in a file is line 1.
    --directives:   Path to file containing parallelization directives. It can be a relative or absolute path.
                    This file must contain all the parallelization directives, one for each line.
    --num_threads:  (Optional) List of new number of threads to set after sequential execution.
                    Thread numbers must be separated with commas without spaces. Each value has to be an integer greater than 1.
    --save_results: (Optional) If used, stdout prints produced by this script will also be saved to a file.
                    A destination filename must be introduced.
    --n_executions: (Optional) Number of times the script will execute each code variant to get an average.
                    Default value is number of executions is 5.
    --working_dir:  (Optional) Defines the directory where the makefile and executable files are located.
                    It can be a relative or absolute path.

Example:
python3 parallelizer.py --source sourcefile.c --lines 5,6,8 --directives directives.txt --num_threads 2,3,4 --save_results results.txt --n_executions 10 --working_dir mydir/