Skip to content

Commit

Permalink
Regenerated.
Browse files Browse the repository at this point in the history
  • Loading branch information
sletz committed May 30, 2021
1 parent 5cb2348 commit b707357
Show file tree
Hide file tree
Showing 6 changed files with 75 additions and 86 deletions.
2 changes: 1 addition & 1 deletion docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -387,5 +387,5 @@ <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>

<!--
MkDocs version : 1.1.2
Build Date UTC : 2021-05-29 17:18:51.517956+00:00
Build Date UTC : 2021-05-30 04:57:41.870719+00:00
-->
80 changes: 35 additions & 45 deletions docs/libs/filters/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -421,10 +421,6 @@
<ul class="nav flex-column">
</ul>
</li>
<li class="nav-item" data-level="3"><a href="#fitf1s" class="nav-link">(fi.)tf1s</a>
<ul class="nav flex-column">
</ul>
</li>
<li class="nav-item" data-level="3"><a href="#fitf1snp" class="nav-link">(fi.)tf1snp</a>
<ul class="nav flex-column">
</ul>
Expand All @@ -433,7 +429,7 @@
<ul class="nav flex-column">
</ul>
</li>
<li class="nav-item" data-level="3"><a href="#fitf1s_1" class="nav-link">(fi.)tf1s</a>
<li class="nav-item" data-level="3"><a href="#fitf1s" class="nav-link">(fi.)tf1s</a>
<ul class="nav flex-column">
</ul>
</li>
Expand Down Expand Up @@ -1310,15 +1306,9 @@ <h4 id="reference_18">Reference</h4>
<li><a href="https://ccrma.stanford.edu/~jos/pasp/Bilinear_Transformation.html">https://ccrma.stanford.edu/~jos/pasp/Bilinear_Transformation.html</a></li>
</ul>
<hr />
<h3 id="fitf1s"><code>(fi.)tf1s</code></h3>
<p>First-order special case of tf2s above</p>
<h4 id="usage_37">Usage</h4>
<pre><code>_ : tf1s(b1,b0,a0) : _
</code></pre>
<hr />
<h3 id="fitf1snp"><code>(fi.)tf1snp</code></h3>
<p>First-order special case of tf2snp above</p>
<h4 id="usage_38">Usage</h4>
<h4 id="usage_37">Usage</h4>
<pre><code>_ : tf1snp(b1,b0,a0) : _
</code></pre>
<hr />
Expand All @@ -1327,15 +1317,15 @@ <h3 id="fitf3slf"><code>(fi.)tf3slf</code></h3>
low-frequency-matching bilinear-transform constant 2/T ("lf" series)
instead of the specific-frequency-matching value used in tf2s and tf1s.
Note the lack of a "w1" argument.</p>
<h4 id="usage_39">Usage</h4>
<h4 id="usage_38">Usage</h4>
<pre><code>_ : tf3slf(b3,b2,b1,b0,a3,a2,a1,a0) : _
</code></pre>
<hr />
<h3 id="fitf1s_1"><code>(fi.)tf1s</code></h3>
<h3 id="fitf1s"><code>(fi.)tf1s</code></h3>
<p>First-order direct-form digital filter,
specified by ANALOG transfer-function polynomials B(s)/A(s),
and a frequency-scaling parameter.</p>
<h4 id="usage_40">Usage</h4>
<h4 id="usage_39">Usage</h4>
<pre><code>_ : tf1s(b1,b0,a0,w1) : _
</code></pre>
<p>Where:</p>
Expand Down Expand Up @@ -1374,22 +1364,22 @@ <h3 id="fitf2sb"><code>(fi.)tf2sb</code></h3>
The order of mappings is (1) frequency scaling (to set lowpass cutoff w1),
(2) bandpass mapping to wc, then (3) the bilinear transform, with the
usual scale parameter <code>2*SR</code>. Algebra carried out in maxima and pasted here.</p>
<h4 id="usage_41">Usage</h4>
<h4 id="usage_40">Usage</h4>
<pre><code>_ : tf2sb(b2,b1,b0,a1,a0,w1,wc) : _
</code></pre>
<hr />
<h3 id="fitf1sb"><code>(fi.)tf1sb</code></h3>
<p>First-to-second-order lowpass-to-bandpass section mapping,
analogous to tf2sb above.</p>
<h4 id="usage_42">Usage</h4>
<h4 id="usage_41">Usage</h4>
<pre><code>_ : tf1sb(b1,b0,a0,w1,wc) : _
</code></pre>
<h2 id="simple-resonator-filters">Simple Resonator Filters</h2>
<hr />
<h3 id="firesonlp"><code>(fi.)resonlp</code></h3>
<p>Simple resonant lowpass filter based on <code>tf2s</code> (virtual analog).
<code>resonlp</code> is a standard Faust function.</p>
<h4 id="usage_43">Usage</h4>
<h4 id="usage_42">Usage</h4>
<pre><code>_ : resonlp(fc,Q,gain) : _
_ : resonhp(fc,Q,gain) : _
_ : resonbp(fc,Q,gain) : _
Expand All @@ -1405,7 +1395,7 @@ <h4 id="usage_43">Usage</h4>
<h3 id="firesonhp"><code>(fi.)resonhp</code></h3>
<p>Simple resonant highpass filters based on <code>tf2s</code> (virtual analog).
<code>resonhp</code> is a standard Faust function.</p>
<h4 id="usage_44">Usage</h4>
<h4 id="usage_43">Usage</h4>
<pre><code>_ : resonlp(fc,Q,gain) : _
_ : resonhp(fc,Q,gain) : _
_ : resonbp(fc,Q,gain) : _
Expand All @@ -1421,7 +1411,7 @@ <h4 id="usage_44">Usage</h4>
<h3 id="firesonbp"><code>(fi.)resonbp</code></h3>
<p>Simple resonant bandpass filters based on <code>tf2s</code> (virtual analog).
<code>resonbp</code> is a standard Faust function.</p>
<h4 id="usage_45">Usage</h4>
<h4 id="usage_44">Usage</h4>
<pre><code>_ : resonlp(fc,Q,gain) : _
_ : resonhp(fc,Q,gain) : _
_ : resonbp(fc,Q,gain) : _
Expand All @@ -1438,7 +1428,7 @@ <h2 id="butterworth-lowpasshighpass-filters">Butterworth Lowpass/Highpass Filter
<h3 id="filowpass"><code>(fi.)lowpass</code></h3>
<p>Nth-order Butterworth lowpass filter.
<code>lowpass</code> is a standard Faust function.</p>
<h4 id="usage_46">Usage</h4>
<h4 id="usage_45">Usage</h4>
<pre><code>_ : lowpass(N,fc) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1455,7 +1445,7 @@ <h4 id="references_7">References</h4>
<h3 id="fihighpass"><code>(fi.)highpass</code></h3>
<p>Nth-order Butterworth highpass filters.
<code>highpass</code> is a standard Faust function.</p>
<h4 id="usage_47">Usage</h4>
<h4 id="usage_46">Usage</h4>
<pre><code>_ : highpass(N,fc) : _
</code></pre>
<p>Where:</p>
Expand Down Expand Up @@ -1492,7 +1482,7 @@ <h4 id="references_9">References</h4>
<hr />
<h3 id="filowpass3e"><code>(fi.)lowpass3e</code></h3>
<p>Third-order Elliptic (Cauer) lowpass filter.</p>
<h4 id="usage_48">Usage</h4>
<h4 id="usage_47">Usage</h4>
<pre><code>_ : lowpass3e(fc) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1508,7 +1498,7 @@ <h4 id="design">Design</h4>
<hr />
<h3 id="filowpass6e"><code>(fi.)lowpass6e</code></h3>
<p>Sixth-order Elliptic/Cauer lowpass filter.</p>
<h4 id="usage_49">Usage</h4>
<h4 id="usage_48">Usage</h4>
<pre><code>_ : lowpass6e(fc) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1526,7 +1516,7 @@ <h2 id="elliptic-highpass-filters">Elliptic Highpass Filters</h2>
<h3 id="fihighpass3e"><code>(fi.)highpass3e</code></h3>
<p>Third-order Elliptic (Cauer) highpass filter. Inversion of <code>lowpass3e</code> wrt unit
circle in s plane (s &lt;- 1/s)</p>
<h4 id="usage_50">Usage</h4>
<h4 id="usage_49">Usage</h4>
<pre><code>_ : highpass3e(fc) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1537,7 +1527,7 @@ <h4 id="usage_50">Usage</h4>
<h3 id="fihighpass6e"><code>(fi.)highpass6e</code></h3>
<p>Sixth-order Elliptic/Cauer highpass filter. Inversion of lowpass3e wrt unit
circle in s plane (s &lt;- 1/s)</p>
<h4 id="usage_51">Usage</h4>
<h4 id="usage_50">Usage</h4>
<pre><code>_ : highpass6e(fc) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1551,7 +1541,7 @@ <h3 id="fibandpass"><code>(fi.)bandpass</code></h3>
<code>s &lt;- s + wc^2/s</code> on <code>lowpass(Nh)</code>, where <code>wc</code> is the desired bandpass center
frequency. The <code>lowpass(Nh)</code> cutoff <code>w1</code> is half the desired bandpass width.
<code>bandpass</code> is a standard Faust function.</p>
<h4 id="usage_52">Usage</h4>
<h4 id="usage_51">Usage</h4>
<pre><code>_ : bandpass(Nh,fl,fu) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1572,7 +1562,7 @@ <h3 id="fibandstop"><code>(fi.)bandstop</code></h3>
<code>s &lt;- s + wc^2/s</code> on <code>highpass(Nh)</code>, where <code>wc</code> is the desired bandpass center
frequency. The <code>highpass(Nh)</code> cutoff <code>w1</code> is half the desired bandpass width.
<code>bandstop</code> is a standard Faust function.</p>
<h4 id="usage_53">Usage</h4>
<h4 id="usage_52">Usage</h4>
<pre><code>_ : bandstop(Nh,fl,fu) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1597,7 +1587,7 @@ <h3 id="fibandpass12e"><code>(fi.)bandpass12e</code></h3>
<hr />
<h3 id="fipospass"><code>(fi.)pospass</code></h3>
<p>Positive-Pass Filter (single-side-band filter)</p>
<h4 id="usage_54">Usage</h4>
<h4 id="usage_53">Usage</h4>
<pre><code>_ : pospass(N,fc) : _,_
</code></pre>
<p>where</p>
Expand Down Expand Up @@ -1645,7 +1635,7 @@ <h4 id="references_11">References</h4>
<h3 id="filow_shelf"><code>(fi.)low_shelf</code></h3>
<p>First-order "low shelf" filter (gain boost|cut between dc and some frequency)
<code>low_shelf</code> is a standard Faust function.</p>
<h4 id="usage_55">Usage</h4>
<h4 id="usage_54">Usage</h4>
<pre><code>_ : lowshelf(N,L0,fx) : _
_ : low_shelf(L0,fx) : _ // default case (order 3)
_ : lowshelf_other_freq(N,L0,fx) : _
Expand Down Expand Up @@ -1687,7 +1677,7 @@ <h4 id="references_12">References</h4>
<h3 id="fihigh_shelf"><code>(fi.)high_shelf</code></h3>
<p>First-order "high shelf" filter (gain boost|cut above some frequency).
<code>high_shelf</code> is a standard Faust function.</p>
<h4 id="usage_56">Usage</h4>
<h4 id="usage_55">Usage</h4>
<pre><code>_ : highshelf(N,Lpi,fx) : _
_ : high_shelf(L0,fx) : _ // default case (order 3)
_ : highshelf_other_freq(N,Lpi,fx) : _
Expand All @@ -1709,7 +1699,7 @@ <h3 id="fipeak_eq"><code>(fi.)peak_eq</code></h3>
<p>Second order "peaking equalizer" section (gain boost or cut near some frequency)
Also called a "parametric equalizer" section.
<code>peak_eq</code> is a standard Faust function.</p>
<h4 id="usage_57">Usage</h4>
<h4 id="usage_56">Usage</h4>
<pre><code>_ : peak_eq(Lfx,fx,B) : _;
</code></pre>
<p>Where:</p>
Expand All @@ -1724,7 +1714,7 @@ <h4 id="references_14">References</h4>
<hr />
<h3 id="fipeak_eq_cq"><code>(fi.)peak_eq_cq</code></h3>
<p>Constant-Q second order peaking equalizer section.</p>
<h4 id="usage_58">Usage</h4>
<h4 id="usage_57">Usage</h4>
<pre><code>_ : peak_eq_cq(Lfx,fx,Q) : _;
</code></pre>
<p>Where:</p>
Expand All @@ -1739,7 +1729,7 @@ <h4 id="references_15">References</h4>
<hr />
<h3 id="fipeak_eq_rm"><code>(fi.)peak_eq_rm</code></h3>
<p>Regalia-Mitra second order peaking equalizer section.</p>
<h4 id="usage_59">Usage</h4>
<h4 id="usage_58">Usage</h4>
<pre><code>_ : peak_eq_rm(Lfx,fx,tanPiBT) : _;
</code></pre>
<p>Where:</p>
Expand All @@ -1764,7 +1754,7 @@ <h3 id="fispectral_tilt"><code>(fi.)spectral_tilt</code></h3>
In other words, alpha is the slope of the ln magnitude versus ln frequency.
For a "pinking filter" (e.g., to generate 1/f noise from white noise),
set alpha to -1/2.</p>
<h4 id="usage_60">Usage</h4>
<h4 id="usage_59">Usage</h4>
<pre><code>_ : spectral_tilt(N,f0,bw,alpha) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1786,7 +1776,7 @@ <h4 id="reference_23">Reference</h4>
<h3 id="filevelfilter"><code>(fi.)levelfilter</code></h3>
<p>Dynamic level lowpass filter.
<code>levelfilter</code> is a standard Faust function.</p>
<h4 id="usage_61">Usage</h4>
<h4 id="usage_60">Usage</h4>
<pre><code>_ : levelfilter(L,freq) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1802,7 +1792,7 @@ <h4 id="reference_24">Reference</h4>
<hr />
<h3 id="filevelfiltern"><code>(fi.)levelfilterN</code></h3>
<p>Dynamic level lowpass filter.</p>
<h4 id="usage_62">Usage</h4>
<h4 id="usage_61">Usage</h4>
<pre><code>_ : levelfilterN(N,freq,L) : _
</code></pre>
<p>Where:</p>
Expand Down Expand Up @@ -1858,7 +1848,7 @@ <h4 id="references_16">References</h4>
<h3 id="fimth_octave_filterbankn"><code>(fi.)mth_octave_filterbank[n]</code></h3>
<p>Allpass-complementary filter banks based on Butterworth band-splitting.
For Butterworth band-splits, the needed delay equalizer is easily found.</p>
<h4 id="usage_63">Usage</h4>
<h4 id="usage_62">Usage</h4>
<pre><code>_ : mth_octave_filterbank(O,M,ftop,N) : par(i,N,_); // Oth-order
_ : mth_octave_filterbank_alt(O,M,ftop,N) : par(i,N,_); // dc-inverted version
</code></pre>
Expand All @@ -1881,7 +1871,7 @@ <h2 id="arbitrary-crossover-filter-banks-and-spectrum-analyzers">Arbitrary-Cross
<h3 id="fifilterbank"><code>(fi.)filterbank</code></h3>
<p>Filter bank.
<code>filterbank</code> is a standard Faust function.</p>
<h4 id="usage_64">Usage</h4>
<h4 id="usage_63">Usage</h4>
<pre><code>_ : filterbank (O,freqs) : par(i,N,_); // Butterworth band-splits
</code></pre>
<p>Where:</p>
Expand All @@ -1897,7 +1887,7 @@ <h4 id="usage_64">Usage</h4>
<hr />
<h3 id="fifilterbanki"><code>(fi.)filterbanki</code></h3>
<p>Inverted-dc filter bank.</p>
<h4 id="usage_65">Usage</h4>
<h4 id="usage_64">Usage</h4>
<pre><code>_ : filterbanki(O,freqs) : par(i,N,_); // Inverted-dc version
</code></pre>
<p>Where:</p>
Expand All @@ -1918,7 +1908,7 @@ <h4 id="references_17">References</h4>
<h3 id="fisvf"><code>(fi.)svf</code></h3>
<p>An environment with <code>lp</code>, <code>bp</code>, <code>hp</code>, <code>notch</code>, <code>peak</code>, <code>ap</code>, <code>bell</code>, <code>ls</code>, <code>hs</code> SVF based filters.
All filters have <code>freq</code> and <code>Q</code> parameters, the <code>bell</code>, <code>ls</code>, <code>hs</code> ones also have a <code>gain</code> third parameter.</p>
<h4 id="usage_66">Usage</h4>
<h4 id="usage_65">Usage</h4>
<pre><code>_ : svf.xx(freq, Q, [gain]) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1931,7 +1921,7 @@ <h2 id="averaging-functions">Averaging Functions</h2>
<hr />
<h3 id="fiavg_rect"><code>(fi.)avg_rect</code></h3>
<p>Moving average.</p>
<h4 id="usage_67">Usage</h4>
<h4 id="usage_66">Usage</h4>
<pre><code>_ : avg_rect(period) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1945,7 +1935,7 @@ <h3 id="fiavg_tau">(fi.)avg_tau</h3>
that is, tau is the integral of the filter's impulse response. This
response is slower to reach the final value but has less ripples in
non-steady signals.</p>
<h4 id="usage_68">Usage</h4>
<h4 id="usage_67">Usage</h4>
<pre><code>_ : avg_tau(period) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1962,7 +1952,7 @@ <h3 id="fiavg_t60">(fi.)avg_t60</h3>
<p>Averaging function based on a one-pole filter and the t60 response time.
This response is particularly useful when the system is required to
reach the final value after about <code>period</code> seconds.</p>
<h4 id="usage_69">Usage</h4>
<h4 id="usage_68">Usage</h4>
<pre><code>_ : avg_t60(period) : _
</code></pre>
<p>Where:</p>
Expand All @@ -1980,7 +1970,7 @@ <h3 id="fiavg_t19">(fi.)avg_t19</h3>
This response is close to the moving-average algorithm as it roughly reaches
the final value after <code>period</code> seconds and shows about the same
oscillations for non-steady signals.</p>
<h4 id="usage_70">Usage</h4>
<h4 id="usage_69">Usage</h4>
<pre><code>_ : avg_t19(period) : _
</code></pre>
<p>Where:</p>
Expand Down
1 change: 0 additions & 1 deletion docs/libs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -634,7 +634,6 @@ <h2 id="filters">filters</h2>
<a href="filters/#fiallpasskl">(fi.)allpasskl</a> &nbsp; &nbsp;
<a href="filters/#fiallpass1m">(fi.)allpass1m</a> &nbsp; &nbsp;
<a href="filters/#fitf2s-and-fitf2snp">(fi.)tf2s and (fi.)tf2snp</a> &nbsp; &nbsp;
<a href="filters/#fitf1s">(fi.)tf1s</a> &nbsp; &nbsp;
<a href="filters/#fitf1snp">(fi.)tf1snp</a> &nbsp; &nbsp;
<a href="filters/#fitf3slf">(fi.)tf3slf</a> &nbsp; &nbsp;
<a href="filters/#fitf1s">(fi.)tf1s</a> &nbsp; &nbsp;
Expand Down
2 changes: 1 addition & 1 deletion docs/search/search_index.json

Large diffs are not rendered by default.

Loading

0 comments on commit b707357

Please sign in to comment.