主要内容

dlfeval

评估自定义训练循环的深度学习模型

描述

使用dlfeval为自定义训练循环评估自定义深度学习模型。

提示

对于大多数深度学习任务,您可以使用预先训练的网络,并使其适应您自己的数据。有关如何使用迁移学习来重新训练卷积神经网络来对一组新图像进行分类的示例,请参见训练深度学习网络对新图像进行分类.或者,您可以使用从头开始创建和培训网络layerGraph的对象trainNetworktrainingOptions功能。

如果trainingOptions函数不提供任务所需的训练选项,则可以使用自动区分创建自定义训练循环。想要了解更多,请看为自定义训练循环定义深度学习网络

例子

日元…,即) = dlfeval (有趣的x1,…,xn计算深度学习数组函数有趣的在输入参数处x1,…,xn.函数传递给dlfeval可以包含对dlgradient,它根据输入计算梯度x1,…,xn通过使用自动区分。

例子

全部折叠

罗森布罗克函数是优化的标准测试函数。的rosenbrock.m辅助函数计算函数值,并使用自动微分来计算其梯度。

类型rosenbrock.m
函数[y,就要]=。(x) y = 100 * (x - x(1)(2)。^ 2)。²+ (1 - x(1))²;就要= dlgradient (y、x);结束

求罗森布罗克函数及其在该点处的梯度[1,2],创建一个dlarray的点,然后调用dlfeval在函数句柄上@rosenbrock

x0 = dlarray ([1, 2]);[fval, gradval] = dlfeval (x0 @rosenbrock)
Fval = 1x1 dlarray 104
梯度= 1x2 dlarray 396 200

或者,将罗森布罗克函数定义为两个输入的函数,x1和x2

类型rosenbrock2.m
函数[y,dydx1,dydx2] = rosenbrock2(x1,x2) y = 100*(x2 - x1.^2)²+ (1 - x1)²;[dydx1, dydx2] = dlgradient (y, x1, x2);结束

调用dlfeval评估rosenbrock2在两个dlarray表示输入的参数12

x1 = dlarray (1);x2 = dlarray (2);[fval, dydx1 dydx2] = dlfeval (@rosenbrock2 (x1, x2)
Fval = 1x1 dlarray 104
Dydx1 = 1x1美元396
Dydx2 = 1x1 dlarray 200

绘制罗森布罗克函数在单位平方上几个点的梯度。首先,初始化表示求值点的数组和函数的输出。

[X1 X2] = meshgrid(linspace(0,1,10));X1 = dlarray (X1 (:));X2 = dlarray (X2 (:));Y = dlarray(0(大小(X1)));DYDX1 = Y;DYDX2 = Y;

在循环中对函数求值。用以下方法绘制结果箭袋

i = 1:长度(X1) [Y (i), DYDX1(我),DYDX2 (i)) = dlfeval (@rosenbrock2, X1 (i), X2(我));结束箭袋(extractdata (X1)、extractdata (X2)、extractdata (DYDX1) extractdata (DYDX2))包含(x1的) ylabel (“x2”

图中包含一个轴对象。轴对象包含一个类型为箭筒的对象。

使用dlgradientdlfeval计算包含复数的函数的值和梯度。您可以计算复杂的梯度,或仅将梯度限制为实数。

定义的函数complexFun,列在本例的最后。这个函数实现了以下复杂的公式:

f x 2 + 3. x

定义的函数gradFun,列在本例的最后。这个函数调用complexFun并使用dlgradient来计算结果相对于输入的梯度。对于自动微分,要微分的值——即从输入计算出的函数的值——必须是一个实标量,因此该函数在计算梯度之前取结果的实部之和。函数返回函数值的实部和梯度,这可能是复杂的。

定义复平面上-2和-2之间的采样点 和2 和转换dlarray

functionRes = linspace (2100);x = function .';x = dlarray (x);

计算每个采样点的函数值和梯度。

[y, grad] = dlfeval(@gradFun,x);y = extractdata (y);

定义显示渐变的采样点。

gradientRes = linspace (2, 2, 11);xGrad = gradientRes + 1i*gradientRes.';

在这些采样点提取梯度值。

[~, gradPlot] = dlfeval (@gradFun dlarray (xGrad));gradPlot = extractdata (gradPlot);

策划的结果。使用显示亮度图像来表示函数在复平面上的值。使用箭袋表示梯度的方向和大小。

显示亮度图像((2,2),(2,2),y);轴xycolorbar举行箭袋(真实(xGrad),图像放大(xGrad),真正的(gradPlot),图像放大(gradPlot),“k”);包含(“真正的”) ylabel (“虚”)标题(“实值与梯度”"Re$(f(x)) = $ Re$((2+3i)x)$"“翻译”“乳胶”

图中包含一个轴对象。标题为实值和梯度的轴对象包含2个类型为image, quiver的对象。

函数的梯度在整个复平面上都是一样的。提取自动差分计算出的梯度值。

研究生(1,1)
Ans = 1x1 dlarray 2.000 - 3.0000i

经检验,该函数的复导数是有值的

df x dx 2 + 3.

但是,函数Re( f x )不是解析的,因此没有复导数的定义。对于MATLAB中的自动微分,微分值必须是实数,因此函数永远不能是复解析函数。相反,导数的计算使得返回的梯度指向最陡的上升方向,如图所示。这是通过解释函数Re来实现的 f x C R作为一个功能 f x R + x R × R R

函数y = (2+3i)*x;结束函数[y,grad] = gradFun(x) y = complexFun(x);y =真正的(y);研究生= dlgradient(总和(y,“所有”), x);结束

输入参数

全部折叠

要计算的函数,指定为函数句柄。如果有趣的包括一个dlgradient电话,然后dlfeval使用自动微分来计算梯度。在这个梯度求值中dlgradient呼叫必须是dlarray或单元格数组、结构或包含dlarray.输入参数的数量dlfeval必须与输入参数的数量相同有趣的

例子:@rosenbrock

数据类型:function_handle

函数参数,指定为任何MATLAB数据类型或dlnetwork对象。

一个输入参数xj这是a的微分变量dlgradient电话一定被跟踪了dlarray或包含跟踪的单元格数组、结构或表dlarray.一个额外的变量,如超参数或常量数据数组,并不一定是dlarray

为了评估深度学习的梯度,您可以提供dlnetwork对象作为函数参数,并计算内部网络的前向传递有趣的

例子:dlarray ([1 2; 3 4])

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑|字符|字符串|结构体|表格|细胞|function_handle|分类|datetime|持续时间|calendarDuration|fi
复数的支持:金宝app是的

输出参数

全部折叠

函数输出,作为任何数据类型返回。如果输出结果是dlgradient调用时,输出为adlarray

提示

扩展功能

介绍了R2019b