Skip to content

Commit

Permalink
API docs fix (newline issue)
Browse files Browse the repository at this point in the history
  • Loading branch information
yiitozer committed May 23, 2024
1 parent ab7752f commit 571e723
Show file tree
Hide file tree
Showing 6 changed files with 36 additions and 32 deletions.
Binary file modified docs/build/doctrees/environment.pickle
Binary file not shown.
Binary file modified docs/build/doctrees/index_tsm.doctree
Binary file not shown.
28 changes: 15 additions & 13 deletions docs/build/html/_modules/libtsm/tsm.html
Original file line number Diff line number Diff line change
Expand Up @@ -105,9 +105,11 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>
<span class="sd"> alpha : float or np.ndarray [shape=(S, 2)]</span>
<span class="sd"> Time stretch function, given by a constant (float) or a set of S anchor points (int).</span>
<span class="sd"> A valid anchor point sequence</span>
<span class="sd"> </span>
<span class="sd"> (1) contains only non-negative values,</span>
<span class="sd"> (2) both sequences along the first axis are strictly increasing,</span>
<span class="sd"> (3) starts with position (m, 0), where m is an intereger &gt;= 0.</span>
<span class="sd"> (3) starts with position (m, 0), where m is an integer &gt;= 0.</span>

<span class="sd"> These conditions will be checked and an error is thrown if they are not met.</span>
<span class="sd"> See `libtsm.ensure_validity` for one way to ensure that condition (2) is fulfilled.</span>

Expand Down Expand Up @@ -234,8 +236,7 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>


<div class="viewcode-block" id="wsola_tsm"><a class="viewcode-back" href="../../index_tsm.html#libtsm.tsm.wsola_tsm">[docs]</a><span class="k">def</span> <span class="nf">wsola_tsm</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">alpha</span><span class="p">,</span> <span class="n">syn_hop</span><span class="o">=</span><span class="mi">512</span><span class="p">,</span> <span class="n">win_length</span><span class="o">=</span><span class="mi">1024</span><span class="p">,</span> <span class="n">win_beta</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">tol</span><span class="o">=</span><span class="mi">512</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Waveform Similarity Overlap and Add (WSOLA) algorithm that rescales the time-axis of the input signal x</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Waveform Similarity Overlap and Add (WSOLA) algorithm that rescales the time-axis of the input signal x</span>
<span class="sd"> according to the time-stretch function s without altering the pitch of x.</span>

<span class="sd"> Parameters</span>
Expand All @@ -246,9 +247,11 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>
<span class="sd"> alpha : float or np.ndarray [shape=(S, 2)]</span>
<span class="sd"> Time stretch function, given by a constant (float) or a set of S anchor points (int).</span>
<span class="sd"> A valid anchor point sequence</span>

<span class="sd"> (1) contains only non-negative values,</span>
<span class="sd"> (2) both sequences along the first axis are strictly increasing,</span>
<span class="sd"> (3) starts with position (m, 0), where m is an intereger &gt;= 0.</span>
<span class="sd"> (3) starts with position (m, 0), where m is an integer &gt;= 0.</span>

<span class="sd"> These conditions will be checked and an error is thrown if they are not met.</span>
<span class="sd"> See `libtsm.ensure_validity` for one way to ensure that condition (2) is fulfilled.</span>

Expand Down Expand Up @@ -358,8 +361,7 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>
<span class="n">hps_fil_len_harm</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span> <span class="n">hps_fil_len_perc</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span> <span class="n">pv_syn_hop</span><span class="o">=</span><span class="mi">512</span><span class="p">,</span> <span class="n">pv_win_length</span><span class="o">=</span><span class="mi">2048</span><span class="p">,</span> <span class="n">pv_win_beta</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">pv_zero_pad</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
<span class="n">pv_restore_energy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">pv_fft_shift</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">ola_syn_hop</span><span class="o">=</span><span class="mi">128</span><span class="p">,</span> <span class="n">ola_win_length</span><span class="o">=</span><span class="mi">256</span><span class="p">,</span> <span class="n">ola_win_beta</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span> \
<span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Time Scale Modification algorithm based on Harmonic - Percussive separation. After separation is</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Time Scale Modification algorithm based on Harmonic - Percussive separation. After separation is</span>
<span class="sd"> performed, the algorithm uses two phase vocoder TSM and WSOLA TSM algorithms for the Harmonic and percussive part</span>
<span class="sd"> separately.</span>

Expand All @@ -371,11 +373,13 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>
<span class="sd"> alpha : float or np.ndarray [shape=(S, 2)]</span>
<span class="sd"> Time stretch function, given by a constant (float) or a set of S anchor points (int).</span>
<span class="sd"> A valid anchor point sequence</span>

