From cd42f56eae2d35e7de605d5e3bb353408eec9649 Mon Sep 17 00:00:00 2001
From: James Turk <dev@jpt.sh>
Date: Thu, 26 Sep 2024 15:43:02 -0500
Subject: [PATCH] switch to Jupyter, marimo was having strange issues

---
 .gitignore                       |    1 +
 00.value-of-dataviz/slides.md    |    7 +-
 01.gog-altair/altair-notebook.py |  226 ------
 01.gog-altair/altair.ipynb       | 1099 ++++++++++++++++++++++++++++++
 01.gog-altair/slides.html        |   72 +-
 01.gog-altair/slides.md          |   76 ++-
 01.gog-altair/vega.png           |  Bin 0 -> 64954 bytes
 README.md                        |   17 +-
 8 files changed, 1253 insertions(+), 245 deletions(-)
 delete mode 100644 01.gog-altair/altair-notebook.py
 create mode 100644 01.gog-altair/altair.ipynb
 create mode 100644 01.gog-altair/vega.png

diff --git a/.gitignore b/.gitignore
index 0d20b64..69435bb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
 *.pyc
+.ipynb_checkpoints
diff --git a/00.value-of-dataviz/slides.md b/00.value-of-dataviz/slides.md
index 2e0fd46..1394bbd 100644
--- a/00.value-of-dataviz/slides.md
+++ b/00.value-of-dataviz/slides.md
@@ -233,7 +233,7 @@ Final project will have a place where D3 will be helpful, but other options will
 After introductory lecture, some examples will continue to be in D3, but you will not need to understand their inner workings.
 
 <!--
-It has however, become a "library's library" in some ways. Most developers interact with d3 through a higher-level interface. 
+It has however, become a "library's library" in some ways. Most developers interact with D3 through a higher-level interface. 
 
 We will be learning Altair, which generates Vega JSON, which in turn is drawn using D3.
 
@@ -260,9 +260,10 @@ So, if you are here to learn visualization, I think that it is fair that you can
 ## Course Staff
 
 - James Turk
-- TODO
+- Krisha Mehta
+- Sam Huang
 
-**All official information will be on the course site and/or Ed as appropriate.**
+**All official information will be on the course site and/or Ed.**
 
 
 ---
