improved code formatting and documentation
Merge branch 'develop' of https://github.com/golvmopp/BGSEP into develop