快速上手飞桨（PaddlePaddle）
============================

本示例通过一个基础案例带您从一个飞桨新手快速掌握如何使用。

1. 安装飞桨
-----------

如果您已经安装好飞桨那么可以跳过此步骤。我们针对用户提供了一个方便易用的安装引导页面，您可以通过选择自己的系统和软件版本来获取对应的安装命令，具体可以点击\ `快速安装 <https://www.paddlepaddle.org.cn/install/quick>`__\ 查看。

2. 导入飞桨
-----------

这个示例我们采用了Notebook的形式来进行编写，您可以直接通过AIStudio或Jupyter等平台工具来运行这个案例，Notebook的好处是可以通过浏览器来运行Python程序，边看教程边运行结果，可以对比学习，并且可以做到单步运行调试。

安装好飞桨后我们就可以在Python程序中进行飞桨的导入。

.. code:: ipython3

    import paddle
    
    paddle.__version__




.. parsed-literal::

    '0.0.0'



3. 实践一个手写数字识别任务
---------------------------

对于深度学习任务如果简单来看，其实分为几个核心步骤：1.
数据集的准备和加载；2.
模型的构建；3.模型训练；4.模型评估。那么接下来我们就一步一步带您通过飞桨的少量API快速实现。

3.1 数据加载
~~~~~~~~~~~~

加载我们框架为您准备好的一个手写数字识别数据集。这里我们使用两个数据集，一个用来做模型的训练，一个用来做模型的评估。

.. code:: ipython3

    train_dataset = paddle.vision.datasets.MNIST(mode='train', chw_format=False)
    val_dataset =  paddle.vision.datasets.MNIST(mode='test', chw_format=False)

3.2 模型搭建
~~~~~~~~~~~~

通过Sequential将一层一层的网络结构组建起来。通过数据集加载接口的chw_format参数我们已经将[1,
28, 28]形状的图片数据改变形状为[1,
784]，那么在组网过程中不在需要先进行Flatten操作。

.. code:: ipython3

    mnist = paddle.nn.Sequential(
        paddle.nn.Linear(784, 512),
        paddle.nn.ReLU(),
        paddle.nn.Dropout(0.2),
        paddle.nn.Linear(512, 10)
    )

3.3 模型训练
~~~~~~~~~~~~

配置好我们模型训练需要的损失计算方法和优化方法后就可以使用fit接口来开启我们的模型训练过程。

.. code:: ipython3

    # 开启动态图模式
    paddle.disable_static()  
    
    # 预计模型结构生成模型实例，便于进行后续的配置、训练和验证
    model = paddle.Model(mnist)  
    
    # 模型训练相关配置，准备损失计算方法，优化器和精度计算方法
    model.prepare(paddle.optimizer.Adam(parameters=mnist.parameters()),
                  paddle.nn.CrossEntropyLoss(),
                  paddle.metric.Accuracy())
    
    # 开始模型训练
    model.fit(train_dataset,
              epochs=5, 
              batch_size=32,
              verbose=1)


.. parsed-literal::

    Epoch 1/5
    step 1875/1875 [==============================] - loss: 0.2571 - acc: 0.9037 - 10ms/step          
    Epoch 2/5
    step 1875/1875 [==============================] - loss: 0.1880 - acc: 0.9458 - 14ms/step          
    Epoch 3/5
    step 1875/1875 [==============================] - loss: 0.0279 - acc: 0.9549 - 11ms/step          
    Epoch 4/5
    step 1875/1875 [==============================] - loss: 0.0505 - acc: 0.9608 - 13ms/step          
    Epoch 5/5
    step 1875/1875 [==============================] - loss: 0.2253 - acc: 0.9646 - 12ms/step          


3.4 模型评估
~~~~~~~~~~~~

使用我们刚才训练得到的模型参数进行模型的评估操作，看看我们的模型精度如何。

.. code:: ipython3

    model.evaluate(val_dataset, verbose=0)




.. parsed-literal::

    {'loss': [3.576278e-07], 'acc': 0.9666}



那么初步训练得到的模型效果在97%附近，我们可以进一步通过调整其中的训练参数来提升我们的模型精度。

至此我们可以知道如何通过飞桨的几个简单API来快速完成一个深度学习任务，大家可以针对自己的需求来更换其中的代码，如果需要使用自己的数据集，那么可以更换数据集加载部分程序，如果需要替换模型，那么可以更改模型代码实现等等。我们也为大家提供了很多其他场景的示例代码来教大家如何使用我们的飞桨API，大家可以查看下面的链接或通过页面导航来查看自己感兴趣的部分。

TODO：补充其他示例教程的快速链接。
