主要内容

向前

计算用于训练的深度学习网络输出

描述

一些深度学习层在训练和推断(预测)过程中表现不同。例如,在训练过程中,dropout层随机将输入元素设置为零以帮助防止过拟合,但在推断过程中,dropout层不改变输入。

要计算用于训练的网络输出,请使用向前函数。要计算用于推理的网络输出,请使用预测函数。

例子

海底= (dlnetdlX返回网络输出海底在训练中给定输入数据dlX

海底= (dlnet、dlX1 dlXM……)返回网络输出海底在培训期间输入dlX1,…,dlXM还有网络dlnet输入和单一输出。

[dlY1,…,dlYN= forward(___返回N输出dlY1、……dlYN在培训网络的时候N使用任何前面的语法输出。

[dlY1,…,dlYK= forward(___“输出”,layerNames返回输出dlY1、……dlYK在使用任何前面的语法对指定层进行训练期间。

___= forward(___“加速度”,加速度还指定在训练期间使用的性能优化,以及前面语法中的输入参数。

___状态= forward(___还返回更新后的网络状态。

例子

全部折叠

这个例子展示了如何训练一个使用自定义学习率计划分类手写数字的网络。

如果trainingOptions不提供您需要的选项(例如,自定义学习速率计划),那么您可以使用自动区分定义自己的自定义训练循环。

此示例训练网络对手写数字进行分类基于时间的衰减学习率计划:对于每次迭代,求解器使用 ρ t ρ 0 1 + k t ,在那里t是迭代数, ρ 0 初始学习率,和k就是衰变。

负荷训练数据

方法将数字数据加载为图像数据存储imageDatastore函数并指定包含图像数据的文件夹。

dataFolder = fullfile(toolboxdir(“nnet”),“nndemos”“nndatasets”“DigitDataset”);imds = imageDatastore(数据文件夹,...“IncludeSubfolders”,真的,...“LabelSource”“foldernames”);

将数据划分为训练集和验证集。方法留出10%的数据用于验证splitEachLabel函数。

[imdsTrain,imdsValidation] = splitEachLabel(imds,0.9,“随机”);

本例中使用的网络需要大小为28 × 28 × 1的输入图像。要自动调整训练图像的大小,请使用增强图像数据存储。指定要对训练图像执行的附加增强操作:在水平轴和垂直轴上随机将图像平移到5个像素。数据增强有助于防止网络过度拟合和记忆训练图像的确切细节。

inputSize = [28 28 1];pixelRange = [-5 5];imageAugmenter = imageDataAugmenter(...“RandXTranslation”pixelRange,...“RandYTranslation”, pixelRange);augimdsTrain = augmentedimagedastore (inputSize(1:2)),imdsTrain,“DataAugmentation”, imageAugmenter);

若要自动调整验证图像的大小,而不执行进一步的数据增强,请使用增强图像数据存储,而不指定任何额外的预处理操作。

augimdsValidation = augmentedImageDatastore(inputSize(1:2),imdsValidation);

确定训练数据中的类数。

classes = categories(imdsTrain.Labels);numClasses = nummel(类);

定义网络

定义图像分类的网络。

图层= [imageInputLayer(inputSize,“归一化”“没有”“名字”“输入”20岁的)convolution2dLayer (5“名字”“conv1”) batchNormalizationLayer (“名字”“bn1”) reluLayer (“名字”“relu1”20岁的)convolution2dLayer (3“填充”“相同”“名字”“conv2”) batchNormalizationLayer (“名字”“bn2”) reluLayer (“名字”“relu2”20岁的)convolution2dLayer (3“填充”“相同”“名字”“conv3”) batchNormalizationLayer (“名字”“bn3”) reluLayer (“名字”“relu3”) fullyConnectedLayer (numClasses“名字”“俱乐部”) softmaxLayer (“名字”“softmax”));lgraph = layerGraph(图层);

创建一个dlnetwork对象从图层图。

Dlnet = dlnetwork(lgraph)
dlnet = dlnetwork with properties: Layers: [12×1 nnet.cnn.layer.Layer] Connections: [11×2 table] Learnables: [14×3 table] State: [6×3 table] InputNames: {'input'} OutputNames: {'softmax'}

定义模型梯度函数

创建函数modelGradients,列在示例末尾,它需要adlnetwork对象,一个带有相应标签的小批量输入数据,并返回相对于网络中可学习参数的损失梯度和相应的损失。

指定培训项目

用128个小批量训练10个epoch。

numEpochs = 10;miniBatchSize = 128;

指定用于SGDM优化的选项。指定初始学习速率为0.01,衰减为0.01,动量为0.9。

initialLearnRate = 0.01;衰减= 0.01;动量= 0.9;

火车模型

创建一个minibatchqueue对象,该对象在训练期间处理和管理小批量图像。对于每个小批量:

  • 使用自定义小批量预处理功能preprocessMiniBatch(在本例结束时定义)将标签转换为单热编码变量。

  • 用尺寸标签格式化图像数据“SSCB”(空间,空间,通道,批次)。默认情况下,minibatchqueue对象将数据转换为dlarray具有基础类型的对象.不要向类标签添加格式。

  • 如果有GPU,可以在GPU上进行训练。默认情况下,minibatchqueue对象将每个输出转换为gpuArray如果GPU可用。使用GPU需要并行计算工具箱™和受支持的GPU设备。金宝app有关受支持设备的信息,请参见金宝appGPU支金宝app持版本(并行计算工具箱)

mbq = minibatchqueue(augimdsTrain,...“MiniBatchSize”miniBatchSize,...“MiniBatchFcn”@preprocessMiniBatch,...“MiniBatchFormat”, {“SSCB”});

初始化培训进度图。

图lineLossTrain = animatedline(“颜色”,[0.85 0.325 0.098]);Ylim ([0 inf]) xlabel(“迭代”) ylabel (“损失”网格)

初始化SGDM求解器的速度参数。

速度= [];

使用自定义训练循环训练网络。对于每个纪元,洗牌数据并在小批量数据上循环。对于每个小批量:

  • 方法评估模型梯度、状态和损失dlfeval而且modelGradients函数并更新网络状态。

  • 确定基于时间的衰减学习率计划的学习率。

  • 方法更新网络参数sgdmupdate函数。

  • 显示培训进度。

迭代= 0;开始= tic;%遍历epoch。epoch = 1:numEpochs% Shuffle数据。洗牌(兆贝可);在小批上循环。Hasdata (mbq)迭代=迭代+ 1;读取小批数据。[dlX, ly] = next(mbq);使用dlfeval和% modelGradients函数并更新网络状态。[gradients,state,loss] = dlfeval(@modelGradients,dlnet,dlX,dlY);dlnet。状态=状态;确定基于时间的衰减学习率计划的学习率。learnRate = initialLearnRate/(1 +衰减*迭代);使用SGDM优化器更新网络参数。[dlnet,velocity] = sgdmupdate(dlnet,gradients,velocity,learnRate,momentum);%显示培训进度。D = duration(0,0,toc(start),“格式”“hh: mm: ss”);addpoints (lineLossTrain、迭代、失去)标题(”时代:“+ epoch +,消失:"+字符串(D))现在绘制结束结束

测试模型

通过将验证集上的预测结果与真实标签进行比较,检验模型的分类精度。

经过训练后,对新数据进行预测不需要标签。创建minibatchqueue对象,只包含测试数据的预测器:

  • 为了忽略标签进行测试,将迷你批处理队列的输出数量设置为1。

  • 指定用于训练的相同的小批大小。

  • 属性预处理预测器preprocessMiniBatchPredictors函数,在示例末尾列出。

  • 对于数据存储的单个输出,指定迷你批处理格式“SSCB”(空间,空间,通道,批次)。

numOutputs = 1;mbqTest = minibatchqueue(augimdsValidation,numOutputs,...“MiniBatchSize”miniBatchSize,...“MiniBatchFcn”@preprocessMiniBatchPredictors,...“MiniBatchFormat”“SSCB”);

循环小批和分类图像使用modelPredictions函数,在示例末尾列出。

预测= modelforecasts (dlnet,mbqTest,classes);

评估分类准确率。

YTest = imdsValidation.Labels;准确度=平均值(预测= YTest)
准确度= 0.9530

模型梯度函数

modelGradients函数的参数为dlnetwork对象dlnet,一小批输入数据dlX有相应的标签Y并返回损失相对于中可学习参数的梯度dlnet、网络状态、丢失。要自动计算梯度,请使用dlgradient函数。

函数[gradients,state,loss] = modelGradients(dlnet,dlX,Y) [dlYPred,state] = forward(dlnet,dlX);loss = crossentropy(dlYPred,Y);gradients = dlgradient(loss,dlnet.Learnables);损失= double(gather(extractdata(Loss)));结束

模型预测函数

modelPredictions函数的参数为dlnetwork对象dlnet,一个minibatchqueue输入数据的兆贝可和网络类,并通过迭代中所有数据来计算模型预测minibatchqueue对象。函数使用onehotdecode函数来查找得分最高的预测班级。

函数forecasts = modelforecasts (dlnet,mbq,classes) forecasts = [];hasdata(mbq) dlXTest = next(mbq);dlYPred = predict(dlnet,dlXTest);YPred = onehotdecode(dlYPred,classes,1)';预测=[预测;YPred];结束结束

迷你批量预处理功能

preprocessMiniBatch函数使用以下步骤预处理一小批预测器和标签:

  1. 对图像进行预处理preprocessMiniBatchPredictors函数。

  2. 从传入的单元格数组中提取标签数据,并沿着第二次维度连接到分类数组中。

  3. One-hot将分类标签编码为数字数组。编码到第一个维度会产生一个与网络输出形状匹配的编码数组。

函数[X,Y] = preprocessMiniBatch(XCell,YCell)预处理预测器。X = preprocessMiniBatchPredictors(XCell);从单元格和级联中提取标签数据。Y = cat(2,YCell{1:end});单热编码标签。Y = onehotencode(Y,1);结束

小批量预测预处理函数

preprocessMiniBatchPredictors函数通过从输入单元格数组中提取图像数据并将其连接到数值数组来预处理一小批预测器。对于灰度输入,在第四个维度上的连接将为每个图像添加第三个维度,以用作单个通道维度。

函数X = preprocessMiniBatchPredictors(XCell)%连接。X = cat(4,XCell{1:end});结束

输入参数

全部折叠

用于自定义训练循环的网络,指定为dlnetwork对象。

输入数据,指定为格式化的dlarray.欲了解更多有关dlarray格式,请参见fmt的输入参数dlarray

要从中提取输出的层,指定为字符串数组或包含层名的字符向量的单元格数组。

  • 如果layerNames(我)那么,对应于具有单一输出的层layerNames(我)是层的名称。

  • 如果layerNames(我)那么,对应于具有多个输出的层layerNames(我)是层名后面加字符"/和层输出的名称:“layerName / outputName”

性能优化,指定为以下之一:

  • “汽车”—自动应用大量适合输入网络和硬件资源的优化。

  • “没有”-禁用所有加速。

默认选项为“汽车”

使用“汽车”加速选项可以提供性能优势,但代价是增加初始运行时间。具有兼容参数的后续调用速度更快。当您计划使用相同大小和形状的不同输入数据多次调用函数时,请使用性能优化。

输出参数

全部折叠

输出数据,以格式化的形式返回dlarray.欲了解更多有关dlarray格式,请参见fmt的输入参数dlarray

更新的网络状态,以表形式返回。

网络状态是一个有三列的表:

  • -层名,指定为字符串标量。

  • 参数—状态参数名称,指定为字符串标量。

  • 价值-状态参数的值,指定为dlarray对象。

层状态包含在层操作期间计算的信息,这些信息将保留用于层的后续向前传递。例如,LSTM层的单元状态和隐藏状态,或者在批归一化层中运行统计信息。

对于循环层,例如LSTM层,使用HasStateInputs属性设置为1(true),状态表不包含该层的状态项。

更新的状态dlnetwork使用状态财产。

兼容性的考虑

全部展开

R2021a的行为发生了变化

扩展功能

R2019b引入