slreportgen.report.SystemIO クラス

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

Simulink システム入出力信号レポーター

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

説明

Simulink® モデルまたはサブシステムの入出力信号についてレポートするレポーターを作成します。

メモ

レポートで SystemIO レポーターを使用するには、slreportgen.report.Report クラスを使用してレポートを作成する必要があります。

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

クラス属性

HandleCompatible
true

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

作成

説明

slreportgen.report.SystemIO は、空の slreportgen.report.SystemIO レポーター オブジェクトを作成します。Object プロパティを使用して、レポートするモデルまたはサブシステムを指定します。既定では、レポーターはシステムの入出力についての概要テーブルを生成します。入力の概要テーブルには、入力信号の接続元がリストされます。出力の概要テーブルには、出力信号の接続先がリストされます。レポーターは、入出力端子のプロパティをリストする信号の詳細の節も生成します。生成されるレポートの内容や外観をカスタマイズするには、レポーターのプロパティを使用します。たとえば、信号の詳細に関する節の内容や外観をカスタマイズするには DetailsReporter プロパティを使用します。

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

例

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

プロパティ

すべて展開する

レポート対象の Simulink モデルまたはサブシステム。モデルまたはサブシステムのパスを含む文字ベクトルまたは string スカラーとして指定するか、モデルまたはサブシステムのハンドルとして指定するか、slreportgen.finder.DiagramResult オブジェクトまたは slreportgen.finder.BlockResult オブジェクトとして指定します。

属性:

GetAccess
public
SetAccess
public

各入力についてレポートするプロパティのリスト。string 配列、または文字ベクトルの cell 配列として指定します。既定では、Port、Inport Block、Source、Name、および DataType がリストに含まれます。Inport Block についてレポートされる値は、システムの入力信号に対応する Inport ブロックの名前です。有効な信号プロパティは次のとおりです。

  • "Port"

  • "Source"

  • "Name"

  • "Description"

  • "DataType"

  • "Complexity"

  • "Dimensions"

  • "Min"

  • "Max"

  • "SampleTime"

  • "Units"

さらに、対応する Inport ブロックの次のブロック プロパティも指定できます。

  • "Inport Block"

  • "Inport Block Description"

属性:

GetAccess
public
SetAccess
public

データ型: char | string

各出力についてレポートするプロパティのリスト。string 配列、または文字ベクトルの cell 配列として指定します。既定では、Port、Outport Block、Destination、Name、および DataType がリストに含まれます。Outport Block についてレポートされる値は、システムの出力信号に対応する Outport ブロックの名前です。有効な信号プロパティは次のとおりです。

  • "Port"

  • "Destination"

  • "Name"

  • "Description"

  • "DataType"

  • "Complexity"

  • "Dimensions"

  • "Min"

  • "Max"

  • "SampleTime"

  • "Units"

さらに、対応する Outport block の次のブロック プロパティも指定できます。

  • "Outport Block"

  • "Outport Block Description"

属性:

GetAccess
public
SetAccess
public

データ型: char | string

サブシステムまたはモデルへの入力をまとめたテーブルを表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定に関する詳細は次の通りです。

  • 1 (true) — レポートに入力の概要テーブルを含めます。

  • 0 (false) — レポートで入力の概要テーブルを省略します。

テーブルに含まれる入力についてのプロパティは InputSummaryProperties プロパティで決まります。

属性:

GetAccess
public
SetAccess
public

データ型: logical

サブシステムまたはモデルからの出力をまとめたテーブルを表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定に関する詳細は次の通りです。

  • 1 (true) — レポートに出力の概要テーブルを含めます。

  • 0 (false) — レポートで入力の概要テーブルを省略します。

テーブルに含まれる出力についてのプロパティは OutputSummaryProperties プロパティで決まります。

属性:

GetAccess
public
SetAccess
public

データ型: logical

各入出力の詳細を表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定に関する詳細は次の通りです。

  • 1 (true) — レポーターは slreportgen.report.SimulinkObjectProperties レポーターを入出力の概要テーブルの後に挿入します。Object がモデルの場合は、入出力ブロックに関する詳細が含まれます。Object がサブシステムの場合は、入出力端子に関する詳細が含まれます。概要テーブルの端子番号は、その端子の対応する SimulinkObjectProperties レポーターにリンクしています。

  • 0 (false) — レポートで入出力ブロックに関する詳細を省略します。

属性:

GetAccess
public
SetAccess
public

データ型: logical

概要テーブルに空の列を含めるかどうか。logical の 1 (true) または 0 (false) として指定します。指定に関する詳細は次の通りです。

  • 1 (true) — 概要テーブルに空の列を含めます。

  • 0 (false) — 概要テーブルで空の列を省略します。

