<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>book/src/tutorial.md - fork/numbat @ v1.6.2</title>
<meta name="description" content="book/src/tutorial.md in fork/numbat at v1.6.2.">
<meta property="og:title" content="book/src/tutorial.md - fork/numbat @ v1.6.2">
<meta property="og:description" content="book/src/tutorial.md in fork/numbat at v1.6.2.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="v1.6.2" data-tip="4926554e3eb378f166658e24a2be99c5403eca59">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/numbat</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/numbat</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">David Peter</span><span class="commit-message" data-commit="b70f4997ba118b373cfd2cc8ea49636843a5af88">Documentation improvements</span><span class="snapshot-sha sha" data-commit="b70f4997ba118b373cfd2cc8ea49636843a5af88">b70f499</span><time datetime="2023-09-12T20:16:13+02:00" title="2023-09-12 20:16:13 +0200">2023-09-12</time></p>
<header class="topbar"><details class="switcher"><summary>v1.6.2</summary><div class="menu"><strong>branches</strong><a href="/fork/numbat/ref/master/">master</a><strong>tags</strong><a href="/fork/numbat/ref/v1.6.0/">v1.6.0</a><a href="/fork/numbat/ref/v1.6.1/">v1.6.1</a><a class="current" href="/fork/numbat/ref/v1.6.2/">v1.6.2</a><a href="/fork/numbat/ref/v1.6.3/">v1.6.3</a><a href="/fork/numbat/ref/v1.7.0/">v1.7.0</a><a href="/fork/numbat/ref/v1.8.0/">v1.8.0</a><a class="all" href="/fork/numbat/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/numbat/">numbat</a> / <a href="/fork/numbat/ref/v1.6.2/tree/book/">book</a> / <a href="/fork/numbat/ref/v1.6.2/tree/book/src/">src</a> / <span class="cur">tutorial.md</span></nav>
<span class="view-stats"><span>4.7 KiB</span><span>112 lines</span></span><span class="actions"><a class="raw" href="/fork/numbat/raw/2c3fdcb53a2e0d72405142a8729da394a6fd6255/book/src/tutorial.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Tutorial</h1>
<p>In this tutorial, you will use Numbat to calculate how many bananas you would need to power a
house. This is based on <a href="https://what-if.xkcd.com/158/">an article</a> in the great <em>what if?</em> series
by the author of the xkcd comics.</p>
&lt;p align="center"&gt;&lt;img src="https://what-if.xkcd.com/imgs/a/158/hazard.png"&gt;&lt;/p&gt;
<p>Bananas contain potassium. In its natural form, potassium contains a tiny fraction (0.0117%)
of the isotope &lt;sup style="line-height: 0"&gt;40&lt;/sup&gt;K, which is radioactive. The idea is to
use the radioactive decay energy as a power source. Open an interactive Numbat session by
typing <code>numbat</code> in your favorite terminal emulator. We start by entering a few <a href="https://en.wikipedia.org/wiki/Potassium-40">facts about
potassium-40</a>:</p>
<pre>let halflife = 1.25 billion years
let occurence = 0.0117%
let molar_mass = 40 g / mol
</pre>
<p>New constants are <a href="/fork/numbat/ref/v1.6.2/blob/book/src/constant-definitions.md">introduced with the <code>let</code> keyword</a>. We
define these physical quantities with their respective physical units (<code>years</code>,
<code>percent</code>, <code>g / mol</code>) in order to profit from Numbats unit-safety and unit-conversion
features later on.</p>
<p>Our first goal is to compute the radioactivity of natural potassium. Instead of dealing with the
half-life, we want to know the decay rate. When entering the following computation, you can try
Numbats auto-completion functionality. Instead of typing out <code>halflife</code>, just type <code>half</code> and press
<code>Tab</code>.</p>
<pre>let decay_rate = ln(2) / halflife
</pre>
<p>As you can see, we can use typical <a href="/fork/numbat/ref/v1.6.2/blob/book/src/list-functions.md">mathematical functions</a> such as the
natural logarithm <code>ln</code>. Next, we are interested how much radioactivity comes from a certain
mass of potassium:</p>
<pre>let radioactivity =
    N_A * occurence * decay_rate / molar_mass -&gt; Bq / g
