このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

getCheckInstanceIDs

クラス: Advisor.Application
名前空間: Advisor

チェック インスタンス ID の取得

このページをすべて展開する

構文

CheckInstanceIDs = getCheckInstanceIDs(app)
CheckInstanceIDs = getCheckInstanceIDs(app,CheckID)

説明

チェック ID を使用してチェックのチェック インスタンス ID を取得します。チェック インスタンスは、モデル アドバイザー構成の ModelAdvisor.Check オブジェクトをインスタンス化したものです。モデル アドバイザー構成を変更すると、チェック インスタンス ID が変わる場合があります。チェック ID は、変化しない静的な識別子です。

CheckInstanceIDs = getCheckInstanceIDs(app) はチェック インスタンス ID の cell 配列を返します。

例

CheckInstanceIDs = getCheckInstanceIDs(app,CheckID) は、チェックに関連付けられている単一または複数のインスタンス ID を返します。getCheckInstanceIDs は、チェックがモデル アドバイザー ツリーの複数のフォルダーに存在している場合、複数のチェック インスタンス ID を返します。

例

入力引数

すべて展開する

モデル アドバイザーのアプリケーション オブジェクト。Advisor.Application オブジェクトとして指定します。Advisor.Application オブジェクトを使用して、モデル参照階層に対してモデル アドバイザー チェックを実行できます。メソッド Advisor.Manager.createApplication を使用して Advisor.Application オブジェクトを作成します。

モデル アドバイザー チェックに関連付けられているチェック ID。文字ベクトルとして指定します。

例: 'mathworks.design.UnconnectedLinesPorts'

出力引数

すべて展開する

チェック インスタンス ID。cell 配列として返されます。

例

すべて展開する

この例では、Advisor.Application オブジェクトを作成し、モデル アドバイザー解析のルートを設定し、さらに、選択した各チェック インスタンス ID を確認する方法を示します。

モデル例 sldemo_mdlref_basic を開きます。MATLAB® コマンド ウィンドウで次を入力します。

openExample("sldemo_mdlref_basic")

モデル アドバイザー チェックを実行するために使用できる Advisor.Application オブジェクトを作成します。

app = Advisor.Manager.createApplication();

解析するモデルまたはサブシステムを指定します。この例では、モデル sldemo_mdlref_basic をモデル アドバイザー解析のルートとして指定します。

setAnalysisRoot(app,Root = "sldemo_mdlref_basic");

現在のモデル アドバイザー構成で各チェック インスタンスを選択します。

selectCheckInstances(app);

現在のモデル アドバイザー構成で各チェック インスタンスのチェック インスタンス ID を取得します。

CheckInstanceIDs = getCheckInstanceIDs(app);

この例では、Advisor.Application オブジェクトを作成し、モデル アドバイザー解析のルートを設定し、さらに、チェック [ルート モデルの Inport ブロックの仕様をチェック] に関連付けられているチェック インスタンス ID を確認する方法を示します。

モデル例 sldemo_mdlref_basic を開きます。MATLAB コマンド ウィンドウで次を入力します。

openExample("sldemo_mdlref_basic")

モデル アドバイザー チェックを実行するために使用できる Advisor.Application オブジェクトを作成します。

app = Advisor.Manager.createApplication();

解析するモデルまたはサブシステムを指定します。この例では、モデル sldemo_mdlref_basic をモデル アドバイザー解析のルートとして指定します。

setAnalysisRoot(app,Root = "sldemo_mdlref_basic");

チェック インスタンス ID を確認して使用することで、モデル アドバイザーでチェック [接続されていないライン、入力端子、出力端子を特定] を実行するように指定します。

checkID = "mathworks.design.UnconnectedLinesPorts";
instanceIDs = getCheckInstanceIDs(app,checkID)

チェック インスタンス ID を使用して、モデル アドバイザー解析で実行されるチェックを選択または選択解除できます。詳細については、メソッド selectCheckInstances および deselectCheckInstances を参照してください。

Advisor.Application オブジェクトを使用したモデル アドバイザーの実行の詳細については、Advisor.Application を参照してください。

この例では、モデル sldemo_mdlref_basic およびその参照モデル sldemo_mdlref_counter でチェック [ルート モデルの Inport ブロックの仕様をチェック] を実行する方法について説明します。

モデル例 sldemo_mdlref_basic を開きます。MATLAB コマンド ウィンドウで次を入力します。

openExample("sldemo_mdlref_basic")

モデル sldemo_mdlref_basic は 3 つの Model ブロック CounterA、CounterB、および CounterC を含む親モデルです。これらのブロックは同じモデル sldemo_mdlref_counter を参照しています。このモデルは別個のモデルであり、sldemo_mdlref_basic のサブシステムではありません。

sldemo_mdlref_basic 内のモデル参照階層全体でモデル アドバイザー チェックを実行するために使用できる Advisor.Application オブジェクトを作成します。

app = Advisor.Manager.createApplication();

解析するモデルまたはサブシステムを指定します。この例では、モデル sldemo_mdlref_basic をモデル アドバイザー解析のルートとして指定します。

setAnalysisRoot(app,Root = "sldemo_mdlref_basic");

Advisor.Application オブジェクトの解析ルートとしてモデルを指定すると、モデル アドバイザーはそのモデルおよびすべての参照モデルを解析します。詳細については、setAnalysisRoot を参照してください。

チェック [ルート モデルの Inport ブロックの仕様をチェック] のみを実行するとします。

