slreportgen.finder.SystemDiagramFinder クラス

名前空間: slreportgen.finder
スーパークラス: slreportgen.finder.DiagramFinder

ブロック線図ファインダーを作成する

説明

Simulink^® ブロック線図ファインダーを作成します。

slreportgen.finder.SystemDiagramFinder クラスは handle クラスです。

作成

説明

finder = SystemDiagramFinder(container) は、指定されたコンテナー (Simulink モデルやサブシステムなど) 内のコメントのない Simulink ブロック線図をすべて既定で検索するファインダーを作成します。特定タイプのモデルまたはサブシステムに検索を制約するには、ファインダーのプロパティを使用します。

メモ

このファインダーは、検索モードまたは反復子モードのいずれかで動作可能です。検索モードでは、その find メソッドを使用して、検索結果を結果の配列として返します。反復子モードでは、その hasNext メソッドと next メソッドを使用して、検索結果を 1 つずつ返します。多数のモデル参照をもつモデルを検索する場合は、反復子モードを使用します。反復子モードではモデルのコンパイルと検索の後にモデルを閉じますが、検索モードでは検索したすべてのモデルを開いたままにします。開いたモデルが多数あると、すべてのシステム メモリが消費され、レポート生成が遅くなる可能性があります。反復子モードは検索モードより遅いため、他のモデルをほとんど、またはまったく参照しないモデルを検索するには検索モードを使用します。

finder = SystemDiagramFinder(Name=Value) は、名前と値の引数を使用してプロパティを設定します。複数の名前と値の引数を任意の順序で指定できます。

入力引数

Container — 検索するブロック線図コンテナー

パス | ハンドル | チャート ID | チャート オブジェクト

Container プロパティを参照してください。

プロパティ

Container — 検索するブロック線図コンテナー

パス | ハンドル | チャート ID | チャート オブジェクト

検索の対象となるシステム コンテナー。次のいずれかの値として指定します。

• Simulink モデルまたはサブシステムのハンドル

• Simulink モデルまたはサブシステムへのパス

SearchDepth — システム ブロック線図の検索の深さ

Inf (既定値) | 正の整数

システム ブロック線図の検索の深さ。Inf または正の整数として指定します。SearchDepth は、ブロック線図コンテナーをブロック線図について検索するレベルの深さを指定します。すべてのレベルを検索するには、Inf を使用します。

属性:

GetAccess	public
SetAccess	public

データ型: double

IncludeMaskedSubsystems — マスク サブシステムの検索

true (既定値) | false

マスク サブシステムを検索するかどうかの選択。logical 1 (true) または 0 (false) として指定します。このプロパティが true の場合、ファインダーはブロック線図コンテナー内のマスク Subsystem ブロックを検索します。指定された SearchDepth まで検索し、見つかったブロック線図を検索結果に含めます。

属性:

GetAccess	public
SetAccess	public

データ型: logical

IncludeReferencedModels — モデル参照の検索

true (既定値) | false

参照モデルを検索するかどうかの選択。logical 1 (true) または 0 (false) として指定します。このプロパティが true の場合、ファインダーはブロック線図コンテナー内で参照されるモデルを検索します。指定された SearchDepth まで検索し、見つかったブロック線図を検索結果に含めます。

属性:

GetAccess	public
SetAccess	public

データ型: logical

IncludeSimulinkLibraryLinks — Simulink ライブラリ リンクの検索

true (既定値) | false

Simulink ライブラリ リンクを検索するかどうかの選択。logical 1 (true) または 0 (false) として指定します。このプロパティと IncludeMaskedSubsystems がいずれも true の場合、ファインダーはブロック線図コンテナー内にある、Simulink ライブラリの Subsystem ブロックとマスク Subsystem ブロックの両方へのリンクを検索します。指定された SearchDepth まで検索し、見つかったブロック線図を検索結果に含めます。このプロパティが true で IncludeMaskedSubsystems が false の場合、ファインダーは Simulink ライブラリの Subsystem ブロックへのリンクのみを検索します。

属性:

GetAccess	public
SetAccess	public

データ型: logical

IncludeUserLibraryLinks — ユーザー ライブラリ リンクの検索

true (既定値) | false

ユーザー ライブラリ リンクを検索するかどうかの選択。logical 1 (true) または 0 (false) として指定します。このプロパティが true で IncludeMaskedSubsystems プロパティが true の場合、ファインダーはブロック線図コンテナー内にある、ユーザー ライブラリの Subsystem ブロックとマスク Subsystem ブロックへのリンクを検索します。指定された SearchDepth まで検索し、見つかったブロック線図を検索結果に含めます。このプロパティが true で IncludeMaskedSubsystems プロパティが false の場合、ファインダーはユーザー ライブラリの Subsystem ブロックへのリンクのみを検索します。

属性:

GetAccess	public
SetAccess	public

データ型: logical

IncludeRoot — ルート ブロック線図を含める

true (既定値) | false

ルート ブロック線図を検索結果に含めるかどうかの選択。logical として指定します。true かつ最上位ブロック線図のコンテナーがモデルである場合、モデルのブロック線図が検索結果に含められます。それ以外の場合、検索結果ではモデルのブロック線図が省略されます。

属性:

GetAccess	public
SetAccess	public

データ型: logical

IncludeCommented — コメントアウトされたブロック線図を含める

false (既定値) | true

コメントアウトされたブロック線図を検索結果に含めるかどうかの選択。logical として指定します。false の場合、コメントアウトされたブロック線図は検索結果から除外されます。

