changed defaults and named arguments
improved docstrings and abbreviation tweaks