Also changed (peak.py):
* Standardized documentation as requested.
* Removed `threshold` as an optional kwarg.
* Removed extra line break incorrect by PEP8 standards.
Also changed (watershed.py):
* Added @deprecated decorator and import statement
Detailed changelist:
* Fully documented new API for peak_local_max()
* Removed commented-out old code for is_local_maximum()
* Added "See also" and "Notes" to is_local_maximum() redirecting to peak_local_max()
is_local_maximum() is a wrapper function for peak_local_max()
is_local_maximum() runs much faster (~20% of prior runtime, nearly = to peak_local_max())
All tests in .feature and .morphology subpackages pass as written with these changes.
Todo:
* Fully document API
* remove commented-out old algorithm in is_local_maximum()
* add new tests for full coverage of new, more complex peak_local_max()