TensorFlow扩展 ================ 本章介绍一些最为常用的TensorFlow扩展功能。虽然这些功能称不上“必须”，但能让模型训练和调用的过程更加方便。 前置知识： * `Python的序列化模块Pickle `_ （非必须） * `Python的特殊函数参数**kwargs `_ （非必须） Checkpoint：变量的保存与恢复 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 很多时候，我们希望在模型训练完成后能将训练好的参数（变量）保存起来。在需要使用模型的其他地方载入模型和参数，就能直接得到训练好的模型。可能你第一个想到的是用Python的序列化模块 ``pickle`` 存储 ``model.variables``。但不幸的是，TensorFlow的变量类型 ``ResourceVariable`` 并不能被序列化。 好在TensorFlow提供了 `tf.train.Checkpoint `_ 这一强大的变量保存与恢复类，可以使用其 ``save()`` 和 ``restore()`` 方法将TensorFlow中所有包含Checkpointable State的对象进行保存和恢复。具体而言，``tf.train.Optimizer`` 实现, ``tf.Variable``, ``tf.keras.Layer`` 实现或者 ``tf.keras.Model`` 实现都可以被保存。其使用方法非常简单，我们首先声明一个Checkpoint： .. code-block:: python checkpoint = tf.train.Checkpoint(model=model) 这里 ``tf.train.Checkpoint()`` 接受的初始化参数比较特殊，是一个 ``**kwargs`` 。具体而言，是一系列的键值对，键名可以随意取，值为需要保存的对象。例如，如果我们希望保存一个继承 ``tf.keras.Model`` 的模型实例 ``model`` 和一个继承 ``tf.train.Optimizer`` 的优化器 ``optimizer`` ，我们可以这样写： .. code-block:: python checkpoint = tf.train.Checkpoint(myAwesomeModel=model, myAwesomeOptimizer=optimizer) 这里 ``myAwesomeModel`` 是我们为待保存的模型 ``model`` 所取的任意键名。注意，在恢复变量的时候，我们还将使用这一键名。 接下来，当模型训练完成需要保存的时候，使用： .. code-block:: python checkpoint.save(save_path_with_prefix) 就可以。 ``save_path_with_prefix`` 是保存文件的目录+前缀。例如，在源代码目录建立一个名为save的文件夹并调用一次 ``checkpoint.save('./save/model.ckpt')`` ，我们就可以在可以在save目录下发现名为 ``checkpoint`` 、 ``model.ckpt-1.index`` 、 ``model.ckpt-1.data-00000-of-00001`` 的三个文件，这些文件就记录了变量信息。``checkpoint.save()`` 方法可以运行多次，每运行一次都会得到一个.index文件和.data文件，序号依次累加。 当在其他地方需要为模型重新载入之前保存的参数时，需要再次实例化一个checkpoint，同时保持键名的一致。再调用checkpoint的restore方法。就像下面这样： .. code-block:: python model_to_be_restored = MyModel() # 待恢复参数的同一模型 checkpoint = tf.train.Checkpoint(myAwesomeModel=model_to_be_restored) # 键名保持为“myAwesomeModel” checkpoint.restore(save_path_with_prefix_and_index) 即可恢复模型变量。 ``save_path_with_prefix_and_index`` 是之前保存的文件的目录+前缀+编号。例如，调用 ``checkpoint.restore('./save/model.ckpt-1')`` 就可以载入前缀为 ``model.ckpt`` ，序号为1的文件来恢复模型。 当保存了多个文件时，我们往往想载入最近的一个。可以使用 ``tf.train.latest_checkpoint(save_path)`` 这个辅助函数返回目录下最近一次checkpoint的文件名。例如如果save目录下有 ``model.ckpt-1.index`` 到 ``model.ckpt-10.index`` 的10个保存文件， ``tf.train.latest_checkpoint('./save')`` 即返回 ``./save/model.ckpt-10`` 。 总体而言，恢复与保存变量的典型代码框架如下： .. code-block:: python # train.py 模型训练阶段 model = MyModel() checkpoint = tf.train.Checkpoint(myModel=model) # 实例化Checkpoint，指定保存对象为model（如果需要保存Optimizer的参数也可加入） # 模型训练代码 checkpoint.save('./save/model.ckpt') # 模型训练完毕后将参数保存到文件，也可以在模型训练过程中每隔一段时间就保存一次 .. code-block:: python # test.py 模型使用阶段 model = MyModel() checkpoint = tf.train.Checkpoint(myModel=model) # 实例化Checkpoint，指定恢复对象为model checkpoint.restore(tf.train.latest_checkpoint('./save')) # 从文件恢复模型参数 # 模型使用代码 顺便一提， ``tf.train.Checkpoint`` 与以前版本常用的 ``tf.train.Saver`` 相比，强大之处在于其支持在Eager Execution下“延迟”恢复变量。具体而言，当调用了 ``checkpoint.restore()`` ，但模型中的变量还没有被建立的时候，Checkpoint可以等到变量被建立的时候再进行数值的恢复。Eager Execution下，模型中各个层的初始化和变量的建立是在模型第一次被调用的时候才进行的（好处在于可以根据输入的张量形状而自动确定变量形状，无需手动指定）。这意味着当模型刚刚被实例化的时候，其实里面还一个变量都没有，这时候使用以往的方式去恢复变量数值是一定会报错的。比如，你可以试试在train.py调用 ``tf.keras.Model`` 的 ``save_weight()`` 方法保存model的参数，并在test.py中实例化model后立即调用 ``load_weight()`` 方法，就会出错，只有当调用了一遍model之后再运行 ``load_weight()`` 方法才能得到正确的结果。可见， ``tf.train.Checkpoint`` 在这种情况下可以给我们带来相当大的便利。另外， ``tf.train.Checkpoint`` 同时也支持Graph Execution模式。 最后提供一个实例，以前章的 :ref:`多层感知机模型 ` 为例展示模型变量的保存和载入： .. literalinclude:: ../_static/code/zh/extended/save_and_restore/mnist.py 在代码目录下建立save文件夹并运行代码进行训练后，save文件夹内将会存放每隔100个batch保存一次的模型变量数据。将第7行改为 ``model = 'test'`` 并再次运行代码，将直接使用最后一次保存的变量值恢复模型并在测试集上测试模型性能，可以直接获得95%左右的准确率。 .. AutoGraph：动态图转静态图 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ `AutoGraph `_ SavedModel：模型的封装 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ TensorBoard：训练过程可视化 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 有时，你希望查看模型训练过程中各个参数的变化情况（例如损失函数loss的值）。虽然可以通过命令行输出来查看，但有时显得不够直观。而TensorBoard就是一个能够帮助我们将训练过程可视化的工具。 目前，Eager Execution模式下的TensorBoard支持尚在 `tf.contrib.summary `_ 内，可能以后会有较多变化，因此这里只做简单示例。首先在代码目录下建立一个文件夹（如./tensorboard）存放TensorBoard的记录文件，并在代码中实例化一个记录器： .. code-block:: python summary_writer = tf.contrib.summary.create_file_writer('./tensorboard') 接下来，将训练的代码部分通过with语句放在 ``summary_writer.as_default()`` 和 ``tf.contrib.summary.always_record_summaries()`` 的上下文中，并对需要记录的参数（一般是scalar）运行 ``tf.contrib.summary.scalar(name, tensor, step=batch_index)`` 即可。这里的step参数可根据自己的需要自行制定，一般可设置为当前训练过程中的batch序号。整体框架如下： .. code-block:: python summary_writer = tf.contrib.summary.create_file_writer('./tensorboard') with summary_writer.as_default(), tf.contrib.summary.always_record_summaries(): # 开始模型训练 for batch_index in range(num_batches): # 训练代码，当前batch的损失值放入变量loss中 tf.contrib.summary.scalar("loss", loss, step=batch_index) tf.contrib.summary.scalar("MyScalar", my_scalar, step=batch_index) # 还可以添加其他自定义的变量 每运行一次 ``tf.contrib.summary.scalar()`` ，记录器就会向记录文件中写入一条记录。除了最简单的标量（scalar）以外，TensorBoard还可以对其他类型的数据（如图像，音频等）进行可视化，详见 `API文档 `_ 。 当我们要对训练过程可视化时，在代码目录打开终端（如需要的话进入TensorFlow的conda环境），运行:: tensorboard --logdir=./tensorboard 然后使用浏览器访问命令行程序所输出的网址（一般是http://计算机名称:6006），即可访问TensorBoard的可视界面，如下图所示： .. figure:: ../_static/image/extended/tensorboard.png :width: 100% :align: center 默认情况下，TensorBoard每30秒更新一次数据。不过也可以点击右上角的刷新按钮手动刷新。 TensorBoard的使用有以下注意事项： * 如果需要重新训练，需要删除掉记录文件夹内的信息并重启TensorBoard（或者建立一个新的记录文件夹并开启TensorBoard， ``--logdir`` 参数设置为新建立的文件夹）； * 记录文件夹目录保持全英文。 最后提供一个实例，以前章的 :ref:`多层感知机模型 ` 为例展示TensorBoard的使用： .. literalinclude:: ../_static/code/zh/extended/tensorboard/mnist.py GPU的使用与分配 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 很多时候的场景是：实验室/公司研究组里有许多学生/研究员都需要使用GPU，但多卡的机器只有一台，这时就需要注意如何分配显卡资源。 命令 ``nvidia-smi`` 可以查看机器上现有的GPU及使用情况（在Windows下，将 ``C:\Program Files\NVIDIA Corporation\NVSMI`` 加入Path环境变量中即可，或Windows 10下可使用任务管理器的“性能”标签查看显卡信息）。 使用环境变量 ``CUDA_VISIBLE_DEVICES`` 可以控制程序所使用的GPU。假设发现四卡的机器上显卡0,1使用中，显卡2,3空闲，Linux终端输入:: export CUDA_VISIBLE_DEVICES=2,3 或在代码中加入 .. code-block:: python import os os.environ['CUDA_VISIBLE_DEVICES'] = "2,3" 即可指定程序只在显卡2,3上运行。 默认情况下，TensorFlow将使用几乎所有可用的显存，以避免内存碎片化所带来的性能损失。可以通过 ``tf.ConfigProto`` 类来设置TensorFlow使用显存的策略。具体方式是实例化一个 ``tf.ConfigProto`` 类，设置参数，并在运行 ``tf.enable_eager_execution()`` 时指定Config参数。以下代码通过 ``allow_growth`` 选项设置TensorFlow仅在需要时申请显存空间： .. code-block:: python config = tf.ConfigProto() config.gpu_options.allow_growth = True tf.enable_eager_execution(config=config) 以下代码通过 ``per_process_gpu_memory_fraction`` 选项设置TensorFlow固定消耗40%的GPU显存： .. code-block:: python config = tf.ConfigProto() config.gpu_options.per_process_gpu_memory_fraction = 0.4 tf.enable_eager_execution(config=config) Graph Execution下，也可以在实例化新的session时传入 tf.ConfigPhoto 类来进行设置。