sldiagnostics

R2026b

Simulink システムの診断情報を表示する

ページ内をすべて折りたたむ

構文

sldiagnostics(modelName)

sldiagnostics(modelName,option1,...,optionN)

[txtRpt,sRpt] = sldiagnostics(___)

説明

sldiagnostics(modelName) はコマンドウィンドウで、次の統計情報を含む Simulink^® モデルまたはサブシステムの診断情報を返します。

ブロックカウント — 固有のブロックの名前と数
Stateflow^® カウント — 固有の Stateflow オブジェクトの名前と数
モデルサイズ — 状態、出力、入力、直達のフラグ、およびサンプル時間の数
ライブラリ使用率統計 — すべてのライブラリブロックと参照ライブラリの名前と数
コンパイル統計 — 各フェーズのコンパイルで使用された時間とメモリ

例

sldiagnostics(modelName,option1,...,optionN) は、option1,...,optionN でリストされた診断について、コマンドウィンドウで Simulink モデルまたはサブシステムの診断情報を返します。たとえば、オプション CountBlocks を使用すると、モデルまたはサブシステム内の固有のブロックの名前と数がリストされます。

例

[txtRpt,sRpt] = sldiagnostics(___) は、前述の構文のいずれかを使用して、診断情報を txtRpt で書式設定されたテキストとして、sRpt で構造体配列として返します。

例

すべて折りたたむ

診断情報のレポート

Simulink モデルまたはサブシステムの診断情報を生成してコマンドウィンドウに表示します。

BangBangControlUsingTemporalLogicExample の例を開いて、ルートモデル sf_boiler の診断情報を生成します。

openExample('stateflow/BangBangControlUsingTemporalLogicExample');
sldiagnostics('sf_boiler')

モデルを開かず、読み込みもしなかった場合、sldiagnostics はモデルを読み込んで、診断情報を生成します。

特定の診断情報のレポート

Simulink モデルまたはサブシステムの特定の診断情報を生成してコマンドウィンドウに表示します。

BangBangControlUsingTemporalLogicExample の例を開いて、sf_boiler/Bang-Bang Controller サブシステム内のブロックおよび Stateflow オブジェクトの数に関連した診断情報を生成します。

openExample('stateflow/BangBangControlUsingTemporalLogicExample');
sldiagnostics('sf_boiler/Bang-Bang Controller','CountBlocks','countSF')

モデルを開かず、読み込みもしなかった場合、sldiagnostics はモデルを読み込んで、診断情報を生成します。

診断情報のレポートと結果の保存

モデルの診断情報を生成し、結果を書式設定されたテキストおよび構造体配列として保存します。

BangBangControlUsingTemporalLogicExample の例を開いて、ルートモデル sf_boiler の診断情報を生成します。myReport および strucRpt にこれらのレポートを保存します。

openExample('stateflow/BangBangControlUsingTemporalLogicExample');
[myReport,strucRpt] = sldiagnostics('sf_boiler');

モデルを開かず、読み込みもしなかった場合、sldiagnostics はモデルを読み込んで、診断情報を生成します。

コンパイル時間とメモリの統計のレポート

モデルでコンパイルに使用した時間とメモリを生成し、この情報を使用してモデルの性能を評価します。

コンパイル時間とメモリ使用量のデータ収集

BangBangControlUsingTemporalLogicExample の例を開いて、ルートモデル sf_boiler のコンパイル時の診断情報を生成します。結果を txtRpt および strucRpt に保存します。

openExample('stateflow/BangBangControlUsingTemporalLogicExample');
[txtRpt,strucRpt] = sldiagnostics(sf_boiler,'CompileStats');

txtRpt は sf_boiler の各フェーズのコンパイル時間と説明を書式設定されたテキストとして保存します。strucRpt は、sf_boiler の各フェーズにおけるコンパイル時間とメモリ使用量を構造体として保存します。

strucRpt

strucRpt = 

  struct with fields:

         Model: 'sf_boiler'
    Statistics: [1×197 struct]

strucRpt.Statistics 配列のサイズは、コンパイル中に実行されたコンパイルおよびビルドフェーズの数を示します。フェーズ 6 におけるコンパイル時間とメモリ使用量に関する統計を確認します。

strucRpt.Statistics(6)

ans = 

  struct with fields:

            Description: 'Stateflow compile pre-start notification'
                CPUTime: 0
          WallClockTime: 0.2222
        ProcessMemUsage: 0.7852
    ProcessMemUsagePeak: 0
          ProcessVMSize: 1.0781

レポート情報は以下のとおりです。

CPUTime — CPU が Simulink フェーズをアクティブに処理するのにかかった時間 (秒単位)。
WallClockTime — Simulink プロセスの 1 つのフェーズが完了するまでのリアルタイム経過時間 (秒単位)。WallClockTime は、CPUTime、入出力時間、およびプログラミング遅延の合計です。
ProcessMemUsage — Simulink 演算フェーズの実行に使用されたワーキングセットサイズ (メガバイト単位)。プロセスのワーキングセットサイズは、そのプロセスコンテキストに物理的にマッピングされたメモリ容量です。
ProcessMemUsagePeak — Simulink 演算フェーズの実行に使用されたピークワーキングセットサイズ (メガバイト単位)。
ProcessVMSize — 演算フェーズの開始時に MATLAB^® プロセスにコミットされたバーチャルメモリまたはアドレス空間の量。

