主要内容

ClassificationEnsemble预测

使用决策树集成对观测结果进行分类

  • 库:
  • 统计和机器学习工具箱/分类

描述

ClassificationEnsemble预测Block使用决策树集合(ClassificationEnsembleClassificationBaggedEnsemble,或CompactClassificationEnsemble)作多类别分类。

通过指定包含该对象的工作区变量的名称,将经过训练的分类对象导入到块中。输入端口x接收一个观察(预测器数据)和输出端口标签为观察结果返回预测的类标签。您可以添加一个可选的输出端口分数即预测的班级分数或后验概率。

港口

输入

全部展开

预测器数据,指定为一个观测的列向量或行向量。

依赖关系

数据类型:||一半|int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点

输出

全部展开

预测的类标号,作为标量返回。被预测的班级为得分最高的班级。

数据类型:||一半|int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点|枚举

预测的类分数或后验概率,作为大小为1-的行向量返回k,在那里k是树模型中的类的数量。

要查看类的顺序,请使用一会指定的树模型的选择训练好的机器学习模型

依赖关系

数据类型:||一半|int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点

参数

全部展开

主要

指定工作区变量的名称,该变量包含ClassificationEnsemble对象,ClassificationBaggedEnsemble对象,或CompactClassificationEnsemble对象。

当你用fitcensemble,适用以下限制:

  • 你必须使用树型弱学习者来训练集合。

  • 预测数据不能包括分类预测(逻辑分类字符字符串,或细胞).如果在表中提供培训数据,则预测器必须为数字().也不能使用“CategoricalPredictors”名称-值参数。要在模型中包含分类预测器,可以使用dummyvar在拟合模型之前。

  • 的价值“ScoreTransform”名称-值参数不能是“invlogit”或者匿名函数。

  • 不能对树弱学习者使用代理分割,即“代孕”名称-值参数必须为“关闭”(默认)定义树型弱学习者时使用templateTree函数。

编程使用

块参数:TrainedLearner
类型:工作空间变量
价值观:ClassificationEnsemble对象|ClassificationBaggedEnsemble对象|CompactClassificationEnsemble对象
默认值:“ensMdl”

选择复选框以包含第二个输出端口分数ClassificationEnsemble预测块。

编程使用

块参数:ShowOutputScore
类型:特征向量
价值观:”从“|”“
默认值:“关闭”

数据类型

定点操作参数

为定点操作指定舍入模式。有关更多信息,请参见舍入(定点设计师)

块参数总是四舍五入到最接近的可表示值。为了控制块参数的四舍五入,使用MATLAB输入一个表达式®入掩码字段的舍入函数。

编程使用

块参数:RndMeth
类型:特征向量
价值观:'Ceiling' | 'Convergent' | 'Floor' | '最接近' | 'Round' | '最简单' | 'Zero'
默认值:“地板”

指定溢出是否饱和或缠绕。

行动 基本原理 对溢出的影响 例子

选中此复选框().

您的模型可能存在溢出,您希望在生成的代码中提供显式的饱和保护。

溢出饱和到数据类型可以表示的最小值或最大值。

最大的值int8(有符号8位整数)数据类型可以表示为127。任何大于此最大值的块操作结果都会导致8位整数溢出。选中复选框后,块输出饱和为127。同样,块输出在最小输出值为-128时饱和。

清除此复选框().

您希望优化生成代码的效率。

您希望避免过度指定块如何处理超出范围的信号。有关更多信息,请参见排除信号范围错误(万博1manbetx模型)

溢出封装到数据类型可以表示的适当值。

最大的值int8(有符号8位整数)数据类型可以表示为127。任何大于此最大值的块操作结果都会导致8位整数溢出。清除复选框后,软件将导致溢出的值解释为int8,这可能会产生意想不到的结果。例如,130(二进制1000 0010)的块结果表示为int8是-126。

编程使用

块参数:SaturateOnIntegerOverflow
类型:特征向量
价值观:”从“|”“
默认值:“关闭”

选择此参数以防止定点工具覆盖为块指定的数据类型。有关更多信息,请参见使用锁定输出数据类型设置(定点设计师)

编程使用

块参数:LockScale
类型:特征向量
价值观:”从“|”“
默认值:“关闭”
数据类型

