Improve vertex validation

This PR will fix an offset-by-one bug that was present in the old version while computing mistag and add a rather comprehensive documentation on how to run and use this validation package.

Further code improvements, mainly related to logic and speed, have been included.