既定では、Advisor.Application オブジェクトは、現在のモデル アドバイザー構成で各チェック インスタンスを実行するように設定されており、すべてのチェック インスタンスが選択されています。チェック インスタンスをクリアして、すべてのチェック インスタンスをモデル アドバイザー解析から削除します。

deselectCheckInstances(app);

チェック インスタンス ID を確認して使用することで、モデル アドバイザーでチェック [ルート モデルの Inport ブロックの仕様をチェック] のみを実行するように指定します。

checkID = "mathworks.design.RootInportSpec";
instanceIDs = getCheckInstanceIDs(app,checkID);
instanceID = instanceIDs(1);
selectCheckInstances(app,ID = instanceID);

これで、モデル アドバイザー解析用にチェック [ルート モデルの Inport ブロックの仕様をチェック] が選択されました。

メソッド getCheckInstanceIDs は複数のチェック インスタンス ID を返します。これは、チェック [ルート モデルの Inport ブロックの仕様をチェック] がモデル アドバイザー ツリーの複数のフォルダーに存在しているためです。この例では、instanceID は getCheckInstanceIDs から返された最初のチェック インスタンス ID として指定されていますが、getCheckInstanceIDs から返された任意のチェック インスタンス ID を選択できます。

メモ

あるいは、個別のチェックを選択するのではなくモデル アドバイザー構成ファイルを読み込む場合は、メソッド loadConfiguration を使用します。

モデル アドバイザー解析を実行します。

run(app);

モデル アドバイザーは、sldemo_mdlref_basic と sldemo_mdlref_counter の両方でチェック [ルート モデルの Inport ブロックの仕様をチェック] を実行します。

モデル アドバイザー解析からの結果を取得します。

res = getResults(app);

モデル アドバイザー レポートを生成して表示します。

report = generateReport(app);
web(report);

モデル アドバイザー レポートは、sldemo_mdlref_basic および sldemo_mdlref_counter の結果の概要、およびモデルごとの個別のレポートへのハイパーリンクを提供します。

この例では、モデル slexVariantManagement のさまざまなバリアント選択でチェック [接続されていないライン、入力端子、出力端子を特定] を実行する方法を示します。

モデル例 slexVariantManagement を開きます。MATLAB コマンド ウィンドウで次を入力します。

openExample("slexVariantManagement")

モデル slexVariantManagement には、Controller や Plant など、複数の Variant Subsystem ブロックが含まれています。Variant Subsystem ブロック内には、該当するコンポーネントのさまざまな実装があります。

slexVariantManagement には、モデルに関連付けられているバリアント構成データ オブジェクト vcd に保存されている複数のバリアント構成があります。Advisor.Application オブジェクトでは、バリアント マネージャーを使用して作成したバリアント構成で、モデル内のアクティブおよび非アクティブなバリアント ブロックのモデル アドバイザー解析のみを実行できます。詳細については、Variant Manager for SimulinkおよびVariant Configurationsを参照してください。

モデル アドバイザー チェックを実行するために使用できる Advisor.Application オブジェクトを作成します。

app = Advisor.Manager.createApplication();

AnalyzeVariants を true として指定し、Advisor.Application オブジェクトで slexVariantManagement のバリアント選択ごとにモデル アドバイザーを実行できるようにします。

app.AnalyzeVariants = true;

解析するモデルを指定します。この例では、モデル slexVariantManagement をモデル アドバイザー解析のルートとして指定します。

setAnalysisRoot(app,Root = "slexVariantManagement");

チェック [接続されていないライン、入力端子、出力端子を特定] のみを実行するとします。

既定では、Advisor.Application オブジェクトは、現在のモデル アドバイザー構成で各チェック インスタンスを実行するように設定されており、すべてのチェック インスタンスが選択されています。チェック インスタンスをクリアして、すべてのチェック インスタンスをモデル アドバイザー解析から削除します。

deselectCheckInstances(app);

チェック インスタンス ID を確認して使用することで、モデル アドバイザーでチェック [接続されていないライン、入力端子、出力端子を特定] を実行するように指定します。

checkID = "mathworks.design.UnconnectedLinesPorts";
instanceIDs = getCheckInstanceIDs(app,checkID);
instanceID = instanceIDs(1);
selectCheckInstances(app,ID = instanceID);

これで、モデル アドバイザー解析用にチェック [接続されていないライン、入力端子、出力端子を特定] が選択されました。

メソッド getCheckInstanceIDs は複数のチェック インスタンス ID を返します。これは、チェック [接続されていないライン、入力端子、出力端子を特定] がモデル アドバイザー ツリーの複数のフォルダーに存在しているためです。この例では、instanceID は getCheckInstanceIDs から返された最初のチェック インスタンス ID として指定されていますが、getCheckInstanceIDs から返された任意のチェック インスタンス ID を選択できます。

メモ

あるいは、個別のチェックを選択するのではなくモデル アドバイザー構成ファイルを読み込む場合は、メソッド loadConfiguration を使用します。

モデル アドバイザー解析を実行します。

run(app);

モデル アドバイザーは、モデルおよび参照モデルで両方のアクティブなバリアントのチェックを実行します。

モデル アドバイザー解析からの結果を取得します。

res = getResults(app);

モデル アドバイザー レポートを生成して表示します。

report = generateReport(app);
web(report);

モデル アドバイザー レポートは、slexVariantManagement の結果の概要、およびバリアントごとの個別のレポートへのハイパーリンクを提供します。

代替方法

モデル アドバイザー ウィンドウの左側のペインで、チェックを右クリックし、[ワークスペースにチェック インスタンス ID を送信] を選択します。

バージョン履歴

R2015b で導入

参考

| | | |