build based on b961269

previews/PR81/examples/generated/UserGuide/functions_pass_to_DB/index.html

@@ -516,6 +516,15 @@
     </span>
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#interpolating-queries" class="md-nav__link">
+    <span class="md-ellipsis">
+      Interpolating queries
+    </span>
+  </a>
+
 </li>
 
     </ul>
@@ -675,6 +684,15 @@
     </span>
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#interpolating-queries" class="md-nav__link">
+    <span class="md-ellipsis">
+      Interpolating queries
+    </span>
+  </a>
+
 </li>
 
     </ul>
@@ -803,6 +821,31 @@ <h2 id="write-pipeline-function-to-use-inside-of-chains">Write pipeline function
 <div><div style = "float: left;"><span>8×7 DataFrame</span></div><div style = "clear: both;"></div></div>
 <div class = "data-frame" style = "overflow-x: scroll;"><table class = "data-frame" style = "margin-bottom: 6px;"><thead><tr class = "header"><th class = "rowNumber" style = "font-weight: bold; text-align: right;">Row</th><th style = "text-align: left;">id</th><th style = "text-align: left;">groups</th><th style = "text-align: left;">value</th><th style = "text-align: left;">percent</th><th style = "text-align: left;">value_minimum</th><th style = "text-align: left;">value_maximum</th><th style = "text-align: left;">value_mean</th></tr><tr class = "subheader headerLastRow"><th class = "rowNumber" style = "font-weight: bold; text-align: right;"></th><th title = "String" style = "text-align: left;">String</th><th title = "String" style = "text-align: left;">String</th><th title = "Int64" style = "text-align: left;">Int64</th><th title = "Float64" style = "text-align: left;">Float64</th><th title = "Int64" style = "text-align: left;">Int64</th><th title = "Int64" style = "text-align: left;">Int64</th><th title = "Float64" style = "text-align: left;">Float64</th></tr></thead><tbody><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">1</td><td style = "text-align: left;">AB</td><td style = "text-align: left;">aa</td><td style = "text-align: right;">2</td><td style = "text-align: right;">0.2</td><td style = "text-align: right;">2</td><td style = "text-align: right;">4</td><td style = "text-align: right;">3.0</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">2</td><td style = "text-align: left;">AD</td><td style = "text-align: left;">aa</td><td style = "text-align: right;">4</td><td style = "text-align: right;">0.4</td><td style = "text-align: right;">2</td><td style = "text-align: right;">4</td><td style = "text-align: right;">3.0</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">3</td><td style = "text-align: left;">AH</td><td style = "text-align: left;">aa</td><td style = "text-align: right;">3</td><td style = "text-align: right;">0.8</td><td style = "text-align: right;">3</td><td style = "text-align: right;">5</td><td style = "text-align: right;">4.0</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">4</td><td style = "text-align: left;">AJ</td><td style = "text-align: left;">aa</td><td style = "text-align: right;">5</td><td style = "text-align: right;">1.0</td><td style = "text-align: right;">3</td><td style = "text-align: right;">5</td><td style = "text-align: right;">4.0</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">5</td><td style = "text-align: left;">AC</td><td style = "text-align: left;">bb</td><td style = "text-align: right;">3</td><td style = "text-align: right;">0.3</td><td style = "text-align: right;">3</td><td style = "text-align: right;">5</td><td style = "text-align: right;">4.0</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">6</td><td style = "text-align: left;">AE</td><td style = "text-align: left;">bb</td><td style = "text-align: right;">5</td><td style = "text-align: right;">0.5</td><td style = "text-align: right;">2</td><td style = "text-align: right;">5</td><td style = "text-align: right;">3.33333</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">7</td><td style = "text-align: left;">AG</td><td style = "text-align: left;">bb</td><td style = "text-align: right;">2</td><td style = "text-align: right;">0.7</td><td style = "text-align: right;">2</td><td style = "text-align: right;">5</td><td style = "text-align: right;">3.66667</td></tr><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">8</td><td style = "text-align: left;">AI</td><td style = "text-align: left;">bb</td><td style = "text-align: right;">4</td><td style = "text-align: right;">0.9</td><td style = "text-align: right;">2</td><td style = "text-align: right;">4</td><td style = "text-align: right;">3.0</td></tr></tbody></table></div>
 
