[FIX] improve set_peaks documentation

- write message what went wrong in assertion code
- fix typo
- reserve space for new data (for speed)

NOTE: this still needs testing