Major update with competition loop and documentation

Adding documentation to all new competition-related functions. Adding a
full competition loop to test all the metrics across the competition
simulation.