diff --git a/01.gog-altair/altair-notebook.py b/01.gog-altair/altair-notebook.py
deleted file mode 100644
index 236932f..0000000
--- a/01.gog-altair/altair-notebook.py
+++ /dev/null
@@ -1,226 +0,0 @@
-import marimo
-
-__generated_with = "0.8.20"
-app = marimo.App(width="medium")
-
-
-@app.cell
-def __():
-    import marimo as mo
-    import altair as alt
-    import polars as pl
-    from pathlib import Path
-    return Path, alt, mo, pl
-
-
-@app.cell
-def __(mo):
-    mo.md(
-        """
-        ## Tidy Data
-
-        Altair expects our data to be [tidy](http://vita.had.co.nz/papers/tidy-data.html).
-
-        - Each variable is a column.
-        - Each observation is a row. 
-        - Each type of observational unit is a table.
-
-        You can use `pandas` or `polars` DataFrames.
-        """
-    )
-    return
-
-
-@app.cell
-def __(Path, __file__, pl):
-    # first let's load and look at a dataframe with three columns
-    #  there is an observation for each state legislature, showing how many bills they introduced in a given year
-    df = pl.read_csv(Path(__file__).parent / "midwest_bills.csv")
-    # (having a dataframe or chart as the last line in a notebook cell will automatically display it)
-    df
-    return (df,)
-
-
-@app.cell
-def __(alt, df):
-    # Let's make our own charts of this dat, first we bind the data to a new chart object
-    chart = alt.Chart(df)
-    return (chart,)
-
-
-@app.cell
-def __(chart):
-    # we add a geometry, we'll start with a point (at this point *something* can be displayed, but it won't be useful)
-    chart.mark_point()
-    return
-
-
-@app.cell
-def __(chart):
-    # We use encodings to map our data to particular dimensions.
-    # Altair will make then make appropriate choices based upon the type of data.
-    chart.mark_point().encode(
-        y="state",
-        x="num_bills"
-    )
-    return
-
-
-@app.cell
-def __():
-    return
-
-
-@app.cell
-def __(alt, chart):
-    # what happens when we try to add color?
-    chart.mark_point().encode(
-        alt.Y("state"),
-        alt.X("num_bills"),
-        alt.Color("session_start_year"),
-    )
-    return
-
-
-@app.cell
-def __(alt, chart):
-    # the prior example treated year as an Ordinal because it was numeric
-    # instead we would treat it as Nominal for this data
-    # we can use :Q, :O, :N, :T to mark the type that should be used
-    by_year = chart.mark_point().encode(
-        alt.Y("state:N"),
-        alt.X("num_bills:Q"),
-        alt.Color("session_start_year:N"),
-    )
-    # we're saving this one for later
-    by_year
-    return (by_year,)
-
-
-@app.cell
-def __(alt, chart):
-    # Here we make a different chart from the same base data 
-    # by re-using our `chart` variable.
-    #
-    # We choose a different shape (parameters that don't need to vary can be passed into the mark_* functions)
-    # We also use an aggregate function average(num_bills)
-    avgs = chart.mark_point(shape="wedge", color="black").encode(
-        alt.Y("state"),
-        alt.X("average(num_bills)"),
-    )
-    avgs
-    return (avgs,)
-
-
-@app.cell
-def __(avgs, by_year):
-    # two charts with compatible data can be layered with +
-    by_year + avgs
-    return
-
-
-@app.cell
-def __(alt, by_year, chart):
-    # perhaps we don't want to use mark_point anymore, maybe a bar?
-    bar_avgs = chart.mark_bar(color="#ccc").encode(
-        alt.Y("state"),
-        alt.X("average(num_bills)"),
-    )
-    bar_avgs + by_year
-    return (bar_avgs,)
-
-
-@app.cell
-def __(alt, chart):
-    # We can customize titles and other details by using `.title` and `.properties`
-    # the latter sets chart-wide properties.
-    final = chart.mark_point(shape="diamond").encode(
-        alt.Y("state:N"),
-        alt.X("num_bills:Q"),
-        alt.Color("session_start_year:N").title("Session Year"),
-    ) + chart.mark_bar(color="#70905050").encode(
-        alt.Y("state"),
-        alt.X("average(num_bills)").title("Number of Bills Introduced"),
-    )
-    final.properties(
-        title='Midwest Bills by State',
-        background='#f5f5dc'
-    )
-    return (final,)
-
-
-@app.cell
-def __(alt, chart):
-    # Let's say we instead want to see if there are trends by year.
-    # create a new chart object with year on the X-axis, and bills on the Y-axis
-    # Also, make the chart print/colorblind friendly by encoding state in multiple ways.
-    new_chart = chart.mark_point().encode(
-        alt.Y("num_bills"),
-        alt.X("session_start_year:N"),
-        alt.Color("state"),
-        alt.Shape("state"),
-    )
-    new_chart.properties(
-        title='Midwest Bills by Year',
-        background='#f5f5dc'
-    )
-    return (new_chart,)
-
-
-@app.cell
-def __(mo):
-    mo.md(
-        """
-        ### Recommended Reading
-
-        Altair Tutorial
-
-        - Specifying Data (you can stop when you hit 'Generated Data')
-        - Encodings
-        - Encodings -> Channels (skim Channel Options)
-        - Marks (skim a few of the mark guides, including Bar & Point)
-        - Data Transformations (skim a few, including Regression)
-        - Layered and Multi-View Charts
-        - Customizing Visualizations
-
-        Once you've read the above you have the core ideas of Altair.
-        The remaining sections are useful as reference, and as you use Altair you will find your way to them as you ask yourself questions like "how do I work with geospatial data" or "how can I combine these axes"?
-
-        The other common thing you will use the documentation for is "what arguments can I pass to this?"
-
-        For that, use the [API Reference](https://altair-viz.github.io/user_guide/api.html) and find the class you're working with.
-
-        Example: 
-
-        - Let's say we want to adjust the color scheme, start with <https://altair-viz.github.io/user_guide/generated/channels/altair.Color.html>
-        - Note that it can take a scale, and click to <https://altair-viz.github.io/user_guide/generated/core/altair.Scale.html#altair.Scale>
-        """
-    )
-    return
-
-
-@app.cell
-def __(alt, chart):
-    color_scheme = alt.Scale(scheme="set2")
-    chart.mark_line().encode(
-        alt.Y("num_bills"),
-        alt.X("session_start_year:N"),
-        alt.Color("state", scale=color_scheme),
-    ) + chart.mark_point().encode(
-        alt.Y("num_bills").title("Bills Introduced"),
-        alt.X("session_start_year:N").title("Session Year"),
-        alt.Color("state", scale=color_scheme),
-        alt.Shape("state"),
-    ).properties(
-        title='Midwest Bills by Session',
-    )
-    return (color_scheme,)
-
-
-@app.cell
-def __():
-    return
-
-
-if __name__ == "__main__":
-    app.run()
diff --git a/01.gog-altair/altair.ipynb b/01.gog-altair/altair.ipynb
new file mode 100644
index 0000000..1240535
--- /dev/null
+++ b/01.gog-altair/altair.ipynb
@@ -0,0 +1,1099 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "b30269d6-9c9d-4a1f-a5e2-95c94a4877d6",
+   "metadata": {},
+   "source": [
+    "# Introduction to Altair\n",
+    "\n",
+    "## Before we start: Jupyter Notebooks\n",
+    "\n",
+    "- Made up of \"cells\" which can be Python, markdown, or with extensions, any language.\n",
+    "- Cells execute individually, and can execute out of order.  Always re-order cells to be logical and make use of comments and/or markdown cells to make your notebook a narrative.\n",
+    "- Tip: Before submitting a notebook, restart the kernel and run all cells in order. (See Kernel menu for options.) Ensure that you didn't inadvertently break things.\n",
+    "- Not particularly Git friendly as the contents of the notebook are stored in JSON.  (Still keep them in Git! even if suboptimal better than losing work!)\n",
+    "- An alternative is `marimo` notebooks, which fix a few of the above issues.  Still new & there are some rough edges still so I'll be sticking with Jupyter.\n",
+    "\n",
+    "`uv run jupyter lab` or `uv run jupyter notebook` will start the local notebook server (Lab is a newer UI, Notebook is the traditional one).  You may opt to use VS Code, but I personallyh find their interface for notebooks more confusing than helpful.\n",
+    "\n",
+    "### Style Addendum (for all assignments in this course)\n",
+    "\n",
+    "- Notebook style imports allowed/preferred.\n",
+    "- Limited use of global variables permitted with useful names and comments.\n",
+    "- Notebooks must execute sequentially!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "MJUe",
+   "metadata": {},
+   "source": [
+    "## Altair expects \"tidy\" data\n",
+    "\n",
+    "Altair expects our data to be [tidy](http://vita.had.co.nz/papers/tidy-data.html).\n",
+    "\n",
+    "- Each variable is a column.\n",
+    "- Each observation is a row.\n",
+    "- Each type of observational unit is a table.\n",
+    "\n",
+    "You may use `pandas` or `polars` DataFrames. \n",
+    "Class examples will focus on pre-cleaned data, and I will use polars in examples, though rarely will what I show differ significantly in pandas."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "Hbol",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# best to follow convention, \"notebook\" style imports are allowed/preferred\n",
+    "import marimo as mo\n",
+    "import altair as alt\n",
+    "import polars as pl\n",
+    "from pathlib import Path"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "id": "vblA",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div><style>\n",
+       ".dataframe > thead > tr,\n",
+       ".dataframe > tbody > tr {\n",
+       "  text-align: right;\n",
+       "  white-space: pre-wrap;\n",
+       "}\n",
+       "</style>\n",
+       "<small>shape: (12, 3)</small><table border=\"1\" class=\"dataframe\"><thead><tr><th>state</th><th>session_start_year</th><th>num_bills</th></tr><tr><td>str</td><td>i64</td><td>i64</td></tr></thead><tbody><tr><td>&quot;IL&quot;</td><td>2017</td><td>13616</td></tr><tr><td>&quot;IL&quot;</td><td>2019</td><td>12760</td></tr><tr><td>&quot;IL&quot;</td><td>2021</td><td>12847</td></tr><tr><td>&quot;IL&quot;</td><td>2023</td><td>11951</td></tr><tr><td>&quot;MI&quot;</td><td>2017</td><td>4818</td></tr><tr><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td></tr><tr><td>&quot;MI&quot;</td><td>2023</td><td>3424</td></tr><tr><td>&quot;WI&quot;</td><td>2017</td><td>1820</td></tr><tr><td>&quot;WI&quot;</td><td>2019</td><td>2264</td></tr><tr><td>&quot;WI&quot;</td><td>2021</td><td>2618</td></tr><tr><td>&quot;WI&quot;</td><td>2023</td><td>2656</td></tr></tbody></table></div>"
+      ],
+      "text/plain": [
+       "shape: (12, 3)\n",
+       "┌───────┬────────────────────┬───────────┐\n",
+       "│ state ┆ session_start_year ┆ num_bills │\n",
+       "│ ---   ┆ ---                ┆ ---       │\n",
+       "│ str   ┆ i64                ┆ i64       │\n",
+       "╞═══════╪════════════════════╪═══════════╡\n",
+       "│ IL    ┆ 2017               ┆ 13616     │\n",
+       "│ IL    ┆ 2019               ┆ 12760     │\n",
+       "│ IL    ┆ 2021               ┆ 12847     │\n",
+       "│ IL    ┆ 2023               ┆ 11951     │\n",
+       "│ MI    ┆ 2017               ┆ 4818      │\n",
+       "│ …     ┆ …                  ┆ …         │\n",
+       "│ MI    ┆ 2023               ┆ 3424      │\n",
+       "│ WI    ┆ 2017               ┆ 1820      │\n",
+       "│ WI    ┆ 2019               ┆ 2264      │\n",
+       "│ WI    ┆ 2021               ┆ 2618      │\n",
+       "│ WI    ┆ 2023               ┆ 2656      │\n",
+       "└───────┴────────────────────┴───────────┘"
+      ]
+     },
+     "execution_count": 22,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Also OK, limited use of global variables.\n",
+    "#\n",
+    "# Avoid `df` though because that is a common parameter name and not helpful in a global context.\n",
+    "# Also to avoid: `df2`, `df_pure`, `df_final_final_final_final_v4_v9`.\n",
+    "\n",
+    "# first let's load and look at a dataframe with three columns\n",
+    "#  there is an observation for each state legislature, showing how many bills they introduced in a given year\n",
+    "bills = pl.read_csv(\"midwest_bills.csv\")\n",
+    "\n",
+    "# Having a dataframe or chart variable as the last line in a notebook cell will automatically display it.\n",
+    "#  Use sparingly, and typically only for final chart in your own work, but in tutorials I will show intermediate steps.\n",
+    "bills"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "bkHC",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's make our own charts of this data, first we bind the data to a new chart object\n",
+    "chart = alt.Chart(df)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "lEQa",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-ce76917b42b6429cac34c70b23e012b3.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-ce76917b42b6429cac34c70b23e012b3.vega-embed details,\n",
+       "  #altair-viz-ce76917b42b6429cac34c70b23e012b3.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-ce76917b42b6429cac34c70b23e012b3\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-ce76917b42b6429cac34c70b23e012b3\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-ce76917b42b6429cac34c70b23e012b3\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"mark\": {\"type\": \"point\"}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.Chart(...)"
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# we add a geometry, we'll start with a point (at this point *something* can be displayed, but it won't be useful)\n",
+    "chart.mark_point()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "id": "PKri",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-14388f53e0d5400b802ade3cdfacd6b8.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-14388f53e0d5400b802ade3cdfacd6b8.vega-embed details,\n",
+       "  #altair-viz-14388f53e0d5400b802ade3cdfacd6b8.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-14388f53e0d5400b802ade3cdfacd6b8\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-14388f53e0d5400b802ade3cdfacd6b8\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-14388f53e0d5400b802ade3cdfacd6b8\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"mark\": {\"type\": \"point\"}, \"encoding\": {\"x\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.Chart(...)"
+      ]
+     },
+     "execution_count": 29,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 1\n",
+    "# We use encodings to map our data to particular dimensions.\n",
+    "# Altair will make then make appropriate choices based upon the type of data.\n",
+    "\n",
+    "chart.mark_point().encode(\n",
+    "    y=\"state\",\n",
+    "    x=\"num_bills\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "SFPL",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-c0984a148f9845b7be3b4dc92f7faa3c.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-c0984a148f9845b7be3b4dc92f7faa3c.vega-embed details,\n",
+       "  #altair-viz-c0984a148f9845b7be3b4dc92f7faa3c.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-c0984a148f9845b7be3b4dc92f7faa3c\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-c0984a148f9845b7be3b4dc92f7faa3c\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-c0984a148f9845b7be3b4dc92f7faa3c\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"mark\": {\"type\": \"point\"}, \"encoding\": {\"color\": {\"field\": \"session_start_year\", \"type\": \"quantitative\"}, \"x\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.Chart(...)"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 2 - what happens when we try to add color?\n",
+    "chart.mark_point().encode(\n",
+    "    alt.Y(\"state\"),\n",
+    "    alt.X(\"num_bills\"),\n",
+    "    alt.Color(\"session_start_year\"),\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "BYtC",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-aea0a88137694b9a82ca539c11313c96.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-aea0a88137694b9a82ca539c11313c96.vega-embed details,\n",
+       "  #altair-viz-aea0a88137694b9a82ca539c11313c96.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-aea0a88137694b9a82ca539c11313c96\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-aea0a88137694b9a82ca539c11313c96\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-aea0a88137694b9a82ca539c11313c96\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"mark\": {\"type\": \"point\"}, \"encoding\": {\"color\": {\"field\": \"session_start_year\", \"type\": \"nominal\"}, \"x\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.Chart(...)"
+      ]
+     },
+     "execution_count": 32,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 3\n",
+    "# The prior example treated year as an Ordinal because it was numeric,\n",
+    "# instead we would treat it as Nominal for this data.\n",
+    "# We can use :Q, :O, :N, :T to mark the type that should be used.\n",
+    "\n",
+    "by_year = chart.mark_point().encode(\n",
+    "    alt.Y(\"state:N\"),\n",
+    "    alt.X(\"num_bills:Q\"),\n",
+    "    alt.Color(\"session_start_year:N\"),\n",
+    ")\n",
+    "\n",
+    "# we're saving this one for later, so repeat the variable name to see it\n",
+    "by_year"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "id": "RGSE",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-95590e473fb24ba09fde2dc67ddfb3e8.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-95590e473fb24ba09fde2dc67ddfb3e8.vega-embed details,\n",
+       "  #altair-viz-95590e473fb24ba09fde2dc67ddfb3e8.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-95590e473fb24ba09fde2dc67ddfb3e8\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-95590e473fb24ba09fde2dc67ddfb3e8\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-95590e473fb24ba09fde2dc67ddfb3e8\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"mark\": {\"type\": \"point\", \"shape\": \"wedge\"}, \"encoding\": {\"x\": {\"aggregate\": \"average\", \"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.Chart(...)"
+      ]
+     },
+     "execution_count": 34,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 4\n",
+    "# Here we make a different chart from the same base data \n",
+    "# by re-using our `chart` variable.\n",
+    "#\n",
+    "# We choose a different shape (parameters that don't need to vary can be passed into the mark_* functions)\n",
+    "# We also use an aggregate function average(num_bills)\n",
+    "\n",
+    "avgs = chart.mark_point(shape=\"wedge\").encode(\n",
+    "    alt.Y(\"state:N\"),\n",
+    "    alt.X(\"average(num_bills)\"),\n",
+    ")\n",
+    "avgs"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "id": "Kclp",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-84be3b793e6b4ba5970b06e34046c01c.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-84be3b793e6b4ba5970b06e34046c01c.vega-embed details,\n",
+       "  #altair-viz-84be3b793e6b4ba5970b06e34046c01c.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-84be3b793e6b4ba5970b06e34046c01c\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-84be3b793e6b4ba5970b06e34046c01c\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-84be3b793e6b4ba5970b06e34046c01c\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"layer\": [{\"mark\": {\"type\": \"point\"}, \"encoding\": {\"color\": {\"field\": \"session_start_year\", \"type\": \"nominal\"}, \"x\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}}, {\"mark\": {\"type\": \"point\", \"shape\": \"wedge\"}, \"encoding\": {\"x\": {\"aggregate\": \"average\", \"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}}], \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.LayerChart(...)"
+      ]
+     },
+     "execution_count": 36,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 5\n",
+    "# We can combine compatible charts by using `+` to layer them.\n",
+    "# There are other operators you'll encounter that allow placing charts side by side.\n",
+    "by_year + avgs"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 41,
+   "id": "Hstk",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-73b896755fac48a784ac7b5d2ae8c928.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-73b896755fac48a784ac7b5d2ae8c928.vega-embed details,\n",
+       "  #altair-viz-73b896755fac48a784ac7b5d2ae8c928.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-73b896755fac48a784ac7b5d2ae8c928\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-73b896755fac48a784ac7b5d2ae8c928\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-73b896755fac48a784ac7b5d2ae8c928\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"layer\": [{\"mark\": {\"type\": \"bar\", \"color\": \"#ccc\"}, \"encoding\": {\"x\": {\"aggregate\": \"average\", \"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}}, {\"mark\": {\"type\": \"point\"}, \"encoding\": {\"color\": {\"field\": \"session_start_year\", \"type\": \"nominal\"}, \"x\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}}], \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.LayerChart(...)"
+      ]
+     },
+     "execution_count": 41,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 6\n",
+    "# perhaps we don't want to use mark_point anymore, maybe a bar?\n",
+    "bar_avgs = chart.mark_bar(color=\"#ccc\").encode(\n",
+    "    alt.Y(\"state\"),\n",
+    "    alt.X(\"average(num_bills)\"),\n",
+    ")\n",
+    "bar_avgs + by_year"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "id": "nWHF",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-0c92a68553c042fba9cde6540507b9cb.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-0c92a68553c042fba9cde6540507b9cb.vega-embed details,\n",
+       "  #altair-viz-0c92a68553c042fba9cde6540507b9cb.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-0c92a68553c042fba9cde6540507b9cb\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-0c92a68553c042fba9cde6540507b9cb\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-0c92a68553c042fba9cde6540507b9cb\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"layer\": [{\"mark\": {\"type\": \"point\", \"shape\": \"diamond\"}, \"encoding\": {\"color\": {\"field\": \"session_start_year\", \"title\": \"Session Year\", \"type\": \"nominal\"}, \"x\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}}, {\"mark\": {\"type\": \"bar\", \"color\": \"#70905050\"}, \"encoding\": {\"x\": {\"aggregate\": \"average\", \"field\": \"num_bills\", \"title\": \"Number of Bills Introduced\", \"type\": \"quantitative\"}, \"y\": {\"field\": \"state\", \"type\": \"nominal\"}}}], \"background\": \"#f5f5dc\", \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"title\": \"Midwest Bills by State\", \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.LayerChart(...)"
+      ]
+     },
+     "execution_count": 42,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example 7\n",
+    "# We can customize titles and other details by using `.title` and `.properties`\n",
+    "# the latter sets chart-wide properties.\n",
+    "\n",
+    "final = chart.mark_point(shape=\"diamond\").encode(\n",
+    "    alt.Y(\"state:N\"),\n",
+    "    alt.X(\"num_bills:Q\"),\n",
+    "    alt.Color(\"session_start_year:N\").title(\"Session Year\"),\n",
+    ") + chart.mark_bar(color=\"#70905050\").encode(\n",
+    "    alt.Y(\"state\"),\n",
+    "    alt.X(\"average(num_bills)\").title(\"Number of Bills Introduced\"),\n",
+    ")\n",
+    "final.properties(\n",
+    "    title='Midwest Bills by State',\n",
+    "    background='#f5f5dc'\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "93b3a8bc-be56-452d-a443-7b4711e339cb",
+   "metadata": {},
+   "source": [
+    "## Exercise\n",
+    "\n",
+    "Let's say we instead want to see if there are trends by year.\n",
+    "Try and create a new chart that:\n",
+    "- has year on X axis, and bills on Y\n",
+    "- is print & colorblind friendly (using multiple channels for encoding state)\n",
+    "- uses a custom color scale, not the default (to avoid confusion with the colors used in our earlier chart)\n",
+    "\n",
+    "Try completing this below, before continuing on to look at my version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 43,
+   "id": "3506dd11-76ba-40b0-8e1f-2210dcd3defd",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# YOUR SOLUTION HERE"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ZHCJ",
+   "metadata": {},
+   "source": [
+    "### Altair User Guide / Next Steps\n",
+    "\n",
+    "See <https://capp30239.netlify.app/readings/> for details.\n",
+    "\n",
+    "You'll want to work your way through the recommended material at your own pace, which will help you learn the material much better than me reading library documentation to you would. :)\n",
+    "\n",
+    "**You aren't on your own**, we're here to help -- start with documentation and ask questions on Ed, in class, and in office hours.\n",
+    "\n",
+    "Once you've read the guide and worked through the assignment you will have the core ideas of Altair.\n",
+    "\n",
+    "The next steps towards mastery are using it a lot and asking questions to deepen understanding, *not leaning on GenAI too much*.\n",
+    "\n",
+    "You're reading a fairly small subset of the library's documentation. \n",
+    "The remaining sections are useful as reference, and as you use Altair you will find your way to them as you ask yourself questions like \"how do I work with geospatial data\" or \"how can I combine these axes\"?\n",
+    "\n",
+    "It's likely the most common thing you will use the documentation for is \"what arguments can I pass to this?\"\n",
+    "\n",
+    "For that, use the [API Reference](https://altair-viz.github.io/user_guide/api.html) and find the class you're working with.\n",
+    "\n",
+    "Example:\n",
+    "\n",
+    "- Let's say we want to adjust the color scheme, start with <https://altair-viz.github.io/user_guide/generated/channels/altair.Color.html>\n",
+    "- Note that it can take a scale, and click to <https://altair-viz.github.io/user_guide/generated/core/altair.Scale.html#altair.Scale>\n",
+    "- We find ourselves on Vega documentation, here <https://vega.github.io/vega-lite/docs/scale.html#scheme> before long. Vega documentation can be very helpful for understanding the options that are available, since Altair is an interface to those."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 54,
+   "id": "iLit",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "<style>\n",
+       "  #altair-viz-8d10ab61b28f4f6cbb22061c07d924ea.vega-embed {\n",
+       "    width: 100%;\n",
+       "    display: flex;\n",
+       "  }\n",
+       "\n",
+       "  #altair-viz-8d10ab61b28f4f6cbb22061c07d924ea.vega-embed details,\n",
+       "  #altair-viz-8d10ab61b28f4f6cbb22061c07d924ea.vega-embed details summary {\n",
+       "    position: relative;\n",
+       "  }\n",
+       "</style>\n",
+       "<div id=\"altair-viz-8d10ab61b28f4f6cbb22061c07d924ea\"></div>\n",
+       "<script type=\"text/javascript\">\n",
+       "  var VEGA_DEBUG = (typeof VEGA_DEBUG == \"undefined\") ? {} : VEGA_DEBUG;\n",
+       "  (function(spec, embedOpt){\n",
+       "    let outputDiv = document.currentScript.previousElementSibling;\n",
+       "    if (outputDiv.id !== \"altair-viz-8d10ab61b28f4f6cbb22061c07d924ea\") {\n",
+       "      outputDiv = document.getElementById(\"altair-viz-8d10ab61b28f4f6cbb22061c07d924ea\");\n",
+       "    }\n",
+       "    const paths = {\n",
+       "      \"vega\": \"https://cdn.jsdelivr.net/npm/vega@5?noext\",\n",
+       "      \"vega-lib\": \"https://cdn.jsdelivr.net/npm/vega-lib?noext\",\n",
+       "      \"vega-lite\": \"https://cdn.jsdelivr.net/npm/vega-lite@5.20.1?noext\",\n",
+       "      \"vega-embed\": \"https://cdn.jsdelivr.net/npm/vega-embed@6?noext\",\n",
+       "    };\n",
+       "\n",
+       "    function maybeLoadScript(lib, version) {\n",
+       "      var key = `${lib.replace(\"-\", \"\")}_version`;\n",
+       "      return (VEGA_DEBUG[key] == version) ?\n",
+       "        Promise.resolve(paths[lib]) :\n",
+       "        new Promise(function(resolve, reject) {\n",
+       "          var s = document.createElement('script');\n",
+       "          document.getElementsByTagName(\"head\")[0].appendChild(s);\n",
+       "          s.async = true;\n",
+       "          s.onload = () => {\n",
+       "            VEGA_DEBUG[key] = version;\n",
+       "            return resolve(paths[lib]);\n",
+       "          };\n",
+       "          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);\n",
+       "          s.src = paths[lib];\n",
+       "        });\n",
+       "    }\n",
+       "\n",
+       "    function showError(err) {\n",
+       "      outputDiv.innerHTML = `<div class=\"error\" style=\"color:red;\">${err}</div>`;\n",
+       "      throw err;\n",
+       "    }\n",
+       "\n",
+       "    function displayChart(vegaEmbed) {\n",
+       "      vegaEmbed(outputDiv, spec, embedOpt)\n",
+       "        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));\n",
+       "    }\n",
+       "\n",
+       "    if(typeof define === \"function\" && define.amd) {\n",
+       "      requirejs.config({paths});\n",
+       "      require([\"vega-embed\"], displayChart, err => showError(`Error loading script: ${err.message}`));\n",
+       "    } else {\n",
+       "      maybeLoadScript(\"vega\", \"5\")\n",
+       "        .then(() => maybeLoadScript(\"vega-lite\", \"5.20.1\"))\n",
+       "        .then(() => maybeLoadScript(\"vega-embed\", \"6\"))\n",
+       "        .catch(showError)\n",
+       "        .then(() => displayChart(vegaEmbed));\n",
+       "    }\n",
+       "  })({\"config\": {\"view\": {\"continuousWidth\": 300, \"continuousHeight\": 300}}, \"layer\": [{\"mark\": {\"type\": \"line\"}, \"encoding\": {\"color\": {\"field\": \"state\", \"scale\": {\"scheme\": \"set2\"}, \"type\": \"nominal\"}, \"x\": {\"field\": \"session_start_year\", \"type\": \"nominal\"}, \"y\": {\"field\": \"num_bills\", \"type\": \"quantitative\"}}}, {\"mark\": {\"type\": \"point\"}, \"encoding\": {\"color\": {\"field\": \"state\", \"scale\": {\"scheme\": \"set2\"}, \"type\": \"nominal\"}, \"shape\": {\"field\": \"state\", \"type\": \"nominal\"}, \"x\": {\"field\": \"session_start_year\", \"title\": \"Session Year\", \"type\": \"nominal\"}, \"y\": {\"field\": \"num_bills\", \"title\": \"Bills Introduced\", \"type\": \"quantitative\"}}, \"title\": \"Midwest Bills by Session\"}], \"data\": {\"name\": \"data-7819b1facf2e5fc9998dcf4cad0b99f8\"}, \"$schema\": \"https://vega.github.io/schema/vega-lite/v5.20.1.json\", \"datasets\": {\"data-7819b1facf2e5fc9998dcf4cad0b99f8\": [{\"state\": \"IL\", \"session_start_year\": 2017, \"num_bills\": 13616}, {\"state\": \"IL\", \"session_start_year\": 2019, \"num_bills\": 12760}, {\"state\": \"IL\", \"session_start_year\": 2021, \"num_bills\": 12847}, {\"state\": \"IL\", \"session_start_year\": 2023, \"num_bills\": 11951}, {\"state\": \"MI\", \"session_start_year\": 2017, \"num_bills\": 4818}, {\"state\": \"MI\", \"session_start_year\": 2019, \"num_bills\": 4450}, {\"state\": \"MI\", \"session_start_year\": 2021, \"num_bills\": 4520}, {\"state\": \"MI\", \"session_start_year\": 2023, \"num_bills\": 3424}, {\"state\": \"WI\", \"session_start_year\": 2017, \"num_bills\": 1820}, {\"state\": \"WI\", \"session_start_year\": 2019, \"num_bills\": 2264}, {\"state\": \"WI\", \"session_start_year\": 2021, \"num_bills\": 2618}, {\"state\": \"WI\", \"session_start_year\": 2023, \"num_bills\": 2656}]}}, {\"mode\": \"vega-lite\"});\n",
+       "</script>"
+      ],
+      "text/plain": [
+       "alt.LayerChart(...)"
+      ]
+     },
+     "execution_count": 54,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "\n",
+    "# one possible solution to the exercise\n",
+    "\n",
+    "color_scheme = alt.Scale(scheme=\"set2\")\n",
+    "chart.mark_line().encode(\n",
+    "    alt.Y(\"num_bills\"),\n",
+    "    alt.X(\"session_start_year:N\"),\n",
+    "    alt.Color(\"state\", scale=color_scheme),\n",
+    ") + chart.mark_point().encode(\n",
+    "    alt.Y(\"num_bills\").title(\"Bills Introduced\"),\n",
+    "    alt.X(\"session_start_year:N\").title(\"Session Year\"),\n",
+    "    alt.Color(\"state\", scale=color_scheme),\n",
+    "    alt.Shape(\"state\"),\n",
+    ").properties(\n",
+    "    title='Midwest Bills by Session',\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b4a63b04-c8b0-4406-933e-973708c151f6",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e6ca4883-fea8-49ac-ad7c-23168c69a118",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.15"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/01.gog-altair/slides.html b/01.gog-altair/slides.html
index 5bc9869..bacc644 100644
--- a/01.gog-altair/slides.html
+++ b/01.gog-altair/slides.html
@@ -170,11 +170,73 @@ Countries</p>
 <p><img src="effectiveness.png" alt="" style="width:800px;" /></p>
 </section>
 </foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="12" lang="en-US">
