t81_558_class5_backpropagation.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# T81-558: Applications of Deep Neural Networks\n",
    "**Class 5: Backpropagation.**\n",
    "* Instructor: [Jeff Heaton](https://sites.wustl.edu/jeffheaton/), School of Engineering and Applied Science, [Washington University in St. Louis](https://engineering.wustl.edu/Programs/Pages/default.aspx)\n",
    "* For more information visit the [class website](https://sites.wustl.edu/jeffheaton/t81-558/)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Common Functions from Before"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "from sklearn import preprocessing\n",
    "import matplotlib.pyplot as plt\n",
    "import numpy as np\n",
    "import pandas as pd\n",
    "import shutil\n",
    "\n",
    "# Encode text values to dummy variables(i.e. [1,0,0],[0,1,0],[0,0,1] for red,green,blue)\n",
    "def encode_text_dummy(df,name):\n",
    "    dummies = pd.get_dummies(df[name])\n",
    "    for x in dummies.columns:\n",
    "        dummy_name = \"{}-{}\".format(name,x)\n",
    "        df[dummy_name] = dummies[x]\n",
    "    df.drop(name, axis=1, inplace=True)\n",
    "\n",
    "# Encode text values to a single dummy variable.  The new columns (which do not replace the old) will have a 1\n",
    "# at every location where the origional column (name) matches each of the target_values.  One column is added for\n",
    "# each target value.\n",
    "def encode_text_single_dummy(df,name,target_values):\n",
    "    for tv in target_values:\n",
    "        l = list(df[name].astype(str))\n",
    "        l = [1 if str(x)==str(tv) else 0 for x in l]\n",
    "        name2 = \"{}-{}\".format(name,tv)\n",
    "        df[name2] = l\n",
    "    \n",
    "# Encode text values to indexes(i.e. [1],[2],[3] for red,green,blue).\n",
    "def encode_text_index(df,name):\n",
    "    le = preprocessing.LabelEncoder()\n",
    "    df[name] = le.fit_transform(df[name])\n",
    "    return le.classes_\n",
    "\n",
    "# Encode a numeric column as zscores\n",
    "def encode_numeric_zscore(df,name,mean=None,sd=None):\n",
    "    if mean is None:\n",
    "        mean = df[name].mean()\n",
    "\n",
    "    if sd is None:\n",
    "        sd = df[name].std()\n",
    "\n",
    "    df[name] = (df[name]-mean)/sd\n",
    "\n",
    "# Convert all missing values in the specified column to the median\n",
    "def missing_median(df, name):\n",
    "    med = df[name].median()\n",
    "    df[name] = df[name].fillna(med)\n",
    "\n",
    "# Convert all missing values in the specified column to the default\n",
    "def missing_default(df, name, default_value):\n",
    "    df[name] = df[name].fillna(default_value)\n",
    "\n",
    "# Convert a Pandas dataframe to the x,y inputs that TensorFlow needs\n",
    "def to_xy(df,target):\n",
    "    result = []\n",
    "    for x in df.columns:\n",
    "        if x != target:\n",
    "            result.append(x)\n",
    "\n",
    "    # find out the type of the target column.  Is it really this hard? :(\n",
    "    target_type = df[target].dtypes\n",
    "    target_type = target_type[0] if hasattr(target_type, '__iter__') else target_type\n",
    "    \n",
    "    # Encode to int for classification, float otherwise. TensorFlow likes 32 bits.\n",
    "    if target_type in (np.int64, np.int32):\n",
    "        # Classification\n",
    "        return df.as_matrix(result).astype(np.float32),df.as_matrix([target]).astype(np.int32)\n",
    "    else:\n",
    "        # Regression\n",
    "        return df.as_matrix(result).astype(np.float32),df.as_matrix([target]).astype(np.float32)\n",
    "\n",
    "# Nicely formatted time string\n",
    "def hms_string(sec_elapsed):\n",
    "    h = int(sec_elapsed / (60 * 60))\n",
    "    m = int((sec_elapsed % (60 * 60)) / 60)\n",
    "    s = sec_elapsed % 60\n",
    "    return \"{}:{:>02}:{:>05.2f}\".format(h, m, s)\n",
    "\n",
    "# Regression chart, we will see more of this chart in the next class.\n",
    "def chart_regression(pred,y):\n",
    "    t = pd.DataFrame({'pred' : pred, 'y' : y_test.flatten()})\n",
    "    t.sort_values(by=['y'],inplace=True)\n",
    "    a = plt.plot(t['y'].tolist(),label='expected')\n",
    "    b = plt.plot(t['pred'].tolist(),label='prediction')\n",
    "    plt.ylabel('output')\n",
    "    plt.legend()\n",
    "    plt.show()\n",
    "    \n",
    "# Get a new directory to hold checkpoints from a neural network.  This allows the neural network to be\n",
    "# loaded later.  If the erase param is set to true, the contents of the directory will be cleared.\n",
    "def get_model_dir(name,erase):\n",
    "    base_path = os.path.join(\".\",\"dnn\")\n",
    "    model_dir = os.path.join(base_path,name)\n",
    "    os.makedirs(model_dir,exist_ok=True)\n",
    "    if erase and len(model_dir)>4 and os.path.isdir(model_dir):\n",
    "        shutil.rmtree(model_dir,ignore_errors=True) # be careful, this deletes everything below the specified path\n",
    "    return model_dir"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "# Classic Backpropagation\n",
    "Backpropagation is the primary means by which a neural network's weights are determined during training. Backpropagation works by calculating a weight change amount ($v_t$) for every weight($\\theta$, theata) in the neural network.  This value is subtracted from every weight by the following equation: \n",
    "\n",
    "$ \\theta_t = \\theta_{t-1} - v_t $\n",
    "\n",
    "This process is repeated for every iteration($t$).  How the weight change is calculated depends on the training algorithm.  Classic backpropagation simply calculates a gradient ($\\nabla$, nabla) for every weight in the neural network with respect to the error function ($J$) of the neural network.  The gradient is scaled by a learning rate ($\\eta$, eta).\n",
    "\n",
    "$ v_t = \\eta \\nabla_{\\theta_{t-1}} J(\\theta_{t-1}) $\n",
    "\n",
    "The learning rate is an important concept for backpropagation training.  Setting the learning rate can be complex:\n",
    "\n",
    "* Too low of a learning rate will usually converge to a good solution; however, the process will be very slow.\n",
    "* Too high of a learning rate will either fail outright, or converge to a higher error than a better learning rate.\n",
    "\n",
    "Common values for learning rate are: 0.1, 0.01, 0.001, etc.\n",
    "\n",
    "Gradients:\n",
    "\n",
    "![Derivative](https://raw.githubusercontent.com/jeffheaton/t81_558_deep_learning/master/images/class_2_deriv.png \"Derivative\")\n",
    "\n",
    "The following link, from the book, shows how a simple [neural network is trained with backpropagation](http://www.heatonresearch.com/aifh/vol3/)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Momentum Backpropagation\n",
    "\n",
    "Momentum adds another term to the calculation of $v_t$:\n",
    "\n",
    "$ v_t = \\eta \\nabla_{\\theta_{t-1}} J(\\theta_{t-1}) + \\lambda v_{t-1} $\n",
    "\n",
    "Like the learning rate, momentum adds another training parameter that scales the effect of momentum.  Momentum backpropagation has two training parameters: learning rate ($\\eta$, eta) and momentum ($\\lambda$, lambda).  Momentum simply adds the scaled value of the previous weight change amount ($v_{t-1}$) to the current weight change amount($v_t$).\n",
    "\n",
    "This has the effect of adding additional force behind a direction a weight was moving.  This might allow the weight to escape a local minima:\n",
    "\n",
    "![Momentum](https://raw.githubusercontent.com/jeffheaton/t81_558_deep_learning/master/images/class_5_momentum.png \"Momentum\")\n",
    "\n",
    "A very common value for momentum is 0.9.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Batch and Online Backpropagation\n",
    "\n",
    "How often should the weights of a neural network be updated?  Gradients can be calculated for a training set element.  These gradients can also be summed together into batches and the weights updated once per batch.\n",
    "\n",
    "* **Online Training** - Update the weights based on gradients calculated from a single training set element.\n",
    "* **Batch Training** - Update the weights based on the sum of the gradients over all training set elements.\n",
    "* **Batch Size** - Update the weights based on the sum of some batch size of training set elements.\n",
    "* **Mini-Batch Training** - The same as batch size, but with a very small batch size.  Mini-batches are very popular and they are often in the 32-64 element range.\n",
    "\n",
    "Because the batch size is smaller than the complete training set size, it may take several batches to make it completely through the training set.  \n",
    "\n",
    "* **Step/Iteration** - The number of batches that were processed.\n",
    "* **Epoch** - The number of times the complete training set was processed.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Stochastic Gradient Descent\n",
    "\n",
    "Stochastic gradient descent (SGD) is currently one of the most popular neural network training algorithms.  It works very similarly to Batch/Mini-Batch training, except that the batches are made up of a random set of training elements.\n",
    "\n",
    "This leads to a very irregular convergence in error during training:\n",
    "\n",
    "![SGD Error](https://raw.githubusercontent.com/jeffheaton/t81_558_deep_learning/master/images/class_5_sgd_error.png \"SGD Error\")\n",
    "[Image from Wikipedia](https://en.wikipedia.org/wiki/Stochastic_gradient_descent)\n",
    "\n",
    "Because the neural network is trained on a random sample of the complete training set each time, the error does not make a smooth transition downward.  However, the error usually does go down.\n",
    "\n",
    "Advantages to SGD include:\n",
    "\n",
    "* Computationally efficient.  Even with a very large training set, each training step can be relatively fast.\n",
    "* Decreases overfitting by focusing on only a portion of the training set each step.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Other Techniques\n",
    "\n",
    "One problem with simple backpropagation training algorithms is that they are highly sensative to learning rate and momentum.  This is difficult because:\n",
    "\n",
    "* Learning rate must be adjusted to a small enough level to train an accurate neural network.\n",
    "* Momentum must be large enough to overcome local minima, yet small enough to not destabilize the training.\n",
    "* A single learning rate/momentum is often not good enough for the entire training process. It is often useful to automatically decrease learning rate as the training progresses.\n",
    "* All weights share a single learning rate/momentum.\n",
    "\n",
    "Other training techniques:\n",
    "\n",
    "* **Resilient Propagation** - Use only the magnitude of the gradient and allow each neuron to learn at its own rate.  No need for learning rate/momentum; however, only works in full batch mode.\n",
    "* **Nesterov accelerated gradient** - Helps midigate the risk of choosing a bad mini-batch.\n",
    "* **Adagrad** - Allows an automatically decaying per-weight learning rate and momentum concept.\n",
    "* **Adadelta** - Extension of Adagrad that seeks to reduce its aggressive, monotonically decreasing learning rate.\n",
    "* **Non-Gradient Methods** - Non-gradient methods can *sometimes* be useful, though rarely outperform gradient-based backpropagation methods.  These include: [simulated annealing](https://en.wikipedia.org/wiki/Simulated_annealing), [genetic algorithms](https://en.wikipedia.org/wiki/Genetic_algorithm), [particle swarm optimization](https://en.wikipedia.org/wiki/Particle_swarm_optimization), [Nelder Mead](https://en.wikipedia.org/wiki/Nelder%E2%80%93Mead_method), and [many more](https://en.wikipedia.org/wiki/Category:Optimization_algorithms_and_methods)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# ADAM Update\n",
    "\n",
    "ADAM is the first training algorithm you should try.  It is very effective.  Kingma and Ba (2014) introduced the Adam update rule that derives its name from the adaptive moment estimates that it uses.  Adam estimates the first (mean) and second (variance) moments to determine the weight corrections.  Adam begins with an exponentially decaying average of past gradients (m):\n",
    "\n",
    "$ m_t = \\beta_1 m_{t-1} + (1-\\beta_1) g_t $\n",
    "\n",
    "This average accomplishes a similar goal as classic momentum update; however, its value is calculated automatically based on the current gradient ($g_t$).  The update rule then calculates the second moment ($v_t$):\n",
    "\n",
    "$ v_t = \\beta_2 v_{t-1} + (1-\\beta_2) g_t^2 $\n",
    "\n",
    "The values $m_t$ and $v_t$ are estimates of the first moment (the mean) and the second moment (the uncentered variance) of the gradients respectively.  However, they will have a strong bias towards zero in the initial training cycles.  The first moment’s bias is corrected as follows.\n",
    "\n",
    "$ \\hat{m}_t = \\frac{m_t}{1-\\beta^t_1} $\n",
    "\n",
    "Similarly, the second moment is also corrected:\n",
    "\n",
    "$ \\hat{v}_t = \\frac{v_t}{1-\\beta_2^t} $\n",
    "\n",
    "These bias-corrected first and second moment estimates are applied to the ultimate Adam update rule, as follows:\n",
    "\n",
    "$ \\theta_t = \\theta_{t-1} - \\frac{\\eta}{\\sqrt{\\hat{v}_t}+\\eta} \\hat{m}_t $\n",
    "\n",
    "Adam is very tolerant to initial learning rate (η) and other training parameters. Kingma and Ba (2014)  propose default values of 0.9 for $\\beta_1$, 0.999 for $\\beta_2$, and 10-8 for $\\eta$."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Methods Compared\n",
    "\n",
    "The following image shows how each of these algorithms train (image credits: [author](Alec Radford), [where I found it](http://sebastianruder.com/optimizing-gradient-descent/index.html#visualizationofalgorithms) ):\n",
    "\n",
    "![Training Techniques](https://raw.githubusercontent.com/jeffheaton/t81_558_deep_learning/master/images/contours_evaluation_optimizers.gif \"Training Techniques\")\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Specifying the Update Rule in Tensorflow\n",
    "\n",
    "TensorFlow allows the update rule to be set to one of:\n",
    "\n",
    "* Adagrad\n",
    "* **Adam**\n",
    "* Ftrl\n",
    "* Momentum\n",
    "* RMSProp\n",
    "* **SGD**\n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Score (RMSE): 3.4834437370300293\n",
      "Best step: 895, Last successful step: 1905\n"
     ]
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAYYAAAEACAYAAAC3adEgAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzs3Xd41EX+wPH3pJAC6QXSAyF06VVaAAFFBGynoKggFhT0\nbKfIeYKip/4UTsV2oICiAgpKkVOkhCK9hB5KQnogvfdkfn9sdskmu8mmbArM63n2Mfst851E3c/O\nfKYIKSWKoiiKomXR1BVQFEVRmhcVGBRFURQ9KjAoiqIoelRgUBRFUfSowKAoiqLoUYFBURRF0dMo\ngUEIYSGEOCGE2FT+fqUQIrL82HEhRM/GqIeiKIpSM6tGes7zwFnAsfy9BF6SUv7SSM9XFEVRTGT2\nFoMQwheYACxv7GcriqIotdcYH85LgFfQtBIqWiSECBNCfCSEsG6EeiiKoigmMGtgEELcCVyTUoYB\nosKp16SUXYEBgBvwqjnroSiKopjO3DmGocAkIcQEwA5wEEJ8K6V8BEBKWSyEWAG8ZOhmIYRayElR\nFKUOpJSi5qsMM2uLQUr5upTSX0rZAXgQ2CmlfEQI0Q5ACCGAKcCZaspQLyl58803m7wOzeWl/hbq\nb6H+FtW/6quxRiVV9r0Qwh1N91IY8HQT1UNRFEWppNECg5RyN7C7/OcxjfVcRVEUpXbUkNEWIiQk\npKmr0Gyov8V16m9x3c36tygshC1bGrZM0RD9UeYihJDNuX6KoihNLSICbrsNrly5fkwIgaxH8rmp\ncgyKorQAgYGBREdHN3U1FCMCAgJYvToKb++GLVcFBkVRjIqOjm6QUS6KeQghSEgAL6+GLVflGBRF\nUVqwhAQavMWgAoOiKEoLlpioWgyKoihKBarFoCiKcoNauHAh06dPr/V9iYkqMCiKojRL7du3Z+fO\nnfUqQ7NKUO2o5LOiKIqiR3UlKYqiVJCYmMh9992Hp6cnQUFBLF26FIA777yTl19+WXfdgw8+yKxZ\nswBYtWoVw4YNY+7cuTg7O9OtWze9b/pZWVnMmjULb29v/Pz8eOONN/SG7C5btoxu3brh6OhIjx49\nCAsL45FHHiEmJoa77roLR0dHPvzwQwAOHjzI0KFDcXFxoU+fPuzevVtXTlRUFCEhITg5OTF+/HhS\nUlLq9DcoKAAXlzrdalxTrwJYwwqBUlGUptOc/x8sKyuT/fr1k4sWLZIlJSXyypUrMigoSG7btk1e\nvXpVtm3bVu7atUuuXr1aBgUFydzcXCmllCtXrpRWVlby448/liUlJXLt2rXSyclJpqenSymlnDJl\nipw9e7bMz8+XycnJctCgQfK///2vlFLKdevWSV9fX3ns2DEppZQREREyJiZGSillYGCg3Llzp65+\n8fHx0s3NTf7+++9SSim3b98u3dzcZEpKipRSyiFDhsiXX35ZFhUVyT179kgHBwc5ffr0Wv0NABkY\naPi4rM9nb31uNverOf9HqSg3g5r+H4SGedXFoUOHZEBAgN6xf//733LmzJlSSik3bNgg/fz8pIeH\nh9y/f7/umpUrV0ofHx+9+wYOHChXr14tr127Jm1sbGRBQYHu3I8//ihHjx4tpZRy/Pjx8pNPPjFY\nn8DAQLljxw7d+/fff18+8sgjeteMHz9efvvttzImJkZaW1vLvLw83blp06bVKTDceqvh47Ien71q\n5rOiKHUmm3BSdHR0NPHx8bi6upbXRVJWVsaIESMAmDhxInPmzKFz584MGTJE714fHx+99wEBASQk\nJBAdHU1xcTFe5dlc7Qelv78/ALGxsQQFBZlcv3Xr1rF582ZdWSUlJYwePZqEhARcXFyws7PTq0Nc\nXFyt/w4NnXgGtSSGoigtlJ+fHx06dODChQsGz7/++ut069aNK1eusGbNGh588EHdufj4eL1rY2Ji\nmDx5Mn5+ftja2pKammpwhJCfnx8REREGn1f5ej8/Px555BG++uqrKtfGxMSQnp5Ofn6+LjjExMRg\nYVH7tG9DJ55BJZ8VRWmhBg4ciIODAx988AEFBQWUlpZy9uxZjh49yp49e1i1ahXfffcdK1euZO7c\nuSQmJuruTUpK4tNPP6WkpISffvqJ8PBwJkyYQLt27Rg3bhwvvPAC2dnZSCmJjIxkz549AMyaNYsP\nP/yQ48ePAxAREUFsbCwAbdu2JTIyUveMhx9+mM2bN7Nt2zbKysooKChg9+7dJCQk4O/vT//+/Xnz\nzTcpLi5m3759upZFbZmjxdDkeYTqXqgcg6I0qeb+/2BiYqKcOnWqbNeunXR1dZVDhgyRmzZtku3b\nt5fr1q3TXffaa6/J8ePHSyk1OYZhw4bJuXPnSicnJ9m5c2e5fft23bVZWVly9uzZ0tfXVzo7O8u+\nffvKtWvX6s5/9dVXsnPnztLBwUHecsstMiwsTEop5caNG6W/v790cXGRH330kZRSysOHD8uRI0dK\n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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x23aad0bb240>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from sklearn.model_selection import train_test_split\n",
    "import tensorflow.contrib.learn as learn\n",
    "import pandas as pd\n",
    "import os\n",
    "import numpy as np\n",
    "import tensorflow as tf\n",
    "from sklearn import metrics\n",
    "\n",
    "# Set the desired TensorFlow output level for this example\n",
    "tf.logging.set_verbosity(tf.logging.ERROR)\n",
    "\n",
    "path = \"./data/\"\n",
    "\n",
    "filename_read = os.path.join(path,\"auto-mpg.csv\")\n",
    "df = pd.read_csv(filename_read,na_values=['NA','?'])\n",
    "\n",
    "# create feature vector\n",
    "missing_median(df, 'horsepower')\n",
    "df.drop('name',1,inplace=True)\n",
    "encode_numeric_zscore(df, 'horsepower')\n",
    "encode_numeric_zscore(df, 'weight')\n",
    "encode_numeric_zscore(df, 'cylinders')\n",
    "encode_numeric_zscore(df, 'displacement')\n",
    "encode_numeric_zscore(df, 'acceleration')\n",
    "encode_text_dummy(df, 'origin')\n",
    "\n",
    "# Encode to a 2D matrix for training\n",
    "x,y = to_xy(df,'mpg')\n",
    "\n",
    "# Split into train/test\n",
    "x_train, x_test, y_train, y_test = train_test_split(\n",
    "    x, y, test_size=0.25, random_state=42)\n",
    "\n",
    "# Get/clear a directory to store the neural network to\n",
    "model_dir = get_model_dir('mpg',True)\n",
    "\n",
    "# Choose an optimizer\n",
    "opt=tf.train.AdamOptimizer()\n",
    "#opt=tf.train.MomentumOptimizer(learning_rate=1e-5,momentum=0.9)\n",
    "\n",
    "# Create a deep neural network with 3 hidden layers\n",
    "feature_columns = [tf.contrib.layers.real_valued_column(\"\", dimension=x.shape[1])]\n",
    "regressor = learn.DNNRegressor(\n",
    "    model_dir= model_dir,\n",
    "    optimizer=opt,\n",
    "    config=tf.contrib.learn.RunConfig(save_checkpoints_secs=1),\n",
    "    feature_columns=feature_columns,\n",
    "    hidden_units=[25, 5])\n",
    "\n",
    "# Might be needed in future versions of \"TensorFlow Learn\"\n",
    "#regressor = learn.SKCompat(regressor) # For Sklearn compatibility\n",
    "\n",
    "# Early stopping\n",
    "validation_monitor = tf.contrib.learn.monitors.ValidationMonitor(\n",
    "    x_test,\n",
    "    y_test,\n",
    "    every_n_steps=5,\n",
    "    early_stopping_metric=\"loss\",\n",
    "    early_stopping_metric_minimize=True,\n",
    "    early_stopping_rounds=1000)\n",
    "\n",
    "# Fit/train neural network\n",
    "regressor.fit(x_train, y_train,monitors=[validation_monitor],steps=50000)\n",
    "\n",
    "# Predict and measure RMSE\n",
    "pred = list(regressor.predict(x_test, as_iterable=True))\n",
    "score = np.sqrt(metrics.mean_squared_error(pred,y_test))\n",
    "print(\"Score (RMSE): {}\".format(score))\n",
    "print(\"Best step: {}, Last successful step: {}\".format(\n",
    "    validation_monitor.best_step,validation_monitor._last_successful_step))\n",
    "\n",
    "# Plot the chart\n",
    "chart_regression(pred,y_test)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "# Important Parameters\n",
    "\n",
    "* **learning_rate** - How quickly should the optimizer attempt to train the neural network.  Too high will fail to train.  Too low will train too slowly.\n",
    "* **momentum** - Only used with the momentum optimizer.  How much of the previous weight change direction should be used in the current step.\n",
    "* **every_n_steps** - How often should the validation set be evaluated.\n",
    "* **early_stopping_rounds** - How many rounds (steps) of non-improvement should be tolerated.\n",
    "\n",
    "# Some results\n",
    "* **ADAM**, learning_rate = 1e-1, early_stopping = 100\n",
    "    * Score (RMSE): 3.5879969596862793\n",
    "    * Best step: 1505, Last successful step: 1640\n",
    "* **ADAM**, learning_rate = 1e-3, early_stopping = 100\n",
    "    * Score (RMSE): 2.4205124378204346\n",
    "    * Best step: 4650, Last successful step: 4770\n",
    "* **ADAM**, default learning rate, early_stopping = 1000\n",
    "    * Score (RMSE): 2.410527467727661\n",
    "    * Best step: 6630, Last successful step: 7720\n",
    "* **Momentum**, learning_rate=1e-5,momentum=0.9, early_stopping = 1000\n",
    "    * Score (RMSE): 2.4050464630126953\n",
    "    * Best step: 41270, Last successful step: 42280\n",
    "\n",
    "ADAM will converge quicker (fewer steps) than momentum and get a good RMSE.  For all, it is important to allow enough early_stopping steps to find a good solution."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "kernelspec": {
   "display_name": "tf-latest",
   "language": "python",
   "name": "tf-latest"
  },
  "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.5.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}