Inleiding-Jupyter.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Inleiding Jupyter Notebooks"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Voor het oefenen met SQL in Python gebruiken we [Jupyter Notebooks](https://jupyter.org).\n",
    "Hiermee kun je op een interactieve manier aan de slag, waarbij je alle vrijheden hebt om je eigen varianten uit te proberen."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Een notebook bestaan uit cellen.\n",
    "Er zijn twee soorten cellen: **Code** en **Markdown**. \n",
    "Het type van de huidige cel vind je in de interface-balk bovenin.\n",
    "Met dit menu kun je ook het type van de cel veranderen.\n",
    "Je selecteert een cel door op de cel te klikken - of door te klikken in de kantlijn links.\n",
    "\n",
    "Deze cel is een Markdown cel, de volgende cel is een (Python) code cel."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "2 + 3 * 4"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Je brengt een cel in de *edit-mode* door een dubbel-klik in de cel.\n",
    "Je kunt dan de inhoud van de cel aanpassen."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Je *voert een geselecteerde cel uit* (*Run*) door op het pijl-symbool bovenin te klikken, of door SHIFT-RETURN.\n",
    "\n",
    "* Het uitvoeren van een Markdown-cel resulteert in het formatteren van de tekst.\n",
    "* Het uitvoeren van een Code-cel resulteert in het uitvoeren van de code."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Opdrachten\n",
    "\n",
    "1. pas de tekst in deze cel aan (double-click: edit-mode) en voer deze cel uit.\n",
    "2. pas de tekst van de cel hieronder aan en voer die cel uit.\n",
    "3. verander het type van de cel hieronder (via het menu bovenin) en voer die cel uit.\n",
    "   Let op het verschil tussen (2) en (3)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "2 + 3 * 4"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Code: samengestelde opdrachten\n",
    "\n",
    "Je kunt in een cel willekeurige stukken Python-code opnemen, inclusief import-opdrachten, functie-definities, enz.\n",
    "De definities en declaraties kun je in de volgende cellen weer gebruiken:\n",
    "op die manier kun je een groter programma stap voor stap opbouwen.\n",
    "\n",
    "De laatste expressie van een cel wordt als resultaat van de cel daaronder getoond."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "def succ(x):\n",
    "    return x+1\n",
    "\n",
    "succ(3)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Code werkt over meerdere cellen\n",
    "\n",
    "Code die je uitvoert kan een zij-effect: bijvoorbeeld het definiëren van een functie of een variabele.\n",
    "Het resultaat van dit zij-effect blijft bewaard en kun je gebruiken bij de uitvoering van een volgende cel.\n",
    "We gebruiken dit later om een groter programma in kleinere delen te presenteren.\n",
    "\n",
    "De onderstaande expressie gebruikt de functie die je hierboven gedefinieerd hebt:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "x = succ(5)\n",
    "x"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "En de cel hieronder gebruikt de variabele die je hiervoor gedefinieerd hebt:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "succ(x)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Code: shell-opdrachten in Python\n",
    "\n",
    "In Python-code (in Jupyter Notebooks) kun je ook shell-opdrachten uitvoeren.\n",
    "Deze worden dan uitgevoerd in het onderliggende operating system.\n",
    "Het resultaat van zo'n opdracht kun je weer in Python verwerken.\n",
    "\n",
    "Een shell-opdracht geef je aan met een `!`, bijvoorbeeld `!ls` \n",
    "(voor het opvragen van de namen van de bestanden in de huidige map)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "!ls"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "files = !ls\n",
    "files"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "len(files)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Kernel\n",
    "\n",
    "De code-cellen worden uitgevoerd door een *Kernel*-proces op de server.\n",
    "In ons geval is dat een Python-Kernel.\n",
    "Er zijn ook kernels voor andere programmeertalen beschikbaar.\n",
    "\n",
    "De toestand van de kernel wordt bepaald door de cellen die je uitvoert,\n",
    "in de volgorde zoals je die uitvoert.\n",
    "Dit is niet altijd de volgorde waarin ze in het Notebook staan.\n",
    "\n",
    "### Herstarten van de Kernel\n",
    "\n",
    "Als je allerlei experimenten uitgevoerd hebt, wil je soms weer \"met een schone lei beginnen\".\n",
    "Hiervoor kun je de Kernel herstarten via het menu bovenin.\n",
    "In het bijzonder is het handig om daarbij de uitvoer van alle cellen ook te verwijderen:\n",
    "dan is duidelijk wat er tot nu toe uitgevoerd is, en wat niet.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Learn Python - the hard way\n",
    "\n",
    "De cursus [Learn Python - the hard way](https://learnpythonthehardway.org) bevat allerlei opdrachten die letterlijk overgetypt moeten worden.\n",
    "De auteur legt er de nadruk op dat je die voorbeelden zelf moet intikken: van copy-paste leer je veel minder.\n",
    "Het intikken vraagt meer aandacht, en je maakt mogelijk leerzame fouten.\n",
    "\n",
    "In het materiaal gebruiken we zo nu en dan stukjes Python of SQL om over te tikken.\n",
    "Je zou gebruik kunnen maken van Copy-Paste, maar dan leer je er veel minder van.\n",
    "\n",
    "Tik de onderstaande code over in de volgende cel, en voer dan de cel uit\n",
    "\n",
    "```Python\n",
    "def pred(x):\n",
    "  return x-1\n",
    "  \n",
    "pred(succ(succ(3)))\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Volgorde\n",
    "\n",
    "Bij de opzet van de Notebooks proberen we de volgende regels te gebruiken.\n",
    "Deze verminderen de kans op fouten en verwarring.\n",
    "\n",
    "1. De volgorde van de cellen in het notebook is de natuurlijke volgorde: in principe voer je deze van voor naar achter uit.\n",
    "2. De code in een cel is zoveel mogelijk *idempotent*: het maakt niet uit of je deze één keer of vaker uitvoert.\n",
    "\n",
    "Regel (1) betekent dat als je een cel in het midden van een reeks cellen opnieuw uitvoert,\n",
    "dat je dan in principe de cellen daarna ook opnieuw moet uitvoeren.\n",
    "\n",
    "Regel (2) betekent dat je opdrachten van de vorm `x = x + 1` moet vermijden. Voer in zo'n geval een nieuwe variabele in: `x1 = x + 1` o.i.d.\n",
    "\n",
    "Soms doen we regel (2) geweld aan, bijvoorbeeld bij het veranderen van de inhoud van een database."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Tussenvoegen en verwijderen van cellen\n",
    "\n",
    "Je kunt een cel toevoegen na de huidge cel met het `+`-symbool in het interface bovenin.\n",
    "\n",
    "De huidige cel verwijder je met het schaar-symbool in het interface bovenin.\n",
    "(Met Z -undo cell operation- maak je dat weer ongedaan.)\n",
    "\n",
    "Je kunt een cel verplaatsen met behulp van het handvat in de linker kantlijn.\n",
    "(Dit werkt alleen voor de nieuwere JupyterLab, niet voor Jupyter Notebook.)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Samenvatting\n",
    "\n",
    "* een notebook bestaat uit cellen; een cel kan *tekst* bevatten (Markdown), zoals deze cel, of (Python) *code*, zoals de cellen hieronder.\n",
    "* je voert een cel uit door deze te selecteren (cursor-click in de cel), en vervolgens SHIFT-RETURN in te toetsen.\n",
    "  Ook het pijltje in de opdrachtenbalk hierboven kun je gebruiken.\n",
    "* onder de cel zie je dan de uitvoer van deze opdracht.\n",
    "* alle variabelen enz. die je introduceert in de code van een cel kun je in de volgende cellen gebruiken.\n",
    "* met een `!` kun je een shell-opdracht uitvoeren; het resultaat kun je in Python gebruiken (als string).\n",
    "* om problemen te voorkomen voer je cellen alleen uit *in de volgorde in het notebook*.\n",
    "* je kunt eventueel opnieuw beginnen door de \"Kernel\" opnieuw te starten (via het cirkeltje, als bij een reload in de browser).\n",
    "* zie voor meer informatie: help, en [tutorial](https://www.dataquest.io/blog/jupyter-notebook-tutorial/)\n",
    "\n",
    "De meeste code-cellen kun je zo uitvoeren; probeer de code en de uitvoer te begrijpen.\n",
    "Bij sommige opdrachten moet je de code aanpassen, en dan de cel uitvoeren."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Aan de slag!\n",
    "\n",
    "Nu kun je met de SQL/Python notebooks aan de slag, zie de [Inhoudsopgave](Inhoud.ipynb)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "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
}