回归树预测

回帰木モデルの使用による応答の予測

ライブラリ:
统计和机器学习工具箱/回归

説明

回归树预测ブロックは、回帰木オブジェクト (回归树または紧回归树) を使用して応答を予測します。

オブジェクトを含むワークスペース変数の名前を指定することにより、学習済みの回帰オブジェクトをブロックにインポートします。入力端子[x]では観測値 (予測子データ) を受信し、出力端子[yfit]では観測値の予測応答を返します。

端子

入力

すべて展開する

`x`— 予測子データ
行ベクトル | 列ベクトル

予測子データ。1.つの観測値の列ベクトルまたは行ベクトルとして指定します。

依存関係

[x]の変数の順序は、[选择经过训练的机器学习模型]で指定されたモデルで学習済みの、予測子変数の順序と同じでなければなりません。

データ型:仅有一个的|双重的|一半|int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔值|定点

出力

すべて展開する

`伊菲特`— 予測した応答
スカラー

予測応答。スカラーとして返されます。

データ型:仅有一个的|双重的|一半|int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔值|定点

パラメーター

すべて展開する

メイン

`学習済みの機械学習モデルの選択`— 回帰木モデル
`treeMdl`(既定値) |`回归树`オブジェクト |`紧回归树`オブジェクト

回归树オブジェクトまたは紧回归树オブジェクトを含むワークスペース変数の名前を指定します。

菲特里を使用してモデルに学習させる場合、以下の制限が適用されます。

予測子データにカテゴリカル予測子 (必然的、明确的、烧焦、一串、または单间牢房) を含めることはできません。学習データをテーブルで渡す場合、予測子は数値 (双重的または仅有一个的) でなければなりません。また、名前と値の引数“分类预测因素”は使用できません。カテゴリカル予測子をモデルに含めるには、モデルをあてはめる前に杜姆瓦尔を使用してカテゴリカル予測子を前処理します。
名前と値の引数“ResponseTransform”の値は“没有”(既定の設定) でなければなりません。
代理分岐は使用できません。つまり、名前と値の引数“代理”の値は“关”(既定の設定) でなければなりません。

プログラムでの使用

ブロックパラメーター:受训学员

型:ワークスペース変数

値:回归树オブジェクト |紧回归树オブジェクト

既定の設定:“treeMdl”

データ型

固定小数点が使用可能なパラメーター

`整数丸めモード`— 固定小数点演算の丸めモード
`地板`(既定値) |`天花板`|`会聚性的`|`最近的`|`圆形的`|`简单的`|`零`

固定小数点演算の丸めモードを指定します。詳細は、丸め（定点设计器）を参照してください。

ブロックパラメーターは常に、最も近い表現可能な値に丸められます。ブロックパラメーターの丸めを制御するには、MATLAB^®丸め関数を使用した表現をマスクフィールドに入力します。

プログラムでの使用

ブロックパラメーター:RndMeth

型:文字ベクトル

値:“天花板”|“收敛”|“地板”|“最近”|“圆形”|“最简单”|“零”

既定の設定:“地板”

`整数オーバーフローで飽和`— オーバーフローアクションのメソッド
`关`(既定値) |`在…上`

オーバーフローの際に飽和するか折り返すかを指定します。

アクション理由オーバーフローの際の影響例

アクション	理由	オーバーフローの際の影響	例
このチェックボックスをオンにする (`在…上`)。	モデルにオーバーフローの可能性があり、生成されたコードで明示的な飽和保護が必要である。	オーバーフローの際は、データ型が表現できる最小値または最大値に飽和します。	データ型`int8`(8 ビット負号付き整数) が表現できる最大値は 127です。この最大値よりも大きいブロック演算結果は、8.ビット整数のオーバーフローを引き起こします。チェックボックスをオンにすると、ブロック出力は 127で飽和します。同様に、ブロック出力は最小出力値の -128で飽和します。
このチェックボックスをオフにする (`关`)。	生成されたコードの効率を最適化したい。ブロックが範囲外の信号を処理する方法を過剰指定したくない。詳細は、信号範囲のエラーのトラブルシューティング（万博1manbetxSimulink）を参照してください。	オーバーフローの際は、データ型が表現できる適切な値で折り返します。	データ型`int8`(8 ビット負号付き整数) が表現できる最大値は 127です。この最大値よりも大きいブロック演算結果は、8.ビット整数のオーバーフローを引き起こします。チェックボックスをオフにすると、オーバーフローによって引き起こされた値が`int8`として解釈され、意図しない結果になる可能性があります。たとえば、130 (バイナリでは 1000 0010) というブロック結果が`int8`として表現されると、-126になります。