モデルの性能解析

次の主要なメトリクスを使用して、sf_boiler の性能を解析します。

合計経過時間 — sf_boiler の各フェーズの経過実時間の合計。
合計メモリ — sf_boiler の各フェーズで使用されたメモリの合計。
ピークメモリ — sf_boiler のすべてのフェーズのうちの 1 つのフェーズで使用された最大メモリ。

ElapsedTime = sum([strucRpt.Statistics(:).WallClockTime])

ElapsedTime =

   17.5542

TotalMemory = sum([strucRpt.Statistics(:).ProcessMemUsage])

TotalMemory =

   98.1602

PeakMemory = max([strucRpt.Statistics(:).ProcessMemUsagePeak])

PeakMemory =

   75.1016

考慮事項

CompileStats 診断オプションは、モデルを初めて読み込むときに使用する必要があります。そうしないと、sldiagnostics は以前にコンパイルされたモデルのオブジェクトを再利用してしまうため、モデルの時間とメモリ使用量のレポート値が小さくなります。
メモリ使用量統計情報は Microsoft^® Windows^® プラットフォームでのみ確認できます。

入力引数

すべて折りたたむ

`modelName` — Simulink モデルの名前またはサブシステムのパス
文字ベクトル | string

診断情報を生成する Simulink モデルの名前またはサブシステムのパス。文字ベクトルまたは string として指定します。

例: 'sf_boiler', 'sf_boiler/Bang-Bang Controller'

データ型: char | string

`option1,...,optionN` — 診断オプション
文字ベクトル | string

特定の診断情報セットを表す診断オプション。文字ベクトルまたは string として指定します。一部の診断オプションはルートモデルでのみ機能します。次の表は、診断オプション、互換性のある入力システムタイプ、および予期される出力のリストです。

診断オプション	入力システムタイプ	出力
`'CountBlocks'`	ルートモデル、ライブラリ、またはサブシステム	システムで使用されている固有のブロックの名前と数。これは、マスクサブシステムで入れ子にされているブロックや非表示のブロックを含みます。
`'CountBlocksInRefs'`	ルートモデル、ライブラリ、またはサブシステム	システムおよびその参照で使用されている固有のブロックの名前と数。
`'CountSF'`	ルートモデル、ライブラリ、またはサブシステム	システムで使用されている固有の Stateflow オブジェクトの名前と数。
`'Sizes'`	ルートモデル	モデルで使用されている状態、出力、入力、直達のフラグ、およびサンプル時間の数。
`'Libs'`	ルートモデル、ライブラリ、またはサブシステム	システムで参照されているすべてのライブラリブロックおよび固有のライブラリの名前と数。
`'CompileStats'`	ルートモデル	モデルの各フェーズのコンパイルで使用された時間とメモリ。この情報は、モデルのコンパイル速度とメモリの問題のトラブルシューティングに役立ちます。
`'RTWBuildStats'`	ルートモデル	`CompileStats` オプションを使用している場合に返される Simulink Coder™ のビルド統計およびすべての統計。このオプションは、既定の解析に含まれていないため、明示的に指定しなければなりません。
`'All'`	ルートモデル	すべての診断 (`RTWBuildStats` で提供されるものも含む)。

sldiagnostics は以下の場合に警告を出します。

診断オプションおよび入力システムタイプに互換性がない。
入力システムタイプが Simulink ライブラリである。該当するシステムでは、[ブロック線図の更新] などのモデルのコンパイルを必要とするオプションでは、sldiagnostics は診断を生成できません。

例: 'CountBlocks'

データ型: char | string

出力引数

すべて折りたたむ

`txtRpt` — 診断レポート
文字ベクトル

Simulink システムの診断情報を書式設定されたテキストとして保存する診断レポート。文字ベクトルとして返されます。

`sRpt` — 診断レポート
構造体配列

Simulink システムの診断情報を保存する診断レポート。構造体配列として返されます。この構造体配列には、診断オプションに対応する次のフィールドがあります。

blocks
stateflow
sizes
links
compilestats
rtwbuildstats

データ型: struct

バージョン履歴

R2006a で導入

すべて展開する

R2026a: `CountBlocksInRefs` 引数を使用した、システムおよび参照内のブロックのカウント

CountBlocksInRefs 引数を使用して、システムおよびその参照内で使用されているすべてのブロックをカウントできるようになりました。

sldiagnostics

構文

説明

例

診断情報のレポート

特定の診断情報のレポート

診断情報のレポートと結果の保存

コンパイル時間とメモリの統計のレポート

入力引数

modelName — Simulink モデルの名前またはサブシステムのパス 文字ベクトル | string

option1,...,optionN — 診断オプション 文字ベクトル | string

出力引数

txtRpt — 診断レポート 文字ベクトル

sRpt — 診断レポート 構造体配列

バージョン履歴

R2026a: CountBlocksInRefs 引数を使用した、システムおよび参照内のブロックのカウント

`modelName` — Simulink モデルの名前またはサブシステムのパス
文字ベクトル | string

`option1,...,optionN` — 診断オプション
文字ベクトル | string

`txtRpt` — 診断レポート
文字ベクトル

`sRpt` — 診断レポート
構造体配列

R2026a: `CountBlocksInRefs` 引数を使用した、システムおよび参照内のブロックのカウント