Replace all files with notebooks, update README, add requirements.

Author: rpalo

numpy-tutorial/README.md

@@ -1,3 +1,21 @@
-# Code Materials for the Numpy Tutorial
+# Numpy Tutorial: First Steps in Data Science
 
-These are code resources for the Numpy Tutorial article by @rpalo.
+This folder contains the sample code for the [NumPy Tutorial](https://realpython.com/numpy-tutorial/) by @rpalo.
+
+## Installing
+
+First, you will need to have the dependencies installed:
+
+```shell
+$ python -m pip install -r requirements.txt
+```
+
+## Usage
+
+These examples all make use of the [Jupyter Notebook](https://jupyter-notebook.readthedocs.io/en/stable/).  To the examples, make sure the correct virtual environment is active (you may have to deactivate and reactivate after installing requirements), and run:
+
+```shell
+$ jupyter notebook
+```
+
+You should see listings for each of the example files.  You can open them up and run them cell by cell to see how they perform.  Feel free to make small changes to the code to see how those affect things.

numpy-tutorial/curve_grades.ipynb

@@ -0,0 +1,114 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Curving Grades\n",
+    "\n",
+    "You'll be playing the part of a teacher, curving test grades to account for an unfortunately difficult test.  The curving should improve the student's grade relative to where they ended up with respect to the group's average.  It should also *not* hurt the student by reducing their grade, and it shouldn't give anyone anything over 100%."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "CURVE_CENTER = 80"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def curve(grades):\n",
+    "    \"\"\"Adjusts an array of grades so that the average is roughly shifted\n",
+    "    to the specified curve center.\n",
+    "\n",
+    "    This will never cause a student's grade to decrease, and it will\n",
+    "    never cause the final grade to go over 100%.\n",
+    "\n",
+    "    Parameters:\n",
+    "        grades (np.ndarray): The individual student grades, between 0\n",
+    "                             and 100.\n",
+    "\n",
+    "    Returns:\n",
+    "        (np.ndarray): A new array of grades, adjusted upwards, but in\n",
+    "                      the same order.\n",
+    "    \"\"\"\n",
+    "    average = grades.mean()\n",
+    "    change = CURVE_CENTER - average\n",
+    "    new_grades = grades + change\n",
+    "    return np.clip(new_grades, grades, 100)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([[ 91.25,  54.25,  83.25, 100.  ,  70.25, 100.  ,  93.25,  31.25]])"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "grades = np.array([[72, 35, 64, 88, 51, 90, 74, 12]])\n",
+    "curve(grades)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Note how none of the grades are decreased or greater than 100%!"
+   ]
+  },
+  {
+   "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.8.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

numpy-tutorial/curve_grades.py

@@ -0,0 +1,102 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Validating Dürer's Magic Square\n",
+    "\n",
+    "Albrecht Dürer was an artist and mathematician who created an engraving of a [magic square](https://mathworld.wolfram.com/DuerersMagicSquare.html), where lots of bits all add up to the same thing.  Each row, column, quadrant, corners, etc. all add up to 34.\n",
+    "\n",
+    "At the bottom, you see 15 and 14, signifying the year it was engraved (1514) as well as 4 and 1, standing for D and A, the creator's initials.\n",
+    "\n",
+    "You're going to validate that everything does, in fact, add up."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([[16,  3,  2, 13],\n",
+       "       [ 5, 10, 11,  8],\n",
+       "       [ 9,  6,  7, 12],\n",
+       "       [ 4, 15, 14,  1]])"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "square = np.array([\n",
+    "    [16, 3, 2, 13],\n",
+    "    [5, 10, 11, 8],\n",
+    "    [9, 6, 7, 12],\n",
+    "    [4, 15, 14, 1],\n",
+    "])\n",
+    "square"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "All assertions passed!\n"
+     ]
+    }
+   ],
+   "source": [
+    "for i in range(4):\n",
+    "    assert square[i, :].sum() == 34\n",
+    "    assert square[:, i].sum() == 34\n",
+    "    \n",
+    "assert square[:2, :2].sum() == 34\n",
+    "assert square[2:, :2].sum() == 34\n",
+    "assert square[:2, 2:].sum() == 34\n",
+    "assert square[2:, 2:].sum() == 34\n",
+    "\n",
+    "print(\"All assertions passed!\")"
+   ]
+  }
+ ],
+ "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.8.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}