cv::ml::ANN_MLP 类参考

人工神经网络 - 多层感知器。 更多...

#include <opencv2/ml.hpp>

cv::ml::ANN_MLP 的协作图

公开类型
enum	ActivationFunctions {   IDENTITY = 0 ,   SIGMOID_SYM = 1 ,   GAUSSIAN = 2 ,   RELU = 3 ,   LEAKYRELU = 4 }
enum	TrainFlags {   UPDATE_WEIGHTS = 1 ,   NO_INPUT_SCALE = 2 ,   NO_OUTPUT_SCALE = 4 }
enum	TrainingMethods {   BACKPROP =0 ,   RPROP = 1 ,   ANNEAL = 2 }
从 cv::ml::StatModel 继承的公共类型
enum	标志 {   UPDATE_MODEL = 1 ,   RAW_OUTPUT =1 ,   COMPRESSED_INPUT =2 ,   PREPROCESSED_INPUT =4 }

公开成员函数
virtual double	getAnnealCoolingRatio () const =0
virtual double	getAnnealFinalT () const =0
virtual double	getAnnealInitialT () const =0
virtual int	getAnnealItePerStep () const =0
virtual double	getBackpropMomentumScale () const =0
virtual double	getBackpropWeightScale () const =0
virtual cv::Mat	getLayerSizes () const =0
virtual double	getRpropDW0 () const =0
virtual double	getRpropDWMax () const =0
virtual double	getRpropDWMin () const =0
virtual double	getRpropDWMinus () const =0
virtual double	getRpropDWPlus () const =0
virtual TermCriteria	getTermCriteria () const =0
virtual int	getTrainMethod () const =0
virtual Mat	getWeights (int layerIdx) const =0
virtual void	setActivationFunction (int type, double param1=0, double param2=0)=0
virtual void	setAnnealCoolingRatio (double val)=0
virtual void	setAnnealEnergyRNG (const RNG &rng)=0
	设置/初始化退火 RNG。
virtual void	setAnnealFinalT (double val)=0
virtual void	setAnnealInitialT (double val)=0
virtual void	setAnnealItePerStep (int val)=0
virtual void	setBackpropMomentumScale (double val)=0
virtual void	setBackpropWeightScale (double val)=0
virtual void	setLayerSizes (InputArray _layer_sizes)=0
virtual void	setRpropDW0 (double val)=0
virtual void	setRpropDWMax (double val)=0
virtual void	setRpropDWMin (double val)=0
virtual void	setRpropDWMinus (double val)=0
virtual void	setRpropDWPlus (double val)=0
virtual void	setTermCriteria (TermCriteria val)=0
virtual void	setTrainMethod (int method, double param1=0, double param2=0)=0
从 cv::ml::StatModel 继承的公共成员函数
virtual float	calcError (const Ptr< TrainData > &data, bool test, OutputArray resp) const
	计算训练集或测试集上的误差。
virtual bool	empty () const CV_OVERRIDE
	如果 Algorithm 为空（例如，在最开始或读取不成功后），则返回 true。
virtual int	getVarCount () const =0
	返回训练样本中的变量数量。
virtual bool	isClassifier () const =0
	如果模型是分类器，则返回 true。
virtual bool	isTrained () const =0
	如果模型已训练，则返回 true。
virtual float	predict (InputArray samples, OutputArray results=noArray(), int flags=0) const =0
	预测所提供样本的响应
virtual bool	train (const Ptr< TrainData > &trainData, int flags=0)
	训练统计模型。
virtual bool	train (InputArray samples, int layout, InputArray responses)
	训练统计模型。
从 cv::Algorithm 继承的公共成员函数
	Algorithm ()
virtual	~Algorithm ()
virtual void	clear ()
	清除算法状态。
virtual String	getDefaultName () const
virtual void	read (const FileNode &fn)
	从文件存储中读取算法参数。
virtual void	save (const String &filename) const
void	write (const Ptr< FileStorage > &fs, const String &name=String()) const
virtual void	write (FileStorage &fs) const
	将算法参数存储在文件存储中。
void	write (FileStorage &fs, const String &name) const

静态公开成员函数
static Ptr< ANN_MLP >	create ()
	创建空模型。
static Ptr< ANN_MLP >	load (const String &filepath)
	从文件加载并创建一个序列化的 ANN。
