diff --git a/recognize_digits/.gitignore b/recognize_digits/.gitignore
index 3133248ffdf6693eefd367436864396a872689ec..4ca20920b31ca0cd5ae29b1ce27b40a695901235 100644
--- a/recognize_digits/.gitignore
+++ b/recognize_digits/.gitignore
@@ -2,3 +2,5 @@ data/raw_data
data/train.list
data/test.list
*.log
+*.pyc
+plot.png
diff --git a/recognize_digits/README.md b/recognize_digits/README.md
index d04e24e6ce71bcd287aeafe532b361fb67e56ec5..eba6877ac2feb82fe6b747115c45d9c95b552a6d 100644
--- a/recognize_digits/README.md
+++ b/recognize_digits/README.md
@@ -1,310 +1,181 @@
# 手写字符识别教程
## 背景介绍
-当我们学习编程的时候,编写的第一个程序一般是实现打印"Hello World"。而就像编程语言有"Hello World",机器学习则有 [MNIST](http://yann.lecun.com/exdb/mnist/) 数据库。MNIST数据库是手写字符,属于机器学习中典型的图像分类问题,而由于其问题简单,数据集完备,因此常常被作为机器学习入门的教程。
-
-MNIST数据库作为一个简单的计算机视觉数据集,包含一系列如下的手写数字:
-
-
-图1. MNIST图片示例
-
-其同时包含每张图片的标签,标签告诉我们图像中包含的数字是什么。例如,上面的图片中对应的标签为[3, 4, 7, 0, 4, 1, 1, 4, 3, 1]。该数据有60,000条数据的训练集,10,000条数据的测试集。其是更大的数据集NIST的一个子集。MNIST数据集中的数字经过了大小归一化和图片居中的处理。 MNIST数据集从NIST的Special Database 3和Special Database 1构建而来,NIST最初利用SD-3作为训练集,而SD-1作为测试集。然而,SD-3比SD-1更干净,更容易识别,因为SD-3是Census Bureau(人口调查局)的员工进行标注的,而SD-1来自高中生的标注。要训练出合理的模型,需要消除数据集的偏差,因此Yann LeCun等人构建了MNIST数据库,从SD-1和SD-3中各取一半作为MNIST的训练集和测试集,其中训练集来自250位标注员的手写,并且保证了训练集和测试集手写标注员也不相同。
+当我们学习编程的时候,编写的第一个程序一般是实现打印"Hello World"。而机器学习(或深度学习)的入门教程,一般都是 [MNIST](http://yann.lecun.com/exdb/mnist/) 数据库上的手写识别问题。原因是手写识别属于典型的图像分类问题,比较简单,同时MNIST数据集也很完备。
+MNIST数据集作为一个简单的计算机视觉数据集,包含一系列如图1所示的手写数字图片和对应的标签。图片是28x28的像素矩阵,标签则对应着0~9的10个数字。每张图片都经过了大小归一化和居中处理。
-该数据库的提供者Yann LeCun,早先在手写字符识别上做了很多研究,并在研究过程中提出了卷积神经网络,大幅度地提高了手写字符的识别能力,也因此成为了深度学习领域的奠基人之一。如今的深度学习领域,卷积神经网络占据了至关重要的地位,从最早Yann LeCun提出的简单LeNet,到如今ImageNet大赛上的优胜模型VGGNet、GoogLeNet等。现在的卷积神经网络核心与LeNet类似,但它们在网络结构上要复杂很多,有了更多的组织技巧,如GoogLeNet的Inception模块、以及为了防止过拟合的正则和BatchNorm等等方法。
-
-事实上,许多人对MNIST手写字符的识别做了研究,除了采用不同的分类器之外,人们还考虑用许多预处理的方法(如deskewing(去除歪曲),noise removal(去噪),blurring(模糊)等等)来提高识别的准确率。 Yann LeCunn关于[MNIST数据库] (http://yann.lecun.com/exdb/mnist/) 的网站中介绍多种分类器加上多种预处理方法对于该数据库识别效果的表格。
-其中包含的分类器有:
-
-1. 线性分类器(Linear Classifiers)
-2. K-近邻法(K-Nearest Neighbors)
-3. Boosting算法(Boosted Stumps)
-4. 非线性分类器(Non-Linear Classifiers)
-5. 支持向量机(SVMs)
-6. 神经网络(Neural Nets)
-7. 卷积神经网络(Convolutional nets)
-
-我们要介绍的Softmax回归,多层感知器和卷积神经网络就分别对应上面的1、6和7分类器,以下为表格中相关的部分:
+MNIST数据集是从 [NIST](https://www.nist.gov/srd/nist-special-database-19) 的Special Database 3(SD-3)和Special Database 1(SD-1)构建而来。由于SD-3是由美国人口调查局的员工进行标注,SD-1是由美国高中生进行标注,因此SD-3比SD-1更干净也更容易识别。Yann LeCun等人从SD-1和SD-3中各取一半作为MNIST的训练集(60000条数据)和测试集(10000条数据),其中训练集来自250位不同的标注员,此外还保证了训练集和测试集的标注员是不完全相同的。\[[1](#参考文献)\]
-
-
- 分类器 |
- 预处理 |
- 测试误差 |
- 参考文献 |
-
-
-
- linear classifier (1-layer NN) |
- none |
- 12.0 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
- linear classifier (1-layer NN) |
- deskewing |
- 8.4 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
- 2-layer NN, 300 hidden units, mean square error |
- none |
- 4.7 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
-2-layer NN, 300 HU |
- deskewing |
- 1.6 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
- 2-layer NN, 800 HU, Cross-Entropy Loss |
- none |
- 1.6 |
- [Simard et al., ICDAR 2003] (https://www.microsoft.com/en-us/research/publication/best-practices-for-convolutional-neural-networks-applied-to-visual-document-analysis/) |
-
-
-
- Convolutional net LeNet-1 |
- subsampling to 16x16 pixels |
- 1.7 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
- Convolutional net LeNet-4 |
- none |
- 1.1 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
- Convolutional net LeNet-5, [no distortions] |
- none |
- 0.95 |
- [LeCun et al. 1998] (http://yann.lecun.com/exdb/publis/index.html#lecun-98) |
-
-
-
+
+图1. MNIST图片示例
-从上表中,我们可以大致看出模型从简单到复杂的过程中,测试误差逐渐降低。
+Yann LeCun早先在手写字符识别上做了很多研究,并在研究过程中提出了卷积神经网络(Convolutional Neural Network),大幅度地提高了手写字符的识别能力,也因此成为了深度学习领域的奠基人之一。如今的深度学习领域,卷积神经网络占据了至关重要的地位,从最早Yann LeCun提出的简单LeNet,到如今ImageNet大赛上的优胜模型VGGNet、GoogLeNet、ResNet等(请参见[图像分类](https://github.com/PaddlePaddle/book/tree/develop/image_classification) ),人们在图像分类领域,利用卷积神经网络得到了一系列惊人的结果。
-本章中,我们希望通过简单的模型带大家入门利用神经网络进行图像识别,并逐步深入进行模型优化。
+有很多算法在MNIST上进行实验。1998年,LeCun分别用单层线性分类器、多层感知器(Multilayer Perceptron, MLP)和多层卷积神经网络LeNet进行实验,使得测试集上的误差不断下降(从12%下降到0.7%)。此后,科学家们又基于K近邻(K-Nearest Neighbors)算法、支持向量机(SVM)、神经网络和Boosting方法等做了大量实验,并采用多种预处理方法(如去除歪曲、去噪、模糊等)来提高识别的准确率。\[[2-13](#参考文献)\]
+本章中,我们从简单的模型Softmax回归开始,带大家入门手写字符识别,并逐步进行模型优化。
-## 模型概览
-
-###问题说明:
-基于MNIST数据,我们希望训练一个分类器 $f$,对于每张给定的图片数据 $X$ ,预测结果为 $ Y = f(x) $ ,应该尽可能准确的接近真实标签L。
+## 模型概览
-### Softmax回归(Softmax Regression)
-
-这是一个多分类问题,神经网络中通常使用 `softmax` 函数计算多分类问题中每一类的概率。为了熟悉 `softmax` 函数,我们定义最简单的多分类网络:将输入层经过一个线性映射得到的特征,直接通过 `softmax` 函数进行多分类。
+这是一个分类问题,基于MNIST数据,我们希望训练一个分类器 $f$。输入为MNIST数据库的图片, $28\times28$ 的二维图像,为了进行计算,我们一般将上将 $28\times28$ 的二维图像转化为 $n(n=784)$ 维的向量,因此我们采用$x_i(i=0,1,2,...,n-1)$(向量表示为$X$)来表示输入的图片数据。对于每张给定的图片数据 $X$,我们采用$ y_i (i=0,1,2,..9)$(向量表示为 $Y$来表示预测的输出,预测结果为 $ Y = f(X) $。然后,我们用 $label_i$ (向量表示为$L$)来代表标签,则预测结果 $Y$ 应该尽可能准确的接近真实标签 $L$。
-MNIST数据库的图片为 $28X28$ 的二维图像,为了进行计算,我们一般将上将 $28X28$ 的二维图像转化为 $n(n=784)$ 维的向量,因此我们采用$x_i(i=0,1,2,...,n-1)$(向量表示为$X$)来表示输入的图片数据。同时,我们采用$ y_i (i=0,1,2,..9)$(向量表示为 $Y$来表示预测的输出,其含义为:
+$Y$和$L$具体含义为:比如说,$y_i$组成的向量$Y$为[0.2,0.3,0,1,0,0.1,0.1,0.1,0.1,0],每一维分别代表图像数字预测为0~9的概率;而此时$label_i$组成的向量$L$可能为[0,1,0,0,0,0,0,0,0,0],其代表标签为1,即输入$X$代表图片的数字为1。则$Y$和$L$尽可能接近的意思是$Y$中概率最大的一维为$L$中对应的标签,并且概率越大则代表越接近。
-比如说,$y_i$组成的向量$Y$为[0.2,0.3,0,1,0,0.1,0.1,0.1,0.1,0],每一维分别代表图像数字预测为0~9的概率。然后,我们用 $label_i$ (向量表示为$L$)来代表预测的输出。输入层的数据X传到 `softmax` 层,在激活操作之前,会乘以相应的权重 $W$ ,并加上偏置变量 $b$ ,具体如下:
+下面我们一一介绍本章中使用的三个分类器Softmax回归、多层感知器、卷积神经网络。
-$$ net_i = \sum_j W_{i,j}x_j + b_i $$
-`net` 是激活前的值(仅仅进行了矩阵乘法),然后再用 `softmax` 函数进行激活。
+### Softmax回归(Softmax Regression)
-其中 `softmax` 函数的定义如下:
+神经网络中通常使用softmax函数计算多分类问题中每一类的概率。为了熟悉softmax函数,我们定义最简单的多分类网络:将输入层经过一个线性映射得到的特征,直接通过softmax 函数进行多分类。\[[14](#参考文献)\]
-$$ softmax(x_i) = \frac{e^{x_i}}{\sum_j e^{x_j}} $$
+输入层的数据X传到softmax层,在激活操作之前,会乘以相应的权重 $W$ ,并加上偏置变量 $b$ ,具体如下:
-即:
+$$ y_i = softmax(\sum_j W_{i,j}x_j + b_i) $$
-$$ y_i = \frac{e^{net_i}}{\sum_j e^{net_j}} $$
+其中 $ softmax(x_i) = \frac{e^{x_i}}{\sum_j e^{x_j}} $
-在神经网络中,多分类问题一般用 `softmax` 函数来作为输出。对于有 `N` 个类别的多分类问题,指定 `N` 个输出节点,`N` 维输入特征经过 `softmax` 将归一化为 `N` 个[0,1]范围内的实数值,分别表示该样本属于这N个类别的概率。此处的 $y_i$ 即对应该图片为数字 `i` 的预测概率。
+对于有 $N$ 个类别的多分类问题,指定 $N$ 个输出节点,$N$ 维输入特征经过softmax将归一化为 $N$ 个[0,1]范围内的实数值,分别表示该样本属于这 $N$ 个类别的概率。此处的 $y_i$ 即对应该图片为数字 $i$ 的预测概率。
-以下为softmax回归的网络图:
+图2为softmax回归的网络图,图中权重用黑线表示,偏置用红线表示,+1代表偏置参数的系数为1。
图2. softmax回归网络结构图
-注:图中权重用黑线表示,偏置用红线表示,+1代表偏置参数的系数为1
-神经网络模型的构建包括网络配置在内,通常有以下几个步骤:
-
-1. 网络结构配置。
-2. 初始化参数,其中包括训练参数权重W和偏置b,以及超参数训练速度 $\eta$、 `batchSize` 和训练轮次 `Pass` 等等,训练参数随着网络的迭代不断更新,而超参数一般是在网络初始化的时候给定好的。
-3. 前向传播计算网络输出和代价损失函数。
-4. 根据代价损失函数进行反向误差传播,更新训练参数。
-5. 重复3~4步骤,直至网络训练误差达到规定的程度或训练轮次达到设定值。
-
-对于以上步骤4,神经网络的训练采用 `backpropagation` 的形式,其一般会定义一个损失函数(也称目标函数),训练的目的是为了减小目标函数的值。在分类问题中,我们一般采用交叉熵代价损失函数(cross entropy),其形式如下:
+神经网络的训练采用 `backpropagation` 的形式,其一般会定义一个损失函数(也称目标函数),训练的目的是为了减小目标函数的值。在分类问题中,我们一般采用交叉熵代价损失函数(cross entropy),其形式如下:
$$ CE(label, y) = -\sum_i label_ilog(y_i) $$
-注:上面公式为softmax输出层的交叉熵代价损失函数,CE为cross entropy的简称,y是预测每一类的概率,label是标签,为one-hot向量(事实上,由于label为one-hot向量,上面公式中只有一项不为0)。
+上面公式为softmax输出层的交叉熵代价损失函数,CE为cross entropy的简称,y是预测每一类的概率,label是标签。
### 多层感知器(Multilayer Perceptron, MLP)
-在softmax回归中,我们采用了最简单的两层神经网络,分别为输入的datalayer层和输出的 `softmax` 层,模型比较简单,意味着其拟合能力有限。因此,为了达到更好的识别效果,我们可以考虑在输入层和输出层中间加上若干个隐藏层。
+在softmax回归中,我们采用了最简单的两层神经网络,分别为输入的data层和输出的softmax 层。由于这个模型比较简单,其拟合能力有限。因此,为了达到更好的识别效果,我们可以考虑在输入层和输出层中间加上若干个隐藏层。\[[15-16](#参考文献)\]
在该网络层中,我们有输入X($x_i(i=0,1,2,...,n-1)$),输出标签Y($y_i(i=0,1,2,..9)$),为了表示方便,以下我们都直接用向量计算来表示。经过第一层网络,我们可以得到:
-$$ H_1 = activation(W_1X + b_1) $$
+$$ H_1 = \phi(W_1X + b_1) $$
-上面,`activation` 代表激活函数,其常见的为 `sigmoid` ,`tanh` 或 `ReLU` 等函数。
+上面,$\phi$ 代表 [激活函数](#常见激活函数介绍),其常见的为 $sigmoid$ 、$tanh$ 或 $ReLU$ 等函数。
经过第二层网络,可以得到:
-$$ H_2 = activation(W_2H_1 + b_2) $$
+$$ H_2 = \phi(W_2H_1 + b_2) $$
最后,再经过输出层:
$$ Y = softmax(W_3H_2 + b_3) $$
-得到的P即为最后的预测结果向量。
+得到的$Y$即为最后的预测结果向量。
+
+
+图3为多层感知器的网络结构图,图中权重用黑线表示,偏置用红线表示,+1代表偏置参数的系数为1
-
+
图3. 多层感知器网络结构图
-注:图中权重用黑线表示,偏置用红线表示,+1代表偏置参数的系数为1
### 卷积神经网络(Convolutional Neural Network, CNN)
#### 卷积层
-
+
图4. 卷积层图片
-卷积层是卷积神经网络的核心基石。该层的参数由一组可学习的过滤器(也叫作卷积核)组成。在前向过程中,每个卷积核在输入层进行横向和纵向的扫描,与输入层对应扫描位置进行卷积,得到的结果加上偏置并用相应的激活函数进行激活,结果能够得到一个二维的激活图(activation map)。每个特定的卷积核都能得到特定的激活图(activation map),如有的卷积核可能对识别边角,有的可能识别圆圈,那这些卷积核可能对于对应的特征响应要强。
-
-例如,假如我们有如上一个矩阵,用二维矩阵X(X的维度为$5\times5$)表示,然后我们用K组卷积核(filter)来扫描图片,卷积核(filter)的大小为 F = 3,扫描的Padding(P=0),扫描步长Stride(S=1)。则该次扫描会输出K个特征图(feature map),其中每个特征图的大小为 $ \frac{5-3}{1} + 1 = 3$,即为$3\times3$。设输出为Y,以其中一个卷积核为例,卷积核参数为$W_0$,偏置为$b_0$,则该卷积核扫描的输出结果如下:
+卷积层是卷积神经网络的核心基石。该层的参数由一组可学习的过滤器(也叫作卷积核)组成。在前向过程中,每个卷积核在输入层进行横向和纵向的扫描,与输入层对应扫描位置进行卷积,得到的结果加上偏置并用相应的激活函数进行激活,结果能够得到一个二维的激活图(activation map)。每个特定的卷积核都能得到特定的激活图(activation map),如有的卷积核可能对识别边角,有的可能识别圆圈,那这些卷积核可能对于对应的特征响应要强。\[[17](#参考文献)\]
-$$ Y_{0,0,0} = sum( X[:3, :3] * W0 ) + b0 $$
-
-$$ Y_{1,0,0} = sum( X[1:4, :3] * W0 ) + b0 $$
-
-$$ Y_{2,0,0} = sum( X[2:5, :3] * W0 ) + b0 $$
-
-上图中计算的即为 $Y_{1,0,0}$的值,sum函数为对矩阵的所有元素求和。
+图4是卷积层的一个动态图。由于3D量难以表示,所有的3D量(输入的3D量(蓝色),权重3D量(红色),输出3D量(绿色))通过将深度在行上堆叠来表示。如图4,输入层是$W_1=5,H_1=5,D_1=3$,我们常见的彩色图片其实就是类似这样的输入层,彩色图片的宽和高对应这里的$W_1$和$H_1$,而彩色图片有RGB三个颜色通道,对应这里的$D_1$;卷积层的参数为$K=2,F=3,S=2,P=1$,这里的$K$是卷积核的数量,如图4中有$Filter W_0$和$Filter W_1$两个卷积核,$F$对应卷积核的大小,图中$W0$和$W1$在每一层深度上都是$3\times3$的矩阵,$S$对应卷积核扫描的步长,从动态图中可以看到,方框每次左移或下移2个单位,$P$对应Padding扩展,是对输入层的扩展,图中输入层,原始数据为蓝色部分,可以看到灰色部分是进行了大小为1的扩展,用0来进行扩展;图4的动态可视化对输出层结果(绿色)进行迭代,显示每个输出元素是通过将突出显示的输入(蓝色)与滤波器(红色)进行元素相乘,将其相加,然后通过偏置抵消结果来计算的。\[[18](#参考文献)\]
#### 池化层
-
+
图5. 池化层图片
-卷积神经网络另外一个重要的概念就是池化层,这是非线性下采样的一种形式。有许多种非线性函数能够完成下采样的功能,而其中用的最多的就是最大池化。如上所示,其用特定大小不重叠的矩形框将输入层分成不同的区域,然后对于每一个矩形框内的数,取最大值来代表这个区域,从而得到输出层。池化层的主要作用是减少网络的参数,从而能够减小计算量,并且能够控制过拟合。通常情况下在卷积层的后面都会加上一个池化层。
-
-池化包括最大池化、平均池化等等。
+池化是非线性下采样的一种形式,主要作用是通过减少网络的参数来减小计算量,并且能够在一定程度上控制过拟合。通常在卷积层的后面会加上一个池化层。
-例如,对于图上的矩阵,用二维矩阵X(X的维度为$4\times4$)表示,采用$F=2$的$2\times2$的过滤器(filter)进行最大池化,步长Stride设置为$S=2$,由于$F=S$,该池化为不重叠池化。
+池化包括最大池化、平均池化等。其中最大池化是用不重叠的矩形框将输入层分成不同的区域,对于每个矩形框的数取最大值作为输出层,如图5所示。
-
-#### LeNet-5网络
+#### LeNet-5网络
图6. 卷积神经网络结构
-上面的网络是典型的LeNet结构,从中我们可以看出,从输入的二维图像,经过两次卷积->池化,然后再经过全连接,最后的输出层是 `softmax` 分类层。
-
-更详细的关于卷积神经网络的具体知识可以参考 [cs231n] ( http://cs231n.github.io/convolutional-networks/ )
+LeNet-5网络的典型结构是:输入的二维图像,首先经过两次卷积层到池化层,再经过全连接层,最后使用softmax分类作为输出层。\[[20](#参考文献)\]
-### 常见激活函数介绍
-- sigmoid激活函数:
+相比于全连接层的多层感知器来说,卷积神经网络有以下特性,这三个特性决定了卷积能够更好的识别图像。\[[17](#参考文献)\]
-$$ f(x) = \frac{1}{1+e^{-x}} $$
+- 神经元的三维特性: 卷积层的神经元在宽度、高度和深度上进行了组织排列。每一层的神经元仅仅与前一层的一块小区域连接,这块小区域被称为感受野。
+- 局部连接:CNN通过在相邻层的神经元之间实施局部连接模式来利用空间局部相关性。这样的结构保证了学习后的过滤器能够对于局部的输入特征有最强的响应。堆叠许多这样的层导致非线性“过滤器”变得越来越“全局”。这允许网络首先创建输入的小部分的良好表示,然后从它们组合较大区域的表示。
+- 共享权重:在CNN中,每个滤波器在整个视野中重复扫描。 这些复制单元共享相同的参数化(权重向量和偏差)并形成特征图。 这意味着给定卷积层中的所有神经元检测完全相同的特征。 以这种方式的复制单元允许不管它们在视野中的位置都能检测到特征,从而构成平移不变性的性质。
-- tanh激活函数:
+更详细的关于卷积神经网络的具体知识可以参考斯坦福大学公开课 [cs231n]( http://cs231n.github.io/convolutional-networks/ )
-$$ f(x) = tanh(x) = \frac{e^x-e^{-x}}{e^x+e^{-x}} $$
+### 常见激活函数介绍
+- sigmoid激活函数: $ f(x) = \frac{1}{1+e^{-x}} $
-实际上,`tanh` 函数只是规模变化的 `sigmoid` 函数:
+- tanh激活函数: $ f(x) = tanh(x) = \frac{e^x-e^{-x}}{e^x+e^{-x}} $
-$$ tanh(x) = 2sigmoid(2x) - 1 $$
+实际上,$tanh$ 函数只是规模变化的 $sigmoid$ 函数,将 $sigmoid$函数值放大2倍之后再向下平移1个单位:$ tanh(x) = 2sigmoid(2x) - 1 $
-- ReLU激活函数:
-
-$$ f(x) = max(0, x) $$
+- ReLU激活函数: $ f(x) = max(0, x) $
+更详细的介绍请参考\[[19](#参考文献)\]
## 数据准备
### 数据介绍与下载
-- 我们首先下载 MNIST数据库,该数据库是手写字符识别常用的数据库。执行以下命令,进行下载:
+执行以下命令,下载[MNIST](http://yann.lecun.com/exdb/mnist/)数据库并解压缩,然后将训练集和测试集的地址分别写入train.list和test.list两个文件,供PaddlePaddle读取。
```bash
./data/get_mnist_data.sh
```
-- 将下载下来的数据进行 `gzip` 解压,可以在文件夹 `data/raw_data` 中找到以下文件:
-
-
+将下载下来的数据进行 `gzip` 解压,可以在文件夹 `data/raw_data` 中找到以下文件:
| 文件名称 | 说明 |
|----------------------|-------------------------|
-|t10k-images-idx3-ubyte | 测试数据图片,10,000条数据 |
-|t10k-labels-idx1-ubyte | 测试数据标签,10,000条数据 |
|train-images-idx3-ubyte| 训练数据图片,60,000条数据 |
|train-labels-idx1-ubyte| 训练数据标签,60,000条数据 |
+|t10k-images-idx3-ubyte | 测试数据图片,10,000条数据 |
+|t10k-labels-idx1-ubyte | 测试数据标签,10,000条数据 |
-
-
-
-- MNIST的每条数据可以分为两部分:手写字符图片和对应的标签。图片是28X28的像素矩阵,而标签则对应着0~9的10个数字,我们随机选取训练集中的10张图片进行绘制,并给出选取图片对应的标签,绘制脚本为 `./data/draw_data.py`。
-
-
-
-
+用户可以通过以下脚本随机绘制10张图片(可参考图1):
-```python
-label: [3, 4, 7, 0, 4, 1, 1, 4, 3, 1]
+```bash
+./load_data.py
```
### 提供数据给PaddlePaddle
-首先是用PaddlePaddle的 `PyDataProvider2` 来为模型导入数据,如 `mnist_provider.py` 中所示。
-
-在下面代码中,`process` 函数读取MNIST数据,然后用 `yield` 函数返回数据的生成器,然后用 `@provider` 对返回的数据进行包装
-(具体的过程见 `PaddlePaddle_root_path/python/paddle/trainer/PyDataProvider2.py`,从而方便以PaddlePaddle DataProvider对象的形式进行调用。
+我们使用python接口传递数据给系统,下面 `mnist_provider.py`针对MNIST数据给出了完整示例。
```python
# Define a py data provider
@provider(
input_types={'pixel': dense_vector(28 * 28),
- 'label': integer_value(10)},
- cache=CacheType.CACHE_PASS_IN_MEM)
+ 'label': integer_value(10)})
def process(settings, filename): # settings is not used currently.
- imgf = filename + "-images-idx3-ubyte"
- labelf = filename + "-labels-idx1-ubyte"
- f = open(imgf, "rb")
- l = open(labelf, "rb")
-
- f.read(16)
- l.read(8)
+ with open( filename + "-images-idx3-ubyte", "rb") as f: # 打开图片文件
+ magic, n, rows, cols = struct.upack(">IIII", f.read(16)) # 读取开头的四个参数,magic代表数据的格式,n代表数据的总量,rows和cols分别代表行数和列数
+ images = np.fromfile( # 以无符号字节为单位一个一个的读取数据
+ f, 'ubyte',
+ count=n * rows * cols).reshape(n, rows, cols).astype('float32')
+ images = images / 255.0 * 2.0 - 1.0 # 将0~255的数据归一化到[-1,1]的区间
- # Define number of samples for train/test
- if "train" in filename:
- n = 60000
- else:
- n = 10000
- images = numpy.fromfile(
- f, 'ubyte', count=n * 28 * 28).reshape((n, 28 * 28)).astype('float32')
- images = images / 255.0 * 2.0 - 1.0
- labels = numpy.fromfile(l, 'ubyte', count=n).astype("int")
+ with open( filename + "-labels-idx1-ubyte", "rb") as l: # 打开标签文件
+ magic, n = struct.upack(">II", l.read(8)) # 读取开头的两个参数
+ labels = np.fromfile(l, 'ubyte', count=n).astype("int") # 以无符号字节为单位一个一个的读取数据
for i in xrange(n):
yield {"pixel": images[i, :], 'label': labels[i]}
-
- f.close()
- l.close()
```
@@ -312,11 +183,9 @@ def process(settings, filename): # settings is not used currently.
### 数据定义
-首先配置数据,如上给出在训练过程中,训练(train_list)和测试数据集(test_list)的位置,指定数据提供模块(module)函数,目标函数(obj)代表在module中提供数据的函数。
+在模型配置中,定义通过 `define_py_data_sources2` 函数从 `dataprovider` 中读入数据,如果该配置用于预测,则不需要数据定义部分。
```python
-####################Data Configuration ##################
-
if not is_predict:
data_dir = './data/'
define_py_data_sources2(
@@ -328,11 +197,14 @@ def process(settings, filename): # settings is not used currently.
### 算法配置
- 然后指定训练相关的参数,`batch` 大小( `batch_size` )表示神经网络每次训练使用的数据为128条,训练速度( `learning_rate` )是迭代
-的速度,影响着网络的训练收敛速度有关系,训练方法( `learning_method` )代表训练过程在更新权重时采用动量优化器( `MomentumOptimizer` ),其中参数0.9代表动量优化每次保持前一次速度的0.9倍,正则化( `regularization` )是防止网络过拟合的一种手段,此处采用L2正则化。
+然后指定训练相关的参数。
+
+- batch_size: 表示神经网络每次训练使用的数据为128条。
+- 训练速度(learning_rate): 迭代的速度,影响着网络的训练收敛速度有关系。
+- 训练方法(learning_method): 代表训练过程在更新权重时采用动量优化器( `MomentumOptimizer` ),其中参数0.9代表动量优化每次保持前一次速度的0.9倍。
+- 正则化(regularization): 是防止网络过拟合的一种手段,此处采用L2正则化。
```python
-######################Algorithm Configuration #############
settings(
batch_size=128,
learning_rate=0.1 / 128.0,
@@ -344,72 +216,72 @@ settings(
#### Softmax回归
-定义好 `dataprovider` 之后,就可以通过 `data_layer` 调用来获取数据 `img`,然后通过一层简单的 `softmax`全连接层,得到预测的结果,然后指定训练的损失函数为分类损失( `classification_cost` ),一般分类问题的损失函数为交叉熵损失函数( `cross_entropy` )。通过控制变量 `is_predict` ,该配置脚本也可以在预测时候使用,将 `is_predict` 置为 `True` ,则最后直接输出预测结果,而不会经过损失函数来进行训练过程。
+定义好 `dataprovider` 之后,就可以通过 `data_layer` 调用来获取数据 `img`,然后通过一层简单的softmax全连接层,得到预测的结果,然后指定训练的损失函数为分类损失( `classification_cost` ),一般分类问题的损失函数为交叉熵损失函数( `cross_entropy` )。通过控制变量 `is_predict` ,该配置脚本也可以在预测时候使用,将 `is_predict` 置为 `True` ,则最后直接输出预测结果,而不会经过损失函数来进行训练过程。
```python
-#######################Network Configuration #############
-
data_size = 1 * 28 * 28
label_size = 10
img = data_layer(name='pixel', size=data_size)
-# softmax regression is used
-predict = fc_layer(input=img, size=10, act=SoftmaxActivation())
+def softmax_regression(img):
+ predict = fc_layer(input=img, size=10, act=SoftmaxActivation())
+ return predict
```
#### 多层感知器
-以下是一个简单的带有两个隐藏层的多层感知器,也就是全连接网络,两个隐藏层的激活函数均采用 `ReLU` 函数,最后的输出层用`softmax` 激活函数。
+以下是一个简单的带有两个隐藏层的多层感知器,也就是全连接网络,两个隐藏层的激活函数均采用 $ReLU$ 函数,最后的输出层用softmax激活函数。
```python
-#######################Network Configuration #############
-
-# The first fully-connected layer
-hidden1 = fc_layer(input=img, size=128, act=ReluActivation())
-# The second fully-connected layer and the according activation function
-hidden2 = fc_layer(input=hidden1, size=64, act=ReluActivation())
-# The thrid fully-connected layer, note that the hidden size should be 10,
-# which is the number of unique digits
-predict = fc_layer(input=hidden2, size=10, act=SoftmaxActivation())
+def multilayer_perceptron(img):
+ # The first fully-connected layer
+ hidden1 = fc_layer(input=img, size=128, act=ReluActivation())
+ # The second fully-connected layer and the according activation function
+ hidden2 = fc_layer(input=hidden1, size=64, act=ReluActivation())
+ # The thrid fully-connected layer, note that the hidden size should be 10,
+ # which is the number of unique digits
+ predict = fc_layer(input=hidden2, size=10, act=SoftmaxActivation())
+ return predict
```
-#### 卷积神经网络LeNet-5
+#### 卷积神经网络LeNet-5
-以下为LeNet-5的网络结构
+以下为LeNet-5的网络结构\[[20](#参考文献)\]
```python
-#######################Network Configuration #############
-
-# first conv layer
-conv_pool_1 = simple_img_conv_pool(
- input=img,
- filter_size=5,
- num_filters=20,
- num_channel=1,
- pool_size=2,
- pool_stride=2,
- act=TanhActivation())
-# second conv layer
-conv_pool_2 = simple_img_conv_pool(
- input=conv_pool_1,
- filter_size=5,
- num_filters=50,
- num_channel=20,
- pool_size=2,
- pool_stride=2,
- act=TanhActivation())
-# The first fully-connected layer
-fc1 = fc_layer(input=conv_pool_2, size=128, act=TanhActivation())
-# The softmax layer, note that the hidden size should be 10,
-# which is the number of unique digits
-predict = fc_layer(input=fc1, size=10, act=SoftmaxActivation())
+def convolutional_neural_network(img):
+ # first conv layer
+ conv_pool_1 = simple_img_conv_pool(
+ input=img,
+ filter_size=5,
+ num_filters=20,
+ num_channel=1,
+ pool_size=2,
+ pool_stride=2,
+ act=TanhActivation())
+ # second conv layer
+ conv_pool_2 = simple_img_conv_pool(
+ input=conv_pool_1,
+ filter_size=5,
+ num_filters=50,
+ num_channel=20,
+ pool_size=2,
+ pool_stride=2,
+ act=TanhActivation())
+ # The first fully-connected layer
+ fc1 = fc_layer(input=conv_pool_2, size=128, act=TanhActivation())
+ # The softmax layer, note that the hidden size should be 10,
+ # which is the number of unique digits
+ predict = fc_layer(input=fc1, size=10, act=SoftmaxActivation())
+ return predict
```
-## 训练模型
-最后,就可以通过配置训练脚本 `train.sh` 来执行训练过程:
+## 训练命令及日志
+
+1.通过配置训练脚本 `train.sh` 来执行训练过程
```bash
-config=softmax_mnist.py # mlp: mlp_mnist.py cnn: cnn_mnist.py
+config=mnist_model.py # 在mnist_model.py中可以选择网络
output=./softmax_mnist_model # mlp: ./mlp_mnist_model cnn: ./cnn_mnist_model
log=softmax_train.log # mlp: mlp_train.log cnn: cnn_train.log
@@ -441,113 +313,128 @@ python -m paddle.utils.plotcurve -i $log > plot.png
模型训练的日志类似如下:
```
-I1227 02:58:08.519176 275 Util.cpp:229] copy mlp_mnist.py to ./mlp_mnist_model/pass-00087
+I0117 12:52:29.628617 4538 TrainerInternal.cpp:165] Batch=100 samples=12800 AvgCost=2.63996 CurrentCost=2.63996 Eval: classification_error_evaluator=0.241172 CurrentEval: classification_error_evaluator=0.241172
.........
-I1227 02:58:09.395433 275 TrainerInternal.cpp:165] Batch=100 samples=12800 AvgCost=0.200571 CurrentCost=0.200571 Eval: classification_error_evaluator=0.0621875 CurrentEval: classification_error_evaluator=0.0621875
+I0117 12:52:29.768741 4538 TrainerInternal.cpp:165] Batch=200 samples=25600 AvgCost=1.74027 CurrentCost=0.840582 Eval: classification_error_evaluator=0.185234 CurrentEval: classification_error_evaluator=0.129297
.........
-I1227 02:58:10.265552 275 TrainerInternal.cpp:165] Batch=200 samples=25600 AvgCost=0.21248 CurrentCost=0.224389 Eval: classification_error_evaluator=0.065625 CurrentEval: classification_error_evaluator=0.0690625
+I0117 12:52:29.916970 4538 TrainerInternal.cpp:165] Batch=300 samples=38400 AvgCost=1.42119 CurrentCost=0.783026 Eval: classification_error_evaluator=0.167786 CurrentEval: classification_error_evaluator=0.132891
.........
-I1227 02:58:11.120333 275 TrainerInternal.cpp:165] Batch=300 samples=38400 AvgCost=0.209837 CurrentCost=0.204553 Eval: classification_error_evaluator=0.0649479 CurrentEval: classification_error_evaluator=0.0635938
-.........
-I1227 02:58:11.964988 275 TrainerInternal.cpp:165] Batch=400 samples=51200 AvgCost=0.215699 CurrentCost=0.233282 Eval: classification_error_evaluator=0.0667773 CurrentEval: classification_error_evaluator=0.0722656
-......I1227 02:58:12.554342 275 TrainerInternal.cpp:181] Pass=88 Batch=469 samples=60000 AvgCost=0.218966 Eval: classification_error_evaluator=0.0676833
-I1227 02:58:12.871682 275 Tester.cpp:109] Test samples=10000 cost=0.214518 Eval: classification_error_evaluator=0.064
-I1227 02:58:12.871961 275 GradientMachine.cpp:113] Saving parameters to ./mlp_mnist_model/pass-00088
-I1227 02:58:12.873564 275 Util.cpp:229] copy mlp_mnist.py to ./mlp_mnist_model/pass-00088
-.
+I0117 12:52:30.061213 4538 TrainerInternal.cpp:165] Batch=400 samples=51200 AvgCost=1.23965 CurrentCost=0.695054 Eval: classification_error_evaluator=0.160039 CurrentEval: classification_error_evaluator=0.136797
+......I0117 12:52:30.223270 4538 TrainerInternal.cpp:181] Pass=0 Batch=469 samples=60000 AvgCost=1.1628 Eval: classification_error_evaluator=0.156233
+I0117 12:52:30.366894 4538 Tester.cpp:109] Test samples=10000 cost=0.50777 Eval: classification_error_evaluator=0.0978
```
-## 应用模型
-### 训练误差图及评估
-用脚本 `plot_error.py` 可以画出训练过程中的误差变化曲线:
+2.用脚本 `plot_cost.py` 可以画出训练过程中的误差变化曲线:
```bash
-python plot_error.py softmax_train.log # mlp: mlp_train.log cnn: cnn_train.log
+python plot_cost.py softmax_train.log # mlp: mlp_train.log cnn: cnn_train.log
```
-#### softmax回归
-
-
-
-图8. softmax回归训练误差图
-
-
-用脚本 `evaluate.py ` 可以选出最好的Pass训练出来的模型,可以执行以下命令:
+3.用脚本 `evaluate.py ` 可以选出最好的Pass训练出来的模型:
```bash
python evaluate.py softmax_train.log
```
-得到的结果类似如下:
+#### softmax回归的训练结果
+
+
+
+图7. softmax回归的误差曲线图
+
+
+评估模型结果如下:
```text
-Best pass is 00047, error is 0.473053, which means predict get error as 0.343894
-The classification accuracy is 89.49%
+Best pass is 00013, testing Avgcost is 0.484447
+The classification accuracy is 90.01%
```
-从上面过程中可以看到,softmax回归模型分类效果最好的时候是pass-00047,分类准确率为89.49%,而最终的pass-00099的准确率为85.39%。从图中也可以看出,准确率最好的时候并以不定是最后一个pass的模型。
+从上面过程中可以看到,softmax回归模型分类效果最好的时候是pass-00013,分类准确率为90.01%,而最终的pass-00099的准确率为89.3%。从图中也可以看出,准确率最好的时候并以不定是最后一个pass的模型(这是因为迭代的中间Pass可能已经收敛达到局部最优值,后面的训练可能是在该局部最优值震荡或者达到另外的低于中间Pass局部最优值的其他局部最优。)
-#### 多层感知器
+#### 多层感知器的训练结果
-
-图9. 多层感知器训练误差图
+
+图8. 多层感知器的误差曲线图
+评估模型结果如下:
+
```text
-Best pass is 00085, error is 0.164746, which means predict get error as 0.202945
+Best pass is 00085, testing Avgcost is 0.164746
The classification accuracy is 94.95%
```
-从训练日志中我们可以看出,最终训练的准确率为94.95%。这是多层感知器网络分类分类效果,可以看到其相对于softmax回归来说有了显著的分类效果的提升。但是,这还不是最好的分类效果,后面,我们可以看到卷积神经网络对于图像分类能够达到更为惊人的准确率。
+从训练日志中我们可以看出,最终训练的准确率为94.95%,相比于softmax回归模型有了显著的提升(这是因为softmax回归模型较为简单,无法拟合更为复杂的数据,而加入了隐藏层之后的多层感知器则具有更强的拟合能力)。
-#### 卷积神经网络
+#### 卷积神经网络的训练结果
-
-图10. 卷积神经网络训练误差图
+
+图9. 卷积神经网络的误差曲线图
+评估模型结果如下:
+
```text
-Best pass is 00076, error is 0.0244684, which means predict get error as 0.078212
+Best pass is 00076, testing Avgcost is 0.0244684
The classification accuracy is 99.20%
```
-从训练日志中我们可以看出,最终训练的准确率为99.20%。由此可以看到,对于图像问题而言,卷积神经网络能够比一般全连接网络达到更好的识别效果,而这与卷积层的性质是分不开的。同时,我们可以看到,卷积神经网络在很早的时候就能达到好的效果,说明其训练收敛的速度很快。
+从评估模型的结果可以看到,卷积神经网络的最好分类准确率达到惊人的99.20%。由此可以看到,对于图像问题而言,卷积神经网络能够比一般的全连接网络达到更好的识别效果,而这与卷积层具有局部连接和共享权重的特性是分不开的。同时,从图9中可以看到,卷积神经网络在很早的时候就能达到很好的效果,说明其收敛速度非常快。
+## 应用模型
### 预测命令与结果
-用脚本 `predict.py` 用训练好的模型进行预测,例如softmax回归中:
+脚本 `predict.py` 可以对训练好的模型进行预测,例如softmax回归中:
- -c 指定模型的结构
- -d 指定需要预测的数据源,这里用测试数据集进行预测
- -m 指定模型的参数,这里用之前训练效果最好的模型进行预测
```bash
-python predict.py -c softmax_mnist.py -d ../data/raw_data/ -m softmax_mnist_model/pass-00047
+python predict.py -c softmax_mnist.py -d data/raw_data/ -m softmax_mnist_model/pass-00047
```
-根据提示,输入需要预测的图片的序号,则分类器能够给出预测的结果和实际的标签。
+根据提示,输入需要预测的图片序号,则分类器能够给出各个数字的生成概率、预测的结果(取最大生成概率对应的数字)和实际的标签。
```
Input image_id [0~9999]: 3
+Predicted probability of each digit:
[[ 1.00000000e+00 1.60381094e-28 1.60381094e-28 1.60381094e-28
1.60381094e-28 1.60381094e-28 1.60381094e-28 1.60381094e-28
1.60381094e-28 1.60381094e-28]]
-0 0
+Predict Number: 0
+Actual Number: 0
```
-上面,给出的向量是神经网络输出的十维向量,可以理解为分类为各个数字的概率,实际预测的类即为向量中值最大的一项。如上,代表该分类器接近100%的认为该图片上面的数字为0,而实际标签给出的类也确实如此。
+从结果看出,该分类器接近100%地认为第3张图片上面的数字为0,而实际标签给出的类也确实如此。
## 总结
-从上面的过程中,我们了解到了softmax回归、多层感知器和卷积神经网络都是最基础的机器学习模型,而复杂的神经网络都是从这些衍生出来的,因此了解了这些基本的东西之后,对于我们之后的学习大有裨益。在这过程中,我们也观察到当我们将模型从简单的Softmax回归到稍微复杂的卷积神经网络的时候,识别准确率有了大幅度的提升,而这与卷积层的加入是密切联系的,这启发我们在之后遇到新的模型的时候,要认识到新模型相对于其他模型来说效果提升的关键之处。此外,在体验用PaddlePaddle搭建模型识别MNIST图片的同时我们了解了PaddlePaddle模型搭建的过程,从dataprovider的编写,到网络层的构建,到最后的训练和预测,是用PaddlePaddle实现自定义模型的一个基本流程。对这个流程熟悉以后,我们可以用自己的数据,定义自己的网络模型,来完成自己的训练和预测任务。
+
+本章的softmax回归、多层感知器和卷积神经网络是最基础的深度学习模型,后续章节中复杂的神经网络都是从它们衍生出来的,因此这几个模型对之后的学习大有裨益。同时,我们也观察到从最简单的softmax回归到稍复杂的卷积神经网络的时候,MNIST数据集上的识别准确率有了大幅度的提升,原因是卷积层局部连接和共享权重的特性。在之后学习新模型的时候,希望大家也要深入到新模型相比原模型带来效果提升的关键之处。此外,本章还介绍了PaddlePaddle模型搭建的基本流程,从dataprovider的编写、网络层的构建,到最后的训练和预测。对这个流程熟悉以后,大家就可以用自己的数据,定义自己的网络模型,并完成自己的训练和预测任务。
## 参考文献
-1. http://yann.lecun.com/exdb/mnist/
+1. Yann LeCun网站MNIST数据库介绍 http://yann.lecun.com/exdb/mnist/
2. LeCun, Yann, et al. "Gradient-based learning applied to document recognition." Proceedings of the IEEE 86.11 (1998): 2278-2324.
3. Simard, Patrice Y., David Steinkraus, and John C. Platt. "Best practices for convolutional neural networks applied to visual document analysis." ICDAR. Vol. 3. 2003.
-4. Rosenblatt F. The perceptron: a probabilistic model for information storage and organization in the brain[J]. Psychological review, 1958, 65(6): 386.
-5. Bishop C M. Pattern recognition[J]. Machine Learning, 2006, 128.
-6. http://cs231n.github.io/convolutional-networks/
+4. Keysers, Daniel, et al. "Deformation models for image recognition." IEEE Transactions on Pattern Analysis and Machine Intelligence 29.8 (2007): 1422-1435.
+5. Mori, Greg, and Jitendra Malik. "Estimating human body configurations using shape context matching." European conference on computer vision. Springer Berlin Heidelberg, 2002.
+6. Kégl, Balázs, and Róbert Busa-Fekete. "Boosting products of base classifiers." Proceedings of the 26th Annual International Conference on Machine Learning. ACM, 2009.
+7. Decoste, Dennis, and Bernhard Schölkopf. "Training invariant support vector machines." Machine learning 46.1-3 (2002): 161-190.
+8. Simard, Patrice Y., David Steinkraus, and John C. Platt. "Best practices for convolutional neural networks applied to visual document analysis." ICDAR. Vol. 3. 2003.
+9. Salakhutdinov, Ruslan, and Geoffrey E. Hinton. "Learning a Nonlinear Embedding by Preserving Class Neighbourhood Structure." AISTATS. 2007.
+10. Ciresan, Dan Claudiu, et al. "Deep, big, simple neural nets for handwritten digit recognition." Neural computation 22.12 (2010): 3207-3220.
+11. Ciresan, Dan C., et al. "Flexible, high performance convolutional neural networks for image classification." IJCAI Proceedings-International Joint Conference on Artificial Intelligence. Vol. 22. No. 1. 2011.
+12. Deng, Li, et al. "Binary coding of speech spectrograms using a deep auto-encoder." Interspeech. 2010.
+13. Lauer, Fabien, Ching Y. Suen, and Gérard Bloch. "A trainable feature extractor for handwritten digit recognition." Pattern Recognition 40.6 (2007): 1816-1824.
+14. 维基百科Softmax函数介绍 https://en.wikipedia.org/wiki/Softmax_function
+15. Rosenblatt F. The perceptron: a probabilistic model for information storage and organization in the brain[J]. Psychological review, 1958, 65(6): 386.
+16. Bishop C M. Pattern recognition[J]. Machine Learning, 2006, 128.
+17. 维基百科卷积神经网络介绍 https://en.wikipedia.org/wiki/Convolutional_neural_network
+18. 斯坦福大学公开课cs231n http://cs231n.github.io/convolutional-networks/
+19. 维基百科激活函数介绍 https://en.wikipedia.org/wiki/Activation_function
+20. LeNet网站 http://yann.lecun.com/exdb/lenet/
diff --git a/recognize_digits/cnn_mnist.py b/recognize_digits/cnn_mnist.py
deleted file mode 100644
index 82e00e0929cd6d64ab9d18cc82f5a99d5cc2367a..0000000000000000000000000000000000000000
--- a/recognize_digits/cnn_mnist.py
+++ /dev/null
@@ -1,71 +0,0 @@
-# Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserved
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from paddle.trainer_config_helpers import *
-
-is_predict = get_config_arg("is_predict", bool, False)
-
-####################Data Configuration ##################
-
-if not is_predict:
- data_dir = './data/'
- define_py_data_sources2(
- train_list=data_dir + 'train.list',
- test_list=data_dir + 'test.list',
- module='mnist_provider',
- obj='process')
-
-######################Algorithm Configuration #############
-settings(
- batch_size=128,
- learning_rate=0.1 / 128.0,
- learning_method=MomentumOptimizer(0.9),
- regularization=L2Regularization(0.0005 * 128))
-
-#######################Network Configuration #############
-
-data_size = 1 * 28 * 28
-label_size = 10
-img = data_layer(name='pixel', size=data_size)
-
-# first conv layer
-conv_pool_1 = simple_img_conv_pool(
- input=img,
- filter_size=5,
- num_filters=20,
- num_channel=1,
- pool_size=2,
- pool_stride=2,
- act=TanhActivation())
-# second conv layer
-conv_pool_2 = simple_img_conv_pool(
- input=conv_pool_1,
- filter_size=5,
- num_filters=50,
- num_channel=20,
- pool_size=2,
- pool_stride=2,
- act=TanhActivation())
-# The first fully-connected layer
-fc1 = fc_layer(input=conv_pool_2, size=128, act=TanhActivation())
-# The softmax layer, note that the hidden size should be 10,
-# which is the number of unique digits
-predict = fc_layer(input=fc1, size=10, act=SoftmaxActivation())
-
-if not is_predict:
- lbl = data_layer(name="label", size=label_size)
- inputs(img, lbl)
- outputs(classification_cost(input=predict, label=lbl))
-else:
- outputs(predict)
diff --git a/recognize_digits/data/get_mnist_data.sh b/recognize_digits/data/get_mnist_data.sh
index 5a71d4f1ed14c4af6dbad78fea82029c1a34e490..8d5cf179a940be06288d283e8a783b28d038acad 100755
--- a/recognize_digits/data/get_mnist_data.sh
+++ b/recognize_digits/data/get_mnist_data.sh
@@ -31,5 +31,5 @@ done
cd $DIR
rm -f *.list
-echo "./data/raw_data/train\n" > "$DIR/train.list"
-echo "./data/raw_data/t10k\n" > "$DIR/test.list"
+echo "./data/raw_data/train" > "$DIR/train.list"
+echo "./data/raw_data/t10k" > "$DIR/test.list"
diff --git a/recognize_digits/evaluate.py b/recognize_digits/evaluate.py
index ad0457a56a0ee73be216a03cfe92eea5056f6790..b91467e242e83fe47b910c44122acc26209dcaec 100755
--- a/recognize_digits/evaluate.py
+++ b/recognize_digits/evaluate.py
@@ -30,8 +30,6 @@ def get_best_pass(filename):
filename = sys.argv[1]
log = get_best_pass(filename)
-predict_error = math.sqrt(float(log[0])) / 2
classification_accuracy = (1 - float(log[1])) * 100
-print 'Best pass is %s, error is %s, which means predict get error as %f' % (
- log[2], log[0], predict_error)
+print 'Best pass is %s, testing Avgcost is %s' % (log[2], log[0])
print 'The classification accuracy is %.2f%%' % classification_accuracy
diff --git a/recognize_digits/image/Conv_layer.png b/recognize_digits/image/Conv_layer.png
deleted file mode 100644
index b9f4ca79cd5f3e107532f09d21f3577c5f051342..0000000000000000000000000000000000000000
Binary files a/recognize_digits/image/Conv_layer.png and /dev/null differ
diff --git a/recognize_digits/image/cnn_train_log.png b/recognize_digits/image/cnn_train_log.png
index b0a946506a6cb5418f01cb56beee1878fe4b1b03..56e1b1d5f7a6f820e5a1bc7751648496920ddda5 100644
Binary files a/recognize_digits/image/cnn_train_log.png and b/recognize_digits/image/cnn_train_log.png differ
diff --git a/recognize_digits/image/conv_layer.png b/recognize_digits/image/conv_layer.png
new file mode 100644
index 0000000000000000000000000000000000000000..67d2e3337c94dc3effbf210416062401601d3ec8
Binary files /dev/null and b/recognize_digits/image/conv_layer.png differ
diff --git a/recognize_digits/image/Max_pooling.png b/recognize_digits/image/max_pooling.png
similarity index 100%
rename from recognize_digits/image/Max_pooling.png
rename to recognize_digits/image/max_pooling.png
diff --git a/recognize_digits/image/MLP.png b/recognize_digits/image/mlp.png
similarity index 100%
rename from recognize_digits/image/MLP.png
rename to recognize_digits/image/mlp.png
diff --git a/recognize_digits/image/mlp_train_log.png b/recognize_digits/image/mlp_train_log.png
index dc2d5baae14a96d472701fc88da6303978f23048..b1dfeed5e1cf67d0891f10b237fcba4f5de26886 100644
Binary files a/recognize_digits/image/mlp_train_log.png and b/recognize_digits/image/mlp_train_log.png differ
diff --git a/recognize_digits/image/softmax_train_log.png b/recognize_digits/image/softmax_train_log.png
index 81af95b2fa31344d0a7bbc5e084f755d2d326ab4..e5ac0a44e52c8b075b2072c7668e4a24a6bb7683 100644
Binary files a/recognize_digits/image/softmax_train_log.png and b/recognize_digits/image/softmax_train_log.png differ
diff --git a/recognize_digits/load_data.py b/recognize_digits/load_data.py
index c7602e92edf06a4bf84c600675e481f7506b434e..a3055a591ee897afccc1e56c4f8abde5b274e93f 100644
--- a/recognize_digits/load_data.py
+++ b/recognize_digits/load_data.py
@@ -14,34 +14,28 @@
import numpy as np
import matplotlib.pyplot as plt
import random
+import struct
def read_data(path, filename):
- imgf = path + filename + "-images-idx3-ubyte"
- labelf = path + filename + "-labels-idx1-ubyte"
- f = open(imgf, "rb")
- l = open(labelf, "rb")
-
- f.read(16)
- l.read(8)
-
- # Define number of samples for train/test
- n = 60000 if "train" in filename else 10000
-
- rows = 28
- cols = 28
-
- images = np.fromfile(
- f, 'ubyte',
- count=n * rows * cols).reshape(n, rows, cols).astype('float32')
- labels = np.fromfile(l, 'ubyte', count=n).astype("int")
+ with open(path + filename + "-images-idx3-ubyte",
+ "rb") as f: # open picture file
+ magic, n, rows, cols = struct.unpack(">IIII", f.read(16))
+ images = np.fromfile(
+ f, 'ubyte',
+ count=n * rows * cols).reshape(n, rows, cols).astype('float32')
+
+ with open(path + filename + "-labels-idx1-ubyte",
+ "rb") as l: # open label file
+ magic, n = struct.unpack(">II", l.read(8))
+ labels = np.fromfile(l, 'ubyte', count=n).astype("int")
return images, labels
if __name__ == "__main__":
- train_images, train_labels = read_data("./raw_data/", "train")
- test_images, test_labels = read_data("./raw_data/", "t10k")
+ train_images, train_labels = read_data("./data/raw_data/", "train")
+ test_images, test_labels = read_data("./data/raw_data/", "t10k")
label_list = []
for i in range(10):
index = random.randint(0, train_images.shape[0] - 1)
diff --git a/recognize_digits/mlp_mnist.py b/recognize_digits/mnist_model.py
similarity index 50%
rename from recognize_digits/mlp_mnist.py
rename to recognize_digits/mnist_model.py
index 5efcafa14aafe8078a55d7f4860e1ceab81e5001..4bece1bbe5988c0acc6341d3fb1a6b81c3dcbed7 100644
--- a/recognize_digits/mlp_mnist.py
+++ b/recognize_digits/mnist_model.py
@@ -39,13 +39,53 @@ data_size = 1 * 28 * 28
label_size = 10
img = data_layer(name='pixel', size=data_size)
-# The first fully-connected layer
-hidden1 = fc_layer(input=img, size=128, act=ReluActivation())
-# The second fully-connected layer and the according activation function
-hidden2 = fc_layer(input=hidden1, size=64, act=ReluActivation())
-# The thrid fully-connected layer, note that the hidden size should be 10,
-# which is the number of unique digits
-predict = fc_layer(input=hidden2, size=10, act=SoftmaxActivation())
+
+def softmax_regression(img):
+ predict = fc_layer(input=img, size=10, act=SoftmaxActivation())
+ return predict
+
+
+def multilayer_perceptron(img):
+ # The first fully-connected layer
+ hidden1 = fc_layer(input=img, size=128, act=ReluActivation())
+ # The second fully-connected layer and the according activation function
+ hidden2 = fc_layer(input=hidden1, size=64, act=ReluActivation())
+ # The thrid fully-connected layer, note that the hidden size should be 10,
+ # which is the number of unique digits
+ predict = fc_layer(input=hidden2, size=10, act=SoftmaxActivation())
+ return predict
+
+
+def convolutional_neural_network(img):
+ # first conv layer
+ conv_pool_1 = simple_img_conv_pool(
+ input=img,
+ filter_size=5,
+ num_filters=20,
+ num_channel=1,
+ pool_size=2,
+ pool_stride=2,
+ act=TanhActivation())
+ # second conv layer
+ conv_pool_2 = simple_img_conv_pool(
+ input=conv_pool_1,
+ filter_size=5,
+ num_filters=50,
+ num_channel=20,
+ pool_size=2,
+ pool_stride=2,
+ act=TanhActivation())
+ # The first fully-connected layer
+ fc1 = fc_layer(input=conv_pool_2, size=128, act=TanhActivation())
+ # The softmax layer, note that the hidden size should be 10,
+ # which is the number of unique digits
+ predict = fc_layer(input=fc1, size=10, act=SoftmaxActivation())
+ return predict
+
+
+predict = softmax_regression(img)
+#predict = multilayer_perceptron(img)
+#predict = convolutional_neural_network(img)
if not is_predict:
lbl = data_layer(name="label", size=label_size)
diff --git a/recognize_digits/mnist_provider.py b/recognize_digits/mnist_provider.py
index b5fd38ca6a7cdd5e2a7c30414aa5a6f409d81aa3..b6f1d9662ed46aa18030543246b096fdc2e892cc 100644
--- a/recognize_digits/mnist_provider.py
+++ b/recognize_digits/mnist_provider.py
@@ -13,36 +13,25 @@
# limitations under the License.
from paddle.trainer.PyDataProvider2 import *
-import numpy
+import numpy as np
+import struct
# Define a py data provider
@provider(
input_types={'pixel': dense_vector(28 * 28),
- 'label': integer_value(10)},
- cache=CacheType.CACHE_PASS_IN_MEM)
+ 'label': integer_value(10)})
def process(settings, filename): # settings is not used currently.
- imgf = filename + "-images-idx3-ubyte"
- labelf = filename + "-labels-idx1-ubyte"
- f = open(imgf, "rb")
- l = open(labelf, "rb")
+ with open(filename + "-images-idx3-ubyte", "rb") as f: # open picture file
+ magic, n, rows, cols = struct.unpack(">IIII", f.read(16))
+ images = np.fromfile(
+ f, 'ubyte',
+ count=n * rows * cols).reshape(n, rows, cols).astype('float32')
+ images = images / 255.0 * 2.0 - 1.0 # normalized to [-1,1]
- f.read(16)
- l.read(8)
-
- # Define number of samples for train/test
- if "train" in filename:
- n = 60000
- else:
- n = 10000
-
- images = numpy.fromfile(
- f, 'ubyte', count=n * 28 * 28).reshape((n, 28 * 28)).astype('float32')
- images = images / 255.0 * 2.0 - 1.0
- labels = numpy.fromfile(l, 'ubyte', count=n).astype("int")
+ with open(filename + "-labels-idx1-ubyte", "rb") as l: # open label file
+ magic, n = struct.unpack(">II", l.read(8))
+ labels = np.fromfile(l, 'ubyte', count=n).astype("int")
for i in xrange(n):
yield {"pixel": images[i, :], 'label': labels[i]}
-
- f.close()
- l.close()
diff --git a/recognize_digits/plot_cost.py b/recognize_digits/plot_cost.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f79e835f6ccb282102a97699ae9c08fa5fd3aae
--- /dev/null
+++ b/recognize_digits/plot_cost.py
@@ -0,0 +1,54 @@
+# Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserved
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import matplotlib.pyplot as plt
+import re
+import sys
+
+
+def plot_log(filename):
+ with open(filename, 'r') as f:
+ text = f.read()
+ pattern = re.compile(
+ 'AvgCost=([0-9]+\.[0-9]+).*?Test.*? cost=([0-9]+\.[0-9]+).*?pass-([0-9]+)',
+ re.S)
+ results = re.findall(pattern, text)
+ train_cost, test_cost, pass_ = zip(*results)
+ train_cost_float = map(float, train_cost)
+ test_cost_float = map(float, test_cost)
+ pass_int = map(int, pass_)
+ plt.plot(pass_int, train_cost_float, 'red', label='Train')
+ plt.plot(pass_int, test_cost_float, 'g--', label='Test')
+ plt.ylabel('AvgCost')
+ plt.xlabel('Epoch')
+
+ # Now add the legend with some customizations.
+ legend = plt.legend(loc='upper right', shadow=False)
+
+ # The frame is matplotlib.patches.Rectangle instance surrounding the legend.
+ frame = legend.get_frame()
+ frame.set_facecolor('0.90')
+
+ # Set the fontsize
+ for label in legend.get_texts():
+ label.set_fontsize('large')
+
+ for label in legend.get_lines():
+ label.set_linewidth(1.5) # the legend line width
+
+ plt.show()
+
+
+if __name__ == '__main__':
+ plot_log(sys.argv[1])
diff --git a/recognize_digits/plot_error.py b/recognize_digits/plot_error.py
deleted file mode 100644
index 4c6bb80bc9ff01be824b4b3b6b52f4f2190d7046..0000000000000000000000000000000000000000
--- a/recognize_digits/plot_error.py
+++ /dev/null
@@ -1,36 +0,0 @@
-# Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserved
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-import matplotlib.pyplot as plt
-import re
-import sys
-
-
-def plot_log(filename):
- with open(filename, 'r') as f:
- text = f.read()
- pattern = re.compile('Test.*? cost=([0-9]+\.[0-9]+).*?pass-([0-9]+)',
- re.S)
- results = re.findall(pattern, text)
- cost, pass_ = zip(*results)
- cost_float = map(float, cost)
- pass_int = map(int, pass_)
- plt.plot(pass_int, cost_float, 'bo', pass_, cost_float, 'k')
- plt.ylabel('AvgCost')
- plt.xlabel('epoch')
- plt.show()
-
-
-if __name__ == '__main__':
- plot_log(sys.argv[1])
diff --git a/recognize_digits/predict.py b/recognize_digits/predict.py
index bb9b8aee55a77f994f848e98534bcd9929ef287b..e54d12ba18b5328a2551c48aab8e1694a678e332 100644
--- a/recognize_digits/predict.py
+++ b/recognize_digits/predict.py
@@ -11,7 +11,7 @@
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
-"""Usage: predict.py -c CONF -d DATA -m MODEL
+"""Usage: predict.py -c CONF -d ./data/raw_data/ -m MODEL
Arguments:
@@ -57,8 +57,10 @@ class Prediction():
output = self.network.forwardTest(input)
prob = output[0]["value"]
predict = np.argsort(-prob)
+ print "Predicted probability of each digit:"
print prob
- print predict[0][0], self.labels[index]
+ print "Predict Number: %d" % predict[0][0]
+ print "Actual Number: %d" % self.labels[index]
def main():
diff --git a/recognize_digits/softmax_mnist.py b/recognize_digits/softmax_mnist.py
deleted file mode 100644
index a727aaed03e6657aefd9e4b3874db974ad1ce241..0000000000000000000000000000000000000000
--- a/recognize_digits/softmax_mnist.py
+++ /dev/null
@@ -1,50 +0,0 @@
-# Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserved
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from paddle.trainer_config_helpers import *
-
-is_predict = get_config_arg("is_predict", bool, False)
-
-####################Data Configuration ##################
-
-if not is_predict:
- data_dir = './data/'
- define_py_data_sources2(
- train_list=data_dir + 'train.list',
- test_list=data_dir + 'test.list',
- module='mnist_provider',
- obj='process')
-
-######################Algorithm Configuration #############
-settings(
- batch_size=128,
- learning_rate=0.1 / 128.0,
- learning_method=MomentumOptimizer(0.9),
- regularization=L2Regularization(0.0005 * 128))
-
-#######################Network Configuration #############
-
-data_size = 1 * 28 * 28
-label_size = 10
-img = data_layer(name='pixel', size=data_size)
-
-# mlp is used
-predict = fc_layer(input=img, size=10, act=SoftmaxActivation())
-
-if not is_predict:
- lbl = data_layer(name="label", size=label_size)
- inputs(img, lbl)
- outputs(classification_cost(input=predict, label=lbl))
-else:
- outputs(predict)
diff --git a/recognize_digits/train.sh b/recognize_digits/train.sh
index a5c96080f35d38c6f3bb70b7c71cf0c934882ea8..dfe59b746e10c41b24e9a431cfa092e3dad31b4f 100755
--- a/recognize_digits/train.sh
+++ b/recognize_digits/train.sh
@@ -14,9 +14,9 @@
# limitations under the License.
set -e
-config=cnn_mnist.py
-output=./cnn_mnist_model
-log=cnn_train.log
+config=mnist_model.py
+output=./softmax_mnist_model
+log=softmax_train.log