[FIX] improve set_peaks documentation

- write message what went wrong in assertion code
- fix typo
- reserve space for new data (for speed)
Merge pull request #1034 from hroest/fix/set_peaks

[FIX] improve set_peaks documentation