TensorFlow_intro.ipynb

{
  "cells": [
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "WBk0ZDWY-ff8"
      },
      "source": [
        "<table align=\"center\">\n",
        "  <td align=\"center\"><a target=\"_blank\" href=\"http://introtodeeplearning.com\">\n",
        "        <img src=\"https://i.ibb.co/Jr88sn2/mit.png\" style=\"padding-bottom:5px;\" />\n",
        "      Visit MIT Deep Learning</a></td>\n",
        "  <td align=\"center\"><a target=\"_blank\" href=\"https://colab.research.google.com/github/aamini/introtodeeplearning/blob/master/lab1/Part1_TensorFlow.ipynb\">\n",
        "        <img src=\"https://i.ibb.co/2P3SLwK/colab.png\"  style=\"padding-bottom:5px;\" />Run in Google Colab</a></td>\n",
        "  <td align=\"center\"><a target=\"_blank\" href=\"https://github.com/aamini/introtodeeplearning/blob/master/lab1/Part1_TensorFlow.ipynb\">\n",
        "        <img src=\"https://i.ibb.co/xfJbPmL/github.png\"  height=\"70px\" style=\"padding-bottom:5px;\"  />View Source on GitHub</a></td>\n",
        "</table>\n",
        "\n",
        "\n",
        "# Copyright Information\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 1,
      "metadata": {
        "id": "3eI6DUic-6jo"
      },
      "outputs": [],
      "source": [
        "# Copyright 2024 MIT Introduction to Deep Learning. All Rights Reserved.\n",
        "#\n",
        "# Licensed under the MIT License. You may not use this file except in compliance\n",
        "# with the License. Use and/or modification of this code outside of MIT Introduction\n",
        "# to Deep Learning must reference:\n",
        "#\n",
        "# © MIT Introduction to Deep Learning\n",
        "# http://introtodeeplearning.com\n",
        "#"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "57knM8jrYZ2t"
      },
      "source": [
        "# Lab 1: Intro to TensorFlow and Music Generation with RNNs\n",
        "\n",
        "In this lab, you'll get exposure to using TensorFlow and learn how it can be used for solving deep learning tasks. Go through the code and run each cell. Along the way, you'll encounter several ***TODO*** blocks -- follow the instructions to fill them out before running those cells and continuing.\n",
        "\n",
        "\n",
        "# Part 1: Intro to TensorFlow\n",
        "\n",
        "## 0.1 Install TensorFlow\n",
        "\n",
        "TensorFlow is a software library extensively used in machine learning. Here we'll learn how computations are represented and how to define a simple neural network in TensorFlow. For all the labs in Introduction to Deep Learning 2023, we'll be using the latest version of TensorFlow, TensorFlow 2, which affords great flexibility and the ability to imperatively execute operations, just like in Python. You'll notice that TensorFlow 2 is quite similar to Python in its syntax and imperative execution. Let's install TensorFlow and a couple of dependencies.\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 2,
      "metadata": {
        "id": "LkaimNJfYZ2w",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "ba90f81a-59b9-4598-b5c7-4837519f7f08"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "\u001b[?25l     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/2.1 MB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m \u001b[32m2.1/2.1 MB\u001b[0m \u001b[31m118.6 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m2.1/2.1 MB\u001b[0m \u001b[31m53.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
            "\u001b[?25h  Preparing metadata (setup.py) ... \u001b[?25l\u001b[?25hdone\n",
            "  Building wheel for mitdeeplearning (setup.py) ... \u001b[?25l\u001b[?25hdone\n"
          ]
        }
      ],
      "source": [
        "import tensorflow as tf\n",
        "\n",
        "# Download and import the MIT Introduction to Deep Learning package\n",
        "!pip install mitdeeplearning --quiet\n",
        "import mitdeeplearning as mdl\n",
        "\n",
        "import numpy as np\n",
        "import matplotlib.pyplot as plt"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "2QNMcdP4m3Vs"
      },
      "source": [
        "## 1.1 Why is TensorFlow called TensorFlow?\n",
        "\n",
        "TensorFlow is called 'TensorFlow' because it handles the flow (node/mathematical operation) of Tensors, which are data structures that you can think of as multi-dimensional arrays. Tensors are represented as n-dimensional arrays of base dataypes such as a string or integer -- they provide a way to generalize vectors and matrices to higher dimensions.\n",
        "\n",
        "The ```shape``` of a Tensor defines its number of dimensions and the size of each dimension. The ```rank``` of a Tensor provides the number of dimensions (n-dimensions) -- you can also think of this as the Tensor's order or degree.\n",
        "\n",
        "Let's first look at 0-d Tensors, of which a scalar is an example:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 3,
      "metadata": {
        "id": "tFxztZQInlAB",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "74f721c4-9e5f-4746-d4ff-a2940b67a1d6"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "`sport` is a 0-d Tensor\n",
            "`number` is a 0-d Tensor\n"
          ]
        },
        {
          "output_type": "stream",
          "name": "stderr",
          "text": [
            "/usr/local/lib/python3.10/dist-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n",
            "  and should_run_async(code)\n"
          ]
        }
      ],
      "source": [
        "sport = tf.constant(\"Tennis\", tf.string)\n",
        "number = tf.constant(1.41421356237, tf.float64)\n",
        "\n",
        "print(\"`sport` is a {}-d Tensor\".format(tf.rank(sport).numpy()))\n",
        "print(\"`number` is a {}-d Tensor\".format(tf.rank(number).numpy()))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "-dljcPUcoJZ6"
      },
      "source": [
        "Vectors and lists can be used to create 1-d Tensors:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 4,
      "metadata": {
        "id": "oaHXABe8oPcO",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "3c044247-7e22-4c55-cf51-ed41ed332bfe"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "`sports` is a 1-d Tensor with shape: [2]\n",
            "`numbers` is a 1-d Tensor with shape: [3]\n"
          ]
        }
      ],
      "source": [
        "sports = tf.constant([\"Tennis\", \"Basketball\"], tf.string)\n",
        "numbers = tf.constant([3.141592, 1.414213, 2.71821], tf.float64)\n",
        "\n",
        "print(\"`sports` is a {}-d Tensor with shape: {}\".format(tf.rank(sports).numpy(), tf.shape(sports)))\n",
        "print(\"`numbers` is a {}-d Tensor with shape: {}\".format(tf.rank(numbers).numpy(), tf.shape(numbers)))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "gvffwkvtodLP"
      },
      "source": [
        "Next we consider creating 2-d (i.e., matrices) and higher-rank Tensors. For examples, in future labs involving image processing and computer vision, we will use 4-d Tensors. Here the dimensions correspond to the number of example images in our batch, image height, image width, and the number of color channels."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 5,
      "metadata": {
        "id": "tFeBBe1IouS3"
      },
      "outputs": [],
      "source": [
        "### Defining higher-order Tensors ###\n",
        "\n",
        "'''TODO: Define a 2-d Tensor'''\n",
        "matrix = tf.constant([[1, 2, 3],[4, 5, 6]], tf.int64)\n",
        "\n",
        "assert isinstance(matrix, tf.Tensor), \"matrix must be a tf Tensor object\"\n",
        "assert tf.rank(matrix).numpy() == 2"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 6,
      "metadata": {
        "id": "Zv1fTn_Ya_cz"
      },
      "outputs": [],
      "source": [
        "'''TODO: Define a 4-d Tensor.'''\n",
        "# Use tf.zeros to initialize a 4-d Tensor of zeros with size 10 x 256 x 256 x 3.\n",
        "#   You can think of this as 10 images where each image is RGB 256 x 256.\n",
        "images = tf.zeros([10, 256, 256, 3], tf.int32)\n",
        "\n",
        "assert isinstance(images, tf.Tensor), \"matrix must be a tf Tensor object\"\n",
        "assert tf.rank(images).numpy() == 4, \"matrix must be of rank 4\"\n",
        "assert tf.shape(images).numpy().tolist() == [10, 256, 256, 3], \"matrix is incorrect shape\""
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "wkaCDOGapMyl"
      },
      "source": [
        "As you have seen, the ```shape``` of a Tensor provides the number of elements in each Tensor dimension. The ```shape``` is quite useful, and we'll use it often. You can also use slicing to access subtensors within a higher-rank Tensor:"
      ]
    },
    {
      "cell_type": "code",
      "source": [
        "matrix"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "b5DddK2H3eSL",
        "outputId": "c2073029-bb90-4d39-fd83-8c7991508010"
      },
      "execution_count": 7,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "<tf.Tensor: shape=(2, 3), dtype=int64, numpy=\n",
              "array([[1, 2, 3],\n",
              "       [4, 5, 6]])>"
            ]
          },
          "metadata": {},
          "execution_count": 7
        }
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 8,
      "metadata": {
        "id": "FhaufyObuLEG",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "7b943e44-bb1d-4e26-8bf2-ee7711424f0f"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "`row_vector`: [4 5 6]\n",
            "`column_vector`: [2 5]\n",
            "`scalar`: 2\n"
          ]
        }
      ],
      "source": [
        "row_vector = matrix[1]\n",
        "column_vector = matrix[:,1]\n",
        "scalar = matrix[0, 1]\n",
        "\n",
        "print(\"`row_vector`: {}\".format(row_vector.numpy()))\n",
        "print(\"`column_vector`: {}\".format(column_vector.numpy()))\n",
        "print(\"`scalar`: {}\".format(scalar.numpy()))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "iD3VO-LZYZ2z"
      },
      "source": [
        "## 1.2 Computations on Tensors\n",
        "\n",
        "A convenient way to think about and visualize computations in TensorFlow is in terms of graphs. We can define this graph in terms of Tensors, which hold data, and the mathematical operations that act on these Tensors in some order. Let's look at a simple example, and define this computation using TensorFlow:\n",
        "\n",
        "![alt text](https://raw.githubusercontent.com/aamini/introtodeeplearning/master/lab1/img/add-graph.png)"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 9,
      "metadata": {
        "id": "X_YJrZsxYZ2z",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "d67a40ed-d034-4c62-fe11-422826f91165"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "tf.Tensor(76, shape=(), dtype=int32)\n",
            "tf.Tensor(76, shape=(), dtype=int32)\n"
          ]
        }
      ],
      "source": [
        "# Create the nodes in the graph, and initialize values\n",
        "a = tf.constant(15)\n",
        "b = tf.constant(61)\n",
        "\n",
        "# Add them!\n",
        "c1 = tf.add(a,b)\n",
        "c2 = a + b # TensorFlow overrides the \"+\" operation so that it is able to act on Tensors\n",
        "print(c1)\n",
        "print(c2)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Mbfv_QOiYZ23"
      },
      "source": [
        "Notice how we've created a computation graph consisting of TensorFlow operations, and how  the output is a Tensor with value 76 -- we've just created a computation graph consisting of operations, and it's executed them and given us back the result.\n",
        "\n",
        "Now let's consider a slightly more complicated example:\n",
        "\n",
        "![alt text](https://raw.githubusercontent.com/aamini/introtodeeplearning/master/lab1/img/computation-graph.png)\n",
        "\n",
        "Here, we take two inputs, `a, b`, and compute an output `e`. Each node in the graph represents an operation that takes some input, does some computation, and passes its output to another node.\n",
        "\n",
        "Let's define a simple function in TensorFlow to construct this computation function:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 10,
      "metadata": {
        "id": "PJnfzpWyYZ23",
        "scrolled": true
      },
      "outputs": [],
      "source": [
        "### Defining Tensor computations ###\n",
        "\n",
        "# Construct a simple computation function\n",
        "def func(a,b):\n",
        "  '''TODO: Define the operation for c, d, e (use tf.add, tf.subtract, tf.multiply).'''\n",
        "  c = a + b\n",
        "  d = b - 1\n",
        "  e = c * d\n",
        "  return e"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "AwrRfDMS2-oy"
      },
      "source": [
        "Now, we can call this function to execute the computation graph given some inputs `a,b`:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 11,
      "metadata": {
        "id": "pnwsf8w2uF7p",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "1017cfbf-bfea-40b9-9639-25506c23cd5d"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "6.0\n"
          ]
        }
      ],
      "source": [
        "# Consider example values for a,b\n",
        "a, b = 1.5, 2.5\n",
        "# Execute the computation\n",
        "e_out = func(a,b)\n",
        "print(e_out)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "6HqgUIUhYZ29"
      },
      "source": [
        "Notice how our output is a Tensor with value defined by the output of the computation, and that the output has no shape as it is a single scalar value."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "1h4o9Bb0YZ29"
      },
      "source": [
        "## 1.3 Neural networks in TensorFlow\n",
        "We can also define neural networks in TensorFlow. TensorFlow uses a high-level API called [Keras](https://www.tensorflow.org/guide/keras) that provides a powerful, intuitive framework for building and training deep learning models.\n",
        "\n",
        "Let's first consider the example of a simple perceptron defined by just one dense layer: $ y = \\sigma(Wx + b)$, where $W$ represents a matrix of weights, $b$ is a bias, $x$ is the input, $\\sigma$ is the sigmoid activation function, and $y$ is the output. We can also visualize this operation using a graph:\n",
        "\n",
        "![alt text](https://raw.githubusercontent.com/aamini/introtodeeplearning/master/lab1/img/computation-graph-2.png)\n",
        "\n",
        "Tensors can flow through abstract types called [```Layers```](https://www.tensorflow.org/api_docs/python/tf/keras/layers/Layer) -- the building blocks of neural networks. ```Layers``` implement common neural networks operations, and are used to update weights, compute losses, and define inter-layer connectivity. We will first define a ```Layer``` to implement the simple perceptron defined above."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 16,
      "metadata": {
        "id": "HutbJk-1kHPh",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "420f38a0-c51e-4c5a-e317-248cf89579d0"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stderr",
          "text": [
            "/usr/local/lib/python3.10/dist-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n",
            "  and should_run_async(code)\n"
          ]
        },
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "[[0.27064407 0.1826951  0.50374055]]\n",
            "[PASS] test_custom_dense_layer_output\n"
          ]
        },
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "True"
            ]
          },
          "metadata": {},
          "execution_count": 16
        }
      ],
      "source": [
        "### Defining a network Layer ###\n",
        "\n",
        "# n_output_nodes: number of output nodes\n",
        "# input_shape: shape of the input\n",
        "# x: input to the layer\n",
        "\n",
        "class OurDenseLayer(tf.keras.layers.Layer):\n",
        "  def __init__(self, n_output_nodes):\n",
        "    super(OurDenseLayer, self).__init__()\n",
        "    self.n_output_nodes = n_output_nodes\n",
        "\n",
        "  def build(self, input_shape):\n",
        "    d = int(input_shape[-1])\n",
        "    # Define and initialize parameters: a weight matrix W and bias b\n",
        "    # Note that parameter initialization is random!\n",
        "    self.W = self.add_weight(name=\"weight\", shape=[d, self.n_output_nodes]) # note the dimensionality\n",
        "    self.b = self.add_weight(name=\"bias\", shape=[1, self.n_output_nodes]) # note the dimensionality\n",
        "\n",
        "  def call(self, x):\n",
        "    '''TODO: define the operation for z (hint: use tf.matmul)'''\n",
        "    z = tf.add(tf.matmul(x, self.W), self.b)\n",
        "\n",
        "    '''TODO: define the operation for out (hint: use tf.sigmoid)'''\n",
        "    y = tf.sigmoid(z)\n",
        "    return y\n",
        "\n",
        "# Since layer parameters are initialized randomly, we will set a random seed for reproducibility\n",
        "tf.keras.utils.set_random_seed(1)\n",
        "layer = OurDenseLayer(3)\n",
        "layer.build((1,2))\n",
        "x_input = tf.constant([[1,2.]], shape=(1,2))\n",
        "y = layer.call(x_input)\n",
        "\n",
        "# test the output!\n",
        "print(y.numpy())\n",
        "mdl.lab1.test_custom_dense_layer_output(y)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Jt1FgM7qYZ3D"
      },
      "source": [
        "Conveniently, TensorFlow has defined a number of ```Layers``` that are commonly used in neural networks, for example a [```Dense```](https://www.tensorflow.org/api_docs/python/tf/keras/layers/Dense?version=stable). Now, instead of using a single ```Layer``` to define our simple neural network, we'll use the  [`Sequential`](https://www.tensorflow.org/versions/r2.0/api_docs/python/tf/keras/Sequential) model from Keras and a single [`Dense` ](https://www.tensorflow.org/versions/r2.0/api_docs/python/tf/keras/layers/Dense) layer to define our network. With the `Sequential` API, you can readily create neural networks by stacking together layers like building blocks."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 17,
      "metadata": {
        "id": "7WXTpmoL6TDz"
      },
      "outputs": [],
      "source": [
        "### Defining a neural network using the Sequential API ###\n",
        "\n",
        "# Import relevant packages\n",
        "from tensorflow.keras import Sequential\n",
        "from tensorflow.keras.layers import Dense\n",
        "\n",
        "# Define the number of outputs\n",
        "n_output_nodes = 3\n",
        "\n",
        "# First define the model\n",
        "model = Sequential()\n",
        "\n",
        "'''TODO: Define a dense (fully connected) layer to compute z'''\n",
        "# Remember: dense layers are defined by the parameters W and b!\n",
        "# You can read more about the initialization of W and b in the TF documentation :)\n",
        "# https://www.tensorflow.org/api_docs/python/tf/keras/layers/Dense?version=stable\n",
        "dense_layer = Dense(n_output_nodes, activation='sigmoid')\n",
        "\n",
        "# Add the dense layer to the model\n",
        "model.add(dense_layer)\n"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "HDGcwYfUyR-U"
      },
      "source": [
        "That's it! We've defined our model using the Sequential API. Now, we can test it out using an example input:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 18,
      "metadata": {
        "id": "sg23OczByRDb",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "277c2c6e-a325-48c7-eec5-129d37da6255"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stderr",
          "text": [
            "/usr/local/lib/python3.10/dist-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n",
            "  and should_run_async(code)\n"
          ]
        },
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "\u001b[1m1/1\u001b[0m \u001b[32m━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[37m\u001b[0m \u001b[1m0s\u001b[0m 295ms/step\n",
            "[[0.18752205 0.23909675 0.3213029 ]]\n"
          ]
        }
      ],
      "source": [
        "# Test model with example input\n",
        "x_input = tf.constant([[1,2.]], shape=(1,2))\n",
        "\n",
        "'''TODO: feed input into the model and predict the output!'''\n",
        "model_output = model.predict(x_input)\n",
        "print(model_output)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "596NvsOOtr9F"
      },
      "source": [
        "In addition to defining models using the `Sequential` API, we can also define neural networks by directly subclassing the [`Model`](https://www.tensorflow.org/api_docs/python/tf/keras/Model?version=stable) class, which groups layers together to enable model training and inference. The `Model` class captures what we refer to as a \"model\" or as a \"network\". Using Subclassing, we can create a class for our model, and then define the forward pass through the network using the `call` function. Subclassing affords the flexibility to define custom layers, custom training loops, custom activation functions, and custom models. Let's define the same neural network as above now using Subclassing rather than the `Sequential` model."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 19,
      "metadata": {
        "id": "K4aCflPVyViD"
      },
      "outputs": [],
      "source": [
        "### Defining a model using subclassing ###\n",
        "\n",
        "from tensorflow.keras import Model\n",
        "from tensorflow.keras.layers import Dense\n",
        "\n",
        "class SubclassModel(tf.keras.Model):\n",
        "\n",
        "  # In __init__, we define the Model's layers\n",
        "  def __init__(self, n_output_nodes):\n",
        "    super(SubclassModel, self).__init__()\n",
        "    '''TODO: Our model consists of a single Dense layer. Define this layer.'''\n",
        "    self.dense_layer = Dense(n_output_nodes, activation='sigmoid')\n",
        "\n",
        "  # In the call function, we define the Model's forward pass.\n",
        "  def call(self, inputs):\n",
        "    return self.dense_layer(inputs)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "U0-lwHDk4irB"
      },
      "source": [
        "Just like the model we built using the `Sequential` API, let's test out our `SubclassModel` using an example input.\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 20,
      "metadata": {
        "id": "LhB34RA-4gXb",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "14d5c203-317b-48f4-fe1e-cf44e197cb12"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "tf.Tensor([[0.82794297 0.15568398 0.567044  ]], shape=(1, 3), dtype=float32)\n"
          ]
        }
      ],
      "source": [
        "n_output_nodes = 3\n",
        "model = SubclassModel(n_output_nodes)\n",
        "\n",
        "x_input = tf.constant([[1,2.]], shape=(1,2))\n",
        "\n",
        "print(model.call(x_input))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "HTIFMJLAzsyE"
      },
      "source": [
        "Importantly, Subclassing affords us a lot of flexibility to define custom models. For example, we can use boolean arguments in the `call` function to specify different network behaviors, for example different behaviors during training and inference. Let's suppose under some instances we want our network to simply output the input, without any perturbation. We define a boolean argument `isidentity` to control this behavior:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 21,
      "metadata": {
        "id": "P7jzGX5D1xT5",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "2270976f-e64d-4e75-d427-62e198d919e1"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stderr",
          "text": [
            "/usr/local/lib/python3.10/dist-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n",
            "  and should_run_async(code)\n"
          ]
        }
      ],
      "source": [
        "### Defining a model using subclassing and specifying custom behavior ###\n",
        "\n",
        "from tensorflow.keras import Model\n",
        "from tensorflow.keras.layers import Dense\n",
        "\n",
        "class IdentityModel(tf.keras.Model):\n",
        "\n",
        "  # As before, in __init__ we define the Model's layers\n",
        "  # Since our desired behavior involves the forward pass, this part is unchanged\n",
        "  def __init__(self, n_output_nodes):\n",
        "    super(IdentityModel, self).__init__()\n",
        "    self.dense_layer = tf.keras.layers.Dense(n_output_nodes, activation='sigmoid')\n",
        "\n",
        "  '''TODO: Implement the behavior where the network outputs the input, unchanged,\n",
        "      under control of the isidentity argument.'''\n",
        "  def call(self, inputs, isidentity=False):\n",
        "    x = self.dense_layer(inputs)\n",
        "    '''TODO: Implement identity behavior'''\n",
        "    if isidentity:\n",
        "      return inputs\n",
        "    else:\n",
        "      return x"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Ku4rcCGx5T3y"
      },
      "source": [
        "Let's test this behavior:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 22,
      "metadata": {
        "id": "NzC0mgbk5dp2",
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "outputId": "dbec5072-b638-4184-9beb-cf82e648d2f8"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "Network output with activation: [[0.5746787  0.6182241  0.88219965]]; network identity output: [[1. 2.]]\n"
          ]
        },
        {
          "output_type": "stream",
          "name": "stderr",
          "text": [
            "/usr/local/lib/python3.10/dist-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n",
            "  and should_run_async(code)\n"
          ]
        }
      ],
      "source": [
        "n_output_nodes = 3\n",
        "model = IdentityModel(n_output_nodes)\n",
        "\n",
        "x_input = tf.constant([[1,2.]], shape=(1,2))\n",
        "'''TODO: pass the input into the model and call with and without the input identity option.'''\n",
        "out_activate = model.call(x_input, False)\n",
        "out_identity = model.call(x_input, True)\n",
        "\n",
        "print(\"Network output with activation: {}; network identity output: {}\".format(out_activate.numpy(), out_identity.numpy()))"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "7V1dEqdk6VI5"
      },
      "source": [
        "Now that we have learned how to define `Layers` as well as neural networks in TensorFlow using both the `Sequential` and Subclassing APIs, we're ready to turn our attention to how to actually implement network training with backpropagation."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "dQwDhKn8kbO2"
      },
      "source": [
        "## 1.4 Automatic differentiation in TensorFlow\n",
        "\n",
        "[Automatic differentiation](https://en.wikipedia.org/wiki/Automatic_differentiation)\n",
        "is one of the most important parts of TensorFlow and is the backbone of training with\n",
        "[backpropagation](https://en.wikipedia.org/wiki/Backpropagation). We will use the TensorFlow GradientTape [`tf.GradientTape`](https://www.tensorflow.org/api_docs/python/tf/GradientTape?version=stable) to trace operations for computing gradients later.\n",
        "\n",
        "When a forward pass is made through the network, all forward-pass operations get recorded to a \"tape\"; then, to compute the gradient, the tape is played backwards. By default, the tape is discarded after it is played backwards; this means that a particular `tf.GradientTape` can only\n",
        "compute one gradient, and subsequent calls throw a runtime error. However, we can compute multiple gradients over the same computation by creating a ```persistent``` gradient tape.\n",
        "\n",
        "First, we will look at how we can compute gradients using GradientTape and access them for computation. We define the simple function $ y = x^2$ and compute the gradient:"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 23,
      "metadata": {
        "id": "tdkqk8pw5yJM"
      },
      "outputs": [],
      "source": [
        "### Gradient computation with GradientTape ###\n",
        "\n",
        "# y = x^2\n",
        "# Example: x = 3.0\n",
        "x = tf.Variable(3.0)\n",
        "\n",
        "# Initiate the gradient tape\n",
        "with tf.GradientTape() as tape:\n",
        "  # Define the function\n",
        "  y = x * x\n",
        "# Access the gradient -- derivative of y with respect to x\n",
        "dy_dx = tape.gradient(y, x)\n",
        "\n",
        "assert dy_dx.numpy() == 6.0"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "JhU5metS5xF3"
      },
      "source": [
        "In training neural networks, we use differentiation and stochastic gradient descent (SGD) to optimize a loss function. Now that we have a sense of how `GradientTape` can be used to compute and access derivatives, we will look at an example where we use automatic differentiation and SGD to find the minimum of $L=(x-x_f)^2$. Here $x_f$ is a variable for a desired value we are trying to optimize for; $L$ represents a loss that we are trying to  minimize. While we can clearly solve this problem analytically ($x_{min}=x_f$), considering how we can compute this using `GradientTape` sets us up nicely for future labs where we use gradient descent to optimize entire neural network losses."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 25,
      "metadata": {
        "attributes": {
          "classes": [
            "py"
          ],
          "id": ""
        },
        "id": "7g1yWiSXqEf-",
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 485
        },
        "outputId": "710e57f5-ddab-4cd6-b57d-e4fc0d4bd2c9"
      },
      "outputs": [
        {
          "output_type": "stream",
          "name": "stdout",
          "text": [
            "Initializing x=[[0.40308788]]\n"
          ]
        },
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "Text(0, 0.5, 'x value')"
            ]
          },
          "metadata": {},
          "execution_count": 25
        },
        {
          "output_type": "display_data",
          "data": {
            "text/plain": [
              "<Figure size 640x480 with 1 Axes>"
            ],
            "image/png": "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\n"
          },
          "metadata": {}
        }
      ],
      "source": [
        "### Function minimization with automatic differentiation and SGD ###\n",
        "\n",
        "# Initialize a random value for our initial x\n",
        "x = tf.Variable([tf.random.normal([1])])\n",
        "print(\"Initializing x={}\".format(x.numpy()))\n",
        "\n",
        "learning_rate = 1e-2 # learning rate for SGD\n",
        "history = []\n",
        "# Define the target value\n",
        "x_f = 4\n",
        "\n",
        "# We will run SGD for a number of iterations. At each iteration, we compute the loss,\n",
        "#   compute the derivative of the loss with respect to x, and perform the SGD update.\n",
        "for i in range(500):\n",
        "  with tf.GradientTape() as tape:\n",
        "    '''TODO: define the loss as described above'''\n",
        "    loss = (x - x_f) ** 2\n",
        "\n",
        "  # loss minimization using gradient tape\n",
        "  grad = tape.gradient(loss, x) # compute the derivative of the loss with respect to x\n",
        "  new_x = x - learning_rate*grad # sgd update\n",
        "  x.assign(new_x) # update the value of x\n",
        "  history.append(x.numpy()[0])\n",
        "\n",
        "# Plot the evolution of x as we optimize towards x_f!\n",
        "plt.plot(history)\n",
        "plt.plot([0, 500],[x_f,x_f])\n",
        "plt.legend(('Predicted', 'True'))\n",
        "plt.xlabel('Iteration')\n",
        "plt.ylabel('x value')"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "pC7czCwk3ceH"
      },
      "source": [
        "`GradientTape` provides an extremely flexible framework for automatic differentiation. In order to back propagate errors through a neural network, we track forward passes on the Tape, use this information to determine the gradients, and then use these gradients for optimization using SGD."
      ]
    }
  ],
  "metadata": {
    "accelerator": "GPU",
    "colab": {
      "collapsed_sections": [
        "WBk0ZDWY-ff8"
      ],
      "provenance": []
    },
    "kernelspec": {
      "display_name": "Python 3",
      "language": "python",
      "name": "python3"
    },
    "language_info": {
      "name": "python",
      "version": "3.9.6"
    },
    "vscode": {
      "interpreter": {
        "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
      }
    }
  },
  "nbformat": 4,
  "nbformat_minor": 0
}