updating __docformat__
updating __docformat__ string and other minor tweaks
updating docstrings
adding new classmethod to compute symmetry operation
fix syntax in math directives