slreportgen.report.SystemIO class

Package: slreportgen.report
Superclasses: slreportgen.report.Reporter

Simulink system input and output signal reporter

Description

Create a reporter that reports on signals entering or leaving a Simulink^® model or subsystem.

Note

To use a SystemIO reporter in a report, you must create the report using the slreportgen.report.Report class.

The slreportgen.report.SystemIO class is a handle class.

Class Attributes

HandleCompatible

true

For information on class attributes, see Class Attributes.

Creation

Description

slreportgen.report.SystemIO() creates an empty slreportgen.report.SystemIO reporter object. Use the Object property to specify the model or subsystem to be reported. By default, the reporter generates summary tables for the system inputs and outputs. The input summary table lists the sources of the input signals. The output summary table lists the destinations of the output signals. The reporter also generates a signal details section that lists the properties of the input and output ports. Use the reporter properties to customize the content and appearance of the generated report. For example, use the DetailsReporter property to customize the content and appearance of the signal details section.

slreportgen.report.SystemIO(object) creates a reporter for the model or subsystem specified by object. See the Object property.

slreportgen.report.SystemIO(Name,Value) sets the reporter properties using name-value pairs. You can specify multiple name-value pair arguments in any order. Enclose each property name in single or double quotes.

Properties

Object — Model or subsystem to be reported

string scalar | character vector | handle | slreportgen.finder.DiagramResult object | slreportgen.finder.BlockResult object

Simulink model or subsystem to be reported, specified as a string scalar or character vector that contains the path to the model or subsystem, as a handle to the model or subsystem, as an slreportgen.finder.DiagramResult object, or as an slreportgen.finder.BlockResult object.

InputSummaryProperties — List of properties to report for each input

string array | cell array of character vectors

List of properties to report for each input, specified as a string array or a cell array of character vectors. You can include these properties in the list:

• "Source"

• "Name"

• "Description"

• "DataType"

• "Complexity"

• "Dimensions"

• "Min"

• "Max"

• "SampleTime"

• "Units"

You also can specify these properties of the Inport block that corresponds to the input signal in the system:

• "Inport Block Name"

• "Inport Block Description"

By default, the list includes Source, Name, and DataType.

OutputSummaryProperties — List of properties to report for each output

string array | cell array of character vectors

List of properties to report for each output, specified as a string array or a cell array of character vectors. You can include these properties in the list:

• "Destination"

• "Name"

• "Description"

• "DataType"

• "Complexity"

• "Dimensions"

• "Min"

• "Max"

• "SampleTime"

• "Units"

You also can specify these properties of the Outport block that corresponds to the output signal in the system:

• "Outport Block Name"

• "Outport Block Description"

By default, the list includes Destination, Name, and DataType.

ShowInputSummary — Whether to show input summary table

true (default) | false

Whether to show a table that summarizes the inputs to the subsystem or model, specified as true or false.

ShowOutputSummary — Whether to show output summary table

true (default) | false

Whether to show a table that summarizes the outputs from the subsystem or model, specified as true or false.

ShowDetails — Whether to show details for each input and output

true (default) | false

Whether to show details for each input or output, specified as true or false. If ShowDetails is true, the reporter inserts slreportgen.report.SimulinkObjectProperties reporters after the input and output summary tables. If Object is a model, details about the input or output blocks are included. If Object is a subsystem, details about the input or output ports are included. The port numbers in the summary tables link to the corresponding SimulinkObjectProperties reporter for that port.

ShowEmptyColumns — Whether to show empty columns in summary tables

false (default) | true

Whether to show empty columns in summary tables, specified as true or false. If ShowEmptyColumns is true, the summary tables include columns that do not have data.

InputSummaryReporter — Table formatter for input summary tables

mlreportgen.report.BaseTable object

Table formatter for input summary tables, specified as an mlreportgen.report.BaseTable reporter. The default value is a BaseTable reporter. To customize the appearance of the table, modify the properties of the default table reporter or replace it with a customized table reporter. If you add content to the Title property of the default or customized table reporter, the content appears in front of the table title in the generated report.

OutputSummaryReporter — Table formatter for output summary tables

