Increased doctest coverage, converted all public docstrings to numpy format, and refined interfaces with optional values.