从 cv::ml::StatModel 继承的静态公共成员函数
template<typename _Tp >
static Ptr< _Tp >	train (const Ptr< TrainData > &data, int flags=0)
	创建并训练具有默认参数的模型。
从 cv::Algorithm 继承的静态公共成员函数
template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	从文件中加载算法。
template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	从字符串中加载算法。
template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	从文件节点中读取算法。

更多继承的成员
从 cv::Algorithm 继承的保护成员函数
void	writeFormat (FileStorage &fs) const

详细说明

人工神经网络 - 多层感知器。

与 ML 中许多一次性构造和训练的模型不同，MLP 模型中这些步骤是分开的。首先，使用非默认构造函数或方法 ANN_MLP::create 来创建具有指定拓扑的网络。所有权重都被设置为零。然后，使用一组输入和输出向量训练网络。训练过程可以重复多次，即可以根据新的训练数据调整权重。

StatModel::train 的附加标志可用： ANN_MLP::TrainFlags。

另请参阅

神经网络

成员枚举文档

ActivationFunctions

enum cv::ml::ANN_MLP::ActivationFunctions

可能的激活函数

枚举值 (Enumerator)
IDENTITY	恒等函数: \(f(x)=x\)
SIGMOID_SYM	对称 Sigmoid 函数: \(f(x)=\beta*(1-e^{-\alpha x})/(1+e^{-\alpha x})\) 注意 如果您使用的是默认 Sigmoid 激活函数，参数值为 fparam1=0 和 fparam2=0，则使用的函数是 y = 1.7159*tanh(2/3 * x)，因此输出范围将是 [-1.7159, 1.7159]，而不是 [0,1]。
GAUSSIAN	高斯函数: \(f(x)=\beta e^{-\alpha x*x}\)
RELU	ReLU 函数: \(f(x)=max(0,x)\)
LEAKYRELU	Leaky ReLU 函数: 对于 x>0 \(f(x)=x \) 且 x<=0 \(f(x)=\alpha x \)

TrainFlags

enum cv::ml::ANN_MLP::TrainFlags

训练选项

枚举值 (Enumerator)
UPDATE_WEIGHTS	更新网络权重，而不是从头计算。在后一种情况下，权重使用 Nguyen-Widrow 算法进行初始化。
NO_INPUT_SCALE	不归一化输入向量。如果未设置此标志，训练算法将独立归一化每个输入特征，将其均值移至 0 并使标准差等于 1。如果假定网络会频繁更新，则新训练数据可能与原始数据大不相同。在这种情况下，您应注意进行适当的归一化。
NO_OUTPUT_SCALE	不归一化输出向量。如果未设置标志，训练算法将独立归一化每个输出特征，方法是根据所使用的激活函数将其转换为特定范围。

TrainingMethods

enum cv::ml::ANN_MLP::TrainingMethods

可用的训练方法

枚举值 (Enumerator)
BACKPROP	反向传播算法。
RPROP	RPROP 算法。详情请参阅 [232]。
ANNEAL	模拟退火算法。详情请参阅 [152]。

成员函数说明

create()

static Ptr< ANN_MLP > cv::ml::ANN_MLP::create ( )

static (静态)

Python
	cv.ml.ANN_MLP.create(		) ->	retval
	cv.ml.ANN_MLP_create(		) ->	retval

创建空模型。

使用 StatModel::train 训练模型，使用 Algorithm::load<ANN_MLP>(filename) 加载预训练模型。请注意，训练方法具有可选标志： ANN_MLP::TrainFlags。

getAnnealCoolingRatio()

virtual double cv::ml::ANN_MLP::getAnnealCoolingRatio ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getAnnealCoolingRatio(		) ->	retval

ANNEAL：更新冷却率。它必须大于 0 且小于 1。默认值为 0.95。

另请参阅

setAnnealCoolingRatio

getAnnealFinalT()

virtual double cv::ml::ANN_MLP::getAnnealFinalT ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getAnnealFinalT(		) ->	retval

ANNEAL：更新最终温度。它必须大于等于 0 且小于初始温度。默认值为 0.1。

另请参阅

setAnnealFinalT

getAnnealInitialT()

virtual double cv::ml::ANN_MLP::getAnnealInitialT ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getAnnealInitialT(		) ->	retval

ANNEAL：更新初始温度。它必须大于等于 0。默认值为 10。

另请参阅

setAnnealInitialT

getAnnealItePerStep()

