独自のカスタムモデルアドバイザーチェックの定義- MATLAB和Simuli金宝appnk MathWorks日本

独自のカスタムモデルアドバイザーチェックの定義

モデルアドバイザーが確認する独自の条件およびモデルコンフィギュレーション設定を指定するには,カスタムチェックを作成します。次の図は,カスタムチェックを作成して定義するワークフローの概要を示しています。以降のセクションで,ワークフローの各ステップの詳細について説明します。

sl_customizationファイルおよび関数の作成

カスタムチェックを定義するには,まず,MATLABパスにsl_customization.mファイルを作成します。sl_customization.mファイルの中に,関数sl_customizationを作成します。関数sl_customizationでは1つの引数(カスタマイズマネージャーオブジェクト)を受け入れます。

函数sl_customization (cm)

ヒント

MATLABパス上に複数のsl_customization.mファイルを配置することができます。
モデルアドバイザーのチェックとフォルダーをカスタマイズするsl_customization.mファイルは,ルートMATLAB^®フォルダーやそのサブフォルダー(matlabroot/工作フォルダーを除く)には配置しないでください。配置した場合,モデルアドバイザーはファイルで指定されているカスタマイズを無視します。

カスタムチェックの登録

カスタムチェックを登録するには,addModelAdvisorCheckFcnメソッドを使用します。これは,関数sl_customizationに入力するカスタマイズマネージャーオブジェクトの一部です。次のコードをsl_customization.mファイルに追加します。

函数sl_customization (cm)%注册自定义检查cm.addModelAdvisorCheckFcn (@checkDefinitionFcn)

addModelAdvisorCheckFcnメソッドは,checkDefinitionFcnで定義されたチェックを,モデルアドバイザーの[製品別]フォルダーに登録します。checkDefinitionFcn引数は,ModelAdvisor。检查クラスのインスタンスとしてモデルアドバイザーに追加するカスタムチェックを定義する関数のハンドルです。

チェック定義関数の作成

チェック定義関数は,チェック実行時にモデルアドバイザーが行うアクションを定義します。作成するチェックごとに1つのチェック定義関数を定義する必要があります。以降のセクションでは,チェック定義関数の主要なコンポーネントを説明します。

`ModelAdvisor。检查`クラスのインスタンスの作成

各カスタムチェックごとに,ModelAdvisor。检查クラスのインスタンスを1つ作成します。ModelAdvisor。检查プロパティおよびメソッドを使用して,チェックのユーザーインターフェイスとアクションを定義します。次の表は,主要なチェックコンポーネントの一部を示しています。

内容	説明
チェックID(必須)	チェックを一意に識別します。モデルアドバイザーはこのIDを使用してチェックにアクセスします。
チェックコールバック関数のハンドル(必須)	チェックの内容を指定する関数です。
チェック名(推奨)	モデルアドバイザーで表示されるチェックの名前を作成します。
モデルのコンパイル(オプション)	チェック解析用にモデルをコンパイルするかどうかを指定します。
入力パラメーター(オプション)	ユーザーによる入力を要求する入力パラメーターを追加します。モデルアドバイザーはこの入力を使用してチェックを実行します。
アクション(オプション)	修正アクションを追加します。

チェックアクションと修正の定義

チェック定義関数には,モデルアドバイザーにモデルまたはサブシステムに対して実行させるアクションを指定するチェックコールバック関数が含まれています。チェックコールバック関数を定義し,そのハンドルをsetCallbackFcnメソッドに受け渡します。チェックを実行すると,モデルアドバイザーはコールバック関数を実行します。チェック実行後,コールバック関数は結果を表示する戻り引数を1つ以上提供します。

カスタムチェックの修正を指定する場合,チェック定義関数にはアクションコールバック関数も含める必要があります。チェック定義関数内で,ModelAdvisor。行动クラスのインスタンスを作成します。アクションコールバック関数を定義し,そのハンドルをsetCallbackFcnメソッドに受け渡します。アクションを指定すると,モデルアドバイザーの[解析]ボックスの下に[アクション]ボックスが表示されます。[アクション]ボックスには,モデルまたはサブシステムを修正するためのボタンがあります。以下の例では,ボタンの名前は[設定の変更)です。