このチェックボックスをオンにする (在…上)。

モデルにオーバーフローの可能性があり、生成されたコードで明示的な飽和保護が必要である。

オーバーフローの際は、データ型が表現できる最小値または最大値に飽和します。

データ型int8(8 ビット負号付き整数) が表現できる最大値は 127です。この最大値よりも大きいブロック演算結果は、8.ビット整数のオーバーフローを引き起こします。チェックボックスをオンにすると、ブロック出力は 127で飽和します。同様に、ブロック出力は最小出力値の -128で飽和します。

このチェックボックスをオフにする (关)。

生成されたコードの効率を最適化したい。

ブロックが範囲外の信号を処理する方法を過剰指定したくない。詳細は、信号範囲のエラーのトラブルシューティング（万博1manbetxSimulink）を参照してください。

オーバーフローの際は、データ型が表現できる適切な値で折り返します。

データ型int8(8 ビット負号付き整数) が表現できる最大値は 127です。この最大値よりも大きいブロック演算結果は、8.ビット整数のオーバーフローを引き起こします。チェックボックスをオフにすると、オーバーフローによって引き起こされた値がint8として解釈され、意図しない結果になる可能性があります。たとえば、130 (バイナリでは 1000 0010) というブロック結果がint8として表現されると、-126になります。

プログラムでの使用

ブロックパラメーター:饱和积分溢出

型:文字ベクトル

値:“关”|“开”

既定の設定:“关”

`固定小数点ツールによる変更に対して出力データ型の設定をロックする`— 固定小数点ツールがデータ型をオーバーライドしないようにする
`关`(既定値) |`在…上`

このパラメーターを選択して、ブロックに指定したデータ型を固定小数点ツールがオーバーライドしないようにします。詳細は、[出力データ型の設定をロックする] の使用（定点设计器）を参照してください。

プログラムでの使用

ブロックパラメーター:磅秤

型:文字ベクトル

値:“关”|“开”

既定の設定:“关”

データ型

`出力データ型`-伊菲特出力のデータ型
`继承：自动`(既定値) |`双重的`|`仅有一个的`|`一半`|`int8`|`uint8`|`int16`|`uint16`|`int32`|`uint32`|`int64`|`uint64`|`布尔值`|`fixdt（1,16）`|`fixdt（1,16,0）`|`fixdt（1,16,2^0,0）`|`<データ型式>`

[yfit]出力のデータ型を指定します。データ型は継承するか、直接指定するか、万博1manbetxSimulink.NumericTypeのようにデータ型オブジェクトとして表現することができます。

[继承：自动]を選択すると、ブロックはデータ型を継承するルールを使用します。

データ型の詳細については、信号のデータ型の制御（万博1manbetxSimulink）を参照してください。

[データ型アシスタントを表示]ボタンをクリックすると、[データ型アシスタント]が表示されます。これは、データ型の属性を設定する際に役立ちます。詳細は、データ型アシスタントを利用したデータ型の指定（万博1manbetxSimulink）を参照してください。

プログラムでの使用

ブロックパラメーター:OutDataTypeStr

型: 文字ベクトル

値:'继承：自动'|“双人”|“单身”|“一半”|“int8”|‘uint8’|“int16”|‘uint16’|“int32”|‘uint32’|“int64”|‘uint64’|“布尔”|‘fixdt（1,16）’|‘fixdt（1,16,0）’|'fixdt（1,16,2^0,0）'|“<数据类型表达式>”

既定の設定:'继承：自动'

`出力の最小値`— 範囲チェックの伊菲特出力の最小値
`[]`(既定値) | スカラー

万博1manbetx^®がチェックする[yfit]出力範囲の下限値。