virtual int cv::ml::ANN_MLP::getAnnealItePerStep ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getAnnealItePerStep(		) ->	retval

ANNEAL：更新每步迭代次数。它必须大于 0。默认值为 10。

另请参阅

setAnnealItePerStep

getBackpropMomentumScale()

virtual double cv::ml::ANN_MLP::getBackpropMomentumScale ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getBackpropMomentumScale(		) ->	retval

BPROP：动量项的强度（前两次迭代之间权重的差值）。此参数为权重提供一定的惯性以平滑随机波动。它可以从 0（禁用该功能）到 1 或更高。值为 0.1 左右即可。默认值为 0.1。

另请参阅

setBackpropMomentumScale

getBackpropWeightScale()

virtual double cv::ml::ANN_MLP::getBackpropWeightScale ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getBackpropWeightScale(		) ->	retval

BPROP：权重梯度项的强度。建议值为 0.1 左右。默认值为 0.1。

另请参阅

setBackpropWeightScale

getLayerSizes()

virtual cv::Mat cv::ml::ANN_MLP::getLayerSizes ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getLayerSizes(		) ->	retval

指定每层（包括输入层和输出层）神经元数量的整数向量。第一个元素指定输入层的元素数量。最后一个元素指定输出层的元素数量。

另请参阅

setLayerSizes

getRpropDW0()

virtual double cv::ml::ANN_MLP::getRpropDW0 ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getRpropDW0(		) ->	retval

RPROP：更新值 \(\Delta_0\) 的初始值 \(\Delta_{ij}\)。默认值为 0.1。

另请参阅

setRpropDW0

getRpropDWMax()

virtual double cv::ml::ANN_MLP::getRpropDWMax ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getRpropDWMax(		) ->	retval

RPROP：更新值上限 \(\Delta_{max}\)。它必须大于 1。默认值为 50。

另请参阅

setRpropDWMax

getRpropDWMin()

virtual double cv::ml::ANN_MLP::getRpropDWMin ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getRpropDWMin(		) ->	retval

RPROP：更新值下限 \(\Delta_{min}\)。它必须为正值。默认值为 FLT_EPSILON。

另请参阅

setRpropDWMin

getRpropDWMinus()

virtual double cv::ml::ANN_MLP::getRpropDWMinus ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getRpropDWMinus(		) ->	retval

RPROP：减小因子 \(\eta^-\)。它必须小于 1。默认值为 0.5。

另请参阅

setRpropDWMinus

getRpropDWPlus()

virtual double cv::ml::ANN_MLP::getRpropDWPlus ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getRpropDWPlus(		) ->	retval

RPROP：增大因子 \(\eta^+\)。它必须大于 1。默认值为 1.2。

另请参阅

setRpropDWPlus

getTermCriteria()

virtual TermCriteria cv::ml::ANN_MLP::getTermCriteria ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getTermCriteria(		) ->	retval

训练算法的终止条件。您可以指定最大迭代次数 (maxCount) 和/或在迭代之间为了使算法继续进行而必须改变的误差量 (epsilon)。默认值为 TermCriteria(TermCriteria::MAX_ITER + TermCriteria::EPS, 1000, 0.01)。

另请参阅

setTermCriteria

getTrainMethod()

