{"nbformat":4,"nbformat_minor":0,"metadata":{"colab":{"name":"Copy of basic_regression.ipynb","version":"0.3.2","provenance":[{"file_id":"https://github.com/tensorflow/docs/blob/master/site/en/tutorials/keras/basic_regression.ipynb","timestamp":1561148600812}],"private_outputs":true,"collapsed_sections":[],"toc_visible":true},"kernelspec":{"display_name":"Python 3","name":"python3"}},"cells":[{"cell_type":"markdown","metadata":{"colab_type":"text","id":"FhGuhbZ6M5tl"},"source":["##### Copyright 2018 The TensorFlow Authors."]},{"cell_type":"code","metadata":{"cellView":"form","colab_type":"code","id":"AwOEIRJC6Une","colab":{}},"source":["#@title Licensed under the Apache License, Version 2.0 (the \"License\");\n","# you may not use this file except in compliance with the License.\n","# You may obtain a copy of the License at\n","#\n","# https://www.apache.org/licenses/LICENSE-2.0\n","#\n","# Unless required by applicable law or agreed to in writing, software\n","# distributed under the License is distributed on an \"AS IS\" BASIS,\n","# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n","# See the License for the specific language governing permissions and\n","# limitations under the License."],"execution_count":0,"outputs":[]},{"cell_type":"code","metadata":{"cellView":"form","colab_type":"code","id":"KyPEtTqk6VdG","colab":{}},"source":["#@title MIT License\n","#\n","# Copyright (c) 2017 François Chollet\n","#\n","# Permission is hereby granted, free of charge, to any person obtaining a\n","# copy of this software and associated documentation files (the \"Software\"),\n","# to deal in the Software without restriction, including without limitation\n","# the rights to use, copy, modify, merge, publish, distribute, sublicense,\n","# and/or sell copies of the Software, and to permit persons to whom the\n","# Software is furnished to do so, subject to the following conditions:\n","#\n","# The above copyright notice and this permission notice shall be included in\n","# all copies or substantial portions of the Software.\n","#\n","# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n","# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n","# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL\n","# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n","# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n","# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER\n","# DEALINGS IN THE SOFTWARE."],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"EIdT9iu_Z4Rb"},"source":["# Regression: predict fuel efficiency"]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"bBIlTPscrIT9"},"source":["<table class=\"tfo-notebook-buttons\" align=\"left\">\n","  <td>\n","    <a target=\"_blank\" href=\"https://www.tensorflow.org/tutorials/keras/basic_regression\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n","  </td>\n","  <td>\n","    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/docs/blob/master/site/en/tutorials/keras/basic_regression.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n","  </td>\n","  <td>\n","    <a target=\"_blank\" href=\"https://github.com/tensorflow/docs/blob/master/site/en/tutorials/keras/basic_regression.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n","  </td>\n","</table>"]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"AHp3M9ZmrIxj"},"source":["In a *regression* problem, we aim to predict the output of a continuous value, like a price or a probability. Contrast this with a *classification* problem, where we aim to select a class from a list of classes (for example, where a picture contains an apple or an orange, recognizing which fruit is in the picture).\n","\n","This notebook uses the classic [Auto MPG](https://archive.ics.uci.edu/ml/datasets/auto+mpg) Dataset and builds a model to predict the fuel efficiency of late-1970s and early 1980s automobiles. To do this, we'll provide the model with a description of many automobiles from that time period. This description includes attributes like: cylinders, displacement, horsepower, and weight.\n","\n","This example uses the `tf.keras` API, see [this guide](https://www.tensorflow.org/guide/keras) for details."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"moB4tpEHxKB3","colab":{}},"source":["# Use seaborn for pairplot\n","!pip install seaborn"],"execution_count":0,"outputs":[]},{"cell_type":"code","metadata":{"colab_type":"code","id":"1rRo8oNqZ-Rj","colab":{}},"source":["from __future__ import absolute_import, division, print_function, unicode_literals\n","\n","import pathlib\n","\n","import matplotlib.pyplot as plt\n","import pandas as pd\n","import seaborn as sns\n","\n","import tensorflow as tf\n","from tensorflow import keras\n","from tensorflow.keras import layers\n","\n","print(tf.__version__)"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"F_72b0LCNbjx"},"source":["## The Auto MPG dataset\n","\n","The dataset is available from the [UCI Machine Learning Repository](https://archive.ics.uci.edu/ml/).\n","\n"]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"gFh9ne3FZ-On"},"source":["### Get the data\n","First download the dataset."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"p9kxxgzvzlyz","colab":{}},"source":["dataset_path = keras.utils.get_file(\"auto-mpg.data\", \"http://archive.ics.uci.edu/ml/machine-learning-databases/auto-mpg/auto-mpg.data\")\n","dataset_path"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"nslsRLh7Zss4"},"source":["Import it using pandas"]},{"cell_type":"code","metadata":{"colab_type":"code","id":"CiX2FI4gZtTt","colab":{}},"source":["column_names = ['MPG','Cylinders','Displacement','Horsepower','Weight',\n","                'Acceleration', 'Model Year', 'Origin']\n","raw_dataset = pd.read_csv(dataset_path, names=column_names,\n","                      na_values = \"?\", comment='\\t',\n","                      sep=\" \", skipinitialspace=True)\n","\n","dataset = raw_dataset.copy()\n","dataset.tail()"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"3MWuJTKEDM-f"},"source":["### Clean the data\n","\n","The dataset contains a few unknown values."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"JEJHhN65a2VV","colab":{}},"source":["dataset.isna().sum()"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"9UPN0KBHa_WI"},"source":["To keep this initial tutorial simple drop those rows."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"4ZUDosChC1UN","colab":{}},"source":["dataset = dataset.dropna()"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"8XKitwaH4v8h"},"source":["The `\"Origin\"` column is really categorical, not numeric. So convert that to a one-hot:"]},{"cell_type":"code","metadata":{"colab_type":"code","id":"gWNTD2QjBWFJ","colab":{}},"source":["origin = dataset.pop('Origin')"],"execution_count":0,"outputs":[]},{"cell_type":"code","metadata":{"colab_type":"code","id":"ulXz4J7PAUzk","colab":{}},"source":["dataset['USA'] = (origin == 1)*1.0\n","dataset['Europe'] = (origin == 2)*1.0\n","dataset['Japan'] = (origin == 3)*1.0\n","dataset.tail()"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"Cuym4yvk76vU"},"source":["### Split the data into train and test\n","\n","Now split the dataset into a training set and a test set.\n","\n","We will use the test set in the final evaluation of our model."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"qn-IGhUE7_1H","colab":{}},"source":["train_dataset = dataset.sample(frac=0.8,random_state=0)\n","test_dataset = dataset.drop(train_dataset.index)"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"J4ubs136WLNp"},"source":["### Inspect the data\n","\n","Have a quick look at the joint distribution of a few pairs of columns from the training set."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"oRKO_x8gWKv-","colab":{}},"source":["sns.pairplot(train_dataset[[\"MPG\", \"Cylinders\", \"Displacement\", \"Weight\"]], diag_kind=\"kde\")"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"gavKO_6DWRMP"},"source":["Also look at the overall statistics:"]},{"cell_type":"code","metadata":{"colab_type":"code","id":"yi2FzC3T21jR","colab":{}},"source":["train_stats = train_dataset.describe()\n","train_stats.pop(\"MPG\")\n","train_stats = train_stats.transpose()\n","train_stats"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"Db7Auq1yXUvh"},"source":["### Split features from labels\n","\n","Separate the target value, or \"label\", from the features. This label is the value that you will train the model to predict."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"t2sluJdCW7jN","colab":{}},"source":["train_labels = train_dataset.pop('MPG')\n","test_labels = test_dataset.pop('MPG')"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"mRklxK5s388r"},"source":["### Normalize the data\n","\n","Look again at the `train_stats` block above and note how different the ranges of each feature are."]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"-ywmerQ6dSox"},"source":["It is good practice to normalize features that use different scales and ranges. Although the model *might* converge without feature normalization, it makes training more difficult, and it makes the resulting model dependent on the choice of units used in the input.\n","\n","Note: Although we intentionally generate these statistics from only the training dataset, these statistics will also be used to normalize the test dataset. We need to do that to project the test dataset into the same distribution that the model has been trained on."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"JlC5ooJrgjQF","colab":{}},"source":["def norm(x):\n","  return (x - train_stats['mean']) / train_stats['std']\n","normed_train_data = norm(train_dataset)\n","normed_test_data = norm(test_dataset)"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"BuiClDk45eS4"},"source":["This normalized data is what we will use to train the model.\n","\n","Caution: The statistics used to normalize the inputs here (mean and standard deviation) need to be applied to any other data that is fed to the model, along with the one-hot encoding that we did earlier.  That includes the test set as well as live data when the model is used in production."]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"SmjdzxKzEu1-"},"source":["## The model"]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"6SWtkIjhrZwa"},"source":["### Build the model\n","\n","Let's build our model. Here, we'll use a `Sequential` model with two densely connected hidden layers, and an output layer that returns a single, continuous value. The model building steps are wrapped in a function, `build_model`, since we'll create a second model, later on."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"c26juK7ZG8j-","colab":{}},"source":["def build_model():\n","  model = keras.Sequential([\n","    layers.Dense(64, activation=tf.nn.relu, input_shape=[len(train_dataset.keys())]),\n","    layers.Dense(64, activation=tf.nn.relu),\n","    layers.Dense(1)\n","  ])\n","\n","  optimizer = tf.keras.optimizers.RMSprop(0.001)\n","\n","  model.compile(loss='mean_squared_error',\n","                optimizer=optimizer,\n","                metrics=['mean_absolute_error', 'mean_squared_error'])\n","  return model"],"execution_count":0,"outputs":[]},{"cell_type":"code","metadata":{"colab_type":"code","id":"cGbPb-PHGbhs","colab":{}},"source":["model = build_model()"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"Sj49Og4YGULr"},"source":["### Inspect the model\n","\n","Use the `.summary` method to print a simple description of the model"]},{"cell_type":"code","metadata":{"colab_type":"code","id":"ReAD0n6MsFK-","colab":{}},"source":["model.summary()"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"Vt6W50qGsJAL"},"source":["\n","Now try out the model. Take a batch of `10` examples from the training data and call `model.predict` on it."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"-d-gBaVtGTSC","colab":{}},"source":["example_batch = normed_train_data[:10]\n","example_result = model.predict(example_batch)\n","example_result"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"QlM8KrSOsaYo"},"source":["It seems to be working, and it produces a result of the expected shape and type."]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"0-qWCsh6DlyH"},"source":["### Train the model\n","\n","Train the model for 1000 epochs, and record the training and validation accuracy in the `history` object."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"sD7qHCmNIOY0","colab":{}},"source":["# Display training progress by printing a single dot for each completed epoch\n","class PrintDot(keras.callbacks.Callback):\n","  def on_epoch_end(self, epoch, logs):\n","    if epoch % 100 == 0: print('')\n","    print('.', end='')\n","\n","EPOCHS = 1000\n","\n","history = model.fit(\n","  normed_train_data, train_labels,\n","  epochs=EPOCHS, validation_split = 0.2, verbose=0,\n","  callbacks=[PrintDot()])"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"tQm3pc0FYPQB"},"source":["Visualize the model's training progress using the stats stored in the `history` object."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"4Xj91b-dymEy","colab":{}},"source":["hist = pd.DataFrame(history.history)\n","hist['epoch'] = history.epoch\n","hist.tail()"],"execution_count":0,"outputs":[]},{"cell_type":"code","metadata":{"colab_type":"code","id":"B6XriGbVPh2t","colab":{}},"source":["def plot_history(history):\n","  hist = pd.DataFrame(history.history)\n","  hist['epoch'] = history.epoch\n","\n","  plt.figure()\n","  plt.xlabel('Epoch')\n","  plt.ylabel('Mean Abs Error [MPG]')\n","  plt.plot(hist['epoch'], hist['mean_absolute_error'],\n","           label='Train Error')\n","  plt.plot(hist['epoch'], hist['val_mean_absolute_error'],\n","           label = 'Val Error')\n","  plt.ylim([0,5])\n","  plt.legend()\n","\n","  plt.figure()\n","  plt.xlabel('Epoch')\n","  plt.ylabel('Mean Square Error [$MPG^2$]')\n","  plt.plot(hist['epoch'], hist['mean_squared_error'],\n","           label='Train Error')\n","  plt.plot(hist['epoch'], hist['val_mean_squared_error'],\n","           label = 'Val Error')\n","  plt.ylim([0,20])\n","  plt.legend()\n","  plt.show()\n","\n","\n","plot_history(history)"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"AqsuANc11FYv"},"source":["This graph shows little improvement, or even degradation in the validation error after about 100 epochs. Let's update the `model.fit` call to automatically stop training when the validation score doesn't improve. We'll use an *EarlyStopping callback* that tests a training condition for  every epoch. If a set amount of epochs elapses without showing improvement, then automatically stop the training.\n","\n","You can learn more about this callback [here](https://www.tensorflow.org/versions/master/api_docs/python/tf/keras/callbacks/EarlyStopping)."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"fdMZuhUgzMZ4","colab":{}},"source":["model = build_model()\n","\n","# The patience parameter is the amount of epochs to check for improvement\n","early_stop = keras.callbacks.EarlyStopping(monitor='val_loss', patience=10)\n","\n","history = model.fit(normed_train_data, train_labels, epochs=EPOCHS,\n","                    validation_split = 0.2, verbose=0, callbacks=[early_stop, PrintDot()])\n","\n","plot_history(history)"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"3St8-DmrX8P4"},"source":["The graph shows that on the validation set, the average error is usually around +/- 2 MPG. Is this good? We'll leave that decision up to you.\n","\n","Let's see how well the model generalizes by using the **test** set, which we did not use when training the model.  This tells us how well we can expect the model to predict when we use it in the real world."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"jl_yNr5n1kms","colab":{}},"source":["loss, mae, mse = model.evaluate(normed_test_data, test_labels, verbose=0)\n","\n","print(\"Testing set Mean Abs Error: {:5.2f} MPG\".format(mae))"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"ft603OzXuEZC"},"source":["### Make predictions\n","\n","Finally, predict MPG values using data in the testing set:"]},{"cell_type":"code","metadata":{"colab_type":"code","id":"Xe7RXH3N3CWU","colab":{}},"source":["test_predictions = model.predict(normed_test_data).flatten()\n","\n","plt.scatter(test_labels, test_predictions)\n","plt.xlabel('True Values [MPG]')\n","plt.ylabel('Predictions [MPG]')\n","plt.axis('equal')\n","plt.axis('square')\n","plt.xlim([0,plt.xlim()[1]])\n","plt.ylim([0,plt.ylim()[1]])\n","_ = plt.plot([-100, 100], [-100, 100])\n"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"OrkHGKZcusUo"},"source":["It looks like our model predicts reasonably well. Let's take a look at the error distribution."]},{"cell_type":"code","metadata":{"colab_type":"code","id":"f-OHX4DiXd8x","colab":{}},"source":["error = test_predictions - test_labels\n","plt.hist(error, bins = 25)\n","plt.xlabel(\"Prediction Error [MPG]\")\n","_ = plt.ylabel(\"Count\")"],"execution_count":0,"outputs":[]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"r9_kI6MHu1UU"},"source":["It's not quite gaussian, but we might expect that because the number of samples is very small."]},{"cell_type":"markdown","metadata":{"colab_type":"text","id":"vgGQuV-yqYZH"},"source":["## Conclusion\n","\n","This notebook introduced a few techniques to handle a regression problem.\n","\n","* Mean Squared Error (MSE) is a common loss function used for regression problems (different loss functions are used for classification problems).\n","* Similarly, evaluation metrics used for regression differ from classification. A common regression metric is Mean Absolute Error (MAE).\n","* When numeric input data features have values with different ranges, each feature should be scaled independently to the same range.\n","* If there is not much training data, one technique is to prefer a small network with few hidden layers to avoid overfitting.\n","* Early stopping is a useful technique to prevent overfitting."]}]}