-<h2 id="altairs-grammar">Altair's Grammar</h2>
-<p>Altair condenses several of the different pieces of the grammar to <em>&quot;encoding channels&quot;</em>.</p>
-<p>We've seen X, Y, and color, let's take a look at some examples of other encoding channels.</p>
+<h2 id="altair">Altair</h2>
+<p>Altair is a Python visualization library that allows us to work from a grammar of graphics perspective.</p>
+<p>It also is very flexible in output formats, which will be useful if you want to modify your graphics or make them interactive.</p>
+<p>Altair is built on top of <strong>Vega-Lite</strong>.</p>
+<p>Vega-Lite is a system that represents graphics in a JSON schema, and a set of tools that convert these JSON representations to images or interactive graphics.</p>
+</section>
+</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="13" lang="en-US">
+<h2 id="vega-lite-example">Vega-Lite Example</h2>
+<pre is="marp-pre" data-auto-scaling="downscale-only"><code class="language-json"><span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://vega.github.io/schema/vega-lite/v5.json&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A scatterplot showing horsepower and miles per gallons for various cars.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;data&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;data/cars.json&quot;</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;mark&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;point&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;encoding&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;x&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Horsepower&quot;</span><span class="hljs-punctuation">,</span> <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;quantitative&quot;</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;y&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Miles_per_Gallon&quot;</span><span class="hljs-punctuation">,</span> <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;quantitative&quot;</span><span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
+</code></pre>
+<p>Vega condenses several of the different pieces of the grammar to <em>&quot;encoding channels&quot;</em>.</p>
+</section>
+</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="14" lang="en-US">
+<p><img src="vega.png" alt="" /></p>
+</section>
+</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="15" lang="en-US">
+<h2 id="altair-1">Altair</h2>
+<pre is="marp-pre" data-auto-scaling="downscale-only"><code class="language-python"><span class="hljs-keyword">import</span> pandas <span class="hljs-keyword">as</span> pd
+<span class="hljs-keyword">import</span> altair <span class="hljs-keyword">as</span> alt
+
+df = pd.read_csv(<span class="hljs-string">&quot;cars.csv&quot;</span>)
+alt.Chart(df).encode(
+  x=<span class="hljs-string">&quot;Horsepower:Q&quot;</span>,        <span class="hljs-comment"># shorthand for simple features</span>
+  alt.Y(<span class="hljs-string">&quot;Miles_per_Gallon:Q&quot;</span>).title(<span class="hljs-string">&quot;Miles Per Gallon&quot;</span>),  <span class="hljs-comment"># longer form w/ customization</span>
+)
+</code></pre>
+<p>Altair is a Pythonic wrapper to create Vega-Lite JSON.  If you use it in a notebook, the resulting graphs will render inline.</p>
+</section>
+</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="16" lang="en-US">
+<h2 id="altair-notebook">Altair Notebook</h2>
+</section>
+</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="17" lang="en-US">
+<h2 id="learning-altair">Learning Altair</h2>
+<p>To master a library like Altair, you'll go through the following phases:</p>
+<ol>
+<li>Learn the key concepts.
+<ul>
+<li>Goal: Understand how the authors of Altair think about visualization.</li>
+<li>Achieved by: Reading user guide &amp; watching tutorials.</li>
+</ul>
+</li>
+<li>Internalize concepts &amp; API.
+<ul>
+<li>Goal: Be able to do common tasks without referring to documentation. (You'll always lean on documentation for specifics.)</li>
+<li>Achieved by: Working on assignments &amp; experimentation. Reading API reference as needed.</li>
+</ul>
+</li>
+<li>Mastery (not this quarter!)
+<ul>
+<li>Goal: Be able to manipulate library to achieve most tasks. Understand limits.</li>
+<li>Achieved by: Regular use over months/years. Reading API reference and/or source code.</li>
+</ul>
+</li>
+</ol>
+</section>
+</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="18" lang="en-US">
+<h2 id="altair-assignment">Altair Assignment</h2>
 </section>
-</foreignObject></svg><svg data-marpit-svg="" viewBox="0 0 1280 720"><foreignObject width="1280" height="720"><section id="13" lang="en-US"></section>
 <script>!function(){"use strict";const t={h1:{proto:()=>HTMLHeadingElement,attrs:{role:"heading","aria-level":"1"},style:"display: block; font-size: 2em; margin-block-start: 0.67em; margin-block-end: 0.67em; margin-inline-start: 0px; margin-inline-end: 0px; font-weight: bold;"},h2:{proto:()=>HTMLHeadingElement,attrs:{role:"heading","aria-level":"2"},style:"display: block; font-size: 1.5em; margin-block-start: 0.83em; margin-block-end: 0.83em; margin-inline-start: 0px; margin-inline-end: 0px; font-weight: bold;"},h3:{proto:()=>HTMLHeadingElement,attrs:{role:"heading","aria-level":"3"},style:"display: block; font-size: 1.17em; margin-block-start: 1em; margin-block-end: 1em; margin-inline-start: 0px; margin-inline-end: 0px; font-weight: bold;"},h4:{proto:()=>HTMLHeadingElement,attrs:{role:"heading","aria-level":"4"},style:"display: block; margin-block-start: 1.33em; margin-block-end: 1.33em; margin-inline-start: 0px; margin-inline-end: 0px; font-weight: bold;"},h5:{proto:()=>HTMLHeadingElement,attrs:{role:"heading","aria-level":"5"},style:"display: block; font-size: 0.83em; margin-block-start: 1.67em; margin-block-end: 1.67em; margin-inline-start: 0px; margin-inline-end: 0px; font-weight: bold;"},h6:{proto:()=>HTMLHeadingElement,attrs:{role:"heading","aria-level":"6"},style:"display: block; font-size: 0.67em; margin-block-start: 2.33em; margin-block-end: 2.33em; margin-inline-start: 0px; margin-inline-end: 0px; font-weight: bold;"},span:{proto:()=>HTMLSpanElement},pre:{proto:()=>HTMLElement,style:"display: block; font-family: monospace; white-space: pre; margin: 1em 0; --marp-auto-scaling-white-space: pre;"}},e="data-marp-auto-scaling-wrapper",i="data-marp-auto-scaling-svg",n="data-marp-auto-scaling-container";class s extends HTMLElement{constructor(){super(),this.svgPreserveAspectRatio="xMinYMid meet";const t=t=>([e])=>{const{width:i,height:n}=e.contentRect;this[t]={width:i,height:n},this.updateSVGRect()};this.attachShadow({mode:"open"}),this.containerObserver=new ResizeObserver(t("containerSize")),this.wrapperObserver=new ResizeObserver(((...e)=>{t("wrapperSize")(...e),this.flushSvgDisplay()}))}static get observedAttributes(){return["data-downscale-only"]}connectedCallback(){var t,s,o,r,a;this.shadowRoot.innerHTML=`\n<style>\n  svg[${i}] { display: block; width: 100%; height: auto; vertical-align: top; }\n  span[${n}] { display: table; white-space: var(--marp-auto-scaling-white-space, nowrap); width: max-content; }\n</style>\n<div ${e}>\n  <svg part="svg" ${i}>\n    <foreignObject><span ${n}><slot></slot></span></foreignObject>\n  </svg>\n</div>\n    `.split(/\n\s*/).join(""),this.wrapper=null!==(t=this.shadowRoot.querySelector(`div[${e}]`))&&void 0!==t?t:void 0;const l=this.svg;this.svg=null!==(o=null===(s=this.wrapper)||void 0===s?void 0:s.querySelector(`svg[${i}]`))&&void 0!==o?o:void 0,this.svg!==l&&(this.svgComputedStyle=this.svg?window.getComputedStyle(this.svg):void 0),this.container=null!==(a=null===(r=this.svg)||void 0===r?void 0:r.querySelector(`span[${n}]`))&&void 0!==a?a:void 0,this.observe()}disconnectedCallback(){this.svg=void 0,this.svgComputedStyle=void 0,this.wrapper=void 0,this.container=void 0,this.observe()}attributeChangedCallback(){this.observe()}flushSvgDisplay(){const{svg:t}=this;t&&(t.style.display="inline",requestAnimationFrame((()=>{t.style.display=""})))}observe(){this.containerObserver.disconnect(),this.wrapperObserver.disconnect(),this.wrapper&&this.wrapperObserver.observe(this.wrapper),this.container&&this.containerObserver.observe(this.container),this.svgComputedStyle&&this.observeSVGStyle(this.svgComputedStyle)}observeSVGStyle(t){const e=()=>{const i=(()=>{const e=t.getPropertyValue("--preserve-aspect-ratio");if(e)return e.trim();return`x${(({textAlign:t,direction:e})=>{if(t.endsWith("left"))return"Min";if(t.endsWith("right"))return"Max";if("start"===t||"end"===t){let i="rtl"===e;return"end"===t&&(i=!i),i?"Max":"Min"}return"Mid"})(t)}YMid meet`})();i!==this.svgPreserveAspectRatio&&(this.svgPreserveAspectRatio=i,this.updateSVGRect()),t===this.svgComputedStyle&&requestAnimationFrame(e)};e()}updateSVGRect(){var t,e,i,n,s,o,r;let a=Math.ceil(null!==(e=null===(t=this.containerSize)||void 0===t?void 0:t.width)&&void 0!==e?e:0);const l=Math.ceil(null!==(n=null===(i=this.containerSize)||void 0===i?void 0:i.height)&&void 0!==n?n:0);void 0!==this.dataset.downscaleOnly&&(a=Math.max(a,null!==(o=null===(s=this.wrapperSize)||void 0===s?void 0:s.width)&&void 0!==o?o:0));const c=null===(r=this.svg)||void 0===r?void 0:r.querySelector(":scope > foreignObject");if(null==c||c.setAttribute("width",`${a}`),null==c||c.setAttribute("height",`${l}`),this.svg&&(this.svg.setAttribute("viewBox",`0 0 ${a} ${l}`),this.svg.setAttribute("preserveAspectRatio",this.svgPreserveAspectRatio),this.svg.style.height=a<=0||l<=0?"0":""),this.container){const t=this.svgPreserveAspectRatio.toLowerCase();this.container.style.marginLeft=t.startsWith("xmid")||t.startsWith("xmax")?"auto":"0",this.container.style.marginRight=t.startsWith("xmi")?"auto":"0"}}}const o=(t,{attrs:e={},style:i})=>class extends t{constructor(...t){super(...t);for(const[t,i]of Object.entries(e))this.hasAttribute(t)||this.setAttribute(t,i);this.attachShadow({mode:"open"})}static get observedAttributes(){return["data-auto-scaling"]}connectedCallback(){this._update()}attributeChangedCallback(){this._update()}_update(){const t=i?`<style>:host { ${i} }</style>`:"";let e="<slot></slot>";const{autoScaling:n}=this.dataset;if(void 0!==n){e=`<marp-auto-scaling exportparts="svg:auto-scaling" ${"downscale-only"===n?"data-downscale-only":""}>${e}</marp-auto-scaling>`}this.shadowRoot.innerHTML=t+e}};let r;const a=Symbol();let l;const c="marpitSVGPolyfill:setZoomFactor,",d=Symbol(),g=Symbol();const h=()=>{const t="Apple Computer, Inc."===navigator.vendor,e=t?[u]:[],i={then:e=>(t?(async()=>{if(void 0===l){const t=document.createElement("canvas");t.width=10,t.height=10;const e=t.getContext("2d"),i=new Image(10,10),n=new Promise((t=>{i.addEventListener("load",(()=>t()))}));i.crossOrigin="anonymous",i.src="data:image/svg+xml;charset=utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2210%22%20height%3D%2210%22%20viewBox%3D%220%200%201%201%22%3E%3CforeignObject%20width%3D%221%22%20height%3D%221%22%20requiredExtensions%3D%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%22%3E%3Cdiv%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%22%20style%3D%22width%3A%201px%3B%20height%3A%201px%3B%20background%3A%20red%3B%20position%3A%20relative%22%3E%3C%2Fdiv%3E%3C%2FforeignObject%3E%3C%2Fsvg%3E",await n,e.drawImage(i,0,0),l=e.getImageData(5,5,1,1).data[3]<128}return l})().then((t=>{null==e||e(t?[u]:[])})):null==e||e([]),i)};return Object.assign(e,i)};let p,m;function u(t){const e="object"==typeof t&&t.target||document,i="object"==typeof t?t.zoom:t;window[g]||(Object.defineProperty(window,g,{configurable:!0,value:!0}),document.body.style.zoom=1.0001,document.body.offsetHeight,document.body.style.zoom=1,window.addEventListener("message",(({data:t,origin:e})=>{if(e===window.origin)try{if(t&&"string"==typeof t&&t.startsWith(c)){const[,e]=t.split(","),i=Number.parseFloat(e);Number.isNaN(i)||(m=i)}}catch(t){console.error(t)}})));let n=!1;Array.from(e.querySelectorAll("svg[data-marpit-svg]"),(t=>{var e,s,o,r;t.style.transform||(t.style.transform="translateZ(0)");const a=i||m||t.currentScale||1;p!==a&&(p=a,n=a);const l=t.getBoundingClientRect(),{length:c}=t.children;for(let i=0;i<c;i+=1){const n=t.children[i];if(n.getScreenCTM){const t=n.getScreenCTM();if(t){const i=null!==(s=null===(e=n.x)||void 0===e?void 0:e.baseVal.value)&&void 0!==s?s:0,c=null!==(r=null===(o=n.y)||void 0===o?void 0:o.baseVal.value)&&void 0!==r?r:0,d=n.children.length;for(let e=0;e<d;e+=1){const s=n.children[e];if("SECTION"===s.tagName){const{style:e}=s;e.transformOrigin||(e.transformOrigin=`${-i}px ${-c}px`),e.transform=`scale(${a}) matrix(${t.a}, ${t.b}, ${t.c}, ${t.d}, ${t.e-l.left}, ${t.f-l.top}) translateZ(0.0001px)`;break}}}}}})),!1!==n&&Array.from(e.querySelectorAll("iframe"),(({contentWindow:t})=>{null==t||t.postMessage(`${c}${n}`,"null"===window.origin?"*":window.origin)}))}function v({once:t=!1,target:e=document}={}){const i=function(t=document){if(t[d])return t[d];let e=!0;const i=()=>{e=!1,delete t[d]};Object.defineProperty(t,d,{configurable:!0,value:i});let n=[],s=!1;(async()=>{try{n=await h()}finally{s=!0}})();const o=()=>{for(const e of n)e({target:t});s&&0===n.length||e&&window.requestAnimationFrame(o)};return o(),i}(e);return t?(i(),()=>{}):i}p=1,m=void 0;const b=Symbol(),w=(e=document)=>{if("undefined"==typeof window)throw new Error("Marp Core's browser script is valid only in browser context.");if(((e=document)=>{const i=window[a];i||customElements.define("marp-auto-scaling",s);for(const n of Object.keys(t)){const s=`marp-${n}`,a=t[n].proto();null!=r||(r=!!document.createElement("div",{is:"marp-auto-scaling"}).outerHTML.startsWith("<div is")),r&&a!==HTMLElement?i||customElements.define(s,o(a,{style:t[n].style}),{extends:n}):(i||customElements.define(s,o(HTMLElement,t[n])),e.querySelectorAll(`${n}[is="${s}"]`).forEach((t=>{t.outerHTML=t.outerHTML.replace(new RegExp(`^<${n}`,"i"),`<${s}`).replace(new RegExp(`</${n}>$`,"i"),`</${s}>`)})))}window[a]=!0})(e),e[b])return e[b];const i=v({target:e}),n=()=>{i(),delete e[b]},l=Object.assign(n,{cleanup:n,update:()=>w(e)});return Object.defineProperty(e,b,{configurable:!0,value:l}),l},y=document.currentScript;w(y?y.getRootNode():document)}();
 </script></foreignObject></svg></div><script>/*!! License: https://unpkg.com/@marp-team/marp-cli@3.4.0/lib/bespoke.js.LICENSE.txt */
-!function(){"use strict";function e(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var t={from:function(e,t){var n,r=1===(e.parent||e).nodeType?e.parent||e:document.querySelector(e.parent||e),o=[].filter.call("string"==typeof e.slides?r.querySelectorAll(e.slides):e.slides||r.children,(function(e){return"SCRIPT"!==e.nodeName})),i={},a=function(e,t){return(t=t||{}).index=o.indexOf(e),t.slide=e,t},s=function(e,t){i[e]=(i[e]||[]).filter((function(e){return e!==t}))},l=function(e,t){return(i[e]||[]).reduce((function(e,n){return e&&!1!==n(t)}),!0)},c=function(e,t){o[e]&&(n&&l("deactivate",a(n,t)),n=o[e],l("activate",a(n,t)))},d=function(e,t){var r=o.indexOf(n)+e;l(e>0?"next":"prev",a(n,t))&&c(r,t)},u={off:s,on:function(e,t){return(i[e]||(i[e]=[])).push(t),s.bind(null,e,t)},fire:l,slide:function(e,t){if(!arguments.length)return o.indexOf(n);l("slide",a(o[e],t))&&c(e,t)},next:d.bind(null,1),prev:d.bind(null,-1),parent:r,slides:o,destroy:function(e){l("destroy",a(n,e)),i={}}};return(t||[]).forEach((function(e){e(u)})),n||c(0),u}},n=e(t);const r=document.body,o=(...e)=>history.replaceState(...e),i="presenter",a="next",s=["",i,a],l="bespoke-marp-",c=`data-${l}`,d=(e,{protocol:t,host:n,pathname:r,hash:o}=location)=>{const i=e.toString();return`${t}//${n}${r}${i?"?":""}${i}${o}`},u=()=>r.dataset.bespokeView,f=e=>new URLSearchParams(location.search).get(e),m=(e,t={})=>{var n;const r={location,setter:o,...t},i=new URLSearchParams(r.location.search);for(const t of Object.keys(e)){const n=e[t];"string"==typeof n?i.set(t,n):i.delete(t)}try{r.setter({...null!==(n=window.history.state)&&void 0!==n?n:{}},"",d(i,r.location))}catch(e){console.error(e)}},g=(()=>{const e="bespoke-marp";try{return localStorage.setItem(e,e),localStorage.removeItem(e),!0}catch(e){return!1}})(),p=e=>{try{return localStorage.getItem(e)}catch(e){return null}},v=(e,t)=>{try{return localStorage.setItem(e,t),!0}catch(e){return!1}},h=e=>{try{return localStorage.removeItem(e),!0}catch(e){return!1}},y=(e,t)=>{const n="aria-hidden";t?e.setAttribute(n,"true"):e.removeAttribute(n)},b=e=>{e.parent.classList.add(`${l}parent`),e.slides.forEach((e=>e.classList.add(`${l}slide`))),e.on("activate",(t=>{const n=`${l}active`,r=t.slide,o=r.classList,i=!o.contains(n);if(e.slides.forEach((e=>{e.classList.remove(n),y(e,!0)})),o.add(n),y(r,!1),i){const e=`${n}-ready`;o.add(e),document.body.clientHeight,o.remove(e)}}))},w=e=>{let t=0,n=0;Object.defineProperty(e,"fragments",{enumerable:!0,value:e.slides.map((e=>[null,...e.querySelectorAll("[data-marpit-fragment]")]))});const r=r=>void 0!==e.fragments[t][n+r],o=(r,o)=>{t=r,n=o,e.fragments.forEach(((e,t)=>{e.forEach(((e,n)=>{if(null==e)return;const i=t<r||t===r&&n<=o;e.setAttribute(`${c}fragment`,(i?"":"in")+"active");const a=`${c}current-fragment`;t===r&&n===o?e.setAttribute(a,"current"):e.removeAttribute(a)}))})),e.fragmentIndex=o;const i={slide:e.slides[r],index:r,fragments:e.fragments[r],fragmentIndex:o};e.fire("fragment",i)};e.on("next",(({fragment:i=!0})=>{if(i){if(r(1))return o(t,n+1),!1;const i=t+1;e.fragments[i]&&o(i,0)}else{const r=e.fragments[t].length;if(n+1<r)return o(t,r-1),!1;const i=e.fragments[t+1];i&&o(t+1,i.length-1)}})),e.on("prev",(({fragment:i=!0})=>{if(r(-1)&&i)return o(t,n-1),!1;const a=t-1;e.fragments[a]&&o(a,e.fragments[a].length-1)})),e.on("slide",(({index:t,fragment:n})=>{let r=0;if(void 0!==n){const o=e.fragments[t];if(o){const{length:e}=o;r=-1===n?e-1:Math.min(Math.max(n,0),e-1)}}o(t,r)})),o(0,0)},x=document,k=()=>!(!x.fullscreenEnabled&&!x.webkitFullscreenEnabled),$=()=>!(!x.fullscreenElement&&!x.webkitFullscreenElement),E=e=>{e.fullscreen=()=>{k()&&(async()=>{return $()?null===(e=x.exitFullscreen||x.webkitExitFullscreen)||void 0===e?void 0:e.call(x):((e=x.body)=>{var t;return null===(t=e.requestFullscreen||e.webkitRequestFullscreen)||void 0===t?void 0:t.call(e)})();var e})()},document.addEventListener("keydown",(t=>{"f"!==t.key&&"F11"!==t.key||t.altKey||t.ctrlKey||t.metaKey||!k()||(e.fullscreen(),t.preventDefault())}))},L=`${l}inactive`,S=(e=2e3)=>({parent:t,fire:n})=>{const r=t.classList,o=e=>n(`marp-${e?"":"in"}active`);let i;const a=()=>{i&&clearTimeout(i),i=setTimeout((()=>{r.add(L),o()}),e),r.contains(L)&&(r.remove(L),o(!0))};for(const e of["mousedown","mousemove","touchend"])document.addEventListener(e,a);setTimeout(a,0)},P=["AUDIO","BUTTON","INPUT","SELECT","TEXTAREA","VIDEO"],_=e=>{e.parent.addEventListener("keydown",(e=>{if(!e.target)return;const t=e.target;(P.includes(t.nodeName)||"true"===t.contentEditable)&&e.stopPropagation()}))},T=e=>{window.addEventListener("load",(()=>{for(const t of e.slides){const e=t.querySelector("marp-auto-scaling, [data-auto-scaling], [data-marp-fitting]");t.setAttribute(`${c}load`,e?"":"hideable")}}))},I=({interval:e=250}={})=>t=>{document.addEventListener("keydown",(e=>{if(" "===e.key&&e.shiftKey)t.prev();else if("ArrowLeft"===e.key||"ArrowUp"===e.key||"PageUp"===e.key)t.prev({fragment:!e.shiftKey});else if(" "!==e.key||e.shiftKey)if("ArrowRight"===e.key||"ArrowDown"===e.key||"PageDown"===e.key)t.next({fragment:!e.shiftKey});else if("End"===e.key)t.slide(t.slides.length-1,{fragment:-1});else{if("Home"!==e.key)return;t.slide(0)}else t.next();e.preventDefault()}));let n,r,o=0;t.parent.addEventListener("wheel",(i=>{let a=!1;const s=(e,t)=>{e&&(a=a||((e,t)=>((e,t)=>{const n="X"===t?"Width":"Height";return e[`client${n}`]<e[`scroll${n}`]})(e,t)&&((e,t)=>{const{overflow:n}=e,r=e[`overflow${t}`];return"auto"===n||"scroll"===n||"auto"===r||"scroll"===r})(getComputedStyle(e),t))(e,t)),(null==e?void 0:e.parentElement)&&s(e.parentElement,t)};if(0!==i.deltaX&&s(i.target,"X"),0!==i.deltaY&&s(i.target,"Y"),a)return;i.preventDefault();const l=Math.sqrt(i.deltaX**2+i.deltaY**2);if(void 0!==i.wheelDelta){if(void 0===i.webkitForce&&Math.abs(i.wheelDelta)<40)return;if(i.deltaMode===i.DOM_DELTA_PIXEL&&l<4)return}else if(i.deltaMode===i.DOM_DELTA_PIXEL&&l<12)return;r&&clearTimeout(r),r=setTimeout((()=>{n=0}),e);const c=Date.now()-o<e,d=l<=n;if(n=l,c||d)return;let u;(i.deltaX>0||i.deltaY>0)&&(u="next"),(i.deltaX<0||i.deltaY<0)&&(u="prev"),u&&(t[u](),o=Date.now())}))},M=(e=`.${l}osc`)=>{const t=document.querySelector(e);if(!t)return()=>{};const n=(e,n)=>{t.querySelectorAll(`[${c}osc=${JSON.stringify(e)}]`).forEach(n)};return k()||n("fullscreen",(e=>e.style.display="none")),g||n("presenter",(e=>{e.disabled=!0,e.title="Presenter view is disabled due to restricted localStorage."})),e=>{t.addEventListener("click",(t=>{if(t.target instanceof HTMLElement){const{bespokeMarpOsc:n}=t.target.dataset;n&&t.target.blur();const r={fragment:!t.shiftKey};"next"===n?e.next(r):"prev"===n?e.prev(r):"fullscreen"===n?null==e||e.fullscreen():"presenter"===n&&e.openPresenterView()}})),e.parent.appendChild(t),e.on("activate",(({index:t})=>{n("page",(n=>n.textContent=`Page ${t+1} of ${e.slides.length}`))})),e.on("fragment",(({index:t,fragments:r,fragmentIndex:o})=>{n("prev",(e=>e.disabled=0===t&&0===o)),n("next",(n=>n.disabled=t===e.slides.length-1&&o===r.length-1))})),e.on("marp-active",(()=>y(t,!1))),e.on("marp-inactive",(()=>y(t,!0))),k()&&(e=>{for(const t of["","webkit"])x.addEventListener(t+"fullscreenchange",e)})((()=>n("fullscreen",(e=>e.classList.toggle("exit",k()&&$())))))}},O=e=>{window.addEventListener("message",(t=>{if(t.origin!==window.origin)return;const[n,r]=t.data.split(":");if("navigate"===n){const[t,n]=r.split(",");let o=Number.parseInt(t,10),i=Number.parseInt(n,10)+1;i>=e.fragments[o].length&&(o+=1,i=0),e.slide(o,{fragment:i})}}))};var A=["area","base","br","col","command","embed","hr","img","input","keygen","link","meta","param","source","track","wbr"];let C=e=>String(e).replace(/[&<>"']/g,(e=>`&${D[e]};`)),D={"&":"amp","<":"lt",">":"gt",'"':"quot","'":"apos"},N="dangerouslySetInnerHTML",B={className:"class",htmlFor:"for"},q={};function K(e,t){let n=[],r="";t=t||{};for(let e=arguments.length;e-- >2;)n.push(arguments[e]);if("function"==typeof e)return t.children=n.reverse(),e(t);if(e){if(r+="<"+e,t)for(let e in t)!1!==t[e]&&null!=t[e]&&e!==N&&(r+=` ${B[e]?B[e]:C(e)}="${C(t[e])}"`);r+=">"}if(-1===A.indexOf(e)){if(t[N])r+=t[N].__html;else for(;n.length;){let e=n.pop();if(e)if(e.pop)for(let t=e.length;t--;)n.push(e[t]);else r+=!0===q[e]?e:C(e)}r+=e?`</${e}>`:""}return q[r]=!0,r}const j=({children:e})=>K(null,null,...e),F=`${l}presenter-`,V={container:`${F}container`,dragbar:`${F}dragbar-container`,next:`${F}next`,nextContainer:`${F}next-container`,noteContainer:`${F}note-container`,noteWrapper:`${F}note-wrapper`,noteButtons:`${F}note-buttons`,infoContainer:`${F}info-container`,infoPage:`${F}info-page`,infoPageText:`${F}info-page-text`,infoPagePrev:`${F}info-page-prev`,infoPageNext:`${F}info-page-next`,noteButtonsBigger:`${F}note-bigger`,noteButtonsSmaller:`${F}note-smaller`,infoTime:`${F}info-time`,infoTimer:`${F}info-timer`},U=e=>{const{title:t}=document;document.title="[Presenter view]"+(t?` - ${t}`:"");const n={},r=e=>(n[e]=n[e]||document.querySelector(`.${e}`),n[e]);document.body.appendChild((e=>{const t=document.createElement("div");return t.className=V.container,t.appendChild(e),t.insertAdjacentHTML("beforeend",K(j,null,K("div",{class:V.nextContainer},K("iframe",{class:V.next,src:"?view=next"})),K("div",{class:V.dragbar}),K("div",{class:V.noteContainer},K("div",{class:V.noteWrapper}),K("div",{class:V.noteButtons},K("button",{class:V.noteButtonsSmaller,tabindex:"-1",title:"Smaller notes font size"},"Smaller notes font size"),K("button",{class:V.noteButtonsBigger,tabindex:"-1",title:"Bigger notes font size"},"Bigger notes font size"))),K("div",{class:V.infoContainer},K("div",{class:V.infoPage},K("button",{class:V.infoPagePrev,tabindex:"-1",title:"Previous"},"Previous"),K("span",{class:V.infoPageText}),K("button",{class:V.infoPageNext,tabindex:"-1",title:"Next"},"Next")),K("time",{class:V.infoTime,title:"Current time"}),K("time",{class:V.infoTimer,title:"Timer"})))),t})(e.parent)),(e=>{let t=!1;r(V.dragbar).addEventListener("mousedown",(()=>{t=!0,r(V.dragbar).classList.add("active")})),window.addEventListener("mouseup",(()=>{t=!1,r(V.dragbar).classList.remove("active")})),window.addEventListener("mousemove",(e=>{if(!t)return;const n=e.clientX/document.documentElement.clientWidth*100;r(V.container).style.setProperty("--bespoke-marp-presenter-split-ratio",`${Math.max(0,Math.min(100,n))}%`)})),r(V.nextContainer).addEventListener("click",(()=>e.next()));const n=r(V.next),o=(i=n,(e,t)=>{var n;return null===(n=i.contentWindow)||void 0===n?void 0:n.postMessage(`navigate:${e},${t}`,"null"===window.origin?"*":window.origin)});var i;n.addEventListener("load",(()=>{r(V.nextContainer).classList.add("active"),o(e.slide(),e.fragmentIndex),e.on("fragment",(({index:e,fragmentIndex:t})=>o(e,t)))}));const a=document.querySelectorAll(".bespoke-marp-note");a.forEach((e=>{e.addEventListener("keydown",(e=>e.stopPropagation())),r(V.noteWrapper).appendChild(e)})),e.on("activate",(()=>a.forEach((t=>t.classList.toggle("active",t.dataset.index==e.slide())))));let s=0;const l=e=>{s=Math.max(-5,s+e),r(V.noteContainer).style.setProperty("--bespoke-marp-note-font-scale",(1.2**s).toFixed(4))},c=()=>l(1),d=()=>l(-1),u=r(V.noteButtonsBigger),f=r(V.noteButtonsSmaller);u.addEventListener("click",(()=>{u.blur(),c()})),f.addEventListener("click",(()=>{f.blur(),d()})),document.addEventListener("keydown",(e=>{"+"===e.key&&c(),"-"===e.key&&d()}),!0),e.on("activate",(({index:t})=>{r(V.infoPageText).textContent=`${t+1} / ${e.slides.length}`}));const m=r(V.infoPagePrev),g=r(V.infoPageNext);m.addEventListener("click",(t=>{m.blur(),e.prev({fragment:!t.shiftKey})})),g.addEventListener("click",(t=>{g.blur(),e.next({fragment:!t.shiftKey})})),e.on("fragment",(({index:t,fragments:n,fragmentIndex:r})=>{m.disabled=0===t&&0===r,g.disabled=t===e.slides.length-1&&r===n.length-1}));let p=new Date;const v=()=>{const e=new Date,t=e=>`${Math.floor(e)}`.padStart(2,"0"),n=e.getTime()-p.getTime(),o=t(n/1e3%60),i=t(n/1e3/60%60),a=t(n/36e5%24);r(V.infoTime).textContent=e.toLocaleTimeString(),r(V.infoTimer).textContent=`${a}:${i}:${o}`};v(),setInterval(v,250),r(V.infoTimer).addEventListener("click",(()=>{p=new Date}))})(e)},X=e=>{if(!(e=>e.syncKey&&"string"==typeof e.syncKey)(e))throw new Error("The current instance of Bespoke.js is invalid for Marp bespoke presenter plugin.");Object.defineProperties(e,{openPresenterView:{enumerable:!0,value:H},presenterUrl:{enumerable:!0,get:R}}),g&&document.addEventListener("keydown",(t=>{"p"!==t.key||t.altKey||t.ctrlKey||t.metaKey||(t.preventDefault(),e.openPresenterView())}))};function H(){const{max:e,floor:t}=Math,n=e(t(.85*window.innerWidth),640),r=e(t(.85*window.innerHeight),360);return window.open(this.presenterUrl,F+this.syncKey,`width=${n},height=${r},menubar=no,toolbar=no`)}function R(){const e=new URLSearchParams(location.search);return e.set("view","presenter"),e.set("sync",this.syncKey),d(e)}const W=e=>{const t=u();return t===a&&e.appendChild(document.createElement("span")),{"":X,[i]:U,[a]:O}[t]},J=e=>{e.on("activate",(t=>{document.querySelectorAll(".bespoke-progress-parent > .bespoke-progress-bar").forEach((n=>{n.style.flexBasis=100*t.index/(e.slides.length-1)+"%"}))}))},Y=e=>{const t=Number.parseInt(e,10);return Number.isNaN(t)?null:t},z=(e={})=>{const t={history:!0,...e};return e=>{let n=!0;const r=e=>{const t=n;try{return n=!0,e()}finally{n=t}},o=(t={fragment:!0})=>{let n=t.fragment?Y(f("f")||""):null;((t,n)=>{const{min:r,max:o}=Math,{fragments:i,slides:a}=e,s=o(0,r(t,a.length-1)),l=o(0,r(n||0,i[s].length-1));s===e.slide()&&l===e.fragmentIndex||e.slide(s,{fragment:l})})((()=>{var t,r;if(location.hash){const[o]=location.hash.slice(1).split(":~:");if(/^\d+$/.test(o))return(null!==(t=Y(o))&&void 0!==t?t:1)-1;const i=document.getElementById(o)||document.querySelector(`a[name="${CSS.escape(o)}"]`);if(i){const{length:t}=e.slides;for(let o=0;o<t;o+=1)if(e.slides[o].contains(i)){const t=null===(r=e.fragments)||void 0===r?void 0:r[o],a=i.closest("[data-marpit-fragment]");if(t&&a){const e=t.indexOf(a);e>=0&&(n=e)}return o}}}return 0})(),n)};e.on("fragment",(({index:e,fragmentIndex:r})=>{n||m({f:0===r||r.toString()},{location:{...location,hash:`#${e+1}`},setter:(...e)=>t.history?history.pushState(...e):history.replaceState(...e)})})),setTimeout((()=>{o(),window.addEventListener("hashchange",(()=>r((()=>{o({fragment:!1}),m({f:void 0})})))),window.addEventListener("popstate",(()=>{n||r((()=>o()))})),n=!1}),0)}},G=(e={})=>{var t;const n=e.key||(null===(t=window.history.state)||void 0===t?void 0:t.marpBespokeSyncKey)||Math.random().toString(36).slice(2),r=`bespoke-marp-sync-${n}`;var i;i={marpBespokeSyncKey:n},m({},{setter:(e,...t)=>o({...e,...i},...t)});const a=()=>{const e=p(r);return e?JSON.parse(e):Object.create(null)},s=e=>{const t=a(),n={...t,...e(t)};return v(r,JSON.stringify(n)),n},l=()=>{window.removeEventListener("pageshow",l),s((e=>({reference:(e.reference||0)+1})))};return e=>{l(),Object.defineProperty(e,"syncKey",{value:n,enumerable:!0});let t=!0;setTimeout((()=>{e.on("fragment",(e=>{t&&s((()=>({index:e.index,fragmentIndex:e.fragmentIndex})))}))}),0),window.addEventListener("storage",(n=>{if(n.key===r&&n.oldValue&&n.newValue){const r=JSON.parse(n.oldValue),o=JSON.parse(n.newValue);if(r.index!==o.index||r.fragmentIndex!==o.fragmentIndex)try{t=!1,e.slide(o.index,{fragment:o.fragmentIndex,forSync:!0})}finally{t=!0}}}));const o=()=>{const{reference:e}=a();void 0===e||e<=1?h(r):s((()=>({reference:e-1})))};window.addEventListener("pagehide",(e=>{e.persisted&&window.addEventListener("pageshow",l),o()})),e.on("destroy",o)}},{PI:Q,abs:Z,sqrt:ee,atan2:te}=Math,ne={passive:!0},re=({slope:e=-.7,swipeThreshold:t=30}={})=>n=>{let r;const o=n.parent,i=e=>{const t=o.getBoundingClientRect();return{x:e.pageX-(t.left+t.right)/2,y:e.pageY-(t.top+t.bottom)/2}};o.addEventListener("touchstart",(({touches:e})=>{r=1===e.length?i(e[0]):void 0}),ne),o.addEventListener("touchmove",(e=>{if(r)if(1===e.touches.length){e.preventDefault();const t=i(e.touches[0]),n=t.x-r.x,o=t.y-r.y;r.delta=ee(Z(n)**2+Z(o)**2),r.radian=te(n,o)}else r=void 0})),o.addEventListener("touchend",(o=>{if(r){if(r.delta&&r.delta>=t&&r.radian){const t=(r.radian-e+Q)%(2*Q)-Q;n[t<0?"next":"prev"](),o.stopPropagation()}r=void 0}}),ne)},oe=new Map;oe.clear(),oe.set("none",{backward:{both:void 0,incoming:void 0,outgoing:void 0},forward:{both:void 0,incoming:void 0,outgoing:void 0}});const ie={both:"",outgoing:"outgoing-",incoming:"incoming-"},ae={forward:"",backward:"-backward"},se=e=>`--marp-bespoke-transition-animation-${e}`,le=e=>`--marp-transition-${e}`,ce=se("name"),de=se("duration"),ue=e=>new Promise((t=>{const n={},r=document.createElement("div"),o=e=>{r.remove(),t(e)};r.addEventListener("animationstart",(()=>o(n))),Object.assign(r.style,{animationName:e,animationDuration:"1s",animationFillMode:"both",animationPlayState:"paused",position:"absolute",pointerEvents:"none"}),document.body.appendChild(r);const i=getComputedStyle(r).getPropertyValue(le("duration"));i&&(n.defaultDuration=i),((e,t)=>{requestAnimationFrame((()=>{e.style.animationPlayState="running",requestAnimationFrame((()=>t(void 0)))}))})(r,o)})),fe=async e=>oe.has(e)?oe.get(e):(e=>{const t={},n=[];for(const[r,o]of Object.entries(ie))for(const[i,a]of Object.entries(ae)){const s=`marp-${o}transition${a}-${e}`;n.push(ue(s).then((e=>{t[i]=t[i]||{},t[i][r]=e?{...e,name:s}:void 0})))}return Promise.all(n).then((()=>t))})(e).then((t=>(oe.set(e,t),t))),me=e=>Object.values(e).flatMap(Object.values).every((e=>!e)),ge=(e,{type:t,backward:n})=>{const r=e[n?"backward":"forward"],o=(()=>{const e=r[t],n=e=>({[ce]:e.name});if(e)return n(e);if(r.both){const e=n(r.both);return"incoming"===t&&(e[se("direction")]="reverse"),e}})();return!o&&n?ge(e,{type:t,backward:!1}):o||{[ce]:"__bespoke_marp_transition_no_animation__"}},pe=e=>{if(e)try{const t=JSON.parse(e);if((e=>{if("object"!=typeof e)return!1;const t=e;return"string"==typeof t.name&&(void 0===t.duration||"string"==typeof t.duration)})(t))return t}catch(e){}},ve="_tSId",he="_tA",ye="bespoke-marp-transition-warming-up",be=window.matchMedia("(prefers-reduced-motion: reduce)"),we="__bespoke_marp_transition_reduced_outgoing__",xe="__bespoke_marp_transition_reduced_incoming__",ke={forward:{both:void 0,incoming:{name:xe},outgoing:{name:we}},backward:{both:void 0,incoming:{name:xe},outgoing:{name:we}}},$e=e=>{if(!document.startViewTransition)return;const t=t=>(void 0!==t&&(e._tD=t),e._tD);let n;t(!1),((...e)=>{const t=[...new Set(e).values()];return Promise.all(t.map((e=>fe(e)))).then()})(...Array.from(document.querySelectorAll("section[data-transition], section[data-transition-back]")).flatMap((e=>[e.dataset.transition,e.dataset.transitionBack].flatMap((e=>{const t=pe(e);return[null==t?void 0:t.name,(null==t?void 0:t.builtinFallback)?`__builtin__${t.name}`:void 0]})).filter((e=>!!e))))).then((()=>{document.querySelectorAll("style").forEach((e=>{e.innerHTML=e.innerHTML.replace(/--marp-transition-duration:[^;}]*[;}]/g,(e=>e.slice(0,-1)+"!important"+e.slice(-1)))}))}));const r=(n,{back:r,cond:o})=>i=>{var a;const s=t();if(s)return!!i[he]||!("object"!=typeof s||(s.skipTransition(),!i.forSync));if(!o(i))return!0;const l=e.slides[e.slide()],c=()=>{var e;return null!==(e=i.back)&&void 0!==e?e:r},d="data-transition"+(c()?"-back":""),u=l.querySelector(`section[${d}]`);if(!u)return!0;const f=pe(null!==(a=u.getAttribute(d))&&void 0!==a?a:void 0);return!f||((async(e,{builtinFallback:t=!0}={})=>{let n=await fe(e);if(me(n)){if(!t)return;return n=await fe(`__builtin__${e}`),me(n)?void 0:n}return n})(f.name,{builtinFallback:f.builtinFallback}).then((e=>{if(!e){t(!0);try{n(i)}finally{t(!1)}return}let r=e;be.matches&&(console.warn("Use a constant animation to transition because preferring reduced motion by viewer has detected."),r=ke);const o=document.getElementById(ve);o&&o.remove();const a=document.createElement("style");a.id=ve,document.head.appendChild(a),((e,t)=>{const n=[`:root{${le("direction")}:${t.backward?-1:1};}`,":root:has(.bespoke-marp-inactive){cursor:none;}"],r=t=>{var n,o,i;const a=(null===(n=e[t].both)||void 0===n?void 0:n.defaultDuration)||(null===(o=e[t].outgoing)||void 0===o?void 0:o.defaultDuration)||(null===(i=e[t].incoming)||void 0===i?void 0:i.defaultDuration);return"forward"===t?a:a||r("forward")},o=t.duration||r(t.backward?"backward":"forward");void 0!==o&&n.push(`::view-transition-group(*){${de}:${o};}`);const i=e=>Object.entries(e).map((([e,t])=>`${e}:${t};`)).join("");return n.push(`::view-transition-old(root){${i(ge(e,{...t,type:"outgoing"}))}}`,`::view-transition-new(root){${i(ge(e,{...t,type:"incoming"}))}}`),n})(r,{backward:c(),duration:f.duration}).forEach((e=>{var t;return null===(t=a.sheet)||void 0===t?void 0:t.insertRule(e)}));const s=document.documentElement.classList;s.add(ye);let l=!1;const d=()=>{l||(n(i),l=!0,s.remove(ye))},u=()=>{t(!1),a.remove(),s.remove(ye)};try{t(!0);const e=document.startViewTransition(d);t(e),e.finished.finally(u)}catch(e){console.error(e),d(),u()}})),!1)};e.on("prev",r((t=>e.prev({...t,[he]:!0})),{back:!0,cond:e=>{var t;return e.index>0&&!((null===(t=e.fragment)||void 0===t||t)&&n.fragmentIndex>0)}})),e.on("next",r((t=>e.next({...t,[he]:!0})),{cond:t=>t.index+1<e.slides.length&&!(n.fragmentIndex+1<n.fragments.length)})),setTimeout((()=>{e.on("slide",r((t=>e.slide(t.index,{...t,[he]:!0})),{cond:t=>{const n=e.slide();return t.index!==n&&(t.back=t.index<n,!0)}}))}),0),e.on("fragment",(e=>{n=e}))};let Ee;const Le=()=>(void 0===Ee&&(Ee="wakeLock"in navigator&&navigator.wakeLock),Ee),Se=async()=>{const e=Le();if(e)try{return await e.request("screen")}catch(e){console.warn(e)}return null},Pe=async()=>{if(!Le())return;let e;const t=()=>{e&&"visible"===document.visibilityState&&Se()};for(const e of["visibilitychange","fullscreenchange"])document.addEventListener(e,t);return e=await Se(),e};((e=document.getElementById(":$p"))=>{(()=>{const e=f("view");r.dataset.bespokeView=e===a||e===i?e:""})();const t=(e=>{const t=f(e);return m({[e]:void 0}),t})("sync")||void 0;n.from(e,((...e)=>{const t=s.findIndex((e=>u()===e));return e.map((([e,n])=>e[t]&&n)).filter((e=>e))})([[1,1,0],G({key:t})],[[1,1,1],W(e)],[[1,1,0],_],[[1,1,1],b],[[1,0,0],S()],[[1,1,1],T],[[1,1,1],z({history:!1})],[[1,1,0],I()],[[1,1,0],E],[[1,0,0],J],[[1,1,0],re()],[[1,0,0],M()],[[1,0,0],$e],[[1,1,1],w],[[1,1,0],Pe]))})()}();</script></body></html>
\ No newline at end of file
+!function(){"use strict";function e(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var t={from:function(e,t){var n,r=1===(e.parent||e).nodeType?e.parent||e:document.querySelector(e.parent||e),o=[].filter.call("string"==typeof e.slides?r.querySelectorAll(e.slides):e.slides||r.children,(function(e){return"SCRIPT"!==e.nodeName})),i={},a=function(e,t){return(t=t||{}).index=o.indexOf(e),t.slide=e,t},s=function(e,t){i[e]=(i[e]||[]).filter((function(e){return e!==t}))},l=function(e,t){return(i[e]||[]).reduce((function(e,n){return e&&!1!==n(t)}),!0)},c=function(e,t){o[e]&&(n&&l("deactivate",a(n,t)),n=o[e],l("activate",a(n,t)))},d=function(e,t){var r=o.indexOf(n)+e;l(e>0?"next":"prev",a(n,t))&&c(r,t)},u={off:s,on:function(e,t){return(i[e]||(i[e]=[])).push(t),s.bind(null,e,t)},fire:l,slide:function(e,t){if(!arguments.length)return o.indexOf(n);l("slide",a(o[e],t))&&c(e,t)},next:d.bind(null,1),prev:d.bind(null,-1),parent:r,slides:o,destroy:function(e){l("destroy",a(n,e)),i={}}};return(t||[]).forEach((function(e){e(u)})),n||c(0),u}},n=e(t);const r=document.body,o=(...e)=>history.replaceState(...e),i="presenter",a="next",s=["",i,a],l="bespoke-marp-",c=`data-${l}`,d=(e,{protocol:t,host:n,pathname:r,hash:o}=location)=>{const i=e.toString();return`${t}//${n}${r}${i?"?":""}${i}${o}`},u=()=>r.dataset.bespokeView,f=e=>new URLSearchParams(location.search).get(e),m=(e,t={})=>{var n;const r={location,setter:o,...t},i=new URLSearchParams(r.location.search);for(const t of Object.keys(e)){const n=e[t];"string"==typeof n?i.set(t,n):i.delete(t)}try{r.setter({...null!==(n=window.history.state)&&void 0!==n?n:{}},"",d(i,r.location))}catch(e){console.error(e)}},g=(()=>{const e="bespoke-marp";try{return localStorage.setItem(e,e),localStorage.removeItem(e),!0}catch(e){return!1}})(),p=e=>{try{return localStorage.getItem(e)}catch(e){return null}},v=(e,t)=>{try{return localStorage.setItem(e,t),!0}catch(e){return!1}},h=e=>{try{return localStorage.removeItem(e),!0}catch(e){return!1}},y=(e,t)=>{const n="aria-hidden";t?e.setAttribute(n,"true"):e.removeAttribute(n)},b=e=>{e.parent.classList.add(`${l}parent`),e.slides.forEach((e=>e.classList.add(`${l}slide`))),e.on("activate",(t=>{const n=`${l}active`,r=t.slide,o=r.classList,i=!o.contains(n);if(e.slides.forEach((e=>{e.classList.remove(n),y(e,!0)})),o.add(n),y(r,!1),i){const e=`${n}-ready`;o.add(e),document.body.clientHeight,o.remove(e)}}))},w=e=>{let t=0,n=0;Object.defineProperty(e,"fragments",{enumerable:!0,value:e.slides.map((e=>[null,...e.querySelectorAll("[data-marpit-fragment]")]))});const r=r=>void 0!==e.fragments[t][n+r],o=(r,o)=>{t=r,n=o,e.fragments.forEach(((e,t)=>{e.forEach(((e,n)=>{if(null==e)return;const i=t<r||t===r&&n<=o;e.setAttribute(`${c}fragment`,(i?"":"in")+"active");const a=`${c}current-fragment`;t===r&&n===o?e.setAttribute(a,"current"):e.removeAttribute(a)}))})),e.fragmentIndex=o;const i={slide:e.slides[r],index:r,fragments:e.fragments[r],fragmentIndex:o};e.fire("fragment",i)};e.on("next",(({fragment:i=!0})=>{if(i){if(r(1))return o(t,n+1),!1;const i=t+1;e.fragments[i]&&o(i,0)}else{const r=e.fragments[t].length;if(n+1<r)return o(t,r-1),!1;const i=e.fragments[t+1];i&&o(t+1,i.length-1)}})),e.on("prev",(({fragment:i=!0})=>{if(r(-1)&&i)return o(t,n-1),!1;const a=t-1;e.fragments[a]&&o(a,e.fragments[a].length-1)})),e.on("slide",(({index:t,fragment:n})=>{let r=0;if(void 0!==n){const o=e.fragments[t];if(o){const{length:e}=o;r=-1===n?e-1:Math.min(Math.max(n,0),e-1)}}o(t,r)})),o(0,0)},x=document,k=()=>!(!x.fullscreenEnabled&&!x.webkitFullscreenEnabled),$=()=>!(!x.fullscreenElement&&!x.webkitFullscreenElement),E=e=>{e.fullscreen=()=>{k()&&(async()=>{return $()?null===(e=x.exitFullscreen||x.webkitExitFullscreen)||void 0===e?void 0:e.call(x):((e=x.body)=>{var t;return null===(t=e.requestFullscreen||e.webkitRequestFullscreen)||void 0===t?void 0:t.call(e)})();var e})()},document.addEventListener("keydown",(t=>{"f"!==t.key&&"F11"!==t.key||t.altKey||t.ctrlKey||t.metaKey||!k()||(e.fullscreen(),t.preventDefault())}))},L=`${l}inactive`,S=(e=2e3)=>({parent:t,fire:n})=>{const r=t.classList,o=e=>n(`marp-${e?"":"in"}active`);let i;const a=()=>{i&&clearTimeout(i),i=setTimeout((()=>{r.add(L),o()}),e),r.contains(L)&&(r.remove(L),o(!0))};for(const e of["mousedown","mousemove","touchend"])document.addEventListener(e,a);setTimeout(a,0)},P=["AUDIO","BUTTON","INPUT","SELECT","TEXTAREA","VIDEO"],_=e=>{e.parent.addEventListener("keydown",(e=>{if(!e.target)return;const t=e.target;(P.includes(t.nodeName)||"true"===t.contentEditable)&&e.stopPropagation()}))},T=e=>{window.addEventListener("load",(()=>{for(const t of e.slides){const e=t.querySelector("marp-auto-scaling, [data-auto-scaling], [data-marp-fitting]");t.setAttribute(`${c}load`,e?"":"hideable")}}))},I=({interval:e=250}={})=>t=>{document.addEventListener("keydown",(e=>{if(" "===e.key&&e.shiftKey)t.prev();else if("ArrowLeft"===e.key||"ArrowUp"===e.key||"PageUp"===e.key)t.prev({fragment:!e.shiftKey});else if(" "!==e.key||e.shiftKey)if("ArrowRight"===e.key||"ArrowDown"===e.key||"PageDown"===e.key)t.next({fragment:!e.shiftKey});else if("End"===e.key)t.slide(t.slides.length-1,{fragment:-1});else{if("Home"!==e.key)return;t.slide(0)}else t.next();e.preventDefault()}));let n,r,o=0;t.parent.addEventListener("wheel",(i=>{let a=!1;const s=(e,t)=>{e&&(a=a||((e,t)=>((e,t)=>{const n="X"===t?"Width":"Height";return e[`client${n}`]<e[`scroll${n}`]})(e,t)&&((e,t)=>{const{overflow:n}=e,r=e[`overflow${t}`];return"auto"===n||"scroll"===n||"auto"===r||"scroll"===r})(getComputedStyle(e),t))(e,t)),(null==e?void 0:e.parentElement)&&s(e.parentElement,t)};if(0!==i.deltaX&&s(i.target,"X"),0!==i.deltaY&&s(i.target,"Y"),a)return;i.preventDefault();const l=Math.sqrt(i.deltaX**2+i.deltaY**2);if(void 0!==i.wheelDelta){if(void 0===i.webkitForce&&Math.abs(i.wheelDelta)<40)return;if(i.deltaMode===i.DOM_DELTA_PIXEL&&l<4)return}else if(i.deltaMode===i.DOM_DELTA_PIXEL&&l<12)return;r&&clearTimeout(r),r=setTimeout((()=>{n=0}),e);const c=Date.now()-o<e,d=l<=n;if(n=l,c||d)return;let u;(i.deltaX>0||i.deltaY>0)&&(u="next"),(i.deltaX<0||i.deltaY<0)&&(u="prev"),u&&(t[u](),o=Date.now())}))},M=(e=`.${l}osc`)=>{const t=document.querySelector(e);if(!t)return()=>{};const n=(e,n)=>{t.querySelectorAll(`[${c}osc=${JSON.stringify(e)}]`).forEach(n)};return k()||n("fullscreen",(e=>e.style.display="none")),g||n("presenter",(e=>{e.disabled=!0,e.title="Presenter view is disabled due to restricted localStorage."})),e=>{t.addEventListener("click",(t=>{if(t.target instanceof HTMLElement){const{bespokeMarpOsc:n}=t.target.dataset;n&&t.target.blur();const r={fragment:!t.shiftKey};"next"===n?e.next(r):"prev"===n?e.prev(r):"fullscreen"===n?null==e||e.fullscreen():"presenter"===n&&e.openPresenterView()}})),e.parent.appendChild(t),e.on("activate",(({index:t})=>{n("page",(n=>n.textContent=`Page ${t+1} of ${e.slides.length}`))})),e.on("fragment",(({index:t,fragments:r,fragmentIndex:o})=>{n("prev",(e=>e.disabled=0===t&&0===o)),n("next",(n=>n.disabled=t===e.slides.length-1&&o===r.length-1))})),e.on("marp-active",(()=>y(t,!1))),e.on("marp-inactive",(()=>y(t,!0))),k()&&(e=>{for(const t of["","webkit"])x.addEventListener(t+"fullscreenchange",e)})((()=>n("fullscreen",(e=>e.classList.toggle("exit",k()&&$())))))}},O=e=>{window.addEventListener("message",(t=>{if(t.origin!==window.origin)return;const[n,r]=t.data.split(":");if("navigate"===n){const[t,n]=r.split(",");let o=Number.parseInt(t,10),i=Number.parseInt(n,10)+1;i>=e.fragments[o].length&&(o+=1,i=0),e.slide(o,{fragment:i})}}))};var A=["area","base","br","col","command","embed","hr","img","input","keygen","link","meta","param","source","track","wbr"];let C=e=>String(e).replace(/[&<>"']/g,(e=>`&${D[e]};`)),D={"&":"amp","<":"lt",">":"gt",'"':"quot","'":"apos"},N="dangerouslySetInnerHTML",B={className:"class",htmlFor:"for"},q={};function K(e,t){let n=[],r="";t=t||{};for(let e=arguments.length;e-- >2;)n.push(arguments[e]);if("function"==typeof e)return t.children=n.reverse(),e(t);if(e){if(r+="<"+e,t)for(let e in t)!1!==t[e]&&null!=t[e]&&e!==N&&(r+=` ${B[e]?B[e]:C(e)}="${C(t[e])}"`);r+=">"}if(-1===A.indexOf(e)){if(t[N])r+=t[N].__html;else for(;n.length;){let e=n.pop();if(e)if(e.pop)for(let t=e.length;t--;)n.push(e[t]);else r+=!0===q[e]?e:C(e)}r+=e?`</${e}>`:""}return q[r]=!0,r}const j=({children:e})=>K(null,null,...e),F=`${l}presenter-`,V={container:`${F}container`,dragbar:`${F}dragbar-container`,next:`${F}next`,nextContainer:`${F}next-container`,noteContainer:`${F}note-container`,noteWrapper:`${F}note-wrapper`,noteButtons:`${F}note-buttons`,infoContainer:`${F}info-container`,infoPage:`${F}info-page`,infoPageText:`${F}info-page-text`,infoPagePrev:`${F}info-page-prev`,infoPageNext:`${F}info-page-next`,noteButtonsBigger:`${F}note-bigger`,noteButtonsSmaller:`${F}note-smaller`,infoTime:`${F}info-time`,infoTimer:`${F}info-timer`},U=e=>{const{title:t}=document;document.title="[Presenter view]"+(t?` - ${t}`:"");const n={},r=e=>(n[e]=n[e]||document.querySelector(`.${e}`),n[e]);document.body.appendChild((e=>{const t=document.createElement("div");return t.className=V.container,t.appendChild(e),t.insertAdjacentHTML("beforeend",K(j,null,K("div",{class:V.nextContainer},K("iframe",{class:V.next,src:"?view=next"})),K("div",{class:V.dragbar}),K("div",{class:V.noteContainer},K("div",{class:V.noteWrapper}),K("div",{class:V.noteButtons},K("button",{class:V.noteButtonsSmaller,tabindex:"-1",title:"Smaller notes font size"},"Smaller notes font size"),K("button",{class:V.noteButtonsBigger,tabindex:"-1",title:"Bigger notes font size"},"Bigger notes font size"))),K("div",{class:V.infoContainer},K("div",{class:V.infoPage},K("button",{class:V.infoPagePrev,tabindex:"-1",title:"Previous"},"Previous"),K("span",{class:V.infoPageText}),K("button",{class:V.infoPageNext,tabindex:"-1",title:"Next"},"Next")),K("time",{class:V.infoTime,title:"Current time"}),K("time",{class:V.infoTimer,title:"Timer"})))),t})(e.parent)),(e=>{let t=!1;r(V.dragbar).addEventListener("mousedown",(()=>{t=!0,r(V.dragbar).classList.add("active")})),window.addEventListener("mouseup",(()=>{t=!1,r(V.dragbar).classList.remove("active")})),window.addEventListener("mousemove",(e=>{if(!t)return;const n=e.clientX/document.documentElement.clientWidth*100;r(V.container).style.setProperty("--bespoke-marp-presenter-split-ratio",`${Math.max(0,Math.min(100,n))}%`)})),r(V.nextContainer).addEventListener("click",(()=>e.next()));const n=r(V.next),o=(i=n,(e,t)=>{var n;return null===(n=i.contentWindow)||void 0===n?void 0:n.postMessage(`navigate:${e},${t}`,"null"===window.origin?"*":window.origin)});var i;n.addEventListener("load",(()=>{r(V.nextContainer).classList.add("active"),o(e.slide(),e.fragmentIndex),e.on("fragment",(({index:e,fragmentIndex:t})=>o(e,t)))}));const a=document.querySelectorAll(".bespoke-marp-note");a.forEach((e=>{e.addEventListener("keydown",(e=>e.stopPropagation())),r(V.noteWrapper).appendChild(e)})),e.on("activate",(()=>a.forEach((t=>t.classList.toggle("active",t.dataset.index==e.slide())))));let s=0;const l=e=>{s=Math.max(-5,s+e),r(V.noteContainer).style.setProperty("--bespoke-marp-note-font-scale",(1.2**s).toFixed(4))},c=()=>l(1),d=()=>l(-1),u=r(V.noteButtonsBigger),f=r(V.noteButtonsSmaller);u.addEventListener("click",(()=>{u.blur(),c()})),f.addEventListener("click",(()=>{f.blur(),d()})),document.addEventListener("keydown",(e=>{"+"===e.key&&c(),"-"===e.key&&d()}),!0),e.on("activate",(({index:t})=>{r(V.infoPageText).textContent=`${t+1} / ${e.slides.length}`}));const m=r(V.infoPagePrev),g=r(V.infoPageNext);m.addEventListener("click",(t=>{m.blur(),e.prev({fragment:!t.shiftKey})})),g.addEventListener("click",(t=>{g.blur(),e.next({fragment:!t.shiftKey})})),e.on("fragment",(({index:t,fragments:n,fragmentIndex:r})=>{m.disabled=0===t&&0===r,g.disabled=t===e.slides.length-1&&r===n.length-1}));let p=new Date;const v=()=>{const e=new Date,t=e=>`${Math.floor(e)}`.padStart(2,"0"),n=e.getTime()-p.getTime(),o=t(n/1e3%60),i=t(n/1e3/60%60),a=t(n/36e5%24);r(V.infoTime).textContent=e.toLocaleTimeString(),r(V.infoTimer).textContent=`${a}:${i}:${o}`};v(),setInterval(v,250),r(V.infoTimer).addEventListener("click",(()=>{p=new Date}))})(e)},X=e=>{if(!(e=>e.syncKey&&"string"==typeof e.syncKey)(e))throw new Error("The current instance of Bespoke.js is invalid for Marp bespoke presenter plugin.");Object.defineProperties(e,{openPresenterView:{enumerable:!0,value:H},presenterUrl:{enumerable:!0,get:R}}),g&&document.addEventListener("keydown",(t=>{"p"!==t.key||t.altKey||t.ctrlKey||t.metaKey||(t.preventDefault(),e.openPresenterView())}))};function H(){const{max:e,floor:t}=Math,n=e(t(.85*window.innerWidth),640),r=e(t(.85*window.innerHeight),360);return window.open(this.presenterUrl,F+this.syncKey,`width=${n},height=${r},menubar=no,toolbar=no`)}function R(){const e=new URLSearchParams(location.search);return e.set("view","presenter"),e.set("sync",this.syncKey),d(e)}const W=e=>{const t=u();return t===a&&e.appendChild(document.createElement("span")),{"":X,[i]:U,[a]:O}[t]},J=e=>{e.on("activate",(t=>{document.querySelectorAll(".bespoke-progress-parent > .bespoke-progress-bar").forEach((n=>{n.style.flexBasis=100*t.index/(e.slides.length-1)+"%"}))}))},Y=e=>{const t=Number.parseInt(e,10);return Number.isNaN(t)?null:t},z=(e={})=>{const t={history:!0,...e};return e=>{let n=!0;const r=e=>{const t=n;try{return n=!0,e()}finally{n=t}},o=(t={fragment:!0})=>{let n=t.fragment?Y(f("f")||""):null;((t,n)=>{const{min:r,max:o}=Math,{fragments:i,slides:a}=e,s=o(0,r(t,a.length-1)),l=o(0,r(n||0,i[s].length-1));s===e.slide()&&l===e.fragmentIndex||e.slide(s,{fragment:l})})((()=>{var t,r;if(location.hash){const[o]=location.hash.slice(1).split(":~:");if(/^\d+$/.test(o))return(null!==(t=Y(o))&&void 0!==t?t:1)-1;const i=document.getElementById(o)||document.querySelector(`a[name="${CSS.escape(o)}"]`);if(i){const{length:t}=e.slides;for(let o=0;o<t;o+=1)if(e.slides[o].contains(i)){const t=null===(r=e.fragments)||void 0===r?void 0:r[o],a=i.closest("[data-marpit-fragment]");if(t&&a){const e=t.indexOf(a);e>=0&&(n=e)}return o}}}return 0})(),n)};e.on("fragment",(({index:e,fragmentIndex:r})=>{n||m({f:0===r||r.toString()},{location:{...location,hash:`#${e+1}`},setter:(...e)=>t.history?history.pushState(...e):history.replaceState(...e)})})),setTimeout((()=>{o(),window.addEventListener("hashchange",(()=>r((()=>{o({fragment:!1}),m({f:void 0})})))),window.addEventListener("popstate",(()=>{n||r((()=>o()))})),n=!1}),0)}},G=(e={})=>{var t;const n=e.key||(null===(t=window.history.state)||void 0===t?void 0:t.marpBespokeSyncKey)||Math.random().toString(36).slice(2),r=`bespoke-marp-sync-${n}`;var i;i={marpBespokeSyncKey:n},m({},{setter:(e,...t)=>o({...e,...i},...t)});const a=()=>{const e=p(r);return e?JSON.parse(e):Object.create(null)},s=e=>{const t=a(),n={...t,...e(t)};return v(r,JSON.stringify(n)),n},l=()=>{window.removeEventListener("pageshow",l),s((e=>({reference:(e.reference||0)+1})))};return e=>{l(),Object.defineProperty(e,"syncKey",{value:n,enumerable:!0});let t=!0;setTimeout((()=>{e.on("fragment",(e=>{t&&s((()=>({index:e.index,fragmentIndex:e.fragmentIndex})))}))}),0),window.addEventListener("storage",(n=>{if(n.key===r&&n.oldValue&&n.newValue){const r=JSON.parse(n.oldValue),o=JSON.parse(n.newValue);if(r.index!==o.index||r.fragmentIndex!==o.fragmentIndex)try{t=!1,e.slide(o.index,{fragment:o.fragmentIndex,forSync:!0})}finally{t=!0}}}));const o=()=>{const{reference:e}=a();void 0===e||e<=1?h(r):s((()=>({reference:e-1})))};window.addEventListener("pagehide",(e=>{e.persisted&&window.addEventListener("pageshow",l),o()})),e.on("destroy",o)}},{PI:Q,abs:Z,sqrt:ee,atan2:te}=Math,ne={passive:!0},re=({slope:e=-.7,swipeThreshold:t=30}={})=>n=>{let r;const o=n.parent,i=e=>{const t=o.getBoundingClientRect();return{x:e.pageX-(t.left+t.right)/2,y:e.pageY-(t.top+t.bottom)/2}};o.addEventListener("touchstart",(({touches:e})=>{r=1===e.length?i(e[0]):void 0}),ne),o.addEventListener("touchmove",(e=>{if(r)if(1===e.touches.length){e.preventDefault();const t=i(e.touches[0]),n=t.x-r.x,o=t.y-r.y;r.delta=ee(Z(n)**2+Z(o)**2),r.radian=te(n,o)}else r=void 0})),o.addEventListener("touchend",(o=>{if(r){if(r.delta&&r.delta>=t&&r.radian){const t=(r.radian-e+Q)%(2*Q)-Q;n[t<0?"next":"prev"](),o.stopPropagation()}r=void 0}}),ne)},oe=new Map;oe.clear(),oe.set("none",{backward:{both:void 0,incoming:void 0,outgoing:void 0},forward:{both:void 0,incoming:void 0,outgoing:void 0}});const ie={both:"",outgoing:"outgoing-",incoming:"incoming-"},ae={forward:"",backward:"-backward"},se=e=>`--marp-bespoke-transition-animation-${e}`,le=e=>`--marp-transition-${e}`,ce=se("name"),de=se("duration"),ue=e=>new Promise((t=>{const n={},r=document.createElement("div"),o=e=>{r.remove(),t(e)};r.addEventListener("animationstart",(()=>o(n))),Object.assign(r.style,{animationName:e,animationDuration:"1s",animationFillMode:"both",animationPlayState:"paused",position:"absolute",pointerEvents:"none"}),document.body.appendChild(r);const i=getComputedStyle(r).getPropertyValue(le("duration"));i&&(n.defaultDuration=i),((e,t)=>{requestAnimationFrame((()=>{e.style.animationPlayState="running",requestAnimationFrame((()=>t(void 0)))}))})(r,o)})),fe=async e=>oe.has(e)?oe.get(e):(e=>{const t={},n=[];for(const[r,o]of Object.entries(ie))for(const[i,a]of Object.entries(ae)){const s=`marp-${o}transition${a}-${e}`;n.push(ue(s).then((e=>{t[i]=t[i]||{},t[i][r]=e?{...e,name:s}:void 0})))}return Promise.all(n).then((()=>t))})(e).then((t=>(oe.set(e,t),t))),me=e=>Object.values(e).flatMap(Object.values).every((e=>!e)),ge=(e,{type:t,backward:n})=>{const r=e[n?"backward":"forward"],o=(()=>{const e=r[t],n=e=>({[ce]:e.name});if(e)return n(e);if(r.both){const e=n(r.both);return"incoming"===t&&(e[se("direction")]="reverse"),e}})();return!o&&n?ge(e,{type:t,backward:!1}):o||{[ce]:"__bespoke_marp_transition_no_animation__"}},pe=e=>{if(e)try{const t=JSON.parse(e);if((e=>{if("object"!=typeof e)return!1;const t=e;return"string"==typeof t.name&&(void 0===t.duration||"string"==typeof t.duration)})(t))return t}catch(e){}},ve="_tSId",he="_tA",ye="bespoke-marp-transition-warming-up",be=window.matchMedia("(prefers-reduced-motion: reduce)"),we="__bespoke_marp_transition_reduced_outgoing__",xe="__bespoke_marp_transition_reduced_incoming__",ke={forward:{both:void 0,incoming:{name:xe},outgoing:{name:we}},backward:{both:void 0,incoming:{name:xe},outgoing:{name:we}}},$e=e=>{if(!document.startViewTransition)return;const t=t=>(void 0!==t&&(e._tD=t),e._tD);let n;t(!1),((...e)=>{const t=[...new Set(e).values()];return Promise.all(t.map((e=>fe(e)))).then()})(...Array.from(document.querySelectorAll("section[data-transition], section[data-transition-back]")).flatMap((e=>[e.dataset.transition,e.dataset.transitionBack].flatMap((e=>{const t=pe(e);return[null==t?void 0:t.name,(null==t?void 0:t.builtinFallback)?`__builtin__${t.name}`:void 0]})).filter((e=>!!e))))).then((()=>{document.querySelectorAll("style").forEach((e=>{e.innerHTML=e.innerHTML.replace(/--marp-transition-duration:[^;}]*[;}]/g,(e=>e.slice(0,-1)+"!important"+e.slice(-1)))}))}));const r=(n,{back:r,cond:o})=>i=>{var a;const s=t();if(s)return!!i[he]||!("object"!=typeof s||(s.skipTransition(),!i.forSync));if(!o(i))return!0;const l=e.slides[e.slide()],c=()=>{var e;return null!==(e=i.back)&&void 0!==e?e:r},d="data-transition"+(c()?"-back":""),u=l.querySelector(`section[${d}]`);if(!u)return!0;const f=pe(null!==(a=u.getAttribute(d))&&void 0!==a?a:void 0);return!f||((async(e,{builtinFallback:t=!0}={})=>{let n=await fe(e);if(me(n)){if(!t)return;return n=await fe(`__builtin__${e}`),me(n)?void 0:n}return n})(f.name,{builtinFallback:f.builtinFallback}).then((e=>{if(!e){t(!0);try{n(i)}finally{t(!1)}return}let r=e;be.matches&&(console.warn("Use a constant animation to transition because preferring reduced motion by viewer has detected."),r=ke);const o=document.getElementById(ve);o&&o.remove();const a=document.createElement("style");a.id=ve,document.head.appendChild(a),((e,t)=>{const n=[`:root{${le("direction")}:${t.backward?-1:1};}`,":root:has(.bespoke-marp-inactive){cursor:none;}"],r=t=>{var n,o,i;const a=(null===(n=e[t].both)||void 0===n?void 0:n.defaultDuration)||(null===(o=e[t].outgoing)||void 0===o?void 0:o.defaultDuration)||(null===(i=e[t].incoming)||void 0===i?void 0:i.defaultDuration);return"forward"===t?a:a||r("forward")},o=t.duration||r(t.backward?"backward":"forward");void 0!==o&&n.push(`::view-transition-group(*){${de}:${o};}`);const i=e=>Object.entries(e).map((([e,t])=>`${e}:${t};`)).join("");return n.push(`::view-transition-old(root){${i(ge(e,{...t,type:"outgoing"}))}}`,`::view-transition-new(root){${i(ge(e,{...t,type:"incoming"}))}}`),n})(r,{backward:c(),duration:f.duration}).forEach((e=>{var t;return null===(t=a.sheet)||void 0===t?void 0:t.insertRule(e)}));const s=document.documentElement.classList;s.add(ye);let l=!1;const d=()=>{l||(n(i),l=!0,s.remove(ye))},u=()=>{t(!1),a.remove(),s.remove(ye)};try{t(!0);const e=document.startViewTransition(d);t(e),e.finished.finally(u)}catch(e){console.error(e),d(),u()}})),!1)};e.on("prev",r((t=>e.prev({...t,[he]:!0})),{back:!0,cond:e=>{var t;return e.index>0&&!((null===(t=e.fragment)||void 0===t||t)&&n.fragmentIndex>0)}})),e.on("next",r((t=>e.next({...t,[he]:!0})),{cond:t=>t.index+1<e.slides.length&&!(n.fragmentIndex+1<n.fragments.length)})),setTimeout((()=>{e.on("slide",r((t=>e.slide(t.index,{...t,[he]:!0})),{cond:t=>{const n=e.slide();return t.index!==n&&(t.back=t.index<n,!0)}}))}),0),e.on("fragment",(e=>{n=e}))};let Ee;const Le=()=>(void 0===Ee&&(Ee="wakeLock"in navigator&&navigator.wakeLock),Ee),Se=async()=>{const e=Le();if(e)try{return await e.request("screen")}catch(e){console.warn(e)}return null},Pe=async()=>{if(!Le())return;let e;const t=()=>{e&&"visible"===document.visibilityState&&Se()};for(const e of["visibilitychange","fullscreenchange"])document.addEventListener(e,t);return e=await Se(),e};((e=document.getElementById(":$p"))=>{(()=>{const e=f("view");r.dataset.bespokeView=e===a||e===i?e:""})();const t=(e=>{const t=f(e);return m({[e]:void 0}),t})("sync")||void 0;n.from(e,((...e)=>{const t=s.findIndex((e=>u()===e));return e.map((([e,n])=>e[t]&&n)).filter((e=>e))})([[1,1,0],G({key:t})],[[1,1,1],W(e)],[[1,1,0],_],[[1,1,1],b],[[1,0,0],S()],[[1,1,1],T],[[1,1,1],z({history:!1})],[[1,1,0],I()],[[1,1,0],E],[[1,0,0],J],[[1,1,0],re()],[[1,0,0],M()],[[1,0,0],$e],[[1,1,1],w],[[1,1,0],Pe]))})()}();</script><script>window.__marpCliWatchWS="ws://localhost:37717/d3fdd265f8b28a1e410a217609dce3f1a525f66cab1e9e9f6edf7ce646e565f8";!function(){"use strict";const e=(n,o=!1)=>{const t=new WebSocket(n);return t.addEventListener("open",(()=>{console.info("[Marp CLI] Observing the change of file..."),o&&location.reload()})),t.addEventListener("close",(()=>{console.warn("[Marp CLI] WebSocket for file watcher was disconnected. Try re-connecting in 5000ms..."),setTimeout((()=>e(n,!0)),5e3)})),t.addEventListener("message",(e=>{"reload"===e.data&&location.reload()})),t};(()=>{const n=window.__marpCliWatchWS;n&&e(n)})()}();</script></body></html>
\ No newline at end of file
diff --git a/01.gog-altair/slides.md b/01.gog-altair/slides.md
index b4ac57e..a255a80 100644
--- a/01.gog-altair/slides.md
+++ b/01.gog-altair/slides.md
@@ -135,10 +135,80 @@ Possible Exceptions?
 
 ---
 
-## Altair's Grammar
+## Altair
 
-Altair condenses several of the different pieces of the grammar to _"encoding channels"_.
+Altair is a Python visualization library that allows us to work from a grammar of graphics perspective.
 
-We've seen X, Y, and color, let's take a look at some examples of other encoding channels.
+It also is very flexible in output formats, which will be useful if you want to modify your graphics or make them interactive.
+
+Altair is built on top of **Vega-Lite**.
+
+Vega-Lite is a system that represents graphics in a JSON schema, and a set of tools that convert these JSON representations to images or interactive graphics.
 
 ---
+
+## Vega-Lite Example
+
+```json
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "description": "A scatterplot showing horsepower and miles per gallons for various cars.",
+  "data": {"url": "data/cars.json"},
+  "mark": "point",
+  "encoding": {
+    "x": {"field": "Horsepower", "type": "quantitative"},
+    "y": {"field": "Miles_per_Gallon", "type": "quantitative"}
+  }
+}
+```
+Vega condenses several of the different pieces of the grammar to _"encoding channels"_.
+
+---
+
+![](vega.png)
+
+---
+
+## Altair
+
+```python
+import pandas as pd
+import altair as alt
+
+df = pd.read_csv("cars.csv")
+alt.Chart(df).encode(
+  x="Horsepower:Q",        # shorthand for simple features
+  alt.Y("Miles_per_Gallon:Q").title("Miles Per Gallon"),  # longer form w/ customization
+)
+```
+
+Altair is a Pythonic wrapper to create Vega-Lite JSON.  If you use it in a notebook, the resulting graphs will render inline.
+
+
+---
+
+## Altair Notebook
+
+<!-- at this point, see the marimo notebook in this directory -->
+
+--- 
+
+## Learning Altair
+
+To master a library like Altair, you'll go through the following phases:
+
+1. Learn the key concepts.
+    - Goal: Understand how the authors of Altair think about visualization.
+    - Achieved by: Reading user guide & watching tutorials.
+2. Internalize concepts & API.
+    - Goal: Be able to do common tasks without referring to documentation. (You'll always lean on documentation for specifics.)
+    - Achieved by: Working on assignments & experimentation. Reading API reference as needed.
+3. Mastery (not this quarter!)
+    - Goal: Be able to manipulate library to achieve most tasks. Understand limits.
+    - Achieved by: Regular use over months/years. Reading API reference and/or source code.
+
+---
+
+## Altair Assignment
+
+<!-- walk through of assignment setup & how it'll be graded -->
diff --git a/01.gog-altair/vega.png b/01.gog-altair/vega.png
new file mode 100644
index 0000000000000000000000000000000000000000..fb5a9a21fd668266a35e9c5fe3bcfce12deb9280
GIT binary patch
literal 64954
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
L+Wn96Cc*y;<}%{4

literal 0
HcmV?d00001

diff --git a/README.md b/README.md
index 979b67a..918cb64 100644
--- a/README.md
+++ b/README.md
@@ -14,19 +14,20 @@ Inside each directory, you're likely to find:
 
 - `slides.md` - My slides in raw markdown.
 - `slides.html` - My slides converted to a presentation. (using [`marp`](https://marpit.marp.app)) You can open this in your web browser (Type `open slides.html` from the command line.)
-- `*-notebook.py` - These are marimo notebooks (see below).
+- `*.ipynb` - These are Jupyter notebooks (see below).
 
-Not every week will have slides & a notebook, but one or the other should generally exist.
+Not every week will have both slides & a notebook.
 
 Other files, such as images & data will be kept in the appropriate folder.
 
-### Marimo Notebooks
+### Jupyter Notebooks
 
-Marimo notebooks are similar to Jupyter notebooks, but work much better with Git and have some other nice features I appreciate.
+You have a few options for working with `.ipynb` notebooks:
 
-If you have ever looked at a Jupyter notebook file (.ipynb) in an editor, you know they are large JSON files, and once they are checked into Git changes become very difficult to track.
+- `uv run jupyter lab` - the newer UI, will start a server and 
+- `uv run jupyter notebook` - the older UI, perfectly functional still
+- VS Code will open these in it's own editor
 
-To interact with a notebook, run:
-
-`uv run marimo edit <notebook-file>`
+If you run one of the `uv run` options, you'll need to navigate to the .ipynb file in the window that opens in your browser.
 
+**Note:** To stop a server, press `Ctrl-C` and then 'y' to the prompt.