virtual int cv::ml::ANN_MLP::getTrainMethod ( ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getTrainMethod(		) ->	retval

返回当前的训练方法

getWeights()

virtual Mat cv::ml::ANN_MLP::getWeights ( int layerIdx ) const

纯虚函数

Python
	cv.ml.ANN_MLP.getWeights(	layerIdx	) ->	retval

load()

static Ptr< ANN_MLP > cv::ml::ANN_MLP::load ( const String & filepath )

static (静态)

Python
	cv.ml.ANN_MLP.load(	filepath	) ->	retval
	cv.ml.ANN_MLP_load(	filepath	) ->	retval

从文件加载并创建一个序列化的 ANN。

使用 ANN::save 将 ANN 序列化并存储到磁盘。通过调用此函数并提供文件路径，可以再次从该文件中加载 ANN。

参数

filepath

序列化 ANN 的路径

setActivationFunction()

virtual void cv::ml::ANN_MLP::setActivationFunction ( int type, double param1=0, double param2=0 )

纯虚函数

Python
	cv.ml.ANN_MLP.setActivationFunction(	type[, param1[, param2]]	) ->	None

初始化每个神经元的激活函数。目前，默认且唯一完全支持的激活函数是 ANN_MLP::SIGMOID_SYM。

参数

type	激活函数的类型。请参阅 ANN_MLP::ActivationFunctions。
param1	激活函数的第一个参数，\(\alpha\)。默认值为 0。
param2	激活函数的第二个参数，\(\beta\)。默认值为 0。

setAnnealCoolingRatio()

virtual void cv::ml::ANN_MLP::setAnnealCoolingRatio ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setAnnealCoolingRatio(	val	) ->	None

另请参阅

getAnnealCoolingRatio

setAnnealEnergyRNG()

virtual void cv::ml::ANN_MLP::setAnnealEnergyRNG ( const RNG & rng )

纯虚函数

设置/初始化退火 RNG。

setAnnealFinalT()

virtual void cv::ml::ANN_MLP::setAnnealFinalT ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setAnnealFinalT(	val	) ->	None

另请参阅

getAnnealFinalT

setAnnealInitialT()

virtual void cv::ml::ANN_MLP::setAnnealInitialT ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setAnnealInitialT(	val	) ->	None

另请参阅

getAnnealInitialT

setAnnealItePerStep()

virtual void cv::ml::ANN_MLP::setAnnealItePerStep ( int val )

纯虚函数

Python
	cv.ml.ANN_MLP.setAnnealItePerStep(	val	) ->	None

另请参阅

getAnnealItePerStep

setBackpropMomentumScale()

virtual void cv::ml::ANN_MLP::setBackpropMomentumScale ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setBackpropMomentumScale(	val	) ->	None

另请参阅

getBackpropMomentumScale

setBackpropWeightScale()

virtual void cv::ml::ANN_MLP::setBackpropWeightScale ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setBackpropWeightScale(	val	) ->	None

另请参阅

getBackpropWeightScale

setLayerSizes()

virtual void cv::ml::ANN_MLP::setLayerSizes ( InputArray _layer_sizes )

纯虚函数

Python
	cv.ml.ANN_MLP.setLayerSizes(	_layer_sizes	) ->	None

指定每层（包括输入层和输出层）神经元数量的整数向量。第一个元素指定输入层的元素数量。最后一个元素指定输出层的元素数量。默认值为空 Mat。

另请参阅

getLayerSizes

setRpropDW0()

virtual void cv::ml::ANN_MLP::setRpropDW0 ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setRpropDW0(	val	) ->	None

另请参阅

getRpropDW0

setRpropDWMax()

virtual void cv::ml::ANN_MLP::setRpropDWMax ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setRpropDWMax(	val	) ->	None

另请参阅

getRpropDWMax

setRpropDWMin()

virtual void cv::ml::ANN_MLP::setRpropDWMin ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setRpropDWMin(	val	) ->	None

另请参阅

getRpropDWMin

setRpropDWMinus()

virtual void cv::ml::ANN_MLP::setRpropDWMinus ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setRpropDWMinus(	val	) ->	None

另请参阅

getRpropDWMinus

setRpropDWPlus()

virtual void cv::ml::ANN_MLP::setRpropDWPlus ( double val )

纯虚函数

Python
	cv.ml.ANN_MLP.setRpropDWPlus(	val	) ->	None

另请参阅

getRpropDWPlus

setTermCriteria()

virtual void cv::ml::ANN_MLP::setTermCriteria ( TermCriteria val )

纯虚函数

Python
	cv.ml.ANN_MLP.setTermCriteria(	val	) ->	None

另请参阅

getTermCriteria

setTrainMethod()

virtual void cv::ml::ANN_MLP::setTrainMethod ( int method, double param1=0, double param2=0 )

纯虚函数

Python
	cv.ml.ANN_MLP.setTrainMethod(	method[, param1[, param2]]	) ->	None

设置训练方法和通用参数。

参数

method	默认值为 ANN_MLP::RPROP。请参阅 ANN_MLP::TrainingMethods。
param1	传递给 ANN_MLP::RPROP 的 setRpropDW0，传递给 ANN_MLP::BACKPROP 的 setBackpropWeightScale，以及传递给 ANN_MLP::ANNEAL 的 initialT。
param2	传递给 ANN_MLP::RPROP 的 setRpropDWMin，传递给 ANN_MLP::BACKPROP 的 setBackpropMomentumScale，以及传递给 ANN_MLP::ANNEAL 的 finalT。

---

该类的文档由以下文件生成：

• opencv2/ml.hpp