{ "cells": [ { "cell_type": "markdown", "id": "ccc41aa0", "metadata": {}, "source": [ "(glue/main)=\n", "\n", "# Saving variables to embed (glue)\n", "\n", "The `glue` submodule allows you to store variables in the notebooks outputs, by keys,\n", "then reference those keys to embed the outputs inline of your text content.[^download]\n", "\n", "[^download]: This notebook can be downloaded as **{nb-download}`glue.ipynb`** and {download}`glue.md`\n", "\n", ":::{versionchanged} 0.14.0\n", "The `glue` roles and directives now only identify keys in the same notebook, by default.\n", "To glue keys from other notebooks, see {ref}`glue/crossdoc`.\n", ":::" ] }, { "cell_type": "markdown", "id": "448365fa", "metadata": {}, "source": [ "(glue/gluing)=\n", "\n", "## Save variables in code cells\n", "\n", "You can use `myst_nb.glue()` to assign the output of a variable to a key of your choice.\n", "`glue` will store all of the information that is normally used to display that variable (ie, whatever happens when you display the variable by putting it at the end of a cell).\n", "Choose a key that you will remember, as you will use it later.\n", "\n", "The following code glues a variable inside the notebook:" ] }, { "cell_type": "code", "execution_count": 1, "id": "4b07d837", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'my variable!'" ] }, "metadata": { "scrapbook": { "mime_prefix": "", "name": "my_variable" } }, "output_type": "display_data" } ], "source": [ "from myst_nb import glue\n", "a = \"my variable!\"\n", "glue(\"my_variable\", a)" ] }, { "cell_type": "markdown", "id": "0f6571ae", "metadata": {}, "source": [ "You can then insert it into your text like so: {glue}`my_variable`.\n", "\n", "That was accomplished with the following code: `` {glue}`my_variable` ``.\n", "\n", "### Saving different variable types\n", "\n", "You can glue anything in your notebook and display it later with `{glue}`.\n", "Here we'll show how to glue and paste **numbers and images**.\n", "We'll simulate some data and run a simple bootstrap on it.\n", "We'll hide most of this process below, to focus on the glueing part." ] }, { "cell_type": "code", "execution_count": 2, "id": "52b4b3c4", "metadata": { "tags": [ "hide-cell" ] }, "outputs": [], "source": [ "# Simulate some data and bootstrap the mean of the data\n", "import numpy as np\n", "import pandas as pd\n", "import matplotlib.pyplot as plt\n", "\n", "n_points = 10000\n", "n_boots = 1000\n", "mean, sd = (3, .2)\n", "data = sd*np.random.randn(n_points) + mean\n", "bootstrap_indices = np.random.randint(0, n_points, n_points*n_boots).reshape((n_boots, n_points))" ] }, { "cell_type": "markdown", "id": "1e2fcee6", "metadata": {}, "source": [ "In the cell below, `data` contains our data, and `bootstrap_indices` is a collection of sample indices in each bootstrap.\n", "Below we'll calculate a few statistics of interest, and `glue()` them into the notebook." ] }, { "cell_type": "code", "execution_count": 3, "id": "a68a726e", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "2.9993212063402397" ] }, "metadata": { "scrapbook": { "mime_prefix": "", "name": "boot_mean" } }, "output_type": "display_data" }, { "data": { "text/plain": [ "2.9868794316852276" ] }, "metadata": { "scrapbook": { "mime_prefix": "", "name": "boot_clo" } }, "output_type": "display_data" }, { "data": { "text/plain": [ "3.0116286876911933" ] }, "metadata": { "scrapbook": { "mime_prefix": "", "name": "boot_chi" } }, "output_type": "display_data" } ], "source": [ "# Calculate the mean of a bunch of random samples\n", "means = data[bootstrap_indices].mean(0)\n", "# Calcualte the 95% confidence interval for the mean\n", "clo, chi = np.percentile(means, [2.5, 97.5])\n", "\n", "# Store the values in our notebook\n", "glue(\"boot_mean\", means.mean())\n", "glue(\"boot_clo\", clo)\n", "glue(\"boot_chi\", chi)" ] }, { "cell_type": "markdown", "id": "047c9b95", "metadata": {}, "source": [ "By default, `glue` will display the value of the variable you are gluing.\n", "This is useful for sanity-checking its value at glue-time.\n", "If you'd like to **prevent display**, use the `display=False` option.\n", "Note that below, we also *overwrite* the value of `boot_chi` (but using the same value):" ] }, { "cell_type": "code", "execution_count": 4, "id": "251eff69", "metadata": {}, "outputs": [], "source": [ "glue(\"boot_chi_notdisplayed\", chi, display=False)" ] }, { "cell_type": "markdown", "id": "b865eb45", "metadata": {}, "source": [ "You can also glue visualizations, such as matplotlib figures (here we use `display=False` to ensure that the figure isn't plotted twice):" ] }, { "cell_type": "code", "execution_count": 5, "id": "0eb0ab9f", "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "# Visualize the historgram with the intervals\n", "fig, ax = plt.subplots()\n", "ax.hist(means)\n", "for ln in [clo, chi]:\n", " ax.axvline(ln, ls='--', c='r')\n", "ax.set_title(\"Bootstrap distribution and 95% CI\")\n", "\n", "# And a wider figure to show a timeseries\n", "fig2, ax = plt.subplots(figsize=(6, 2))\n", "ax.plot(np.sort(means), lw=3, c='r')\n", "ax.set_axis_off()\n", "\n", "glue(\"boot_fig\", fig, display=False)\n", "glue(\"sorted_means_fig\", fig2, display=False)" ] }, { "cell_type": "markdown", "id": "e37ec07f", "metadata": {}, "source": [ "The same can be done for DataFrames (or other table-like objects) as well." ] }, { "cell_type": "code", "execution_count": 6, "id": "362fb21a", "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
firstsecondthird
03.0654063.2406053.177796
13.2158783.1111882.947871
22.8084553.4564953.179014
33.3045372.7685943.156621
43.0526523.0332423.178106
\n", "
" ], "text/plain": [ " first second third\n", "0 3.065406 3.240605 3.177796\n", "1 3.215878 3.111188 2.947871\n", "2 2.808455 3.456495 3.179014\n", "3 3.304537 2.768594 3.156621\n", "4 3.052652 3.033242 3.178106" ] }, "metadata": { "scrapbook": { "mime_prefix": "", "name": "df_tbl" } }, "output_type": "display_data" } ], "source": [ "bootstrap_subsets = data[bootstrap_indices][:3, :5].T\n", "df = pd.DataFrame(bootstrap_subsets, columns=[\"first\", \"second\", \"third\"])\n", "glue(\"df_tbl\", df)" ] }, { "cell_type": "markdown", "id": "6a47270a", "metadata": {}, "source": [ "```{tip}\n", "Since we are going to paste this figure into our document at a later point,\n", "you may wish to remove the output here, using the `remove-output` tag\n", "(see {ref}`use/removing`).\n", "```" ] }, { "cell_type": "markdown", "id": "ac3e972a", "metadata": {}, "source": [ "(glue/pasting)=\n", "\n", "## Embedding variables in the page\n", "\n", "Once you have glued variables into a notebook, you can then **paste**\n", "those variables into your text in your book anywhere you like (even on other pages).\n", "These variables can be pasted using one of the roles or directives in the `glue:` *family*." ] }, { "cell_type": "markdown", "id": "1167e479", "metadata": {}, "source": [ "### The `glue` role/directive\n", "\n", "The simplest role and directive are `glue` (a.k.a. `glue:any`),\n", "which paste the glued output inline or as a block respectively,\n", "with no additional formatting.\n", "Simply add:\n", "\n", "````\n", "```{glue} your-key\n", "```\n", "````\n", "\n", "For example, we'll paste the plot we generated above with the following text:\n", "\n", "````md\n", "```{glue} boot_fig\n", "```\n", "````\n", "\n", "Here's how it looks:\n", "\n", "```{glue} boot_fig\n", "```\n", "\n", "Or we can paste inline objects like so:\n", "\n", "```md\n", "Inline text; {glue}`boot_mean`, and figure; {glue}`boot_fig`.\n", "```\n", "\n", "Inline text; {glue}`boot_mean`, and figure; {glue}`boot_fig`.\n", "\n", "```{tip}\n", "We recommend using wider, shorter figures when plotting in-line, with a ratio\n", "around 6x2. For example, here's is an in-line figure of sorted means\n", "from our bootstrap: {glue}`sorted_means_fig`.\n", "It can be used to make a visual point that isn't too complex! For more\n", "ideas, check out [how sparklines are used](https://en.wikipedia.org/wiki/Sparkline).\n", "```\n", "\n", "Next we'll cover some more specific pasting functionality, which gives you more\n", "control over how the outputs look in your pages." ] }, { "cell_type": "markdown", "id": "8bacaa34", "metadata": {}, "source": [ "## Controlling the output format\n", "\n", "You can control the pasted outputs by using a sub-command of `{glue}`.\n", "These are called like so: `` {glue:subcommand}`key` ``.\n", "These subcommands allow you to control more of the look, feel, and content of the pasted output.\n", "\n", "```{tip}\n", "When you use `{glue}` you are actually using a short-hand for `{glue:any}`. This is a\n", "generic command that doesn't make many assumptions about what you are gluing.\n", "```" ] }, { "cell_type": "markdown", "id": "cc230148", "metadata": {}, "source": [ "### The `glue:text` role\n", "\n", "The `glue:text` role, is specific to `text/plain` outputs.\n", "For example, the following text:\n", "\n", "```md\n", "The mean of the bootstrapped distribution was {glue:text}`boot_mean` (95% confidence interval {glue:text}`boot_clo`/{glue:text}`boot_chi`).\n", "```\n", "\n", "Is rendered as:\n", "\n", "The mean of the bootstrapped distribution was {glue:text}`boot_mean` (95% confidence interval {glue:text}`boot_clo`/{glue:text}`boot_chi`)\n", "\n", "```{note}\n", "`glue:text` only works with glued variables that contain a `text/plain` output.\n", "```\n", "\n", "With `glue:text` we can add formatting to the output, by specifying a format spec string after a `:`: `` {glue:text}`mykey:` ``\n", "\n", "The `` should be a valid [Python format specifier](https://docs.python.org/3/library/string.html#format-specification-mini-language).\n", "\n", "This is particularly useful if you are displaying numbers and want to round the results.\n", "For example, the following: ``My rounded mean: {glue:text}`boot_mean:.2f` `` will be rendered like this:\n", "\n", "My rounded mean: {glue:text}`boot_mean:.2f` (95% CI: {glue:text}`boot_clo:.2f`/{glue:text}`boot_chi:.2f`)." ] }, { "cell_type": "markdown", "id": "856ee412", "metadata": {}, "source": [ "### The `glue:figure` directive\n", "\n", "With `glue:figure` you can apply more formatting to figure like objects,\n", "such as giving them a caption and referenceable label:\n", "\n", ":::{table} `glue:figure` directive options\n", "| Option | Type | Description |\n", "| ------ | ---- | ----------- |\n", "| alt | text | Alternate text of an image |\n", "| height | length | The desired height of an image |\n", "| width | length or percentage | The width of an image |\n", "| scale | percentage | The uniform scaling factor of an image |\n", "| class | text | A space-separated list of class names for the image |\n", "| figwidth | length or percentage | The width of the figure |\n", "| figclass | text | A space-separated list of class names for the figure |\n", "| align | text | left, center, or right |\n", "| name | text | referenceable label for the figure |\n", ":::\n", "\n", "````md\n", "```{glue:figure} boot_fig\n", ":alt: \"Alternative title\"\n", ":figwidth: 300px\n", ":name: \"fig-boot\"\n", "\n", "This is a **caption**, with an embedded `{glue:text}` element: {glue:text}`boot_mean:.2f`!\n", "```\n", "````\n", "\n", "```{glue:figure} boot_fig\n", ":alt: \"Alternative title\"\n", ":figwidth: 300px\n", ":name: \"fig-boot\"\n", "\n", "This is a **caption**, with an embedded `{glue:text}` element: {glue:text}`boot_mean:.2f`!\n", "```\n", "\n", "```md\n", "Here is a {ref}`reference to the figure `\n", "```\n", "\n", "Here is a {ref}`reference to the figure `" ] }, { "cell_type": "markdown", "id": "e54e831d", "metadata": {}, "source": [ "Here's a table:\n", "\n", "````md\n", "```{glue:figure} df_tbl\n", ":figwidth: 300px\n", ":name: \"tbl:df\"\n", "\n", "A caption for a pandas table.\n", "```\n", "\n", "````\n", "```{glue:figure} df_tbl\n", ":figwidth: 300px\n", ":name: \"tbl:df\"\n", "\n", "A caption for a pandas table.\n", "```" ] }, { "cell_type": "markdown", "id": "0ff72df7", "metadata": {}, "source": [ "### The `glue:math` directive\n", "\n", "The `glue:math` directive, is specific to latex math outputs\n", "(glued variables that contain a `text/latex` mimetype),\n", "and works similarly to the [sphinx math directive](https://www.sphinx-doc.org/en/1.8/usage/restructuredtext/directives.html#math).\n", "\n", ":::{table} `glue:math` directive options\n", "| Option | Type | Description |\n", "| ------ | ---- | ----------- |\n", "| nowrap | flag | Prevent any wrapping of the given math in a math environment |\n", "| class | text | A space-separated list of class names |\n", "| label or name | text | referenceable label for the figure |\n", ":::" ] }, { "cell_type": "code", "execution_count": 7, "id": "8e6e9b03", "metadata": {}, "outputs": [ { "data": { "text/latex": [ "$\\displaystyle \\left(\\sqrt{5} i\\right)^{\\alpha} \\left(\\frac{1}{2} - \\frac{2 \\sqrt{5} i}{5}\\right) + \\left(- \\sqrt{5} i\\right)^{\\alpha} \\left(\\frac{1}{2} + \\frac{2 \\sqrt{5} i}{5}\\right)$" ], "text/plain": [ "(sqrt(5)*I)**\\alpha*(1/2 - 2*sqrt(5)*I/5) + (-sqrt(5)*I)**\\alpha*(1/2 + 2*sqrt(5)*I/5)" ] }, "metadata": { "scrapbook": { "mime_prefix": "", "name": "sym_eq" } }, "output_type": "display_data" } ], "source": [ "import sympy as sym\n", "f = sym.Function('f')\n", "y = sym.Function('y')\n", "n = sym.symbols(r'\\alpha')\n", "f = y(n)-2*y(n-1/sym.pi)-5*y(n-2)\n", "glue(\"sym_eq\", sym.rsolve(f,y(n),[1,4]))" ] }, { "cell_type": "markdown", "id": "1fad3b65", "metadata": {}, "source": [ "````md\n", "Insert the equation here:\n", "\n", "```{glue:math} sym_eq\n", ":label: eq-sym\n", "```\n", "\n", "Which we reference as Equation {eq}`eq-sym`\n", "````\n", "\n", "Insert the equation here:\n", "\n", "```{glue:math} sym_eq\n", ":label: eq-sym\n", "```\n", "\n", "Which we reference as Equation {eq}`eq-sym`.\n", "\n", "```{note}\n", "`glue:math` only works with glued variables that contain a `text/latex` output.\n", "```\n", "\n", "### The `glue:md` role/directive\n", "\n", "With `glue:md`, you can output `text/markdown`, that will be integrated into your page." ] }, { "cell_type": "code", "execution_count": 8, "id": "28f73f32", "metadata": {}, "outputs": [], "source": [ "from IPython.display import Markdown\n", "glue(\"inline_md\", Markdown(\n", " \"inline **markdown** with a [link](glue/main), \"\n", " \"and a nested glue value: {glue}`boot_mean`\"\n", "), display=False)\n", "glue(\"block_md\", Markdown(\"\"\"\n", "#### A heading\n", "\n", "Then some text, and anything nested.\n", "\n", "```python\n", "print(\"Hello world!\")\n", "```\n", "\"\"\"\n", "), display=False)" ] }, { "cell_type": "markdown", "id": "a7ba0021", "metadata": {}, "source": [ "The format of the markdown can be specified as:\n", "\n", "- `commonmark` (default): Restricted to the [CommonMark specification](https://commonmark.org/).\n", "- `gfm`: Restricted to the [GitHub-flavored markdown](https://github.github.com/gfm/).\n", " - Note, this requires the installation of the [linkify-it-py package](https://pypi.org/project/linkify-it-py)\n", "- `myst`: The MyST parser configuration for the the current document.\n", "\n", "For example, the following role/directive will glue inline/block MyST Markdown, as if it was part of the original document.\n", "\n", "````md\n", "Here is some {glue:md}`inline_md:myst`!\n", "\n", "```{glue:md} block_md\n", ":format: myst\n", "```\n", "````\n", "\n", "Here is some {glue:md}`inline_md:myst`!\n", "\n", "```{glue:md} block_md\n", ":format: myst\n", "```" ] }, { "cell_type": "markdown", "id": "52a6abc0", "metadata": {}, "source": [ "(glue/crossdoc)=\n", "## Embedding outputs from other pages\n", "\n", "Certain `glue` roles and directives can be used to paste content from other notebooks,\n", "by specifying the (relative) path to them.\n", "\n", ":::{tip}\n", "Sometimes you'd like to use variables from notebooks that are not meant to be shown to users.\n", "In this case, you should bundle the notebook with the rest of your content pages, but include `orphan: true` in the metadata of the notebook.\n", ":::\n", "\n", "For example, the following example pastes glue variables from {ref}`orphaned-nb`:\n", "\n", "````markdown\n", "- A cross-pasted `any` role: {glue}`orphaned_nb.ipynb::var_text`\n", "- A cross-pasted `text` role: {glue:text}`orphaned_nb.ipynb::var_float:.2E`\n", "\n", "A cross-pasted `any` directive:\n", "\n", "```{glue} var_text\n", ":doc: orphaned_nb.ipynb\n", "```\n", "````\n", "\n", "- A cross-pasted `any` role: {glue}`orphaned_nb.ipynb::var_text`\n", "- A cross-pasted `text` role: {glue:text}`orphaned_nb.ipynb::var_float:.2E`\n", "\n", "A cross-pasted `any` directive:\n", "\n", "```{glue} var_text\n", ":doc: orphaned_nb.ipynb\n", "```" ] }, { "cell_type": "markdown", "id": "d4a5692f", "metadata": {}, "source": [ "## Advanced use-cases\n", "\n", "Here are a few more specific and advanced uses of the `glue` submodule.\n", "\n", "### Embedding into tables\n", "\n", "In addition to pasting blocks of outputs, or in-line with text, you can also paste directly\n", "into tables. This allows you to compose complex collections of structured data using outputs\n", "that were generated in other notebooks. For example the following table:\n", "\n", "````md\n", "| name | plot | mean | ci |\n", "|:-------------------------------:|:---------------------------:|---------------------------|----------------------------------------------------|\n", "| histogram and raw text | {glue}`boot_fig` | {glue}`boot_mean` | {glue}`boot_clo`-{glue}`boot_chi` |\n", "| sorted means and formatted text | {glue}`sorted_means_fig` | {glue:text}`boot_mean:.3f`| {glue:text}`boot_clo:.3f`-{glue:text}`boot_chi:.3f`|\n", "````\n", "\n", "Results in:\n", "\n", "| name | plot | mean | ci |\n", "|:-------------------------------:|:---------------------------:|---------------------------|---------------------------------------------------|\n", "| histogram and raw text | {glue}`boot_fig` | {glue}`boot_mean` | {glue}`boot_clo`-{glue}`boot_chi` |\n", "| sorted means and formatted text | {glue}`sorted_means_fig` | {glue:text}`boot_mean:.3f` | {glue:text}`boot_clo:.3f`-{glue:text}`boot_chi:.3f` |" ] } ], "metadata": { "file_format": "mystnb", "kernelspec": { "display_name": "python3", "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.8.6" }, "source_map": [ 5, 21, 33, 37, 52, 65, 70, 80, 87, 89, 93, 108, 112, 116, 124, 134, 179, 192, 220, 265, 285, 301, 308, 336, 352, 377, 412 ] }, "nbformat": 4, "nbformat_minor": 5 }