万博1manbetx模拟は以下を実行するために最小値を使用します。

一部のブロックを対象としたパラメーター範囲のチェック (ブロックパラメーターの最小値と最大値の指定（万博1manbetxSimulink）を参照)。
シミュレーション範囲のチェック (信号範囲の指定（万博1manbetxSimulink）およびシミュレーション範囲のチェックの有効化（万博1manbetxSimulink）を参照)。
固定小数点データ型の自動スケーリング。
モデルから生成するコードの最適化。この最適化により、アルゴリズムコードが削除され、SILやエクスターナルモードなど、一部のシミュレーションモードの結果に影響を与える可能性があります。詳細は、指定した最小値と最大値を使用した最適化（嵌入式编码器）を参照してください。

メモ

[出力の最小値]パラメーターが、[yfit]の実際の信号を飽和させたり、クリップしたりすることはありません。代わりに、饱和（万博1manbetxSimulink）ブロックを使用してください。

プログラムでの使用

ブロックパラメーター:奥特明

型: 文字ベクトル

値:'[]'| スカラー

既定の設定:'[]'

`出力の最大値`— 範囲チェックの伊菲特出力の最大値
`[]`(既定値) | スカラー

万博1manbetx模拟がチェックする[yfit]出力範囲の上限値。

万博1manbetx模拟は以下を実行するために最小値を使用します。

一部のブロックを対象としたパラメーター範囲のチェック (ブロックパラメーターの最小値と最大値の指定（万博1manbetxSimulink）を参照)。
シミュレーション範囲のチェック (信号範囲の指定（万博1manbetxSimulink）およびシミュレーション範囲のチェックの有効化（万博1manbetxSimulink）を参照)。
固定小数点データ型の自動スケーリング。
モデルから生成するコードの最適化。この最適化により、アルゴリズムコードが削除され、SILやエクスターナルモードなど、一部のシミュレーションモードの結果に影響を与える可能性があります。詳細は、指定した最小値と最大値を使用した最適化（嵌入式编码器）を参照してください。

メモ

[出力の最大値]パラメーターが、[yfit]の実際の信号を飽和させたり、クリップしたりすることはありません。代わりに、饱和（万博1manbetxSimulink）ブロックを使用してください。

プログラムでの使用

ブロックパラメーター:奥特马克斯

型: 文字ベクトル

値:'[]'| スカラー

既定の設定:'[]'

モデルの例

回归树预测ブロックの使用による応答の予測

この例では、回归树预测ブロックを Simulink®の応答予測に使用万博1manbetxする方法を示します。このブロックは、観測値 (予測子データ) を受け入れて、学習済みの回帰木モデルを使用することにより、その観測値の予測された応答を返します。

ライブスクリプトを開く

ブロックの特性

データ型	`布尔值`\|`双重的`\|`定点`\|`一半`\|`整数`\|`仅有一个的`
直接フィードスルー	`对`
多次元信号	`不`
可変サイズの信号	`不`
ゼロクロッシング検出	`不`

代替機能

MATLAB函数ブロックを回帰木オブジェクト (回归树または紧回归树) のオブジェクト関数预测と共に使用できます。たとえば、MATLAB函数ブロックの使用によるクラスラベルの予測を参照してください。

统计和机器学习工具箱™ ライブラリ内の回归树预测ブロックを使用するかどうか、または MATLAB函数ブロックを関数预测と共に使用するかどうかを判断する際には、以下を考慮してください。

统计和机器学习工具箱ライブラリブロックを使用する場合、固定小数点ツール（定点设计器）を使用して浮動小数点モデルを固定小数点に変換できます。
MATLAB函数ブロックを関数预测と共に使用する場合は、可変サイズの配列に対するサポートを有効にしなければなりません。
MATLAB函数ブロックを使用する場合、予測の前処理や後処理のために、同じ MATLAB函数ブロック内で MATLAB関数を使用することができます。

拡張機能

C/C++コード生成
万博1manbetxSimulink®编码器™ を使用して Cおよび C++コードを生成します。

固定小数点の変換
定点设计器™ を使用して固定小数点システムの設計とシミュレーションを行います。

参考

トピック

R2021aで導入

回归树预测

説明

端子