属性:

GetAccess	public
SetAccess	public

データ型: logical

IncludeVariants — ブロック線図のバリアントを含める

"Active" (既定値) | "All" | "ActivePlusCode" | ...

ブロック線図を検索するためのバリアント。string または文字ベクトルとして指定します。既定値は Active です。有効な値は次のとおりです。

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

属性:

GetAccess	public
SetAccess	public

データ型: char | string

SortType — ファインダーの結果の並べ替えメソッド

"none" (既定値) | "alphabetical" | "numBlocks" | "depth"

ファインダーの結果の並べ替えメソッド。次のいずれかの値として指定します。

値	説明
"none"	結果を並べ替えません。
"alphabetical"	結果を名前のアルファベット順に並べ替えます。
"numBlocks"	結果をシステム内のブロック数順に並べ替えます。並べ替えられたリストの最初のブロックには、最大数のブロックが含まれます。
"depth"	結果をモデルの階層構造の深さ順に並べ替えます。並べ替えられたリストの最初のシステムは、階層内で最上位のシステムです。たとえば、モデルとそのサブシステムは、 myModel、myModel/subsystem1、myModel/subsystem1/nestedSubststem の順に並べ替えられます。

属性:

GetAccess	public
SetAccess	public

データ型: char | string

Properties — 検索対象とするオブジェクトのプロパティ

cell 配列

検索対象とするオブジェクトのプロパティ。名前と値の引数の cell 配列として指定します。ファインダーは、指定のプロパティが指定の値をもつオブジェクトのみを返します。

例: finder.Properties = {'Gain','5'}

属性:

GetAccess	public
SetAccess	public

データ型: cell

AutoCloseModel — モデルを閉じるかどうか

true (既定値) | false

モデルを閉じるかどうか。true または false として指定します。true の場合、ファインダーの next メソッドは、検索対象の次のモデルに移動する前に現在開いているモデルを閉じます。モデルを閉じることで、多数のモデルを参照するモデルを検索する際にメモリが過剰に消費されるのを防止します。

メモ

ファインダーの find メソッドはこのプロパティを無視し、すべての参照モデルを開いたままにします。このため、多数のモデル参照があるモデルの検索では find メソッドを使用すべきではありません。

データ型: logical

メソッド

パブリック メソッド

find	results = find(finder) は、ファインダーによって指定された container 内でブロック線図を検索します。finder は slreportgen.finder.SystemDiagramFinder オブジェクトです。results は、このメソッドで検出されたブロック線図がそれぞれに含まれる slreportgen.finder.DiagramResult オブジェクトの配列です。この配列をレポートまたはレポーターに追加すると、含まれるすべてのブロック線図のイメージが追加されます。このメソッドの results を追加できるレポートは、slreportgen.report.Report タイプのレポートか、または slreportgen.report.Chapter レポーターのような別のレポーター オブジェクトです。
hasNext	tf = hasNext(finder) は、ファインダーが検索するコンテナーに少なくとも 1 つのブロック線図が含まれているかどうかを判定します。コンテナーに少なくとも 1 つのブロック線図がある場合、hasNext メソッドはそのブロック線図を、next メソッドが返す次のブロック線図としてキューに入れます。その後、hasNext メソッドは true を返します。next メソッドを使用してこのブロック線図を取得します。後続の呼び出しで、hasNext メソッドは、next によってまだ取得されていないブロック線図がコンテナーにあるかどうかを判定します。next メソッドの取得するブロック線図をキューに入れ、true を返します。取得するブロック線図がなくなったら、このメソッドは false を返します。コンテナーでブロック線図を順次検索するには、while ループ内で hasNext メソッドを next メソッドと共に使用します。 メモ 現在の結果が、現在のモデルに対する検索キューの最後の結果であり、AutoCloseModel プロパティが true である場合、このメソッドは次のモデルを開く前に現在のモデルを閉じます。これによって検索時間は長くなりますが、多数の他のモデルを参照する最上位モデルを検索する際には、メモリ消費が削減されます。モデルで多数の他のモデルを参照しない場合は、検索の速度を上げるために AutoCloseModel プロパティを false に設定するか、find メソッドを使用します。
next	result = next(finder) は、hasNext メソッドで作成された結果キュー内にある、次の検索の result を返します。検索結果には、結果のブロック線図が含まれます。この result オブジェクトをレポートまたはレポーターに追加すると、そのブロック線図用にブロック線図レポーターが追加されます。

例

ブロック線図の検索

sf_car モデル内でブロック線図を検索するレポートを作成します。

import mlreportgen.report.*
import slreportgen.report.*
import slreportgen.finder.*
model_name = "sf_car";
load_system(model_name);

rpt = slreportgen.report.Report("output","pdf");
add(rpt, TitlePage(Title=model_name+" Systems"));
add(rpt,TableOfContents);
finder = SystemDiagramFinder(model_name); 
results = find(finder);
for result = results
     chapter = Chapter(Title=result.Name);
     add(chapter,result);
     add(rpt,chapter);
end

close(rpt);
close_system(model_name);
rptview(rpt);

バージョン履歴

R2017b で導入

参考

slreportgen.report.Report | slreportgen.finder.DiagramFinder | slreportgen.finder.DiagramElementFinder | slreportgen.report.SimulinkObjectProperties | slreportgen.report.Diagram | slreportgen.finder.DiagramResult

トピック

• Simulink および Stateflow 要素用の Report Generator の作成
• レポーターとは