revise version with code factorization and documentation

This code revision was made base on reviewers' comments during the journal paper submission for SoftwareX

• Added --help option
• Code factorization
• Comments for code documentation
• Optimization for k-1 instead of k/2
• other minor fixes

new features

new parser, examples, and improved version of the mapper

version with all key features

Full Changelog: https://github.com/ympek/floodsar/commits/v1.0