Merge pull request tensorflow#3879 from akshayka/getting_started_with_eager

MarkDaoust · web-flow · commit c79ae3855be0 · 2018-04-06T11:36:56.000-07:00
Touch-ups to eager's getting started guide
diff --git a/samples/core/get_started/eager.ipynb b/samples/core/get_started/eager.ipynb
@@ -67,7 +67,7 @@
         "\n",
         "Note: you can run **[this notebook, live in Google Colab](https://colab.research.google.com/github/tensorflow/models/blob/master/samples/core/get_started/eager.ipynb)** with zero setup.\n",
         "\n",
-        "This tutorial describes how to use machine learning to *categorize* Iris flowers by species. It uses [TensorFlow](https://www.tensorflow.org)'s eager execution to 1. build a *model*, 2. *train* the model on example data, and 3. use the model to make *predictions* on unknown data. Machine Learning experience isn't required to follow this guide, but you'll need to read some Python code.\n",
+        "This tutorial describes how to use machine learning to *categorize* Iris flowers by species. It uses [TensorFlow](https://www.tensorflow.org)'s eager execution to (1) build a *model*, (2) *train* the model on example data, and (3) use the model to make *predictions* on unknown data. Machine learning experience isn't required to follow this guide, but you'll need to read some Python code.\n",
         "\n",
         "## TensorFlow programming\n",
         "\n",
@@ -114,7 +114,7 @@
       "source": [
         "### Install the latest version of TensorFlow\n",
         "\n",
-        "This tutorial uses eager execution features available in [TensorFlow 1.7](https://www.tensorflow.org/install/). (You may need to restart the runtime after upgrading.)"
+        "This tutorial uses eager execution, which is available in [TensorFlow 1.7](https://www.tensorflow.org/install/). (You may need to restart the runtime after upgrading.)"
       ]
     },
     {
@@ -534,7 +534,7 @@
       "source": [
         "### Create an optimizer\n",
         "\n",
-        "An *[optimizer](https://developers.google.com/machine-learning/crash-course/glossary#optimizer)* applies the computed gradients to the model's variables to minimize the `loss` function. You can think of a curved surface (see Figure 3) and we want to find its lowest point by walking around. The gradients point in the direction of steepest the ascent—so we'll travel the opposite way and move down the hill. By iteratively calculating the loss and gradients for each *step* (or *[learning rate](https://developers.google.com/machine-learning/crash-course/glossary#learning_rate)*), we'll adjust the model during training. Gradually, the model will find the best combination of weights and bias to minimize loss. And the lower the loss, the better the model's predictions.\n",
+        "An *[optimizer](https://developers.google.com/machine-learning/crash-course/glossary#optimizer)* applies the computed gradients to the model's variables to minimize the `loss` function. You can think of a curved surface (see Figure 3) and we want to find its lowest point by walking around. The gradients point in the direction of steepest ascent—so we'll travel the opposite way and move down the hill. By iteratively calculating the loss and gradient for each batch, we'll adjust the model during training. Gradually, the model will find the best combination of weights and bias to minimize loss. And the lower the loss, the better the model's predictions.\n",
         "\n",
         "<table>\n",
         "  <tr><td>\n",
@@ -546,7 +546,7 @@
         "  </td></tr>\n",
         "</table>\n",
         "\n",
-        "TensorFlow has many [optimization algorithms](https://www.tensorflow.org/api_guides/python/train) available for training. This model uses the [tf.train.GradientDescentOptimizer](https://www.tensorflow.org/api_docs/python/tf/train/GradientDescentOptimizer) that implements the *[standard gradient descent](https://developers.google.com/machine-learning/crash-course/glossary#gradient_descent)* (SGD) algorithm. The `learning_rate` sets the step size to take for each iteration down the hill. This is a *hyperparameter* that you'll commonly adjust to achieve better results."
+        "TensorFlow has many [optimization algorithms](https://www.tensorflow.org/api_guides/python/train) available for training. This model uses the [tf.train.GradientDescentOptimizer](https://www.tensorflow.org/api_docs/python/tf/train/GradientDescentOptimizer) that implements the *[stochastic gradient descent](https://developers.google.com/machine-learning/crash-course/glossary#gradient_descent)* (SGD) algorithm. The `learning_rate` sets the step size to take for each iteration down the hill. This is a *hyperparameter* that you'll commonly adjust to achieve better results."
       ]
     },
     {
@@ -871,4 +871,4 @@
       ]
     }
   ]
-}
+}

