メインコンテンツ

ModelAdvisor.SystemResult

システム レベルのモデル アドバイザーの結果にアクセスする

説明

run メソッドを使用して取得したモデル アドバイザーの結果を表示します。

作成

SystemResult オブジェクトのプロパティにアクセスするには、Advisor.Application オブジェクトに getResults メソッドを適用します。ModelAdvisor.run を使用してモデル アドバイザーを実行すると、結果が SystemResult オブジェクトとして返されます。このオブジェクトのプロパティに直接アクセスできます。

プロパティ

すべて展開する

モデル アドバイザーが解析するモデルまたはサブシステムです。

データ型: char

モデル アドバイザーが解析したモデル コンポーネントのタイプ。

データ型: char

それぞれのステータスのチェックの数。構造体として返されます。返される構造体には以下のフィールドが含まれています。

  • NotRun — 実行されなかったモデル アドバイザー チェックの数

  • Information — 情報を含むモデル アドバイザー チェックの数

  • Passed — パスしたモデル アドバイザー チェックの数

  • Justified — 正当化されたモデル アドバイザー チェックの数

  • Warning — 警告が出されたモデル アドバイザー チェックの数

  • Failed — 失敗したモデル アドバイザー チェックの数

  • Incomplete — 実行が不完全だったモデル アドバイザー チェックの数

データ型: structure

各モデル アドバイザー チェックの ModelAdvisor.CheckResult オブジェクトが含まれている cell 配列。これらのオブジェクト プロパティにアクセスして、モデル アドバイザー チェックの結果を取得します。

使用中の Simulink® のバージョン、MATLAB® のバージョン、およびモデルのバージョンの詳細。構造体として返されます。返される構造体には以下のフィールドが含まれています。

  • SimulinkVersion — 使用中の Simulink のバージョンの詳細

  • MATLABVersion — 使用中の MATLAB のバージョンの詳細

  • ModelVersion — 使用中のモデルのバージョンの詳細

コンフィギュレーション設定、正当化、対象外指定、オプション、解析の持続時間の詳細。構造体として返されます。返される構造体には以下のフィールドが含まれています。

  • ConfigurationFile — 使用中のコンフィギュレーション ファイルの名前

  • JustificationFile — 生成された正当化ファイルの名前

  • ExclusionFile — 解析から除外する必要があるチェックのリストを含むファイルの名前

  • AnalysisOptions — モデル アドバイザーの解析オプションの詳細。構造体として返されます。返される構造体には以下のフィールドが含まれています。

    解析オプション説明
    DisplayResults

    使用中のモデル アドバイザーの結果の表示設定。

    'Summary' (既定) | 'Details' | 'None'

    • 'Summary' — システムの結果の概要をコマンド ウィンドウに表示します。

    • 'Details' — チェック中のシステムのリアルタイムの進行状況の更新情報、各チェックのパスおよび失敗の結果、システムの結果の概要をコマンド ウィンドウに表示します。

    • 'None' — コマンド ウィンドウに何も情報を表示しません。

    TempDir

    モデル アドバイザーの一時作業フォルダーの設定が使用中かどうかを示します。

    'on' (既定) | 'off' |

    • 'on' — 並列プールを使用して実行するときの同時実行の問題を回避するために、一時作業フォルダーからモデル アドバイザーを実行します。

    • 'off' — 現在の作業フォルダーでモデル アドバイザーを実行します。

    Force

    モデル アドバイザーの強制削除の設定が使用中かどうかを示します。

    'on' (既定) | 'off' |

    • 'on' — 既存の modeladvisor/system フォルダーを削除します。

    • 'off' — 既存の modeladvisor/system フォルダーを削除する前に、プロンプトが表示されます。

    ShowExclusions

    モデル アドバイザー レポートのレポート対象外指定の表示設定が使用中かどうかを示します。

    'on' (既定) | 'off' |

    • 'on' — モデル アドバイザー チェックの対象外指定をレポートにリストします。

    • 'off' — モデル アドバイザー チェックの対象外指定をレポートにリストしません。

    TreatAsMdlRef

    モデルが参照モデルとして扱われるかどうかを示します。

    [] (既定) | 'on' | 'off'

    • [] — システムに参照モデルが存在します。

    • 'on' — モデルは参照モデルとして使用されます。

    • 'off' — モデルは参照モデルとして使用されません。

    ParallelMode

    モデル アドバイザーの並列実行の設定が使用中かどうかを示します。

    'off' (既定) | 'on'

    • 'off' — モデル アドバイザーは並列モードで実行されません。

    • 'on' — Parallel Computing Toolbox™ ライセンスとマルチコア マシンを使用している場合は、モデル アドバイザーが並列モードで実行されます。それぞれの並列処理は、一度に 1 つのモデルのチェックを処理します。

    ExtensiveAnalysis

    モデル アドバイザーの広範な解析の設定が使用中かどうかを示します。

    'on' (既定) | 'off'

    • 'on' — モデル アドバイザーは、広範な解析をトリガーするチェックを含むすべてのチェックを実行します。

    • 'off' — モデル アドバイザーは、広範な解析をトリガーするチェックを実行しません。

    LogVerbosity

    エラー、警告、デバッグの詳細などのログ情報の詳細が提供されるかどうかを示します。

    'None' (既定) | 'Concise' | 'Verbose'

    • 'None' — 解析のログ情報なし

    • 'Concise' — エラーと警告を含む中程度の情報量

    • 'Verbose' — エラー、警告、デバッグの詳細を含む完全な情報

    LogFileログ情報が含まれているログ テキスト ファイルの名前。
    ReportFormat

    生成されるモデル アドバイザー レポートの形式。

    'html' (既定) | 'pdf' | 'docx'

    • 'html' — モデル アドバイザー レポートは HTML 形式です。

    • 'pdf' — モデル アドバイザー レポートは PDF 形式です。

    • 'docx' — モデル アドバイザー レポートは DOCX 形式です。

    ReportPath生成されたモデル アドバイザー レポートのフォルダーのパス。
    ReportNameモデル アドバイザー レポートの名前。

  • AnalysisTimeStamp — いつ解析が完了したかを示す DD-MMM-YYYY HH:MM:SS 形式の時刻の詳細。