コールバック関数およびアクションコールバック関数から,チェックの実行後に結果を表示するための戻り引数が1つ以上返されます。チェックコールバック定義関数とアクションコールバック定義関数の作成を参照してください。

チェック入力パラメーターの定義

入力パラメーターを使用して,チェックを実行する前に入力を要求できます。ModelAdvisor。InputParameterクラスを使用して入力パラメーターを定義します。カスタムチェック定義関数に入力パラメーターの定義を組み込まなければなりません。モデルアドバイザーチェックに追加する入力パラメーターごとにこのクラスのインスタンスを1つ定義しなければなりません。

次のメソッドを使用して,入力パラメーターのレイアウトを指定します。

メソッド	説明
`setInputParametersLayoutGrid`	入力パラメーターグリッドのサイズを指定します。
`setRowSpan`	入力パラメーターレイアウトグリッド内のパラメーターの行数を指定します。
`setColSpan`	入力パラメーターレイアウトグリッド内のパラメーターの列数を指定します。

入力パラメーターはモデルアドバイザーの(入力パラメーター]ボックスに表示されます。

カスタムチェックが表示される場所の指定

发布メソッドを使用して,[製品別]フォルダー内にカスタムチェック用のフォルダーを作成します。次に,モデルアドバイザーの設定エディターを使用して,モデルアドバイザーツリー内のフォルダーをカスタマイズします。詳細については,モデルアドバイザーの設定エディターを使用したモデルアドバイザーのカスタマイズを参照してください。

モデルアドバイザーの設定エディターの代わりに,ModelAdvisor。集团クラスおよびModelAdvisor。FactoryGroupクラスを使用してモデルアドバイザーをカスタマイズすることができます。ただし,これらのAPIは柔軟性が劣り,時間がかかるモデルアドバイザーカスタマイズ方法です。カスタマイズされたチェックを、モデルアドバイザーツリーの最上位 (モデルアドバイザーのルート) に配置するには、ModelAdvisor。集团クラスを使用します。カスタマイズされたチェックを[タスク別]フォルダーの新しいフォルダーに配置するには,ModelAdvisor。FactoryGroupクラスを使用します。これらのタスクおよびフォルダーを関数sl_customizationに登録するメソッドを含めなければなりません。

チェック結果の書式設定

モデルアドバイザーの結果に既定の書式設定を使用するには,setCallbackFcnメソッドでコールバック関数のタイプをDetailStyleに指定します。既定の書式設定では要件が満たされない場合,他のコールバック関数スタイルの1つと,ModelAdvisor。FormatTemplateクラスまたは以下の他のモデルアドバイザーの書式設定APIのいずれかを使用します。

クラス	説明
`ModelAdvisor。文本`	モデルアドバイザーのテキスト出力を作成します。
`ModelAdvisor。列表`	リストを作成します。
`ModelAdvisor。表格`	テーブルを作成します。
`ModelAdvisor。段`	段落を作成し,書式設定します。
`ModelAdvisor。LineBreak`	改行を挿入します。
`ModelAdvisor。图像`	モデルアドバイザーの出力に画像を含めます。

チェックの表示と有効化

カスタムチェックがモデルアドバイザーにどのように表示されるかを指定することができます。どの場合にチェックを表示するか,またユーザーによるチェックの選択や選択解除を許可するかどうかを,ModelAdvisor。检查クラスの可见、启用、价值の各プロパティを使用して指定できます。

次のチャートは,可见、启用および价值の各プロパティ間の相互作用を示しています。

モデルアドバイザーにチェックをタスクとして追加する場合は,これらのプロパティをModelAdvisor。任务クラスで指定します。ModelAdvisor。检查クラスとModelAdvisor。任务クラスの両方でプロパティを指定した場合,ModelAdvisor。任务のプロパティが優先されます(可见プロパティとLicenseNameプロパティを除きます)。

参考