+<p><a id='Interpolating-queries'></a></p>
+<p><a id='Interpolating-queries-1'></a></p>
+<h2 id="interpolating-queries">Interpolating queries<a class="headerlink" href="#interpolating-queries" title="Permanent link">¤</a></h2>
+<p>To use a prior, uncollected TidierDB query in other TidierDB macros, interpolate the needed query without showing or collecting it</p>
+<div class="highlight"><pre><span></span><code><span class="n">ok</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nd">@chain</span><span class="w"> </span><span class="n">t</span><span class="p">(</span><span class="n">df_mem</span><span class="p">)</span><span class="w"> </span><span class="nd">@summarize</span><span class="p">(</span><span class="n">mean</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mean</span><span class="p">(</span><span class="n">value</span><span class="p">));</span>
+</code></pre></div>
+<p>the mean value represented in SQL from the above is 3</p>
+<div class="highlight"><pre><span></span><code><span class="nd">@eval</span><span class="w"> </span><span class="nd">@chain</span><span class="w"> </span><span class="n">t</span><span class="p">(</span><span class="n">df_mem</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
+<span class="w">    </span><span class="nd">@filter</span><span class="p">(</span><span class="w"> </span><span class="n">value</span><span class="w"> </span><span class="o">&gt;</span><span class="w"> </span><span class="o">$</span><span class="n">ok</span><span class="p">)</span>
+<span class="w">    </span><span class="nd">@collect</span>
+<span class="k">end</span>
+
+<span class="nd">@eval</span><span class="w"> </span><span class="nd">@chain</span><span class="w"> </span><span class="n">t</span><span class="p">(</span><span class="n">df_mem</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
+<span class="w">    </span><span class="nd">@mutate</span><span class="p">(</span><span class="n">value2</span><span class="w"> </span><span class="o">=</span><span class="w">  </span><span class="n">value</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="o">$</span><span class="n">ok</span><span class="p">)</span>
+<span class="w">    </span><span class="nd">@collect</span>
+<span class="k">end</span>
+
+<span class="nd">@eval</span><span class="w"> </span><span class="nd">@chain</span><span class="w"> </span><span class="n">t</span><span class="p">(</span><span class="n">df_mem</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
+<span class="w">    </span><span class="nd">@summarize</span><span class="p">(</span><span class="n">value</span><span class="w"> </span><span class="o">=</span><span class="w">  </span><span class="n">mean</span><span class="p">(</span><span class="n">value</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="o">$</span><span class="n">ok</span><span class="p">)</span>
+<span class="w">    </span><span class="nd">@collect</span>
+<span class="k">end</span>
+</code></pre></div>
+<div><div style = "float: left;"><span>1×1 DataFrame</span></div><div style = "clear: both;"></div></div>
+<div class = "data-frame" style = "overflow-x: scroll;"><table class = "data-frame" style = "margin-bottom: 6px;"><thead><tr class = "header"><th class = "rowNumber" style = "font-weight: bold; text-align: right;">Row</th><th style = "text-align: left;">value</th></tr><tr class = "subheader headerLastRow"><th class = "rowNumber" style = "font-weight: bold; text-align: right;"></th><th title = "Float64" style = "text-align: left;">Float64</th></tr></thead><tbody><tr><td class = "rowNumber" style = "font-weight: bold; text-align: right;">1</td><td style = "text-align: right;">9.0</td></tr></tbody></table></div>
+
 <hr />
 <p><em>This page was generated using <a href="https://github.com/fredrikekre/Literate.jl">Literate.jl</a>.</em></p>