</pre>
<p>The <code>-&gt; Bq / g</code> part at the end converts the expression to Becquerel per gram. If you type
in <code>radioactivity</code>, you should see a result of roughly <code>31 Bq / g</code>, i.e. 31 radioactive
decays per second, per gram of potassium.</p>
<p>The unit conversion also serves another purpose. If anything would be wrong with our
calculation at the units-level, Numbat would detect that and show an error.
Unit safety is a powerful concept not just because you can eliminate an entire category
of errors, but also because it makes your computations more readable.</p>
<p>We are interested in the radioactivity of bananas, so we first <a href="/fork/numbat/ref/v1.6.2/blob/book/src/unit-definitions.md">introduce a new (base) unit</a>:</p>
<pre>unit banana
</pre>
<p>This lets us write readable code like</p>
<pre>let potassium_per_banana = 451 mg / banana

let radioactivity_banana = potassium_per_banana * radioactivity -&gt; Bq / banana
</pre>
<p>and should give you a result of rougly <code>14 Bq / banana</code>. Adding unit conversions at the end
of unit definitions is one way to enforce unit safety. An even more powerful way to do this
is to add <em>type annotations</em>: For example, to define the <a href="https://commons.wikimedia.org/wiki/File:Potassium-40-decay-scheme.svg">decay energy for a single
potassium-40 atom</a>,
you can optionally add a <code>: Energy</code> annotation that will be enforced by Numbat:</p>
<pre>let energy_per_decay: Energy = 11 percent × 1.5 MeV + 89 percent × 1.3 MeV
</pre>
<p>This also works with custom units since Numbat adds new physical dimensions (types) implicitly:</p>
<pre>let power_per_banana: Power / Banana = radioactivity_banana * energy_per_decay
</pre>
<p>You'll also notice that types can be combined via <a href="/fork/numbat/ref/v1.6.2/blob/book/src/operations.md">mathematical operators</a> such as <code>/</code> in this example.</p>
<p>How many bananas we need to power a household is going to depend on the average power consumption
of that household. So we are <a href="/fork/numbat/ref/v1.6.2/blob/book/src/function-definitions.md">defining a simple function</a></p>
<pre>fn household_power(annual_consumption: Energy) -&gt; Power = annual_consumption / year
</pre>
<p>This allows us to finally answer the original question (for a <a href="https://www.eia.gov/tools/faqs/faq.php?id=97">typical US household in 2021</a>)</p>
<pre>household_power(10000 kWh) / power_per_banana
</pre>
<p>This should give you a result of roughly 4×10&lt;sup style="line-height: 0"&gt;14&lt;/sup&gt; bananas<sup class="footnote-reference"><a href="#note">1</a></sup>.</p>
&lt;p align="center"&gt;&lt;img src="https://what-if.xkcd.com/imgs/a/158/10bunches.png"&gt;&lt;/p&gt;
<h2>Attribution</h2>
<p>The images in this tutorial are from <a href="https://what-if.xkcd.com/158/">https://what-if.xkcd.com/158/</a>. They are licensed
under the <a href="https://creativecommons.org/licenses/by-nc/2.5/">Creative Commons Attribution-NonCommercial 2.5 License</a>.
Details and usage notes can be found at <a href="https://xkcd.com/license.html">https://xkcd.com/license.html</a>.</p>
<div class="footnote-definition" id="note"><sup class="footnote-definition-label">1</sup>
<p>Interestingly, the <em>what if</em> article comes up with a result of 300 quadrillion bananas,
or 3 × 10&lt;sup style="line-height: 0"&gt;17&lt;/sup&gt;. This is a factor of 1000 higher. This seems like a
mistake in the original source. All of our other intermediate results are consistent with what has
been computed in the original article.</p>
</div>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Tutorial</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">In this tutorial, you will use Numbat to calculate how many bananas you would need to power a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">house. This is based on [an article](https://what-if.xkcd.com/158/) in the great *what if?* series</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">by the author of the xkcd comics.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"><a-p>&lt;</a-p><a-tg>p</a-tg> <a-at>align</a-at>=&quot;<a-s>center</a-s>&quot;<a-p>&gt;&lt;</a-p><a-tg>img</a-tg> <a-at>src</a-at>=&quot;<a-s>https://what-if.xkcd.com/imgs/a/158/hazard.png</a-s>&quot;<a-p>&gt;&lt;/</a-p><a-tg>p</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-p>Bananas contain potassium. In its natural form, potassium contains a tiny fraction (0.0117%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>of the isotope &lt;sup style=&quot;line-height: 0&quot;&gt;40&lt;/sup&gt;K, which is radioactive. The idea is to</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>use the radioactive decay energy as a power source. Open an interactive Numbat session by</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"><a-p>typing `numbat` in your favorite terminal emulator. We start by entering a few [facts about</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>potassium-40](https://en.wikipedia.org/wiki/Potassium-40):</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>let halflife = 1.25 billion years</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>let occurence = 0.0117%</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>let molar_mass = 40 g / mol</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>New constants are [introduced with the `let` keyword](./constant-definitions.md). We</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>define these physical quantities with their respective physical units (`years`,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>`percent`, `g / mol`) in order to profit from Numbats unit-safety and unit-conversion</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>features later on.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>Our first goal is to compute the radioactivity of natural potassium. Instead of dealing with the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>half-life, we want to know the decay rate. When entering the following computation, you can try</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>Numbats auto-completion functionality. Instead of typing out `halflife`, just type `half` and press</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>`Tab`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>let decay_rate = ln(2) / halflife</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>As you can see, we can use typical [mathematical functions](./list-functions.md) such as the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>natural logarithm `ln`. Next, we are interested how much radioactivity comes from a certain</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>mass of potassium:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>let radioactivity =</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>    N_A * occurence * decay_rate / molar_mass -&gt; Bq / g</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>The `-&gt; Bq / g` part at the end converts the expression to Becquerel per gram. If you type</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>in `radioactivity`, you should see a result of roughly `31 Bq / g`, i.e. 31 radioactive</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>decays per second, per gram of potassium.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>The unit conversion also serves another purpose. If anything would be wrong with our</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>calculation at the units-level, Numbat would detect that and show an error.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>Unit safety is a powerful concept not just because you can eliminate an entire category</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>of errors, but also because it makes your computations more readable.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>We are interested in the radioactivity of bananas, so we first [introduce a new (base) unit](./unit-definitions.md):</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>unit banana</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>This lets us write readable code like</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>let potassium_per_banana = 451 mg / banana</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>let radioactivity_banana = potassium_per_banana * radioactivity -&gt; Bq / banana</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>and should give you a result of rougly `14 Bq / banana`. Adding unit conversions at the end</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>of unit definitions is one way to enforce unit safety. An even more powerful way to do this</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>is to add *type annotations*: For example, to define the [decay energy for a single</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>potassium-40 atom](https://commons.wikimedia.org/wiki/File:Potassium-40-decay-scheme.svg),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>you can optionally add a `: Energy` annotation that will be enforced by Numbat:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>let energy_per_decay: Energy = 11 percent × 1.5 MeV + 89 percent × 1.3 MeV</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"><a-p>This also works with custom units since Numbat adds new physical dimensions (types) implicitly:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>let power_per_banana: Power / Banana = radioactivity_banana * energy_per_decay</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>You&#39;ll also notice that types can be combined via [mathematical operators](./operations.md) such as `/` in this example.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"><a-p>How many bananas we need to power a household is going to depend on the average power consumption</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>of that household. So we are [defining a simple function](./function-definitions.md)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>```</a-p><a-tl>numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>fn household_power(annual_consumption: Energy) -&gt; Power = annual_consumption / year</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>This allows us to finally answer the original question (for a [typical US household in 2021](https://www.eia.gov/tools/faqs/faq.php?id=97))</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>```</a-p><a-tl> numbat</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>household_power(10000 kWh) / power_per_banana</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>This should give you a result of roughly 4×10&lt;sup style=&quot;line-height: 0&quot;&gt;14&lt;/sup&gt; bananas[^note].</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>&lt;</a-p><a-tg>p</a-tg><a-p> </a-p><a-at>align</a-at><a-p>=&quot;</a-p><a-s>center</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://what-if.xkcd.com/imgs/a/158/10bunches.png</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>p</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>## </a-p><a-tt>Attribution</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text">The images in this tutorial are from [https://what-if.xkcd.com/158/](https://what-if.xkcd.com/158/). They are licensed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text">under the [Creative Commons Attribution-NonCommercial 2.5 License](https://creativecommons.org/licenses/by-nc/2.5/).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text">Details and usage notes can be found at [https://xkcd.com/license.html](https://xkcd.com/license.html).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text">[^note]: Interestingly, the *what if* article comes up with a result of 300 quadrillion bananas,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text">or 3 × 10&lt;sup style=&quot;line-height: 0&quot;&gt;17&lt;/sup&gt;. This is a factor of 1000 higher. This seems like a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text">mistake in the original source. All of our other intermediate results are consistent with what has</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text">been computed in the original article.</span></span></pre></div></div>
</main>
</body>
</html>