的数据类型标签输出。类型可以继承、指定为枚举数据类型或表示为数据类型对象,例如万博1manbetx仿真软件。NumericType

当您选择一个继承的选项时,软件的行为如下:

  • 继承:通过反向传播继承(默认为数字和逻辑标签)- Simulink自动确定万博1manbetx标签数据类型在数据类型传播期间块的数据类型传播(万博1manbetx模型)).在这种情况下,块使用下游块或信号对象的数据类型。

  • 继承:汽车(默认为非数字标签)-块使用一个自定义的枚举数据类型变量。例如,假设工作区变量名由选择训练好的机器学习模型myMdl,类标签为类1二班.然后,相应的标签值是myMdl_enumLabels.class_1myMdl_enumLabels.class_2.代码块将类标签转换为有效的MATLAB标识符matlab.lang.makeValidName函数。

有关数据类型的更多信息,请参见控制信号数据类型(万博1manbetx模型)

单击显示数据类型助手按钮来显示数据类型的助理,帮助您设置数据类型属性。有关更多信息,请参见使用数据类型助手指定数据类型(万博1manbetx模型)

依赖关系

所支持的万博1manbetx数据类型依赖于模型中使用的标签选择训练好的机器学习模型

  • 如果模型使用数字或逻辑标签,则支持的数据类型为万博1manbetx继承:通过反向传播继承(默认),一半int8uint8int16uint16int32uint32int64uint64布尔、固定点和数据类型对象。

  • 如果模型使用非数字标签,则支持的数据类型为万博1manbetx继承:汽车(默认),枚举:<类名>,以及一个数据类型对象。

编程使用

块参数LabelDataTypeStr
类型:特征向量
'继承:通过反向传播继承'|“继承:汽车”|“双”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”|“int32”|“uint32”|“int64”|“uint64”|“布尔”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|“枚举:<类名>”|“< >数据类型表达”
默认的'继承:通过反向传播继承'(用于数字和逻辑标签)|“继承:汽车”(非数字标签)

的较低值标签Simulink的输出范围万博1manbetx®检查。

万博1manbetxSimulink使用最小值执行:

请注意

标签最低参数不饱和或剪辑实际标签输出信号。使用饱和(万博1manbetx模型)块来代替。

依赖关系

只有当指定的模型为选择训练好的机器学习模型使用数字标签。

编程使用

块参数LabelOutMin
类型:特征向量
“[]”|标量
默认的“[]”

的上值标签Simulink检查的输出范围。万博1manbetx

万博1manbetxSimulink使用最大值来执行:

请注意

标签最大参数不饱和或剪辑实际标签输出信号。使用饱和(万博1manbetx模型)块来代替。

依赖关系

只有当指定的模型为选择训练好的机器学习模型使用数字标签。

编程使用

块参数LabelOutMax
类型:特征向量
“[]”|标量
默认的“[]”

的数据类型分数输出。类型可以继承、直接指定或表示为数据类型对象,例如万博1manbetx仿真软件。NumericType

当您选择继承:汽车,则块使用继承数据类型的规则。

有关数据类型的更多信息,请参见控制信号数据类型(万博1manbetx模型)

单击显示数据类型助手按钮来显示数据类型的助理,帮助您设置数据类型属性。有关更多信息,请参见使用数据类型助手指定数据类型(万博1manbetx模型)

编程使用

块参数ScoreDataTypeStr
类型:特征向量
“继承:汽车”|“双”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”|“int32”|“uint32”|“int64”|“uint64”|“布尔”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|“< >数据类型表达”
默认的“继承:汽车”

的较低值分数Simulink检查的输出范围。万博1manbetx

万博1manbetxSimulink使用最小值执行:

请注意

分数最低参数不饱和或剪辑实际分数信号。使用饱和(万博1manbetx模型)块来代替。

编程使用

块参数ScoreOutMin
类型:特征向量
“[]”|标量
默认的“[]”

的上值分数Simulink检查的输出范围。万博1manbetx

万博1manbetxSimulink使用最大值来执行:

请注意

得分最高参数不饱和或剪辑实际分数信号。使用饱和(万博1manbetx模型)块来代替。

编程使用

块参数ScoreOutMax
类型:特征向量
“[]”|标量
默认的“[]”

