Advisor.addExclusion
対象外指定をモデルまたは対象外指定ファイルに追加する
構文
説明
exclusionInfo = Advisor.addExclusion(modelName,filterType,entityIdentifier)modelName 内で、ブロック、サブシステム、Stateflow® 要素のようなエンティティに対象外指定を追加し、その対象外指定に関する情報を含むオブジェクト exclusionInfo を返します。対象外指定のタイプは filterType 引数で指定します。エンティティは entityIdentifier 引数で指定します。
exclusionInfo = Advisor.addExclusion(___,Name,Value)checks を使用して特定のモデル アドバイザー チェックの対象からエンティティを除外したり、引数 rationale を使用して対象外指定の理由を指定したりすることができます。
メモ
対象外指定を追加すると、モデル アドバイザーでモデルに対して実行する必要がある解析の範囲が限定されるため、モデルの開発と検証にかかる時間を短縮できます。
例
Simulink® ブロックをモデル アドバイザーの解析対象から除外します。
slexAircraftExample モデルを開きます。
openExample('simulink_aerospace/AircraftLongitudinalFlightControlExample')u という名前の Inport ブロックをクリックします。
対象外指定をブロックに追加して、選択したブロックをモデル アドバイザーの解析対象から除外します。MATLAB® コマンド ウィンドウで次を入力します。
exclusions = Advisor.addExclusion('slexAircraftExample','Block',gcb);
'Block' は、対象外指定によって Simulink ブロックをフィルターで除外することを指定します。以下を入力してモデルから対象外指定を取得します。
exclusions(1)
ans =
AdvisorFilterSpecification with properties:
filteredItem: [1×1 advisor.filter.IFilter]
metadata: [1×1 advisor.filter.Metadata]
mode: Exclude
commentThread: [1×0 advisor.filter.Metadata Sequence]
type: Block
id: 'slexAircraftExample:1'
checks: [1×1 String Sequence]Simulink キャンバスを右クリックし、[モデル アドバイザー] 、 [モデル アドバイザーの対象外指定エディターを開く] を選択することで、モデル アドバイザーの対象外指定エディターで対象外指定を表示することもできます。
モデル アドバイザーの対象外指定エディターに、u Inport ブロックの対象外指定の行を含む表が表示されます。[フィルター識別子] 列に、entityIdentifier 引数で指定されたパス名が表示されます。また、[フィルター タイプ] 列に、filterType 引数で指定された対象外指定のフィルター タイプが表示されます。[根拠] 列および [チェック ID] 列は、rationale 引数および checks 引数に関連付けられています。
関数 Advisor.addExclusion を使用して、Stateflow チャートをモデル アドバイザーの解析対象から除外します。この例には、Stateflow が必要です。
sf_yoyo モデルを開きます。
openExample('stateflow/YoYoControlOfSatelliteExample')Stateflow チャートで、モデル アドバイザー チェックの対象から除外するエンティティをクリックします。この例では、デフォルト遷移 [{ReelState= 0;}] をクリックします。
対象外指定を遷移に追加して、選択した遷移をモデル アドバイザーの解析対象から除外します。MATLAB コマンド ウィンドウで次を入力します。
exclusions = Advisor.addExclusion('sf_yoyo','Transition',gcb,'rationale','Do not analyze.')
以下を入力してモデルから対象外指定を取得します。
exclusions(1)
ans =
AdvisorFilterSpecification with properties:
filteredItem: [1×1 advisor.filter.IFilter]
metadata: [1×1 advisor.filter.Metadata]
mode: Exclude
commentThread: [1×0 advisor.filter.Metadata Sequence]
type: Block
id: 'sf_yoyo:1'
checks: [1×1 String Sequence]Simulink キャンバスを右クリックし、[モデル アドバイザー] 、 [モデル アドバイザーの対象外指定エディターを開く] を選択することで、モデル アドバイザーの対象外指定エディターで対象外指定を表示できます。
入力引数
名前と値の引数
出力引数
代替機能
モデル アドバイザーの対象外指定エディター
モデル アドバイザーの対象外指定エディターを使用することで、Simulink キャンバスから対象外指定を追加することもできます。Simulink キャンバスから対象外指定を追加するには、エンティティを右クリックし、[モデル アドバイザー] を選択してから、追加する対象外指定のタイプに対応するメニュー オプションを選択します。詳細については、モデル アドバイザー チェックの解析対象からのブロックの除外を参照してください。
