analysis: added docstring to member functions