Reformat docstrings

[ketch]

Major refactoring to improve clarity, reduce code length, and reformat most docstrings to follow numpy style.

Major API changes:

• symmetric cannot be adjusted by the user
• adaptive is boolean