Create swarm.h

This is the two portal model implementation. The comments are in correspondence with Doxygen guidelines.