Update docs (#244)

Author: jamarshon

_modules/torchaudio.html

@@ -213,7 +213,7 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio</h1><div class="highlight"><pre>
-<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
 <span class="kn">import</span> <span class="nn">os.path</span>
 
 <span class="kn">import</span> <span class="nn">torch</span>

_modules/torchaudio/compliance/kaldi.html

@@ -215,7 +215,7 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio.datasets.vctk</h1><div class="highlight"><pre>
-<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">print_function</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
 <span class="kn">import</span> <span class="nn">torch.utils.data</span> <span class="k">as</span> <span class="nn">data</span>
 <span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">import</span> <span class="nn">os.path</span>

_modules/torchaudio/datasets/vctk.html

@@ -215,7 +215,7 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio.datasets.yesno</h1><div class="highlight"><pre>
-<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">print_function</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
 <span class="kn">import</span> <span class="nn">torch.utils.data</span> <span class="k">as</span> <span class="nn">data</span>
 <span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">import</span> <span class="nn">os.path</span>

_modules/torchaudio/datasets/yesno.html

@@ -215,7 +215,8 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio.functional</h1><div class="highlight"><pre>
-<span></span><span class="kn">import</span> <span class="nn">math</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
+<span class="kn">import</span> <span class="nn">math</span>
 <span class="kn">import</span> <span class="nn">torch</span>
 
 
@@ -278,8 +279,8 @@ <h1>Source code for torchaudio.functional</h1><div class="highlight"><pre>
 <span class="sd">    could be useful. If ``length`` is ``None`` then padding will be aggressively removed</span>
 <span class="sd">    (some loss of signal).</span>
 
-<span class="sd">    [1] D. W. Griffin and J. S. Lim, “Signal estimation from modified short-time Fourier transform,”</span>
-<span class="sd">    IEEE Trans. ASSP, vol.32, no.2, pp.236–243, Apr. 1984.</span>
+<span class="sd">    [1] D. W. Griffin and J. S. Lim, &quot;Signal estimation from modified short-time Fourier transform,&quot;</span>
+<span class="sd">    IEEE Trans. ASSP, vol.32, no.2, pp.236-243, Apr. 1984.</span>
 
 <span class="sd">    Args:</span>
 <span class="sd">        stft_matrix (torch.Tensor): Output of stft where each row of a channel is a frequency and each</span>
@@ -312,6 +313,7 @@ <h1>Source code for torchaudio.functional</h1><div class="highlight"><pre>
         <span class="c1"># add a channel dimension</span>
         <span class="n">stft_matrix</span> <span class="o">=</span> <span class="n">stft_matrix</span><span class="o">.</span><span class="n">unsqueeze</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
 
+    <span class="n">dtype</span> <span class="o">=</span> <span class="n">stft_matrix</span><span class="o">.</span><span class="n">dtype</span>
     <span class="n">device</span> <span class="o">=</span> <span class="n">stft_matrix</span><span class="o">.</span><span class="n">device</span>
     <span class="n">fft_size</span> <span class="o">=</span> <span class="n">stft_matrix</span><span class="o">.</span><span class="n">size</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
     <span class="k">assert</span> <span class="p">(</span><span class="n">onesided</span> <span class="ow">and</span> <span class="n">n_fft</span> <span class="o">//</span> <span class="mi">2</span> <span class="o">+</span> <span class="mi">1</span> <span class="o">==</span> <span class="n">fft_size</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="ow">not</span> <span class="n">onesided</span> <span class="ow">and</span> <span class="n">n_fft</span> <span class="o">==</span> <span class="n">fft_size</span><span class="p">),</span> <span class="p">(</span>
@@ -330,7 +332,7 @@ <h1>Source code for torchaudio.functional</h1><div class="highlight"><pre>
     <span class="k">assert</span> <span class="mi">0</span> <span class="o">&lt;</span> <span class="n">win_length</span> <span class="o">&lt;=</span> <span class="n">n_fft</span>
 
     <span class="k">if</span> <span class="n">window</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">window</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">ones</span><span class="p">(</span><span class="n">win_length</span><span class="p">)</span>
+        <span class="n">window</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">ones</span><span class="p">(</span><span class="n">win_length</span><span class="p">,</span> <span class="n">requires_grad</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">device</span><span class="o">=</span><span class="n">device</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">dtype</span><span class="p">)</span>
 
     <span class="k">assert</span> <span class="n">window</span><span class="o">.</span><span class="n">dim</span><span class="p">()</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">window</span><span class="o">.</span><span class="n">size</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">==</span> <span class="n">win_length</span>
 
@@ -353,7 +355,7 @@ <h1>Source code for torchaudio.functional</h1><div class="highlight"><pre>
     <span class="n">ytmp</span> <span class="o">=</span> <span class="n">ytmp</span><span class="o">.</span><span class="n">transpose</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>  <span class="c1"># size (channel, n_fft, n_frames)</span>
 
     <span class="n">eye</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">eye</span><span class="p">(</span><span class="n">n_fft</span><span class="p">,</span> <span class="n">requires_grad</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-                    <span class="n">device</span><span class="o">=</span><span class="n">device</span><span class="p">)</span><span class="o">.</span><span class="n">unsqueeze</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>  <span class="c1"># size (n_fft, 1, n_fft)</span>
+                    <span class="n">device</span><span class="o">=</span><span class="n">device</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">dtype</span><span class="p">)</span><span class="o">.</span><span class="n">unsqueeze</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>  <span class="c1"># size (n_fft, 1, n_fft)</span>
 
     <span class="c1"># this does overlap add where the frames of ytmp are added such that the i&#39;th frame of</span>
     <span class="c1"># ytmp is added starting at i*hop_length in the output</span>

_modules/torchaudio/functional.html

@@ -215,7 +215,8 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio.kaldi_io</h1><div class="highlight"><pre>
-<span></span><span class="c1"># To use this file, the dependency (https://github.com/vesis84/kaldi-io-for-python)</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
+<span class="c1"># To use this file, the dependency (https://github.com/vesis84/kaldi-io-for-python)</span>
 <span class="c1"># needs to be installed. This is a light wrapper around kaldi_io that returns</span>
 <span class="c1"># torch.Tensors.</span>
 <span class="kn">import</span> <span class="nn">torch</span>

_modules/torchaudio/kaldi_io.html

@@ -215,7 +215,7 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio.sox_effects</h1><div class="highlight"><pre>
-<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
 <span class="kn">import</span> <span class="nn">torch</span>
 <span class="kn">import</span> <span class="nn">_torch_sox</span>
 

_modules/torchaudio/sox_effects.html

@@ -215,7 +215,7 @@
              <article itemprop="articleBody" id="pytorch-article" class="pytorch-article">
 
   <h1>Source code for torchaudio.transforms</h1><div class="highlight"><pre>
-<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span>
+<span></span><span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span><span class="p">,</span> <span class="n">division</span><span class="p">,</span> <span class="n">print_function</span><span class="p">,</span> <span class="n">unicode_literals</span>
 <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
 <span class="kn">import</span> <span class="nn">math</span>
 <span class="kn">import</span> <span class="nn">torch</span>

_modules/torchaudio/transforms.html

@@ -15,15 +15,20 @@ produce similar outputs.
 Functions
 ---------
 
+:hidden:`spectrogram`
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. autofunction:: spectrogram
+
 :hidden:`fbank`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. autofunction:: fbank
 
-:hidden:`spectrogram`
+:hidden:`mfcc`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. autofunction:: spectrogram
+.. autofunction:: mfcc
 
 :hidden:`resample_waveform`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~