slreportgen.report.SystemHierarchy クラス

名前空間: slreportgen.report
スーパークラス: slreportgen.report.Reporter

システム階層レポーター

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

説明

Simulink® のモデルまたはサブシステムについて、サブシステムの入れ子形式のリストをレポートで生成するシステム階層レポーターを作成します。

メモ

レポートでシステム階層レポーターを使用するには、slreportgen.report.Report クラスまたはサブクラスを使用してレポートを作成する必要があります。

slreportgen.report.SystemHierarchy クラスは handle クラスです。

クラス属性

HandleCompatible
true

クラス属性の詳細については、クラスの属性を参照してください。

作成

説明

rptr = slreportgen.report.SystemHierarchy は、既定のテンプレートに基づいて空のシステム階層レポーターを作成します。レポーターのプロパティを使用して、生成されるリストの内容や形式をカスタマイズします。レポーターをレポートに追加する前に、レポーターの Source プロパティでモデルまたはサブシステムを指定する必要があります。空のレポーターをレポートに追加すると、エラーが発生します。

rptr = slreportgen.report.SystemHierarchy(source) は、source で指定されたモデルまたはサブシステムのシステム階層レポーターを作成します。Source プロパティを参照してください。

例

rptr = slreportgen.report.SystemHierarchy(Name=Value) は、名前と値の引数を使用してレポーター プロパティを設定します。複数の名前と値の引数を任意の順序で指定できます。

プロパティ

すべて展開する

Simulink モデルまたはサブシステム。モデルまたはサブシステムのパスを含む文字ベクトルまたは string スカラーとして指定するか、モデルまたはサブシステムのハンドルとして指定します。

属性:

NonCopyable
true

生成されるリストにソース サブシステムの先祖を含める最大レベル数。非負の整数スカラーとして指定します。たとえば、MaxAncestorLevel が 2 の場合、ソースと 2 レベルまでの先祖がリストに含まれます。MaxAncestorLevel が既定値の Inf の場合、すべての先祖がリストに含まれます。MaxAncestorLevel がゼロの場合、リストに先祖は含まれません。

データ型: double

生成されるリストにソース モデルまたはサブシステムの子孫を含める最大レベル数。非負の整数スカラーとして指定します。たとえば、MaxDescendantLevel が 2 の場合、ソースと 2 レベルまでの子孫がリストに含まれます。MaxDescendantLevel が既定値の Inf の場合、すべての子孫がリストに含まれます。MaxDescendantLevel がゼロの場合、リストに子孫は含まれません。

データ型: double

生成されるリストにソース サブシステムのピアを含めるかどうか。true または false として指定します。

データ型: logical

生成されるリストでソース モデルまたはサブシステムを強調するかどうか。true または false として指定します。EmphasizeSource が true の場合、ソース モデルまたはサブシステムの名前が TextFormatter プロパティに従った形式で示されます。それ以外の場合、リストの他の項目と同様の形式になります。

データ型: logical

生成されるリストの形式を設定するリスト フォーマッタ。mlreportgen.dom.UnorderedList オブジェクトまたは mlreportgen.dom.OrderedList オブジェクトとして指定します。このプロパティの既定値は、mlreportgen.dom.UnorderedList のオブジェクトです。リストの形式をカスタマイズするには、リスト オブジェクトのプロパティを変更するか、そのリスト オブジェクトをリスト項目を含まないカスタマイズしたリスト オブジェクトに置き換えます。

生成されるリストでのソース モデルまたはサブシステムの名前の形式を設定するテキスト フォーマッタ オブジェクト。mlreportgen.dom.Text オブジェクトとして指定します。このプロパティは、EmphasizeSource プロパティが true の場合のみ適用されます。SourceTextFormatter プロパティの初期値は、Bold プロパティと Italic プロパティが true に設定された mlreportgen.dom.Text オブジェクトです。生成されるリストでの名前の外観をカスタマイズするには、mlreportgen.dom.Text オブジェクトのプロパティを変更するか、そのオブジェクトをカスタマイズした mlreportgen.dom.Text オブジェクトに置き換えます。既定または置き換えるテキスト オブジェクトにテキストを追加すると、生成されたレポートでソースの名前の前にそのテキストが表示されます。

生成されるソース システムの子孫のリストにマスク サブシステムを含めるかどうか。true または false として指定します。IncludeMaskedSubsystems が true の場合、ソース サブシステムより下のレベル数が MaxDescendantLevel プロパティの値以下であれば、マスク サブシステムとその子孫のサブシステムがリストに含まれます。

システム階層レポーターでマスク サブシステムからレポート内の対応するブロック線図へのリンクを有効にするには、MaskedSystemLinkPolicy プロパティを 'system' に設定します。

データ型: logical

生成されるソース システムの子孫のリストに参照モデルを含めるかどうか。true または false として指定します。IncludeReferencedModels が true の場合、ソース サブシステムより下のレベル数が MaxDescendantLevel プロパティの値以下であれば、参照モデルとその子孫のサブシステムがリストに含まれます。

データ型: logical

生成されるソース システムの子孫のリストに参照サブシステムを含めるかどうか。true または false として指定します。IncludeReferencedSubsystems が true の場合、ソース サブシステムより下のレベル数が MaxDescendantLevel プロパティの値以下であれば、参照サブシステムとその子孫のサブシステムがリストに含まれます。

