金宝appSimulink.SubSystem.convertToModelReference

サブシステムからモデル参照への変換

構文

金宝appSimulink.SubSystem.convertToModelReference (gcb UseConversionAdvisor,真的)

(tf, h) =金宝app Simulink.SubSystem.convertToModelReference(中高,模型)

(tf, h) =金宝app Simulink.SubSystem.convertToModelReference(中高、模型、名称、值)

説明

金宝appSimulink.SubSystem.convertToModelReference (gcb UseConversionAdvisor,真的)は,選択している子系统ブロックに対してモデル参照変換アドバイザーを開きます。

［特遣部队，h) = 金宝appSimulink.SubSystem.convertToModelReference (中高，模型）は指定したサブシステムを参照モデルに変換します。

関数が変換するサブシステムごとに,以下を行います。

モデルを作成する。
サブシステムの内容を新しいモデルにコピーする。
ルートレベルの尺寸ブロックおよび外港ブロックとモデルのコンフィギュレーションパラメーターを更新し,元のサブシステムのコンパイルされた属性と一致させる。
元のモデルのモデルワークスペースの内容を新しいモデルにコピーする。

この関数を使用する前に,サブシステムが含まれるモデルを読み込みます。

例

［特遣部队，h) = 金宝appSimulink.SubSystem.convertToModelReference (中高，模型，名称,值）は1つ以上の名前と値のペアの引数を使用してオプションを指定します。

例

すべて折りたたむ

モデル参照変換アドバイザーを開く

f14モデルを開きます。

open_system (“f14”）;

f14モデルで,控制器子系统の出力信号を選択して(信号のログ]をクリックします。

金宝app^®エディターで,控制器子系统を選択します。コマンドラインからモデル参照変換アドバイザーを開きます。

金宝appSimulink.SubSystem.convertToModelReference (gcb),“UseConversionAdvisor”,真正的);

アドバイザーを使用して変換を実行します。

サブシステムから参照モデルへの変換

スクリプトを開く

巴士柜台サブシステムをbus_counter_ref_modelという名前の参照モデルに変換します。

open_system (“sldemo_mdlref_conversion”）;金宝appSimulink.SubSystem.convertToModelReference (…“sldemo_mdlref_conversion /巴士柜台”，…“bus_counter_ref_model”，…“AutoFix”,真的,…“ReplaceSubsystem”,真的,…“CheckSimulationResults”,真正的);

###成功地将子系统块转换为模型块

複数のサブシステムを参照モデルに変換する

2つのサブシステムを1つのコマンドで変換します。

open_system (“f14”）;set_param (gcs,“SaveOutput”，“上”，“SaveFormat”，“数据集”）;set_param (gcs,“SignalResolutionControl”，“UseLocalSettings”）;金宝appSimulink.SubSystem.convertToModelReference (…｛“f14 /控制器”，“f14 /飞机动力学模型”},…｛“controller_ref_model”，“aircraft_dynamics_ref_model”},…“ReplaceSubsystem”,真的,…“AutoFix”,真的,…“CheckSimulationResults”,真正的)

入力引数

すべて折りたたむ

`中高`- - - - - -サブシステム名またはハンドル
数値配列|文字ベクトル|文字ベクトルの细胞配列|字符串配列

サブシステム名またはハンドル。数値配列、文字ベクトル、文字ベクトルの细胞配列、または字符串配列として指定します。

変換できるサブシステムの詳細については,条件付き実行のための参照モデルの変更を参照してください。

データ型:双|字符|字符串

`模型`- - - - - -参照モデル名
文字ベクトル|文字ベクトルの细胞配列|字符串配列

参照モデル名。文字ベクトルまたは文字ベクトルの细胞配列、または字符串配列として指定します。各モデル名は 59 文字以下でなければなりません。

変換するサブシステムを複数指定する場合は,参照モデル名の数と同じ数を指定します。各モデル名は,指定されたサブシステムに同じ順序で対応します。

データ型:字符|字符串

名前と値のペアの引数

オプションのコンマ区切りされた名称,值の引数ペアを指定します。ここで,的名字は引数名,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を任意の順序で指定できます。

例:金宝appSimulink.SubSystem.convertToModelReference……(engineModelRef engineSubsys ReplaceSubsystem,真的)

`AutoFix`- - - - - -自動修正が可能なすべての変換の問題を修正するオプション
`假`(既定値) |`真正的`

自動修正が可能なすべての変換の問題を修正するオプション。“AutoFix”および真正的または假で構成されるコンマ区切りのペアとして指定します。

AutoFixを真正的に設定すると,関数は修正可能なすべての変換問題を修正します。関数で修正できない問題については、モデルを修正して対処するように促すエラーメッセージが変換プロセスによって生成されます。

メモ

力を真正的に設定すると,関数は自動的に変換の問題を修正しません。

データ型:逻辑

`力`- - - - - -エラーが発生しても変換を完了するオプション
`假`(既定値) |`真正的`

エラーが発生しても変換を完了するオプション。“力”および真正的または假で構成されるコンマ区切りのペアとして指定します。

真正的の場合,関数は変換エラーを警告として返し,AutoFixを真正的に設定した場合でもエラーを修正せずに変換を継続します。力オプションによって,この関数を変換の最初のステップを行うために使用し,その後手動で変換プロセスを完了させることができます。

データ型:逻辑

`CopyCodeMappings`- - - - - -親モデルから新しい変換されたモデルにコードマッピングをコピーするオプション
`假`(既定値) |`真正的`

親モデルから新しい変換されたモデルにコードマッピングをコピーするオプション。“CopyCodeMappings”および真正的または假で構成されるコンマ区切りのペアとして指定します。

真正的の場合,関数は親モデルから新しい変換された参照モデルに既存のコードマッピング構成をコピーします。

假の場合,関数は親モデルから新しい変換された参照モデルに既存のコードマッピング構成をコピーしません。

データ型:逻辑

`CheckSimulationResults`- - - - - -変換前後のシミュレーション結果をチェックするオプション
`假`(既定値) |`真正的`

変換前後のシミュレーション結果をチェックするオプション。“CheckSimulationResults”および真正的または假で構成されるコンマ区切りのペアとして指定します。

変換を実行する前に以下のようにします。

モデルで目的のサブシステム出力信号の信号ログを有効にする。
CheckSimulationResultsを真正的に設定する。
AbsoluteToleranceを設定する。
RelativeToleranceを設定する。
SimulationModesを元のモデルで使用されるシミュレーションモードに設定する。

シミュレーション結果間の差分が許容誤差レベルを超える場合,関数はメッセージを表示します。

データ型:逻辑

`AbsoluteTolerance`- - - - - -比較のための信号の絶対許容誤差
`1 e-06`(既定値) |数値スカラー

比較のための信号の絶対許容誤差。“AbsoluteTolerance”および数値スカラーで構成されるコンマ区切りのペアとして指定します。

CheckSimulationResultsを真正的に設定した場合にのみこのオプションを使用します。

データ型:双

`RelativeTolerance`- - - - - -比較のための信号の相対許容誤差
`1 e-06`(既定値) |数値スカラー

比較のための信号の相対許容誤差。“RelativeTolerance”および数値スカラーで構成されるコンマ区切りのペアとして指定します。

CheckSimulationResultsを真正的に設定した場合にのみこのオプションを使用します。

データ型:双

`DataFileName`- - - - - -変換データを保存するファイルの名前
文字ベクトル

変換データを保存するファイルの名前。“DataFileName”および文字ベクトルで構成されるコンマ区切りのペアとして指定します。絶対パスまたは相対パスを指定できます。

変換データは,垫ファイル(既定)またはMATLAB^®ファイルに保存できます。00ファイル拡張子を使用する場合,関数はすべての変数をMATLABファイルにシリアル化します。

既定では,関数はモデル名と_conversion_data.matで構成されるファイル名を使用します。

データ型:字符

`ReplaceSubsystem`- - - - - -子系统ブロックを模型ブロックと置き換えるオプション
`假`(既定値) |`真正的`

子系统ブロックを模型ブロックと置き換えるオプション。“ReplaceSubsystem”および真正的または假で構成されるコンマ区切りのペアとして指定します。

値を真正的に設定する場合は,サブシステムを変換する前に元のモデルのバックアップを作成することを検討してください。変換を元に戻す場合,バックアップを作成しておくとモデルの復元が容易になります。

ReplaceSubsystemを真正的に設定した場合,変換処理は自動修正オプションを使用するかどうかに応じて異なります。

自動修正を使用する場合,自動修正で入力端子または出力端子が変更されない限り,変換によって子系统ブロックは模型ブロックと置き換えられます。端子が変更される場合,変換によって子系统ブロックに挿入される模型ブロックにサブシステムの内容が含まれます。
自動修正を使用しない場合,変換によって子系统ブロックが模型ブロックと置き換えられます。

データ型:逻辑

`CreateWrapperSubsystem`- - - - - -モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション
`假`(既定値) |`真正的`

モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション。“CreateWrapperSubsystem”および真正的または假で構成されるコンマ区切りのペアとして指定します。

サブシステムを参照モデルに変換する場合,変換プロセスでラッパーサブシステムを挿入してモデルのレイアウトを保持できます。サブシステムラッパーには,変換による模型ブロックが含まれています。

この変換では,端子の追加によって模型ブロックのインターフェイスが変更された場合,ラッパーサブシステムが自動的に作成されます。

データ型:逻辑

`SimulationModes`- - - - - -模型ブロック用のシミュレーションモード
`“正常”`(既定値) |`“加速器”`

模型ブロック用のシミュレーションモード。“SimulationModes”および“正常”または“加速器”で構成されるコンマ区切りのペアとして指定します。このシミュレーションモード設定は変換によって作成されたモデルを参照する模型ブロックに適用されます。

データ型:字符

`BuildTarget`- - - - - -生成するモデル参照ターゲット
`“Sim卡”`|`“编码器”`

生成するモデル参照ターゲット。“BuildTarget”および“Sim卡”または“编码器”で構成されるコンマ区切りのペアとして指定します。

“Sim卡”——モデル参照のシミュレーションターゲット
“编码器”——コード生成ターゲット

データ型:字符

出力引数

すべて折りたたむ

`特遣部队`——真正的または假の結果
`1`|`0`|逻辑配列

真正または假の結果。データ型逻辑の1または0として返されます。

1の値は変換に成功したことを示します。

力を真正的に設定した場合,変換が完了すると関数は1の値を返します。ただし,シミュレーション結果は変換前のモデルのシミュレーション結果とは異なる場合があります。

`h`——作成された模型ブロックのハンドル
数値配列

作成された模型ブロックのハンドル。数値配列として返されます。

データ型:双

ヒント

親サブシステムとそのサブシステムの子を同時に変換することはできません。
変換する複数のサブシステムを1つのコマンドで指定すると,各サブシステムを個別に変換するのに比べ,時間が節約される可能性があります。複数サブシステムの変換プロセスはモデルを1回コンパイルします。
変換する複数のサブシステムを指定すると,変換プロセスは各システムを変換しようとします。正常に変換されたサブシステムは,他のサブシステムの変換が失敗しても,参照モデルになります。
複数のサブシステムを指定する場合は,次の点を考慮します。
- 入力引数で,“Autofix”、“ReplaceSubsystem”、“CheckSimulationResults”を真正的に設定する。
- モデルでは,シミュレーション時間を短時間に設定する。
データディクショナリは,次の条件がどちらも存在する場合に変換プロセスの一部として作成するバスオブジェクトを保存します。
- 最上位モデルでデータディクショナリを使用する。
- 最上位モデルへのすべての変更が保存されている。
マスクサブシステムの動作を維持するには,次の追加のタスクを実行します。
- マスクコールバック,アイコン,端子およびドキュメンテーションに対して,参照モデルに変換する前にマスクサブシステムのバックアップコピーを作成します。変換後に,バックアップしたマスクサブシステムのマスクエディターから内容を新しい模型ブロックのマスクエディターにコピーします。
- マスクパラメーターをモデル引数で置き換えます(再利用可能な参照モデルのインスタンスのパラメーター化を参照)。
メモ

参照モデルは,マスクパラメーターを作成するためにマスク初期化コードで実現できる機能をサポートしていません。

互換性についての考慮事項

すべて展開する

`“BuildTarget”`引数値`“环球套票”`は推奨されない

R2019a以降は非推奨

R2019aで,関数金宝appSimulink.SubSystem.convertToModelReferenceで使用される引数値は更新されました。レガシ引数値は下位互換性のためにサポートされています。

更新された“BuildTarget”引数値を利用するには,“环球套票”ではなく“编码器”を使用します。

参考

金宝appSimulink.BlockDiagram.copyContentsToSubsystem|金宝appSimulink.Bus.save|金宝appSimulink.SubSystem.copyContentsToBlockDiagram

トピック

R2006aで導入

金宝appSimulink.SubSystem.convertToModelReference

構文

説明

例

モデル参照変換アドバイザーを開く

サブシステムから参照モデルへの変換

複数のサブシステムを参照モデルに変換する

入力引数

`中高`- - - - - -サブシステム名またはハンドル
数値配列|文字ベクトル|文字ベクトルの细胞配列|字符串配列

`模型`- - - - - -参照モデル名
文字ベクトル|文字ベクトルの细胞配列|字符串配列

名前と値のペアの引数

`AutoFix`- - - - - -自動修正が可能なすべての変換の問題を修正するオプション
`假`(既定値) |`真正的`

`力`- - - - - -エラーが発生しても変換を完了するオプション
`假`(既定値) |`真正的`

`CopyCodeMappings`- - - - - -親モデルから新しい変換されたモデルにコードマッピングをコピーするオプション
`假`(既定値) |`真正的`

`CheckSimulationResults`- - - - - -変換前後のシミュレーション結果をチェックするオプション
`假`(既定値) |`真正的`

`AbsoluteTolerance`- - - - - -比較のための信号の絶対許容誤差
`1 e-06`(既定値) |数値スカラー

`RelativeTolerance`- - - - - -比較のための信号の相対許容誤差
`1 e-06`(既定値) |数値スカラー

`DataFileName`- - - - - -変換データを保存するファイルの名前
文字ベクトル

`ReplaceSubsystem`- - - - - -子系统ブロックを模型ブロックと置き換えるオプション
`假`(既定値) |`真正的`

`CreateWrapperSubsystem`- - - - - -モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション
`假`(既定値) |`真正的`

`SimulationModes`- - - - - -模型ブロック用のシミュレーションモード
`“正常”`(既定値) |`“加速器”`

`BuildTarget`- - - - - -生成するモデル参照ターゲット
`“Sim卡”`|`“编码器”`

出力引数

`特遣部队`——真正的または假の結果
`1`|`0`|逻辑配列

`h`——作成された模型ブロックのハンドル
数値配列

ヒント

互換性についての考慮事項

`“BuildTarget”`引数値`“环球套票”`は推奨されない

参考

トピック

金宝app仿真软件ドキュメンテーション

サポート

基于模型的嵌入式控制系统设计

金宝appSimulink.SubSystem.convertToModelReference

構文

説明

例

モデル参照変換アドバイザーを開く

サブシステムから参照モデルへの変換

複数のサブシステムを参照モデルに変換する

入力引数

中高- - - - - -サブシステム名またはハンドル数値配列|文字ベクトル|文字ベクトルの细胞配列|字符串配列

模型- - - - - -参照モデル名文字ベクトル|文字ベクトルの细胞配列|字符串配列

名前と値のペアの引数

AutoFix- - - - - -自動修正が可能なすべての変換の問題を修正するオプション假(既定値) |真正的

力- - - - - -エラーが発生しても変換を完了するオプション假(既定値) |真正的

CopyCodeMappings- - - - - -親モデルから新しい変換されたモデルにコードマッピングをコピーするオプション假(既定値) |真正的

CheckSimulationResults- - - - - -変換前後のシミュレーション結果をチェックするオプション假(既定値) |真正的

AbsoluteTolerance- - - - - -比較のための信号の絶対許容誤差1 e-06(既定値) |数値スカラー

RelativeTolerance- - - - - -比較のための信号の相対許容誤差1 e-06(既定値) |数値スカラー

DataFileName- - - - - -変換データを保存するファイルの名前文字ベクトル

ReplaceSubsystem- - - - - -子系统ブロックを模型ブロックと置き換えるオプション假(既定値) |真正的

CreateWrapperSubsystem- - - - - -モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション假(既定値) |真正的

SimulationModes- - - - - -模型ブロック用のシミュレーションモード“正常”(既定値) |“加速器”

BuildTarget- - - - - -生成するモデル参照ターゲット“Sim卡”|“编码器”

出力引数

特遣部队——真正的または假の結果1|0|逻辑配列

h——作成された模型ブロックのハンドル数値配列

ヒント

互換性についての考慮事項

“BuildTarget”引数値“环球套票”は推奨されない

参考

トピック

金宝app仿真软件ドキュメンテーション

サポート

基于模型的嵌入式控制系统设计

`中高`- - - - - -サブシステム名またはハンドル
数値配列|文字ベクトル|文字ベクトルの细胞配列|字符串配列

`模型`- - - - - -参照モデル名
文字ベクトル|文字ベクトルの细胞配列|字符串配列

`AutoFix`- - - - - -自動修正が可能なすべての変換の問題を修正するオプション
`假`(既定値) |`真正的`

`力`- - - - - -エラーが発生しても変換を完了するオプション
`假`(既定値) |`真正的`

`CopyCodeMappings`- - - - - -親モデルから新しい変換されたモデルにコードマッピングをコピーするオプション
`假`(既定値) |`真正的`

`CheckSimulationResults`- - - - - -変換前後のシミュレーション結果をチェックするオプション
`假`(既定値) |`真正的`

`AbsoluteTolerance`- - - - - -比較のための信号の絶対許容誤差
`1 e-06`(既定値) |数値スカラー

`RelativeTolerance`- - - - - -比較のための信号の相対許容誤差
`1 e-06`(既定値) |数値スカラー

`DataFileName`- - - - - -変換データを保存するファイルの名前
文字ベクトル

`ReplaceSubsystem`- - - - - -子系统ブロックを模型ブロックと置き換えるオプション
`假`(既定値) |`真正的`

`CreateWrapperSubsystem`- - - - - -モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション
`假`(既定値) |`真正的`

`SimulationModes`- - - - - -模型ブロック用のシミュレーションモード
`“正常”`(既定値) |`“加速器”`

`BuildTarget`- - - - - -生成するモデル参照ターゲット
`“Sim卡”`|`“编码器”`

`特遣部队`——真正的または假の結果
`1`|`0`|逻辑配列

`h`——作成された模型ブロックのハンドル
数値配列

`“BuildTarget”`引数値`“环球套票”`は推奨されない