01-Intro Jupyter Notebook.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "# A quick, practical intro to the Jupyter Notebook"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Introduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The IPython Notebook is an **interactive computing environment** that enables users to author notebook documents that include: \n",
    "- Live code\n",
    "- Interactive widgets\n",
    "- Plots\n",
    "- Narrative text\n",
    "- Equations\n",
    "- Images\n",
    "- Video\n",
    "\n",
    "These documents provide a **complete and self-contained record of a computation** that can be converted to various formats and shared with others using email, [Dropbox](http://dropbox.com), version control systems (like git/[GitHub](http://github.com)) or [nbviewer.ipython.org](http://nbviewer.ipython.org)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "### Components"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The IPython Notebook combines three components:\n",
    "\n",
    "* **The notebook web application**: An interactive web application for writing and running code interactively and authoring notebook documents.\n",
    "* **Kernels**: Separate processes started by the notebook web application that runs users' code in a given language and returns output back to the notebook web application. The kernel also handles things like computations for interactive widgets, tab completion and introspection. \n",
    "* **Notebook documents**: Self-contained documents that contain a representation of all content visible in the notebook web application, including inputs and outputs of the computations, narrative\n",
    "text, equations, images, and rich media representations of objects. Each notebook document has its own kernel."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Notebook web application"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The notebook web application enables users to:\n",
    "\n",
    "* **Edit code in the browser**, with automatic syntax highlighting, indentation, and tab completion/introspection.\n",
    "* **Run code from the browser**, with the results of computations attached to the code which generated them.\n",
    "* See the results of computations with **rich media representations**, such as HTML, LaTeX, PNG, SVG, PDF, etc.\n",
    "* Create and use **interactive JavaScript wigets**, which bind interactive user interface controls and visualizations to reactive kernel side computations.\n",
    "* Author **narrative text** using the [Markdown](https://daringfireball.net/projects/markdown/) markup language.\n",
    "* Build **hierarchical documents** that are organized into sections with different levels of headings.\n",
    "* Include mathematical equations using **LaTeX syntax in Markdown**, which are rendered in-browser by [MathJax](http://www.mathjax.org/)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Kernels"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Through IPython's kernel and messaging architecture, the Notebook allows code to be run in a range of different programming languages.  For each notebook document that a user opens, the web application starts a kernel that runs the code for that notebook. Each kernel is capable of running code in a single programming language and there are kernels available in over [100 programming languages](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels).\n",
    "\n",
    "[IPython](https://github.com/ipython/ipython) is the default kernel, it runs Python code.\n",
    "\n",
    "Each of these kernels communicate with the notebook web application and web browser using a JSON over ZeroMQ/WebSockets message protocol that is described [here](https://jupyter-client.readthedocs.io/en/latest/messaging.html#messaging). Most users don't need to know about these details, but it helps to understand that \"kernels run code.\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Notebook documents"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Notebook documents contain the **inputs and outputs** of an interactive session as well as **narrative text** that accompanies the code but is not meant for execution. **Rich output** generated by running code, including HTML, images, video, and plots, is embeddeed in the notebook, which makes it a complete and self-contained record of a computation. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "When you run the notebook web application on your computer, notebook documents are just **files on your local filesystem with a `.ipynb` extension**. This allows you to use familiar workflows for organizing your notebooks into folders and sharing them with others using email, Dropbox and version control systems."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Notebooks consist of a **linear sequence of cells**. There are three basic cell types:\n",
    "\n",
    "* **Code cells:** Input and output of live code that is run in the kernel\n",
    "* **Markdown cells:** Narrative text with embedded LaTeX equations\n",
    "* **Raw cells:** Unformatted text that is included, without modification, when notebooks are converted to different formats using nbconvert\n",
    "\n",
    "Internally, notebook documents are **[JSON](http://en.wikipedia.org/wiki/JSO) data** with **binary values [base64]**(http://en.wikipedia.org/wiki/Base64) encoded. This allows them to be **read and manipulated programmatically** by any programming language. Because JSON is a text format, notebook documents are version control friendly.\n",
    "\n",
    "**Notebooks can be exported** to different static formats including HTML, reStructeredText, LaTeX, PDF, and slide shows using Jupyter's `nbconvert` utility.\n",
    "\n",
    "Furthermore, any notebook document available from a **public URL on or GitHub can be shared** via http://nbviewer.jupyter.org. This service loads the notebook document from the URL and renders it as a static web page. The resulting web page may thus be shared with others **without their needing to install Jupyter**."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Body\n",
    "\n",
    "The body of a notebook is composed of cells. Each cell contains either markdown, code input, code output, or raw text. Cells can be included in any order and edited at-will, allowing for a large ammount of flexibility for constructing a narrative.\n",
    "\n",
    "- **Markdown cells** - These are used to build a nicely formatted narrative around the code in the document. The majority of this lesson is composed of markdown cells.\n",
    "\n",
    "- **Code cells** - These are used to define the computational code in the document. They come in two forms: the *input cell* where the user types the code to be executed, and the *output cell* which is the representation of the executed code. Depending on the code, this representation may be a simple scalar value, or something more complex like a plot or an interactive widget.\n",
    "\n",
    "- **Raw cells** - These are used when text needs to be included in raw form, without execution or transformation.\n",
    "\n",
    "This is what the three types of cells look like:\n",
    "\n",
    "<img src=\"images/cell_types.png\" />"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Modality\n",
    "\n",
    "The notebook user interface is *modal*. This means that the keyboard behaves differently depending upon the current mode of the notebook. A notebook has two modes: **edit** and **command**.\n",
    "\n",
    "**Edit mode** is indicated by a blue cell border and a prompt showing in the editor area. When a cell is in edit mode, you can type into the cell, like a normal text editor.\n",
    "\n",
    "<img src=\"images/edit_mode.png\">\n",
    "\n",
    "**Command mode** is indicated by a grey cell background. When in command mode, the structure of the notebook can be modified as a whole, but the text in individual cells cannot be changed. Most importantly, the keyboard is mapped to a set of shortcuts for efficiently performing notebook and cell actions. For example, pressing **`c`** when in command mode, will copy the current cell; no modifier is needed.\n",
    "\n",
    "<img src=\"images/command_mode.png\">\n",
    "\n",
    "Enter edit mode by pressing `Enter` or using the mouse to click on a cell's editor area.\n",
    "\n",
    "Enter command mode by pressing `Esc` or using the mouse to click *outside* a cell's editor area.\n",
    "\n",
    "Do not attempt to type into a cell when in command mode; unexpected things will happen!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Populating the interactive namespace from numpy and matplotlib\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x118dca320>]"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "%pylab inline\n",
    "plot(rand(100))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Mouse navigation\n",
    "\n",
    "The first concept to understand in mouse-based navigation is that **cells can be selected by clicking on them.** The currently selected cell is indicated with a blue outline or gray background depending on whether the notebook is in edit or command mode. Clicking inside a cell's editor area will enter edit mode. Clicking on the prompt or the output area of a cell will enter command mode.\n",
    "\n",
    "The second concept to understand in mouse-based navigation is that **cell actions usually apply to the currently selected cell**. For example, to run the code in a cell, select it and then click the <button class='btn btn-default btn-xs'><i class=\"fa fa-play icon-play\"></i></button> button in the toolbar or the **`Run -> Run Selected Cells`** menu item. Similarly, to copy a cell, select it and then click the <button class='btn btn-default btn-xs'><i class=\"fa fa-copy icon-copy\"></i></button> button in the toolbar or the **`Edit -> Copy`** menu item. With this simple pattern, it should be possible to perform nearly every action with the mouse.\n",
    "\n",
    "Markdown cells have one other state which can be modified with the mouse. These cells can either be rendered or unrendered. When they are rendered, a nice formatted representation of the cell's contents will be presented. When they are unrendered, the raw text source of the cell will be presented. To render the selected cell with the mouse, click the <button class='btn btn-default btn-xs'><i class=\"fa fa-play icon-play\"></i></button> button in the toolbar or the **`Run -> Run Selected Cells`** menu item. To unrender the selected cell, double click on the cell."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Keyboard Navigation\n",
    "\n",
    "The modal user interface of the IPython Notebook has been optimized for efficient keyboard usage. This is made possible by having two different sets of keyboard shortcuts: one set that is active in edit mode and another in command mode.\n",
    "\n",
    "The most important keyboard shortcuts are **`Enter`**, which enters edit mode, and **`Esc`**, which enters command mode.\n",
    "\n",
    "In edit mode, most of the keyboard is dedicated to typing into the cell's editor. Thus, in edit mode there are relatively few shortcuts. In command mode, the entire keyboard is available for shortcuts, so there are many more possibilities.\n",
    "\n",
    "The following shortcuts have been found to be the most useful in day-to-day tasks:\n",
    "\n",
    "- Basic navigation: **`enter`**, **`shift-enter`**, **`up/k`**, **`down/j`**\n",
    "- Saving the notebook: **`s`**\n",
    "- Cell types: **`y`**, **`m`**, **`r`**\n",
    "- Cell creation: **`a`**, **`b`**\n",
    "- Cell editing: **`x`**, **`c`**, **`v`**, **`d`**, **`z`**, **`ctrl+shift+-`**\n",
    "- Kernel operations: **`i`**, **`.`**\n",
    "\n",
    "You can fully customize JupyterLab's keybindings by accessing the **`Settings -> Advanced Settings Editor`** menu item."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Running Code"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "First and foremost, the Jupyter Notebook is an interactive environment for writing and running code. Jupyter is capable of running code in a wide range of languages. However, this notebook, and the default kernel in Jupyter, runs Python code."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Code cells allow you to enter and run Python code"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Run a code cell using `Shift-Enter` or pressing the <button class='btn btn-default btn-xs'><i class=\"icon-play fa fa-play\"></i></button> button in the toolbar above:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "a = 10"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "print(a + 1)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note the difference between the above printing statement and the operation below:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "a + 1"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "When a value is *returned* by a computation, it is displayed with a number, that tells you this is the output value of a given cell.  You can later refere to any of these values (should you need one that you forgot to assign to a named variable). The last three are available respectively as auto-generated variables called `_`, `__` and `___` (one, two and three underscores). In addition to these three convenience ones for recent results, you can use `_N`, where N is the number in `[N]`, to access any numbered output."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There are two other keyboard shortcuts for running code:\n",
    "\n",
    "* `Alt-Enter` runs the current cell and inserts a new one below.\n",
    "* `Ctrl-Enter` run the current cell and enters command mode."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Managing the IPython Kernel"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Code is run in a separate process called the IPython Kernel.  The Kernel can be interrupted or restarted.  Try running the following cell and then hit the <button class='btn btn-default btn-xs'><i class='icon-stop fa fa-stop'></i></button> button in the toolbar above."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import time\n",
    "time.sleep(10)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If the Kernel dies you will be prompted to restart it. Here we call the low-level system libc.time routine with the wrong argument via\n",
    "ctypes to segfault the Python interpreter:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import sys\n",
    "from ctypes import CDLL\n",
    "# This will crash a Linux or Mac system\n",
    "# equivalent calls can be made on Windows\n",
    "dll = 'dylib' if sys.platform == 'darwin' else 'so.6'\n",
    "libc = CDLL(\"libc.%s\" % dll) \n",
    "libc.time(-1)  # BOOM!!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Cell menu"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The \"Run\" menu has a number of items for running code in different ways, including\n",
    "\n",
    "* Run Selected Cells\n",
    "* Run All Cells\n",
    "* Run Selected Cell or Current Line in Console\n",
    "* Run All Above Selected Cell\n",
    "* Run  Selected Cell and All Below\n",
    "* Restart Kernel and Run All Cells"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Restarting the kernels"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The kernel maintains the state of a notebook's computations. You can reset this state by restarting the kernel. This is done by clicking on the <button class='btn btn-default btn-xs'><i class='fa fa-repeat icon-repeat'></i></button> in the toolbar above."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## sys.stdout and sys.stderr"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The stdout and stderr streams are displayed as text in the output area."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "print(\"hi, stdout\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from __future__ import print_function\n",
    "print('hi, stderr', file=sys.stderr)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Output is asynchronous"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "All output is displayed as it is generated in the Kernel: instead of blocking on the execution of the entire cell, output is made available to the Notebook immediately as it is generated by the kernel (even though the whole cell is submitted for execution as a single unit).\n",
    "\n",
    "If you execute the next cell, you will see the output one piece at a time, not all at the end:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import time, sys\n",
    "for i in range(8):\n",
    "    print(i)\n",
    "    time.sleep(0.5)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Large outputs"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To better handle large outputs, the output area can be collapsed. Run the following cell and then click on the vertical blue bar to the left of the output:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "for i in range(50):\n",
    "    print(i)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "# Markdown Cells\n",
    "\n",
    "Text can be added to IPython Notebooks using Markdown cells.  Markdown is a popular markup language that is a superset of HTML. Its specification can be found here:\n",
    "\n",
    "<http://daringfireball.net/projects/markdown/>\n",
    "\n",
    "You can view the source of a cell by double clicking on it, or while the cell is selected in command mode, press `Enter` to edit it. One A cell has been editted, use `Shift-Enter` to re-render it. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Markdown basics\n",
    "\n",
    "You can make text *italic* or **bold**."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can build nested itemized or enumerated lists:\n",
    "\n",
    "* One\n",
    "    - Sublist\n",
    "        - This\n",
    "  - Sublist\n",
    "        - That\n",
    "        - The other thing\n",
    "* Two\n",
    "  - Sublist\n",
    "* Three\n",
    "  - Sublist\n",
    "\n",
    "Now another list:\n",
    "\n",
    "1. Here we go\n",
    "    1. Sublist\n",
    "    2. Sublist\n",
    "2. There we go\n",
    "3. Now this"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can add horizontal rules:\n",
    "\n",
    "---"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here is a blockquote:\n",
    "\n",
    "> Beautiful is better than ugly.\n",
    "> Explicit is better than implicit.\n",
    "> Simple is better than complex.\n",
    "> Complex is better than complicated.\n",
    "> Flat is better than nested.\n",
    "> Sparse is better than dense.\n",
    "> Readability counts.\n",
    "> Special cases aren't special enough to break the rules.\n",
    "> Although practicality beats purity.\n",
    "> Errors should never pass silently.\n",
    "> Unless explicitly silenced.\n",
    "> In the face of ambiguity, refuse the temptation to guess.\n",
    "> There should be one-- and preferably only one --obvious way to do it.\n",
    "> Although that way may not be obvious at first unless you're Dutch.\n",
    "> Now is better than never.\n",
    "> Although never is often better than *right* now.\n",
    "> If the implementation is hard to explain, it's a bad idea.\n",
    "> If the implementation is easy to explain, it may be a good idea.\n",
    "> Namespaces are one honking great idea -- let's do more of those!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And shorthand for links:\n",
    "\n",
    "[IPython's website](http://ipython.org)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can add headings using Markdown's syntax:\n",
    "\n",
    "# Heading 1\n",
    "\n",
    "# Heading 2\n",
    "\n",
    "## Heading 2.1\n",
    "\n",
    "## Heading 2.2"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Embedded code\n",
    "\n",
    "You can embed code meant for illustration instead of execution in Python:\n",
    "\n",
    "    def f(x):\n",
    "        \"\"\"a docstring\"\"\"\n",
    "        return x**2\n",
    "\n",
    "or other languages:\n",
    "\n",
    "    if (i=0; i<n; i++) {\n",
    "      printf(\"hello %d\\n\", i);\n",
    "      x += 4;\n",
    "    }"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "## LaTeX equations\n",
    "\n",
    "Courtesy of MathJax, you can include mathematical expressions both inline: \n",
    "$e^{i\\pi} + 1 = 0$  and displayed:\n",
    "\n",
    "$$e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i$$\n",
    "\n",
    "Use single dolars delimiter for inline math, so `$thisisinline\\int math$`  will give $this is inline\\int math$, for example to refer to variable within text. \n",
    "\n",
    "Double dollars `$$\\int_0^{2\\pi} f(r, \\phi) \\partial \\phi $$` is used for standalone formulas:\n",
    "\n",
    "$$\\int_0^{2\\pi} f(r, \\phi) \\partial \\phi $$\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Github flavored markdown (GFM)\n",
    "\n",
    "The Notebook webapp support Github flavored markdown meaning that you can use triple backticks for code blocks \n",
    "<pre>\n",
    "```python\n",
    "print \"Hello World\"\n",
    "```\n",
    "\n",
    "```javascript\n",
    "console.log(\"Hello World\")\n",
    "```\n",
    "</pre>\n",
    "\n",
    "Gives \n",
    "```python\n",
    "print \"Hello World\"\n",
    "```\n",
    "\n",
    "```javascript\n",
    "console.log(\"Hello World\")\n",
    "```\n",
    "\n",
    "And a table like this : \n",
    "\n",
    "<pre>\n",
    "| This | is   |\n",
    "|------|------|\n",
    "|   a  | table| \n",
    "</pre>\n",
    "\n",
    "A nice HTML Table\n",
    "\n",
    "| This | is   |\n",
    "|------|------|\n",
    "|   a  | table| "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## General HTML\n",
    "\n",
    "Because Markdown is a superset of HTML you can even add things like HTML tables:\n",
    "\n",
    "<table>\n",
    "<tr>\n",
    "<th>Header 1</th>\n",
    "<th>Header 2</th>\n",
    "</tr>\n",
    "<tr>\n",
    "<td>row 1, cell 1</td>\n",
    "<td>row 1, cell 2</td>\n",
    "</tr>\n",
    "<tr>\n",
    "<td>row 2, cell 1</td>\n",
    "<td>row 2, cell 2</td>\n",
    "</tr>\n",
    "</table>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Local files\n",
    "\n",
    "If you have local files in your Notebook directory, you can refer to these files in Markdown cells directly:\n",
    "\n",
    "    [subdirectory/]<filename>\n",
    "\n",
    "For example, in the images folder, we have the Python logo:\n",
    "\n",
    "    <img src=\"images/python-logo.svg\" />\n",
    "\n",
    "<img src=\"images/python-logo.svg\" />\n",
    "\n",
    "and a video with the HTML5 video tag:\n",
    "\n",
    "    <video controls src=\"images/animation.m4v\" />\n",
    "\n",
    "<video controls src=\"images/animation.m4v\" />\n",
    "\n",
    "These do not embed the data into the notebook file, and require that the files exist when you are viewing the notebook."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Security of local files\n",
    "\n",
    "Note that this means that the IPython notebook server also acts as a generic file server\n",
    "for files inside the same tree as your notebooks.  Access is not granted outside the\n",
    "notebook folder so you have strict control over what files are visible, but for this\n",
    "reason it is highly recommended that you do not run the notebook server with a notebook\n",
    "directory at a high level in your filesystem (e.g. your home directory).\n",
    "\n",
    "When you run the notebook in a password-protected manner, local file access is restricted\n",
    "to authenticated users unless read-only views are active."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "# Typesetting Equations\n",
    "\n",
    "The Markdown parser included in IPython is MathJax-aware.  This means that you can freely mix in mathematical expressions using the [MathJax subset of Tex and LaTeX](http://docs.mathjax.org/en/latest/tex.html#tex-support).  \n",
    "\n",
    "You can use single-dollar signs to include inline math, e.g. `$e^{i \\pi} = -1$` will render as $e^{i \\pi} = -1$, and double-dollars for displayed math:\n",
    "\n",
    "```\n",
    "$$\n",
    "e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i\n",
    "$$\n",
    "```\n",
    "\n",
    "renders as:\n",
    "\n",
    "$$\n",
    "e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i\n",
    "$$\n",
    "\n",
    "You can also use more complex LaTeX constructs for displaying math, such as:\n",
    "\n",
    "```\n",
    "\\begin{align}\n",
    "\\dot{x} & = \\sigma(y-x) \\\\\n",
    "\\dot{y} & = \\rho x - y - xz \\\\\n",
    "\\dot{z} & = -\\beta z + xy\n",
    "\\end{align}\n",
    "```\n",
    "\n",
    "to produce the Lorenz equations:\n",
    "\n",
    "\\begin{align}\n",
    "\\dot{x} & = \\sigma(y-x) \\\\\n",
    "\\dot{y} & = \\rho x - y - xz \\\\\n",
    "\\dot{z} & = -\\beta z + xy\n",
    "\\end{align}\n",
    "\n",
    "Please refer to the MathJax documentation for a comprehensive description of which parts of LaTeX are supported, but note that Jupyter's support for LaTeX is **limited to mathematics**. You can **not** use LaTeX typesetting constrcuts for text or document structure, for text formatting you should restrict yourself to Markdown syntax."
   ]
  }
 ],
 "metadata": {
  "celltoolbar": "Slideshow",
  "kernelspec": {
   "display_name": "Python 3",
   "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.7.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}