0_running_Jupyter_notebooks.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Running a Jupyter notebook"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This practical uses Jupyter notebooks, which are a great tool to organize, explain, and share your computational analyses and conclusions.  Jupyter notebooks can handle many coding languages, including R and python, both of which we will use today.  \n",
    "\n",
    "### Let's spend a few minutes understanding how to navigate a Jupyter notebook."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 0. Always save the code!\n",
    "Press the key **S** from time to time, as a routine."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 1. Each one of these windows is a cell.  A cell can be one of two types:\n",
    "\n",
    "1. _Markdown_ - used for typing text (m)\n",
    "2. _Code_ - used for writing and running code (y)\n",
    "\n",
    "Select this cell, press esc, and then press m (markdown) and then y (code).  The color coding changes, and in\n",
    "code mode (y), you will see In [ ]: next to the window.  End in markdown mode (m), then press shift-return.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 2. To run a cell, press shift-return\n",
    "\n",
    "Try changing the cell types of these first windows and running them.  \n",
    "If you try to run these cells in code (y) mode, you will get errors."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 3. Cells can be in one of two modes:\n",
    "\n",
    "### Edit Mode (Press Enter to enable)\n",
    "← GREEN outlined cell.  \n",
    "You can edit cell contents.\n",
    "\n",
    "### Command Mode (Press Esc to enable)\n",
    "←  BLUE outlined cell.  \n",
    "You can command the entire cell. For example, you can move up and down between cells with the arrow keys and change the cell type with m and y (as we have seen).  \n",
    "> **Note:** Command mode doesn't mean that cell is evaluated\n",
    "\n",
    "\n",
    "#### Try switching this cell between command and edit modes."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 4. Useful shortcuts\n",
    "\n",
    "They work in the **Command Mode** only\n",
    "\n",
    "- M: Change cell to Markdown\n",
    "- Y: Change cell to Code\n",
    "<br>\n",
    "<br>\n",
    "- A: Insert cell above\n",
    "- B: Insert cell below\n",
    "- D, D (Press the D key twice): Delete selected cells\n",
    "<br>\n",
    "<br>\n",
    "- C: Copy cell\n",
    "- X: Cut cell\n",
    "- V: Paste cell below\n",
    "- Shift + V: Paste cell above\n",
    "- Shift + M: Merge selected cells or merge cell below if only one cell is selected\n",
    "<br>\n",
    "<br>\n",
    "- Z: Undo last cell operation\n",
    "- S: Save and checkpoint\n",
    "\n",
    "#### Try adding some blank cells. To erase a cell, click on it, hit esc to get into command mode, and press dd"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 5. Now let's run some code.\n",
    "\n",
    "Notebooks have a kernel - the underlying process that actually runs the code.  For this notebook, the kernel is R, but we will also use a python kernel later today.  If you get a message about the kernel crashing or needing to restart, don't panic.  Any variables you have already set will be lost, but you will be able to easily restarst the kernel and rerun the code to get them back.  If this happens, just let me know!\n",
    "\n",
    "Run the following code cells by pressing:\n",
    "- Shift + Enter: Run cell and select cell below\n",
    "- Ctrl + Enter: Run cell\n",
    "- Alt + Enter: Run cell and insert new cell below\n",
    "\n",
    "While a code cell is running, an asterisk [*] will appear in the brackets to the left of the cell.  When it is done, a number will appear inside the brackets to denote the order in which the cell was run."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 4. To get a new cell, press esc to get into command mode and then A or B, depending on whether you want a cell above or below the current one.\n",
    "\n",
    "Try adding some blank cells.  To erase a cell, click on it, hit esc to get into command mode, and press dd"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      " [1]  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15\n"
     ]
    }
   ],
   "source": [
    "## This is a code cell\n",
    "genotype <- seq(1,15,1)\n",
    "print(genotype)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      " [1]  7  8 12 13 13  7 11  6  4 12 12 15  6  3 13\n"
     ]
    }
   ],
   "source": [
    "phenotype <- sample(1:20,15, replace=TRUE)\n",
    "print(phenotype)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### What happens if we make a plot?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA0gAAANICAYAAAD958/bAAAEDmlDQ1BrQ0dDb2xvclNwYWNl\nR2VuZXJpY1JHQgAAOI2NVV1oHFUUPpu5syskzoPUpqaSDv41lLRsUtGE2uj+ZbNt3CyTbLRB\nkMns3Z1pJjPj/KRpKT4UQRDBqOCT4P9bwSchaqvtiy2itFCiBIMo+ND6R6HSFwnruTOzu5O4\na73L3PnmnO9+595z7t4LkLgsW5beJQIsGq4t5dPis8fmxMQ6dMF90A190C0rjpUqlSYBG+PC\nv9rt7yDG3tf2t/f/Z+uuUEcBiN2F2Kw4yiLiZQD+FcWyXYAEQfvICddi+AnEO2ycIOISw7UA\nVxieD/Cyz5mRMohfRSwoqoz+xNuIB+cj9loEB3Pw2448NaitKSLLRck2q5pOI9O9g/t/tkXd\na8Tbg0+PszB9FN8DuPaXKnKW4YcQn1Xk3HSIry5ps8UQ/2W5aQnxIwBdu7yFcgrxPsRjVXu8\nHOh0qao30cArp9SZZxDfg3h1wTzKxu5E/LUxX5wKdX5SnAzmDx4A4OIqLbB69yMesE1pKojL\njVdoNsfyiPi45hZmAn3uLWdpOtfQOaVmikEs7ovj8hFWpz7EV6mel0L9Xy23FMYlPYZenAx0\nyDB1/PX6dledmQjikjkXCxqMJS9WtfFCyH9XtSekEF+2dH+P4tzITduTygGfv58a5VCTH5Pt\nXD7EFZiNyUDBhHnsFTBgE0SQIA9pfFtgo6cKGuhooeilaKH41eDs38Ip+f4At1Rq/sjr6NEw\nQqb/I/DQqsLvaFUjvAx+eWirddAJZnAj1DFJL0mSg/gcIpPkMBkhoyCSJ8lTZIxk0TpKDjXH\nliJzZPO50dR5ASNSnzeLvIvod0HG/mdkmOC0z8VKnzcQ2M/Yz2vKldduXjp9bleLu0ZWn7vW\nc+l0JGcaai10yNrUnXLP/8Jf59ewX+c3Wgz+B34Df+vbVrc16zTMVgp9um9bxEfzPU5kPqUt\nVWxhs6OiWTVW+gIfywB9uXi7CGcGW/zk98k/kmvJ95IfJn/j3uQ+4c5zn3Kfcd+AyF3gLnJf\ncl9xH3OfR2rUee80a+6vo7EK5mmXUdyfQlrYLTwoZIU9wsPCZEtP6BWGhAlhL3p2N6sTjRdd\nuwbHsG9kq32sgBepc+xurLPW4T9URpYGJ3ym4+8zA05u44QjST8ZIoVtu3qE7fWmdn5LPdqv\ngcZz8Ww8BWJ8X3w0PhQ/wnCDGd+LvlHs8dRy6bLLDuKMaZ20tZrqisPJ5ONiCq8yKhYM5cCg\nKOu66Lsc0aYOtZdo5QCwezI4wm9J/v0X23mlZXOfBjj8Jzv3WrY5D+CsA9D7aMs2gGfjve8A\nrD6mePZSeCfEYt8CONWDw8FXTxrPqx/r9Vt4biXeANh8vV7/+/16ffMD1N8AuKD/A/8leAvF\nY9bLAAAAOGVYSWZNTQAqAAAACAABh2kABAAAAAEAAAAaAAAAAAACoAIABAAAAAEAAANIoAMA\nBAAAAAEAAANIAAAAAN/ryxkAAEAASURBVHgB7N0H2HRleSfwD6mCghRFrNgSe2wkolE0YnKp\nMWrsu3Gjq5i4UbNJ3MSyEY1l1xSNJbZde9S1l4iKvWvsNYANBTQRowICUmX/t87El2Haeb8p\nZ875Pdf1Z2bOeeac8/ye4f3mfufMeXfs0AgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAIHWC+zS+iPszwHeIkPd\nvT/DNVICBAgQIECAAIEOCZyXsXymC+NRILVjFqs4+lQ7DsVRECBAgAABAgQIENiWQL2n3fgi\n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\ngAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBA\ngAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBA\ngAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBA\ngAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBA\ngAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQIECBA\ngAABAgQIECBAgAABAgQIECBAgAABAgQIECBAgAABAgQI/P/27j52u3qOA7j0oFCoEJYsiknP\nDPN001oYW22piBppYQ3TGJvNNGzY8ocxZtMaGkbmaYuRh5E1YiZEVllF6UERPZC833W+c3a6\nunXL9uv+3a/P9r7POd9zrnOd8+qP7k/fc64IECBAgAABAgQIECCwFNh6OWCbAAECBAhsIQLb\n5j5PSXZPfrmF3LPbJECAAAECBAgQIECAwEqBYzN6e3LCyr0GCRAgQGCLFLj/FnnXbpoAAQIE\nCBAgQIAAAQIrBDxitwLFEAECBAj8zwLb55OHJCcmeydXJQ9NDk+uSf6ajNomKy9NjkkOS3ZJ\nLk7+mcxrQzaelvwqOSh5edLzPTy5KLktWdY+GegM0dHJE5NbkiuTUc/JykuSpya9rocl3X9k\n8pik513W/hl4YdJ76uN5PffN03rvodvbJZcny3vI0B21V/58WdJr63XdlPR8igABAgQIECBA\ngACBdSbwpNzPn5M+tnZ1cmtyXfLxpGNtLkbtmZXzko7fkLRJ6XqboP2SeZ2VjT8kb0n+lfwj\n6bHNT5Odk3mdlo02KD22n+uyTVTH25S1PpOMc3TZY9qwXJi0aXlIsqzvZqAN3oOS/ZJ+7qPJ\nFclfkl8nPc/1SS2W1fed2qj1mMuSXmOv673JVokiQIAAAQIECBAgQGCdCOyU+2hz0UbnBdM9\n7ZDlx5LRiLxoGm8z8OOkzcErk9EcHJr1a5PfJJ2JGXVWVtpU/Cl5XdLZnt2SryU99zuSUa/J\nSsfOTh45De6a5VeSjrdJGdVZnI7N30F6+4qxHv+4pNdwetIaDVI//6lkXG9npHqdFyY1GdWZ\nsh77veTR0+COWZ6ZdPz4acyCAAECBAgQIECAAIF1IPD63EP/ot8GZl591/WCpPtGg3TMtP3V\nLJd1agZ67EmzHW2QlmPd/eRpvPtbbbQ6g9UmazkD1FmfPyZjBiirdzzm1vPOG6Q2L53Z+U4y\nr3dmo8c+bxocDVJnqLafxsbi5Kz02BPHQJZtmDp28Gysq72uvyc9z2gUs6oIECBAYK0E+i8u\nRYAAAQIE7q3A+Iv/lxYn6qzLFxdjz5i2z8myjcY8fcSu1ZmYZZ27GLh02t5pWu6RZd93+nrS\nx/bm9bds9NoenKx6/G0c20blm0kbod3HYJbHJZck35+NdfWs5ObFWGerWgfeubjjmvr4Xt9r\n6uOB8/t9fLY7m/aoZMwsZVURIECAwFoJjGex1+r7fS8BAgQIrA+B/XMb/cv/VStu57LF2F7T\n9mmL8fnmE+Yb0/qVi7HRmIz/2NcmpPX7Oxd3+XOM99zn32XvfwZOz2pnu16RvD9pQ9drfndy\nezKvcc752BXZ6HH7ToPjfrv8+TS2atHr6mcVAQIECKyhgAZpDfF9NQECBNaRwI25l22THZM+\nxjav5eNuo7HpO0CrGqp+tj96sKzORm2sOkvU6mNrq6rX1hrff+fWXf/sDNB1Sa+vDdKrkjY8\nZyTL2m45kO1+z1bJaOjG930jYx9M7q76KKIiQIAAgTUW0CCt8T8AX0+AAIF1InBh7mND0pmk\nHyTzOmC+kfXfTtttgr692NdH5Pp43WguFrs3unnRtLfvJq2qMb5q1md+/C3ZODPpu0R7J4cn\nfbTukmRZY3ZoPj4e4Tt/Gvxdlm2wdk2W99tDnp7cliwby+5TBAgQIECAAAECBAhshgJtjDrD\n0wbgAbPrPyjrffSuDUIfW2s9M+mx5yZbJ/P6dDZ67FGzwb7n07FdZmNd7aN1HT+nG1P9KMue\nu03WvJ6Sjf74wsVJZ3da/Y5+/o3dWFSvu/s+Py1fvdi/3zTeH1hYvjv0hYz1Gnqfo87OSs/3\n4jEwLffJsg1ZH73rDJwiQIAAAQIECBAgQGCdCJyW+2gT8IvkfcknkjYQVycdPywZ9cmsdKyz\nTUcnRyRnJB37cjKvTWmQDs4Hb02uT05JDknelFw7pY3cqA1Z6fd1RquP0u2ezKtNS/ffmPTH\nHeY1GqTub9N1XNLm53NJx/qrd/Pq+1E3TXlXlocmb0s6u9TGbdnQZUgRIECAAAECBAgQILC5\nC5yUG/hhckPys+QNyXuSNg3PSkZ19uetSRuZ7ms669LZl92SeW1Kg9TPHZj8JBnnbZP2raSz\nQvPaJhufTcYM15HznVl/c9JztHFb1miQTs+OnqOPyPXYS5NTk1XVR+/6qN44tsdfnhyfKAIE\nCBAgQIAAAQIE1pFAZ1iWj8uN2/tIVtoMjHdzxvhYPjYrndnZaQz8n5Y9XxuZ7f7L+XbI/kes\nOObkjPW6N6zYNxqkD0/7+l19X+me1ANz0AHJHsndmd2T8ziGAAECBAgQIECAAIH7qMBrc119\ntO2ExfV1Nui65Jqks0abS3V26YKkj9+Nd5bm175skOb7rBMgQIDAZizQfwEoAgQIECBwbwX6\nCNvNSd/l6UxRH7PrDxD0/aLOrhyb9BG6+3o9PxfYd4menfT6+25RZ5EUAQIECBAgQIAAAQIE\nNknguTl6/u5Pf53tvOSoTTrL2h58RL6+DVFnwz6wkUvZN/t6fx/ayDF2ESBAgAABAgQIECBA\n4H47x6CzL9tvhhZ9nG7PpP+zV0WAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ\nIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQ2EwE/g2hZqQHCoBKtAAAAABJRU5ErkJggg==",
      "text/plain": [
       "plot without title"
      ]
     },
     "metadata": {
      "image/png": {
       "height": 420,
       "width": 420
      }
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plot(genotype, phenotype)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 5. Comment your code\n",
    "\n",
    "Surround your code with brief and clear comments that explain the purpose, functionality, and intricacies of the code. Ensure that these comments provide insight to other developers (or your future self) without overwhelming or repeating information that's evident from the code itself.\n",
    "\n",
    "### Guidelines for Effective Commenting:\n",
    "\n",
    "1. **Purpose Over How**:\n",
    "   - Comment on why the code is doing something, rather than how it's doing it, unless the method is unconventional.\n",
    "   \n",
    "2. **Keep It Relevant**:\n",
    "   - Outdated comments can be more confusing than no comments at all. Update comments as you update your code.\n",
    "\n",
    "3. **Avoid Obvious Comments**:\n",
    "   - Don't write comments that just repeat what the code does, e.g., `x = x + 1  # Adding 1 to x`.\n",
    "\n",
    "4. **Use Inline Comments Sparingly**:\n",
    "   - These are comments inside a line of code. They can be useful, but overuse can make the code look cluttered.\n",
    "\n",
    "5. **Function/Method Comments**:\n",
    "   - Describe what the function/method does, its parameters, return values, and any exceptions it might raise.\n",
    "\n",
    "6. **Avoid Large Comment Blocks**:\n",
    "   - It's usually better to break up the code and comment each piece rather than having a large chunk of code followed by a large comment block.\n",
    "\n",
    "> **Note**: The specific syntax for adding comments varies by programming language. Always adapt your commenting style to the conventions and best practices of the particular programming language you're working with.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 6. Variable names\n",
    "\n",
    "General conventions:\n",
    "- Use names that are meaningful and describe the content of the object.\n",
    "- Avoid using names that overlap with the functions of the base R package.\n",
    "\n",
    "\n",
    "### 6.2 R \n",
    "\n",
    "In the R programming language, there are no specific naming conventions.  \n",
    "\n",
    "\n",
    "- **Variables**: typically written in lowercase with underscores or dots between words (e.g., `my.variable`). \n",
    "- **Functions**: typically written in lowercase (with underscores or dots), but could be in `functionInCamelCase`. \n",
    "\n",
    "\n",
    "### 6.1 Python Naming Convention PEP 8\n",
    "\n",
    "Python has naming conventions [PEP 8](https://peps.python.org/pep-0008/) that specify when and how to use a particular case:\n",
    "\n",
    "- **Variables and functions**: typically named in lowercase with underscores between words, for example, `my_variable`, `calculate_sum`.\n",
    "- **Classes**: use CamelCase (or CapWords), for example, `MyClass`, `DataLoader`.\n",
    "- **Constants**: typically named in uppercase with underscores between words, for example, `PI`, `MAX_SIZE`."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## That's it!  Now we're ready to start with notebook 1_phenotype_exploration.ipynb.\n",
    "\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "R",
   "language": "R",
   "name": "ir"
  },
  "language_info": {
   "codemirror_mode": "r",
   "file_extension": ".r",
   "mimetype": "text/x-r-source",
   "name": "R",
   "pygments_lexer": "r",
   "version": "4.0.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}