Optional Lab - Softmax Function¶
In this lab, we will explore the softmax function. This function is used in both Softmax Regression and in Neural Networks when solving Multiclass Classification problems.
import numpy as np
import matplotlib.pyplot as plt
plt.style.use('./deeplearning.mplstyle')
import tensorflow as tf
from tensorflow.keras.models import Sequential
from tensorflow.keras.layers import Dense
from IPython.display import display, Markdown, Latex
from sklearn.datasets import make_blobs
%matplotlib widget
from matplotlib.widgets import Slider
from lab_utils_common import dlc
from lab_utils_softmax import plt_softmax
import logging
logging.getLogger("tensorflow").setLevel(logging.ERROR)
tf.autograph.set_verbosity(0)
Note: Normally, in this course, the notebooks use the convention of starting counts with 0 and ending with N-1, $\sum_{i=0}^{N-1}$, while lectures start with 1 and end with N, $\sum_{i=1}^{N}$. This is because code will typically start iteration with 0 while in lecture, counting 1 to N leads to cleaner, more succinct equations. This notebook has more equations than is typical for a lab and thus will break with the convention and will count 1 to N.
Softmax Function¶
In both softmax regression and neural networks with Softmax outputs, N outputs are generated and one output is selected as the predicted category. In both cases a vector $\mathbf{z}$ is generated by a linear function which is applied to a softmax function. The softmax function converts $\mathbf{z}$ into a probability distribution as described below. After applying softmax, each output will be between 0 and 1 and the outputs will add to 1, so that they can be interpreted as probabilities. The larger inputs will correspond to larger output probabilities.
The softmax function can be written: $$a_j = \frac{e^{z_j}}{ \sum_{k=1}^{N}{e^{z_k} }} \tag{1}$$ The output $\mathbf{a}$ is a vector of length N, so for softmax regression, you could also write: \begin{align} \mathbf{a}(x) = \begin{bmatrix} P(y = 1 | \mathbf{x}; \mathbf{w},b) \\ \vdots \\ P(y = N | \mathbf{x}; \mathbf{w},b) \end{bmatrix} = \frac{1}{ \sum_{k=1}^{N}{e^{z_k} }} \begin{bmatrix} e^{z_1} \\ \vdots \\ e^{z_{N}} \\ \end{bmatrix} \tag{2} \end{align}
Which shows the output is a vector of probabilities. The first entry is the probability the input is the first category given the input $\mathbf{x}$ and parameters $\mathbf{w}$ and $\mathbf{b}$.
Let's create a NumPy implementation:
def my_softmax(z):
ez = np.exp(z) #element-wise exponenial
sm = ez/np.sum(ez)
return(sm)
Below, vary the values of the z inputs using the sliders.
plt.close("all")
plt_softmax(my_softmax)
Canvas(toolbar=Toolbar(toolitems=[('Home', 'Reset original view', 'home', 'home'), ('Back', 'Back to previous …
As you are varying the values of the z's above, there are a few things to note:
- the exponential in the numerator of the softmax magnifies small differences in the values
- the output values sum to one
- the softmax spans all of the outputs. A change in
z0for example will change the values ofa0-a3. Compare this to other activations such as ReLU or Sigmoid which have a single input and single output.
Cost¶
The loss function associated with Softmax, the cross-entropy loss, is: \begin{equation} L(\mathbf{a},y)=\begin{cases} -log(a_1), & \text{if $y=1$}.\\ &\vdots\\ -log(a_N), & \text{if $y=N$} \end{cases} \tag{3} \end{equation}
Where y is the target category for this example and $\mathbf{a}$ is the output of a softmax function. In particular, the values in $\mathbf{a}$ are probabilities that sum to one.
Recall: In this course, Loss is for one example while Cost covers all examples.
Note in (3) above, only the line that corresponds to the target contributes to the loss, other lines are zero. To write the cost equation we need an 'indicator function' that will be 1 when the index matches the target and zero otherwise. $$\mathbf{1}\{y == n\} = =\begin{cases} 1, & \text{if $y==n$}.\\ 0, & \text{otherwise}. \end{cases}$$ Now the cost is: \begin{align} J(\mathbf{w},b) = -\frac{1}{m} \left[ \sum_{i=1}^{m} \sum_{j=1}^{N} 1\left\{y^{(i)} == j\right\} \log \frac{e^{z^{(i)}_j}}{\sum_{k=1}^N e^{z^{(i)}_k} }\right] \tag{4} \end{align}
Where $m$ is the number of examples, $N$ is the number of outputs. This is the average of all the losses.
Tensorflow¶
This lab will discuss two ways of implementing the softmax, cross-entropy loss in Tensorflow, the 'obvious' method and the 'preferred' method. The former is the most straightforward while the latter is more numerically stable.
Let's start by creating a dataset to train a multiclass classification model.
# make dataset for example
centers = [[-5, 2], [-2, -2], [1, 2], [5, -2]]
X_train, y_train = make_blobs(n_samples=2000, centers=centers, cluster_std=1.0,random_state=30)
The Obvious organization¶
The model below is implemented with the softmax as an activation in the final Dense layer.
The loss function is separately specified in the compile directive.
The loss function is SparseCategoricalCrossentropy. This loss is described in (3) above. In this model, the softmax takes place in the last layer. The loss function takes in the softmax output which is a vector of probabilities.
model = Sequential(
[
Dense(25, activation = 'relu'),
Dense(15, activation = 'relu'),
Dense(4, activation = 'softmax') # < softmax activation here
]
)
model.compile(
loss=tf.keras.losses.SparseCategoricalCrossentropy(),
optimizer=tf.keras.optimizers.Adam(0.001),
)
model.fit(
X_train,y_train,
epochs=10
)
Epoch 1/10 63/63 [==============================] - 1s 2ms/step - loss: 0.8707 Epoch 2/10 63/63 [==============================] - 0s 2ms/step - loss: 0.2938 Epoch 3/10 63/63 [==============================] - 0s 1ms/step - loss: 0.1423 Epoch 4/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0907 Epoch 5/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0705 Epoch 6/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0599 Epoch 7/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0536 Epoch 8/10 63/63 [==============================] - 0s 2ms/step - loss: 0.0487 Epoch 9/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0456 Epoch 10/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0419
<keras.callbacks.History at 0x7583905c5410>
Because the softmax is integrated into the output layer, the output is a vector of probabilities.
p_nonpreferred = model.predict(X_train)
print(p_nonpreferred [:2])
print("largest value", np.max(p_nonpreferred), "smallest value", np.min(p_nonpreferred))
[[4.62e-03 6.60e-03 9.76e-01 1.29e-02] [9.95e-01 5.28e-03 1.33e-04 3.80e-05]] largest value 0.99999785 smallest value 5.557597e-08
Preferred 
Recall from lecture, more stable and accurate results can be obtained if the softmax and loss are combined during training. This is enabled by the 'preferred' organization shown here.
In the preferred organization the final layer has a linear activation. For historical reasons, the outputs in this form are referred to as logits. The loss function has an additional argument: from_logits = True. This informs the loss function that the softmax operation should be included in the loss calculation. This allows for an optimized implementation.
preferred_model = Sequential(
[
Dense(25, activation = 'relu'),
Dense(15, activation = 'relu'),
Dense(4, activation = 'linear') #<-- Note
]
)
preferred_model.compile(
loss=tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True), #<-- Note
optimizer=tf.keras.optimizers.Adam(0.001),
)
preferred_model.fit(
X_train,y_train,
epochs=10
)
Epoch 1/10 63/63 [==============================] - 0s 1ms/step - loss: 1.2443 Epoch 2/10 63/63 [==============================] - 0s 1ms/step - loss: 0.4721 Epoch 3/10 63/63 [==============================] - 0s 1ms/step - loss: 0.2112 Epoch 4/10 63/63 [==============================] - 0s 1ms/step - loss: 0.1214 Epoch 5/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0853 Epoch 6/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0693 Epoch 7/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0596 Epoch 8/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0536 Epoch 9/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0494 Epoch 10/10 63/63 [==============================] - 0s 1ms/step - loss: 0.0460
<keras.callbacks.History at 0x7583705b21d0>
Output Handling¶
Notice that in the preferred model, the outputs are not probabilities, but can range from large negative numbers to large positive numbers. The output must be sent through a softmax when performing a prediction that expects a probability. Let's look at the preferred model outputs:
p_preferred = preferred_model.predict(X_train)
print(f"two example output vectors:\n {p_preferred[:2]}")
print("largest value", np.max(p_preferred), "smallest value", np.min(p_preferred))
two example output vectors: [[-2.71 -3.31 2.25 -1.6 ] [ 4.59 0.04 -5.24 -7.23]] largest value 8.883369 smallest value -13.043844
The output predictions are not probabilities! If the desired output are probabilities, the output should be be processed by a softmax.
sm_preferred = tf.nn.softmax(p_preferred).numpy()
print(f"two example output vectors:\n {sm_preferred[:2]}")
print("largest value", np.max(sm_preferred), "smallest value", np.min(sm_preferred))
two example output vectors: [[6.80e-03 3.71e-03 9.69e-01 2.05e-02] [9.89e-01 1.05e-02 5.34e-05 7.30e-06]] largest value 0.9999975 smallest value 5.8648725e-10
To select the most likely category, the softmax is not required. One can find the index of the largest output using np.argmax().
for i in range(5):
print( f"{p_preferred[i]}, category: {np.argmax(p_preferred[i])}")
[-2.71 -3.31 2.25 -1.6 ], category: 2 [ 4.59 0.04 -5.24 -7.23], category: 0 [ 3.25 0.41 -4.08 -5.65], category: 0 [-1.43 4. -2.98 -0.76], category: 1 [-1.64 -6.04 3.73 -5.15], category: 2
SparseCategorialCrossentropy or CategoricalCrossEntropy¶
Tensorflow has two potential formats for target values and the selection of the loss defines which is expected.
- SparseCategorialCrossentropy: expects the target to be an integer corresponding to the index. For example, if there are 10 potential target values, y would be between 0 and 9.
- CategoricalCrossEntropy: Expects the target value of an example to be one-hot encoded where the value at the target index is 1 while the other N-1 entries are zero. An example with 10 potential target values, where the target is 2 would be [0,0,1,0,0,0,0,0,0,0].
Congratulations!¶
In this lab you
- Became more familiar with the softmax function and its use in softmax regression and in softmax activations in neural networks.
- Learned the preferred model construction in Tensorflow:
- No activation on the final layer (same as linear activation)
- SparseCategoricalCrossentropy loss function
- use from_logits=True
- Recognized that unlike ReLU and Sigmoid, the softmax spans multiple outputs.