Original file line number	Diff line number	Diff line change
`@@ -67,7 +67,7 @@`
`67`	`67`	`"\n",`
`68`	`68`	`"Note: you can run [this notebook, live in Google Colab](https://colab.research.google.com/github/tensorflow/models/blob/master/samples/core/get_started/eager.ipynb) with zero setup.\n",`
`69`	`69`	`"\n",`
`70`		`- "This tutorial describes how to use machine learning to categorize Iris flowers by species. It uses [TensorFlow](https://www.tensorflow.org)'s eager execution to 1. build a model, 2. train the model on example data, and 3. use the model to make predictions on unknown data. Machine Learning experience isn't required to follow this guide, but you'll need to read some Python code.\n",`
	`70`	`+ "This tutorial describes how to use machine learning to categorize Iris flowers by species. It uses [TensorFlow](https://www.tensorflow.org)'s eager execution to (1) build a model, (2) train the model on example data, and (3) use the model to make predictions on unknown data. Machine learning experience isn't required to follow this guide, but you'll need to read some Python code.\n",`
`71`	`71`	`"\n",`
`72`	`72`	`"## TensorFlow programming\n",`
`73`	`73`	`"\n",`
`@@ -114,7 +114,7 @@`
`114`	`114`	`"source": [`
`115`	`115`	`"### Install the latest version of TensorFlow\n",`
`116`	`116`	`"\n",`
`117`		`- "This tutorial uses eager execution features available in [TensorFlow 1.7](https://www.tensorflow.org/install/). (You may need to restart the runtime after upgrading.)"`
	`117`	`+ "This tutorial uses eager execution, which is available in [TensorFlow 1.7](https://www.tensorflow.org/install/). (You may need to restart the runtime after upgrading.)"`
`118`	`118`	`]`
`119`	`119`	`},`
`120`	`120`	`{`
`@@ -534,7 +534,7 @@`
`534`	`534`	`"source": [`
`535`	`535`	`"### Create an optimizer\n",`
`536`	`536`	`"\n",`
`537`		- "An [optimizer](https://developers.google.com/machine-learning/crash-course/glossary#optimizer) applies the computed gradients to the model's variables to minimize the `loss` function. You can think of a curved surface (see Figure 3) and we want to find its lowest point by walking around. The gradients point in the direction of steepest the ascent—so we'll travel the opposite way and move down the hill. By iteratively calculating the loss and gradients for each step (or [learning rate](https://developers.google.com/machine-learning/crash-course/glossary#learning_rate)), we'll adjust the model during training. Gradually, the model will find the best combination of weights and bias to minimize loss. And the lower the loss, the better the model's predictions.\n",
	`537`	+ "An [optimizer](https://developers.google.com/machine-learning/crash-course/glossary#optimizer) applies the computed gradients to the model's variables to minimize the `loss` function. You can think of a curved surface (see Figure 3) and we want to find its lowest point by walking around. The gradients point in the direction of steepest ascent—so we'll travel the opposite way and move down the hill. By iteratively calculating the loss and gradient for each batch, we'll adjust the model during training. Gradually, the model will find the best combination of weights and bias to minimize loss. And the lower the loss, the better the model's predictions.\n",
`538`	`538`	`"\n",`
`539`	`539`	`"<table>\n",`
`540`	`540`	`" <tr><td>\n",`
`@@ -546,7 +546,7 @@`
`546`	`546`	`" </td></tr>\n",`
`547`	`547`	`"</table>\n",`
`548`	`548`	`"\n",`
`549`		- "TensorFlow has many [optimization algorithms](https://www.tensorflow.org/api_guides/python/train) available for training. This model uses the [tf.train.GradientDescentOptimizer](https://www.tensorflow.org/api_docs/python/tf/train/GradientDescentOptimizer) that implements the [standard gradient descent](https://developers.google.com/machine-learning/crash-course/glossary#gradient_descent) (SGD) algorithm. The `learning_rate` sets the step size to take for each iteration down the hill. This is a hyperparameter that you'll commonly adjust to achieve better results."
	`549`	+ "TensorFlow has many [optimization algorithms](https://www.tensorflow.org/api_guides/python/train) available for training. This model uses the [tf.train.GradientDescentOptimizer](https://www.tensorflow.org/api_docs/python/tf/train/GradientDescentOptimizer) that implements the [stochastic gradient descent](https://developers.google.com/machine-learning/crash-course/glossary#gradient_descent) (SGD) algorithm. The `learning_rate` sets the step size to take for each iteration down the hill. This is a hyperparameter that you'll commonly adjust to achieve better results."
`550`	`550`	`]`
`551`	`551`	`},`
`552`	`552`	`{`
`@@ -871,4 +871,4 @@`
`871`	`871`	`]`
`872`	`872`	`}`
`873`	`873`	`]`
`874`		`-}`
	`874`	`+}`