History

[python] add docstrings to ufuncs

Paul Brossier committed 8 years ago

Commit e3c4d001 parent fb1c5e21 file · +44 −3Browse files

Showing the changes to python/ext (1 of 1 file). Show all

Unified · Split

python/ext/ufuncs.c+44−3
@@ -58,7 +58,22 @@ static char Py_aubio_unary_types[] = { · 57 unmodified lines
5858 //NPY_OBJECT, NPY_OBJECT,
5959 };
6060
61−static char Py_unwrap2pi_doc[] = "map angle to unit circle [-pi, pi[";
61+// Note: these docstrings should *not* include the function signatures
62+
63+static char Py_unwrap2pi_doc[] = ""
64+"\n"
65+"Map angle to unit circle :math:`[-\\pi, \\pi[`.\n"
66+"\n"
67+"Parameters\n"
68+"----------\n"
69+"x : numpy.ndarray\n"
70+" input array\n"
71+"\n"
72+"Returns\n"
73+"-------\n"
74+"numpy.ndarray\n"
75+" values clamped to the unit circle :math:`[-\\pi, \\pi[`\n"
76+"";
6277
6378 static void* Py_unwrap2pi_data[] = {
6479 (void *)aubio_unwrap2pi,
@@ -67,14 +82,40 @@ static void* Py_unwrap2pi_data[] = { · 2 unmodified lines
6782 //(void *)unwrap2pio,
6883 };
6984
70−static char Py_freqtomidi_doc[] = "convert frequency to midi";
85+static char Py_freqtomidi_doc[] = ""
86+"\n"
87+"Convert frequency `[0; 23000[` to midi `[0; 128[`.\n"
88+"\n"
89+"Parameters\n"
90+"----------\n"
91+"x : numpy.ndarray\n"
92+" Array of frequencies, in Hz.\n"
93+"\n"
94+"Returns\n"
95+"-------\n"
96+"numpy.ndarray\n"
97+" Converted frequencies, in midi note.\n"
98+"";
7199
72100 static void* Py_freqtomidi_data[] = {
73101 (void *)aubio_freqtomidi,
74102 (void *)aubio_freqtomidi,
75103 };
76104
77−static char Py_miditofreq_doc[] = "convert midi to frequency";
105+static char Py_miditofreq_doc[] = ""
106+"\n"
107+"Convert midi `[0; 128[` to frequency `[0, 23000]`.\n"
108+"\n"
109+"Parameters\n"
110+"----------\n"
111+"x : numpy.ndarray\n"
112+" Array of frequencies, in midi note.\n"
113+"\n"
114+"Returns\n"
115+"-------\n"
116+"numpy.ndarray\n"
117+" Converted frequencies, in Hz\n"
118+"";
78119
79120 static void* Py_miditofreq_data[] = {
80121 (void *)aubio_miditofreq,

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t