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
58 //NPY_OBJECT, NPY_OBJECT,58 //NPY_OBJECT, NPY_OBJECT,
59};59};
60 60
61static char Py_unwrap2pi_doc[] = "map angle to unit circle [-pi, pi[";61// Note: these docstrings should *not* include the function signatures
62
63static 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"";
62 77
63static void* Py_unwrap2pi_data[] = {78static void* Py_unwrap2pi_data[] = {
64 (void *)aubio_unwrap2pi,79 (void *)aubio_unwrap2pi,
@@ -67,14 +82,40 @@ static void* Py_unwrap2pi_data[] = { · 2 unmodified lines
67 //(void *)unwrap2pio,82 //(void *)unwrap2pio,
68};83};
69 84
70static char Py_freqtomidi_doc[] = "convert frequency to midi";85static 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"";
71 99
72static void* Py_freqtomidi_data[] = {100static void* Py_freqtomidi_data[] = {
73 (void *)aubio_freqtomidi,101 (void *)aubio_freqtomidi,
74 (void *)aubio_freqtomidi,102 (void *)aubio_freqtomidi,
75};103};
76 104
77static char Py_miditofreq_doc[] = "convert midi to frequency";105static 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"";
78 119
79static void* Py_miditofreq_data[] = {120static void* Py_miditofreq_data[] = {
80 (void *)aubio_miditofreq,121 (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