mlreportgen.report.BaseTable object

Table formatter for output summary tables, specified as an mlreportgen.report.BaseTable reporter. The default value is a BaseTable reporter. To customize the appearance of the table, modify the properties of the default table reporter or replace it with a customized table reporter. If you add content to the Title property of the default or customized table reporter, the content appears in front of the table title in the generated report.

DetailsReporter — Formatter for detail tables

slreportgen.report.SimulinkObjectProperties object

Formatter for detail tables, specified as an slreportgen.report.SimulinkObjectProperties reporter. The default value is an SimulinkObjectProperties reporter. To customize the appearance of the detail tables, modify the properties of the default SimulinkObjectProperties reporter or replace it with a customized SimulinkObjectProperties reporter.

ListFormatter — List formatter for source and destination lists

mlreportgen.dom.UnorderedList object | mlreportgen.dom.OrderedList object

List formatter for the source and destination lists, specified as an mlreportgen.dom.UnorderedList or mlreportgen.dom.OrderedList object. The source list is the list of blocks to which an input signal is connected. The destination list is the list of blocks to which an output signal is connected. The default formatter is an UnorderedList object. To customize the appearance of the list, modify the properties of the default list formatter or replace it with a customized list object that does not contain any children.

TemplateSrc — Source of template for this reporter

[] (default) | character vector | string scalar | reporter or report | DOM document or document part

Source of the template for this reporter, specified in one of these ways:

• Character vector or string scalar that specifies the path of the file that contains the template for this reporter

• Reporter or report whose template is used for this reporter or whose template library contains the template for this reporter

• DOM document or document part whose template is used for this reporter or whose template library contains the template for this reporter

The specified template must be the same type as the report to which this reporter is appended. For example, for a Microsoft^® Word report, TemplateSrc must be a Word reporter template. If the TemplateSrc property is empty, this reporter uses the default reporter template for the output type of the report.

TemplateName — Name of template for this reporter

character vector | string scalar

Name of the template for this reporter, specified as a character vector or string scalar. The template for this reporter must be in the template library of the template source (TemplateSrc) for this reporter.

LinkTarget — Hyperlink target for this reporter

[] (default) | character vector | string scalar | mlreportgen.dom.LinkTarget object

Hyperlink target for this reporter, specified as a character vector or string scalar that specifies the link target ID, or an mlreportgen.dom.LinkTarget object. A character vector or string scalar value is converted to a LinkTarget object. The link target immediately precedes the content of this reporter in the output report.

Methods

Public Methods

slreportgen.report.SystemIO.createTemplate	Copy the default slreportgen.report.SystemIO reporter template
slreportgen.report.SystemIO.customizeReporter	Create subclass of slreportgen.report.SystemIO class
slreportgen.report.SystemIO.getClassFolder	Get location of folder that contains the slreportgen.report.SystemIO class definition file
copy	Create copy of a Simulink reporter object and make deep copies of certain property values
getImpl	Get implementation of reporter

Examples

Report on Inputs and Outputs of a Model

This example uses an slreportgen.report.SystemIO reporter to report on the inputs and outputs of a model and its subsystems.

model_name = "f14";
load_system(model_name);
% Create a Simulink report
rpt = slreportgen.report.Report("SystemIO_example","docx");

% Create finder to find all diagrams in model
finder = slreportgen.finder.DiagramFinder(model_name);

% Report inputs and outputs of each diagram
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);
      % Create SystemIO reporter and add to report
      ioRptr = slreportgen.report.SystemIO(result);        
      add(sect,ioRptr);

      add(ch,sect);
  end
end

% Add chapter to report and close report
add(rpt,ch);
close(rpt);
rptview(rpt);

Tips

• The input and output signal properties reported by the SystemIO reporter correspond to Simulink properties, which you can query by using get_param. For example, the DataType and Dimensions properties correspond to the Simulink CompiledPortDataType and CompiledPortDimensions properties of the port handles.

• For bus signals, Simulink determines the values of the CompiledPortDataType and CompiledPortDimensions properties based on whether the signal is a nonvirtual or virtual bus.