オブジェクト関数

getCheckResultsAccess specific Model Advisor check results

すべて折りたたむ

この例では、sldemo_mdlref_basic から参照されているモデル sldemo_mdlref_counter のチェックを実行する方法を説明します。

コマンド ウィンドウで、モデル sldemo_mdlref_basic および参照モデル sldemo_mdlref_counter を開きます。

openExample('sldemo_mdlref_basic'); 
openExample('sldemo_mdlref_counter');

モデルのコピーを作業フォルダーに保存して、それらの名前を mdlref_basicmdlref_counter に変更します。

save_system('sldemo_mdlref_basic','mdlref_basic');
save_system('sldemo_mdlref_counter','mdlref_counter');

mdlref_basic で、モデル参照を sldemo_mdlref_counter から mdlref_counter に変更します。mdlref_basic を保存します。

set_param('mdlref_basic/CounterA','ModelName','mdlref_counter');
set_param('mdlref_basic/CounterB','ModelName','mdlref_counter');
set_param('mdlref_basic/CounterC','ModelName','mdlref_counter');
save_system('mdlref_basic');

ルート モデルを mdlref_basic に設定します。

RootModel='mdlref_basic';

Application オブジェクトを作成します。

app = Advisor.Manager.createApplication();

ルートの解析を設定します。

setAnalysisRoot(app,'Root',RootModel);

チェック インスタンスをモデル アドバイザー解析からクリアします。

deselectCheckInstances(app);

チェック インスタンス ID を使用して、チェック [接続されていないライン、入力端子、出力端子を特定] を選択します。

instanceID = getCheckInstanceIDs(app,'mathworks.design.UnconnectedLinesPorts');
checkinstanceID = instanceID(1);
selectCheckInstances(app,'IDs',checkinstanceID);

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

run(app);

解析結果を取得し、ModelAdvisor.SystemResult オブジェクトと ModelAdvisor.CheckResult オブジェクトのプロパティを表示します。

Results=getResults(app);

モデル アドバイザー レポートを生成して、表示します。モデル アドバイザーは、mdlref_basicmdlref_counter の両方のチェックを実行します。

report = generateReport(app);
web(report)

モデルを閉じます。

close_system('mdlref_basic');
close_system('mdlref_counter');

バージョン履歴

R2015b で導入

すべて展開する