How congiuntivo/pepo works
Project type and purpose
• This is a command-line, high-performance computing tool written in C that implements the Emperor Penguin Optimization (EPO) metaheuristic.
• It targets parallel execution on distributed (MPI) and shared-memory (OpenMP) environments.
• It produces CSV logs of optimization runs and ships with Python plotting scripts and a LaTeX report.
File structure
• Top level
• main.c: entry point, MPI/OpenMP initialization, calls into the library
• Makefile: build rules (make run, make clean)
• README.md: description, usage, algorithm background
• .gitignore
• lib/
• cli.{c,h}: command-line parsing
• agent.{c,h}: represents a solution candidate (position, fitness)
• space.{c,h}: holds the population, search bounds
• epo.{c,h}: core EPO algorithm logic (movement, huddle, temperature)
• f_functions.{c,h}: benchmark fitness functions
• csv.{c,h}: CSV logging of iteration data
• utils.{c,h}: RNG, math helpers
• plots/: Python scripts to read CSV output and generate graphs
• report/: LaTeX files to build a written report of experiments
• visual.py: possibly a Python helper for plotting/visualization
README for additional insights
• Describes algorithm phases: huddle formation, temperature, distance, mover selection
• Shows social force equation and behavior plots
• Details MPI + OpenMP parallel execution examples
• Lists CLI flags and their meanings
Detail
• Key files and their responsibilities so no component is omitted.