ShowEmptyColumns が true の場合、概要テーブルにデータがない列が含まれます。

属性:

GetAccess
public
SetAccess
public

データ型: logical

入力の概要テーブルのテーブル フォーマッタ。mlreportgen.report.BaseTable レポーターとして指定します。既定値は BaseTable レポーターです。テーブルの外観をカスタマイズするには、既定のテーブル レポーターのプロパティを変更するか、そのテーブル レポーターをカスタマイズしたテーブル レポーターに置き換えます。既定またはカスタマイズしたテーブル レポーターの Title プロパティに内容を追加すると、生成されたレポートでテーブルのタイトルの前にその内容が表示されます。

メモ

入力の概要テーブルのタイトルをカスタマイズするには、SystemIO レポーターのメイン テンプレートの docpart_templates フォルダーにある SystemIOHierNumberedTitle および SystemIONumberedTitle テンプレートをカスタマイズします。

属性:

GetAccess
public
SetAccess
public

出力の概要テーブルのテーブル フォーマッタ。mlreportgen.report.BaseTable レポーターとして指定します。既定値は BaseTable レポーターです。テーブルの外観をカスタマイズするには、既定のテーブル レポーターのプロパティを変更するか、そのテーブル レポーターをカスタマイズしたテーブル レポーターに置き換えます。既定またはカスタマイズしたテーブル レポーターの Title プロパティに内容を追加すると、生成されたレポートでテーブルのタイトルの前にその内容が表示されます。

メモ

出力の概要テーブルのタイトルをカスタマイズするには、SystemIO レポーターのメイン テンプレートの docpart_templates フォルダーにある SystemIOHierNumberedTitle および SystemIONumberedTitle テンプレートをカスタマイズします。

属性:

GetAccess
public
SetAccess
public

詳細テーブルのフォーマッタ。slreportgen.report.SimulinkObjectProperties レポーターとして指定します。既定値は SimulinkObjectProperties レポーターです。詳細テーブルの外観をカスタマイズするには、既定の SimulinkObjectProperties レポーターのプロパティを変更するか、そのレポーターをカスタマイズした SimulinkObjectProperties レポーターに置き換えます。

属性:

GetAccess
public
SetAccess
public

接続元リストと接続先リストのリスト フォーマッタ。mlreportgen.dom.UnorderedList オブジェクトまたは mlreportgen.dom.OrderedList オブジェクトとして指定します。接続元リストは、入力信号が接続されているブロックのリストです。接続先リストは、出力信号が接続されているブロックのリストです。既定のフォーマッタは UnorderedList オブジェクトです。リストの外観をカスタマイズするには、既定のリスト フォーマッタのプロパティを変更するか、そのリスト フォーマッタを子を含まないカスタマイズしたリスト オブジェクトに置き換えます。

属性:

GetAccess
public
SetAccess
public

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

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

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

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

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true
Dependent
true

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

属性:

GetAccess
public
SetAccess
public

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public

メソッド

すべて展開する

例

すべて折りたたむ

ライブ スクリプトを開く

この例では、slreportgen.report.SystemIO レポーターを使用して、モデルとそのサブシステムの入出力についてレポートします。

model_name = "f14";
load_system(model_name);

Simulink レポートを作成します。

rpt = slreportgen.report.Report("SystemIO_example","docx");

モデル内のすべてのブロック線図を検索するファインダーを作成します。

finder = slreportgen.finder.DiagramFinder(model_name);

各ブロック線図の入出力をレポートを作成します。SystemIO レポーターを作成し、レポートに追加します。

ch = mlreportgen.report.Chapter("Diagrams");
while hasNext(finder)
  result = next(finder);
  if strcmpi(result.Type,"Simulink.SubSystem") ...
          || strcmpi(result.Type,"Simulink.BlockDiagram")
      sect = mlreportgen.report.Section(result.Name);
      add(sect,result);
      ioRptr = slreportgen.report.SystemIO(result);        
      add(sect,ioRptr);
      add(ch,sect);
  end
end

レポートに章を追加し、レポートを閉じます。

add(rpt,ch);
close(rpt);
rptview(rpt);

ヒント

  • SystemIO レポーターでレポートされる入出力信号のプロパティは Simulink のプロパティに対応しており、get_param を使用してクエリできます。たとえば、DataType プロパティと Dimensions プロパティは、Simulink の端子ハンドルの CompiledPortDataType プロパティと CompiledPortDimensions プロパティに対応します。

  • Simulink では、バス信号については、信号が非バーチャル バスであるかバーチャル バスであるかに基づいて CompiledPortDataType プロパティと CompiledPortDimensions プロパティの値を決定します。

バージョン履歴

R2020a で導入

すべて展開する

参考

| | |

トピック