Feature/documentation

Improve readme readability and change physic_vectors to physics_vectors to be compatible with new AnalysisTools with the following merge request.

AnalysisTools!12 (merged)