データ型: logical

生成されるソース システムの子孫のリストに Simulink ライブラリ サブシステムにリンクするサブシステムを含めるかどうか。true または false として指定します。次のすべての条件を満たす場合のみ、リンクされたサブシステムまたはその子孫のいずれかのサブシステムがリストに含まれます。

  • IncludeSimulinkLibraryLinks の値が true である。

  • サブシステムがマスクされていない、サブシステムがマスクされている場合は IncludeMaskedSubsystems プロパティの値が true である。

  • ソース サブシステムより下のレベル数が MaxDescendantLevel プロパティの値以下である。

データ型: logical

生成されるソース システムの子孫のリストにユーザー定義ライブラリ サブシステムにリンクするサブシステムを含めるかどうか。true または false として指定します。次のすべての条件を満たす場合のみ、リンクされたサブシステムまたはその子孫のいずれかのサブシステムがリストに含まれます。

  • IncludeUserLibraryLinks の値が true である。

  • サブシステムがマスクされていない、サブシステムがマスクされている場合は IncludeMaskedSubsystems プロパティの値が true である。

  • ソース サブシステムより下のレベル数が MaxDescendantLevel プロパティの値以下である。

データ型: logical

生成されるソース システムの子孫のリストに含めるバリアント ブロックのバリアント。次のいずれかの値として指定します。

値説明
"Active"アクティブなバリアント
"All"すべてのバリアント
"ActivePlusCode"アクティブなバリアントとコード バリアント

リストにバリアントが含まれるのは、ソース サブシステムより下のレベル数が MaxDescendantLevel プロパティの値以下である場合に限られます。

データ型: char | string

このレポーターのテンプレートのソース。以下のいずれかの方法で指定します。

  • このレポーターのテンプレートを含むファイルのパスを指定する、文字ベクトルまたは string スカラー

  • このレポーターが使用するテンプレートをもつか、このレポーター用のテンプレートを含むテンプレート ライブラリをもつ、レポーターまたはレポート

  • このレポーターが使用するテンプレートをもつか、このレポーター用のテンプレートを含むテンプレート ライブラリをもつ、ドキュメント オブジェクト モデル (DOM) のドキュメントまたはドキュメント パーツ

指定されるテンプレートは、このレポートが追加されるレポーターと同じタイプでなければなりません。たとえば、Microsoft® Word レポートの場合、TemplateSrc は Word レポーター テンプレートでなければなりません。TemplateSrc プロパティが空の場合、このレポーターはレポートの出力タイプで既定のレポーター テンプレートを使用します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

このレポーター テンプレートの名前。文字ベクトルまたは string スカラーとして指定します。このレポーター テンプレートは、このレポーターの TemplateSrc プロパティで指定されたテンプレートのテンプレート ライブラリになければなりません。

属性:

GetAccess
public
SetAccess
public

データ型: char | string

このレポーターのハイパーリンク ターゲット。リンク ターゲット ID を指定する文字ベクトルまたは string スカラー、あるいは mlreportgen.dom.LinkTarget オブジェクトとして指定します。文字ベクトルまたは string スカラーの値は LinkTarget オブジェクトに変換されます。リンク ターゲットは、出力レポートでこのレポーターのコンテンツの直前に配置されます。

属性:

GetAccess
public
SetAccess
public

メソッド

すべて展開する

例

すべて折りたたむ

この例では次を使用します。

ライブ スクリプトを開く

レポート生成プログラムに slreportgen.report.SystemHierarchy レポーターを追加して、sldemo_fuelsys モデルのシステム階層をレポートに含めます。slreportgen.finder.DiagramFinder オブジェクトを追加して、モデルのブロック線図を生成します。システム階層レポーターで、入れ子形式のリストのサブシステムから対応するブロック線図へのリンクを生成します。

API パッケージをインポートします。

import slreportgen.report.*
import mlreportgen.report.*
import mlreportgen.dom.*

モデルを読み込みます。

model = "sldemo_fuelsys";
load_system(model);

レポートを作成します。

rpt = slreportgen.report.Report("output","pdf");

章レポーターを作成します。

chapter = Chapter("System Hierarchy for the " + model + " Model");

モデルのシステム階層レポーターを作成します。

rptr = SystemHierarchy(model);

システム階層レポーターを章に追加します。その後、章をレポートに追加します。

add(chapter, rptr);
add(rpt, chapter);

サブシステムのブロック線図を検索します。

finder = slreportgen.finder.DiagramFinder(model);
while hasNext(finder)
    result = next(finder);
    ch = Chapter(result.Name);
    add(ch, result);
    add(rpt, ch);
end

出力レポートを閉じて表示します。

close(rpt);
close_system(model);
rptview(rpt);

生成されるレポートでは、システム階層に、sldemo_fuelsys モデルの下のサブシステムがリストされます。

System hierarchy listing the subsystems under the sldemo_fuelsys model. Subsystems include Dashboard, Engine Gas Dynamics, To Controller, To Plant, and fuel_rate_control.

サブシステムに対応するブロック線図を表示するには、リストでサブシステムをクリックします。

バージョン履歴

R2019b で導入

参考

トピック