<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">- The new functions are more like building blocks that would be part of<br></blockquote><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
a larger processing chain (filtering, peak finding, peak measurement &<br>
classification). My impression is that examples would be the most useful<br>
here to demonstrate the workflow but would be to code and plot heavy to<br>
fit a tutorial.<br></blockquote><div><br></div><div>How about an entry in the scipy cookbook "Signal Processing" or "Other examples" sections?</div><div><br></div><div><a href="http://scipy-cookbook.readthedocs.io/">http://scipy-cookbook.readthedocs.io/</a><br></div><div><br></div><div>In the SciPy tutorials area you could do some basic things if you want, even if they overlap with what is in the docstrings a bit. Then you could put a link there to the cookbook for a more in-depth example.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">- To extend on this: one thing that is very well done in Matlab is that<br>
it provides examples for the usage of each parameter. A good example is<br>
Matlab's version of `find_peaks` itself:<br>
<a href="https://de.mathworks.com/help/signal/ref/findpeaks.html?requestedDomain=true" rel="noreferrer" target="_blank">https://de.mathworks.com/help/<wbr>signal/ref/findpeaks.html?<wbr>requestedDomain=true</a><br>
I think this would be really useful for some of the options of the new<br>
functions. E.g. the interplay between `width` and `rel_height` comes to<br>
mind. That would require multiple examples which is to much for a<br>
docstring. At least that is my impression.<br></blockquote><div><br></div><div>I see MATLAB's documentation as being roughly equivalent to our docstrings. So if it seems like the MATLAB docs are well organized and not too long, the same could go for our docstrings.</div><div><br></div><div>I don't see too much of an issue if the `find_peaks` docstring becomes a bit longer than usual. Most of the "need it now" information is concentrated at the top (params). The examples and notes come later, and can be browsed (or not) as necessary by users.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
- To demonstrate peak finding I would need a signal to analyze. I'm not<br>
sure how to generate complex demo-signals in only a few lines of code<br>
that don't shift the focus of the reader. The best I could come up with<br>
can be seen in `find_peaks` docstring. How is this usually handled?<br>
Would it be okay to import this stuff from `misc`?<br></blockquote><div><br></div><div>We have `face` and `ascent` in `misc` already for 2D signals. I think it would be nice to have something like this for 1D signals, assuming we can find one that won't take up a ton of space (< 500kB maybe, since that's what ascent takes, and `face` takes up 1.5MB?). We don't want to bloat the repo, but a reasonable sound choice could be used in many examples.</div><div><br></div><div>The most popular "<a href="http://freesound.org">freesound.org</a>" clip is a creative-commons licensed <a href="https://freesound.org/people/RHumphries/sounds/2523/">thunderstorm recording</a>, maybe this could be made mono, truncated, and/or resampled to be sufficiently small? Other ideas welcome.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
- Should this tutorial cover peak finding with wavelet transformation as<br>
well? Reading the roadmap it seems like it's not decided whether wavelet<br>
transformation is within the scope of SciPy. So I'd think this topic<br>
should be left out until this is decided.<br></blockquote><div><br></div><div>We can always add this later, so I'd say only include it if you're motivated to do it.</div><div><br></div><div>Eric</div><div><br></div></div></div></div>