为内部未转换的分数指定数据类型。类型可以继承、直接指定或表示为数据类型对象,例如万博1manbetx仿真软件。NumericType

当您选择继承:汽车,则块使用继承数据类型的规则。

有关数据类型的更多信息,请参见控制信号数据类型(万博1manbetx模型)

单击显示数据类型助手按钮来显示数据类型的助理,帮助您设置数据类型属性。有关更多信息,请参见使用数据类型助手指定数据类型(万博1manbetx模型)

依赖关系

只有当指定的模型为选择训练好的机器学习模型使用一个分数转换“没有”(默认,一样“身份”).

  • 如果模型没有使用分数转换(“没有”“身份”),然后您可以使用分数数据类型

  • 如果模型使用分数转换“没有”“身份”,然后可以使用此参数指定未转换的原始分数的数据类型,并使用分数数据类型

属性可以更改分数转换选项“ScoreTransform”名称-值参数,或通过更改ScoreTransform培训后财产。

编程使用

块参数RawScoreDataTypeStr
类型:特征向量
“继承:汽车”|“双”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”|“int32”|“uint32”|“int64”|“uint64”|“布尔”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|“< >数据类型表达”
默认的“继承:汽车”

Simulink检查的未转换分数范围的较低值。万博1manbetx

万博1manbetxSimulink使用最小值执行:

请注意

原始分数最低参数不会使实际未转换的分数信号饱和或剪辑。

编程使用

块参数RawScoreOutMin
类型:特征向量
“[]”|标量
默认的“[]”

Simulink检查的未转换分数范围的上限。万博1manbetx

万博1manbetxSimulink使用最大值来执行:

请注意

原始分数最高参数不会使实际未转换的分数信号饱和或剪辑。

编程使用

块参数RawScoreOutMax
类型:特征向量
“[]”|标量
默认的“[]”

为弱学习者的输出指定数据类型。类型可以继承、直接指定或表示为数据类型对象,例如万博1manbetx仿真软件。NumericType

当您选择继承:汽车,则块使用继承数据类型的规则。

有关数据类型的更多信息,请参见控制信号数据类型(万博1manbetx模型)

单击显示数据类型助手按钮来显示数据类型的助理,帮助您设置数据类型属性。有关更多信息,请参见使用数据类型助手指定数据类型(万博1manbetx模型)

编程使用

块参数WeakLearnerDataTypeStr
类型:特征向量
“继承:汽车”|“双”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”|“int32”|“uint32”|“int64”|“uint64”|“布尔”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|“< >数据类型表达”
默认的“继承:汽车”

Simulink检查的弱学习输出范围的较低值。万博1manbetx

万博1manbetxSimulink使用最小值执行:

请注意

弱学习者最低参数不饱和或剪辑实际的弱学习者输出信号。

编程使用

块参数WeakLearnerOutMin
类型:特征向量
“[]”|标量
默认的“[]”

Simulink检查的弱学习输出范围的上限。万博1manbetx

万博1manbetxSimulink使用最大值来执行:

请注意

弱学习者最大参数不饱和或剪辑实际的弱学习者输出信号。

编程使用

块参数WeakLearnerOutMax
类型:特征向量
“[]”|标量
默认的“[]”

块特征

数据类型

布尔||枚举|不动点|一半|整数|

直接引线

是的

多维信号

没有

适应信号

没有

讨论二阶导数过零检测

没有

选择功能

你可以使用MATLAB函数块与预测决策树集合的目标函数(ClassificationEnsembleClassificationBaggedEnsemble,或CompactClassificationEnsemble).例如,请参见用MATLAB函数块预测类标签

当决定是否使用ClassificationEnsemble预测在统计和机器学习工具箱™库或MATLAB函数块与预测功能,考虑以下:

  • 如果使用“统计和机器学习工具箱”库块,则可以使用定点的工具(定点设计师)将浮点模型转换为固定点模型。

  • 万博1manbetx变量的MATLAB函数块必须支持可变大小的数组预测函数。

  • 如果您使用MATLAB函数块,您可以使用MATLAB函数在相同的MATLAB函数块中进行预测之前或之后的预处理或后处理。

扩展功能

C / c++代码生成
使用Simulink®Coder™生成C和c++代码。万博1manbetx

定点转换
使用定点设计器™设计和模拟定点系统。

介绍了R2021a