<span class="sd"> (1) contains only non-negative values,</span>
<span class="sd"> (2) both sequences along the first axis are strictly increasing,</span>
<span class="sd"> (3) starts with position (m, 0), where m is an intereger &gt;= 0.</span>
<span class="sd"> These conditions will be checked and an error is thrown if they are not met.</span>
<span class="sd"> See `libtsm.ensure_validity` for one way to ensure that condition (2) is fulfilled.</span>
<span class="sd"> (3) starts with position (m, 0), where m is an integer &gt;= 0.</span>
<span class="sd"> </span>
<span class="sd"> These conditions will be checked and an error is thrown if they are not met. See `libtsm.ensure_validity` for</span>
<span class="sd"> one way to ensure that condition (2) is fulfilled.</span>

<span class="sd"> Fs : int</span>
<span class="sd"> Sampling rate</span>
Expand Down Expand Up @@ -452,8 +456,7 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>

<div class="viewcode-block" id="pv_int_tsm"><a class="viewcode-back" href="../../index_tsm.html#libtsm.tsm.pv_int_tsm">[docs]</a><span class="k">def</span> <span class="nf">pv_int_tsm</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">alpha</span><span class="p">,</span> <span class="n">syn_hop</span><span class="o">=</span><span class="mi">512</span><span class="p">,</span> <span class="n">win_length</span><span class="o">=</span><span class="mi">2048</span><span class="p">,</span> <span class="n">win_beta</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">Fs</span><span class="o">=</span><span class="mi">22050</span><span class="p">,</span> <span class="n">zero_pad</span><span class="o">=-</span><span class="mi">1</span><span class="p">,</span> <span class="n">restore_energy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
<span class="n">fft_shift</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Phase Vocoder Time scale modification algorithm, that rescales the time-axis of the input signal x</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Phase Vocoder Time scale modification algorithm, that rescales the time-axis of the input signal x</span>
<span class="sd"> according to the time-stretch function s without altering the pitch of x. This algorithm is optimized for integer</span>
<span class="sd"> values of the time stretching function.</span>

Expand Down Expand Up @@ -543,8 +546,7 @@ <h1>Source code for libtsm.tsm</h1><div class="highlight"><pre>


<div class="viewcode-block" id="two_step_tsm"><a class="viewcode-back" href="../../index_tsm.html#libtsm.tsm.two_step_tsm">[docs]</a><span class="k">def</span> <span class="nf">two_step_tsm</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">alpha</span><span class="p">,</span> <span class="n">Fs</span><span class="o">=</span><span class="mi">22050</span><span class="p">,</span> <span class="n">order</span><span class="o">=</span><span class="s1">&#39;exact-coarse&#39;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Time Scale Modification algorithm, where the signal is stretched by the integer and decimal part</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Time Scale Modification algorithm, where the signal is stretched by the integer and decimal part</span>
<span class="sd"> of the time stretch function using two different algorithms.</span>

<span class="sd"> Parameters</span>
Expand Down
10 changes: 5 additions & 5 deletions docs/build/html/index_tsm.html
Original file line number Diff line number Diff line change
Expand Up @@ -106,11 +106,11 @@ <h1>Time-Scale Modification<a class="headerlink" href="#time-scale-modification"
<div><ol class="arabic simple">
<li><p>contains only non-negative values,</p></li>
<li><p>both sequences along the first axis are strictly increasing,</p></li>
<li><p>starts with position (m, 0), where m is an intereger &gt;= 0.</p></li>
<li><p>starts with position (m, 0), where m is an integer &gt;= 0.</p></li>
</ol>
</div></blockquote>
<p>These conditions will be checked and an error is thrown if they are not met.
See <cite>libtsm.ensure_validity</cite> for one way to ensure that condition (2) is fulfilled.</p>
<p>These conditions will be checked and an error is thrown if they are not met. See <cite>libtsm.ensure_validity</cite> for
one way to ensure that condition (2) is fulfilled.</p>
</p></li>
<li><p><strong>Fs</strong> (<em>int</em>) – Sampling rate</p></li>
<li><p><strong>hps_ana_hop</strong> (<em>int</em>) – hop size for HPS</p></li>
Expand Down Expand Up @@ -184,7 +184,7 @@ <h1>Time-Scale Modification<a class="headerlink" href="#time-scale-modification"
<div><ol class="arabic simple">
<li><p>contains only non-negative values,</p></li>
<li><p>both sequences along the first axis are strictly increasing,</p></li>
<li><p>starts with position (m, 0), where m is an intereger &gt;= 0.</p></li>
<li><p>starts with position (m, 0), where m is an integer &gt;= 0.</p></li>
</ol>
</div></blockquote>
<p>These conditions will be checked and an error is thrown if they are not met.
Expand Down Expand Up @@ -248,7 +248,7 @@ <h1>Time-Scale Modification<a class="headerlink" href="#time-scale-modification"
<div><ol class="arabic simple">
<li><p>contains only non-negative values,</p></li>
<li><p>both sequences along the first axis are strictly increasing,</p></li>
<li><p>starts with position (m, 0), where m is an intereger &gt;= 0.</p></li>
<li><p>starts with position (m, 0), where m is an integer &gt;= 0.</p></li>
</ol>
</div></blockquote>
<p>These conditions will be checked and an error is thrown if they are not met.
Expand Down
Loading

0 comments on commit 571e723

Please sign in to comment.