slreportgen.report.SummaryTable Class

Namespace: slreportgen.report
Superclasses: slreportgen.report.Reporter

Summary table reporter for finder results

Since R2022a

Description

Use an object of slreportgen.report.SummaryTable class to summarize the search results obtained from a Simulink^® model by using a Finder object.

Note

To use a Simulink summary table reporter in your report, you must create the report by using the slreportgen.report.Report class.

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

Class Attributes

HandleCompatible

true

For information on class attributes, see Class Attributes.

Creation

Description

summaryTableRptr = slreportgen.report.SummaryTable creates a summary table for an unspecified set of finder results.

Note

Adding a Simulink summary table reporter with unspecified results to a report causes an error.

summaryTableRptr = slreportgen.report.SummaryTable(finderResults) creates a summary table reporter for the finder result objects in the array finderResults and sets the FinderResults property to finderResults.

The summary table contains a row for each result whose entries contain properties of the found object. By default, the reported properties depend on the result object type. Use the summary table reporters Properties property to customize the set of properties to report on.

summaryTableRptr = slreportgen.report.SummaryTable(Name=Value) sets properties by using name-value arguments. Specify multiple name-value arguments in any order.

Properties

FinderResults — Finder result objects to report

finder result objects

Finder result objects to report, specified as an array of objects of a finder result class such as slreportgen.report.FunctionReferenceResult, or slreportgen.report.SignalResult.

Attributes:

GetAccess	public
SetAccess	public

Title — Title for summary table

[] (default) | string scalar | character vector | DOM object

Title for the summary table, specified as a string, character vector, or a DOM object. By default, this property is empty and the reporter creates the table title by using the getDefaultSummaryTableTitle method for the finder result object specified by finderResults.

Specifying this property as a character vector or string scalar creates an mlreportgen.dom.Paragraph object with Style property set to 'SummaryTableTitleParagraph' in the generated report.

Attributes:

GetAccess	public
SetAccess	public

Properties — Properties of result class to report

array | cell array

Properties of the result class to report on, specified as an array of string scalars or cell array of character vectors.

If this property is empty, the reporter determines which result object properties to report by using the getDefaultSummaryProperties method of the finder result objects specified in finderResults.

Use the getPropertyValues method of the finder result object specified by finderResults to identify the properties you can add to the summary table.

Attributes:

GetAccess	public
SetAccess	public

SeparateTablesByType — Separate result objects table by type

1 (true) (default) | 0 (false)

Whether to create a separate summary table for finder result objects based on the result object Type property, specified as a logical 1 (true) or 0 (false). When you specify:

• 1 (true) —

• 0 (false) —

Attributes:

GetAccess	public
SetAccess	public

IncludeLinks — Link to corresponding finder result object

1 (true) (default) | 0 (false)

Whether to link the Name property of each object in the summary table to link to the corresponding reporter object, specified as a logical 1 (true) or 0 (false). When you specify:

• 1 (true) — Link the Name property of each object in the summary table to link to the corresponding reporter object.

• 0 (false) — Do link the Name property of each object in the summary table.

Attributes:

GetAccess	public
SetAccess	public

Data Types: logical

ShowEmptyColumns — Whether to include columns for empty result properties

0 (false) (default) | 1 (true)

Whether to include columns for empty finder result object properties in the summary tables, specified as a logical 1 (true) or 0 (false). When you specify:

• 1 (true) — Include columns for empty finder result object properties in the summary tables.

• 0 (false) — Omit columns for empty finder result object properties in the summary tables.

Attributes:

GetAccess	public
SetAccess	public

Data Types: logical

TableReporter — Table reporter formatter

mlreportgen.report.BaseTable object

Table reporter formatter type, specified as an mlreportgen.report.BaseTable object. The default value of this property is a BaseTable object with the TableStyleName property set to the SummaryTableTable style, which is defined in the default template for a SummaryTable reporter.

To customize the appearance of the summary table, customize the default reporter or replace it with a customized BaseTable reporter.

Attributes:

GetAccess	public
SetAccess	public

TemplateSrc — Source of template for this reporter

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 this reporter uses or whose template library contains the template for this reporter

• Document Object Model (DOM) document or document part whose template this reporter uses or whose template library contains the template for this reporter

The specified template must be the same type as the report to which you append this reporter. 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.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true
Dependent	true

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 specified by the TemplateSrc property of this reporter.

Attributes:

GetAccess	public
SetAccess	public

Data Types: char | string

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 converts to a LinkTarget object. The link target immediately precedes the content of this reporter in the output report.

Attributes:

GetAccess	public
SetAccess	public

Methods

Public Methods

Method	Purpose
slreportgen.report.SummaryTable.createTemplate	Create reporter template template = createTemplate(templatePath,templateType) creates a copy of the default template for the report type specified by templateType at the location specified by templatePath. You can use the copied template as a starting point to design a custom reporter template for your report. Input Arguments templatePath — Target path and file name for template file, specified as a character vector or a string scalar. templateType — Template type, specified as "html", "docx", or "pdf" Return Values template — Path and file name of the template copy, returned as a string scalar For more information, see the method for the Reporter class, slreportgen.report.Reporter.createTemplate.
slreportgen.report.SummaryTable.customizeReporter	Create reporter from slreportgen.report.SummaryTable class classPathOut = customizeReporter(classPath) creates a reporter class definition file that defines a subclass of slreportgen.report.SummaryTable at the location specified by classPath. The method copies the default reporter templates to the resources/templates subfolder of the folder that contains the class definition file. You can use the class definition file as a starting point to design a custom reporter class. Input Arguments classPath — Path and name of the new class definition file, specified as a character vector or string scalar Return Values classPathOut — Path and file name of the new class, returned as a string scalar For more information, see the method for the slreportgen.report.Reporter class, slreportgen.report.Reporter.customizeReporter.
slreportgen.report.SummaryTable.getClassFolder	Get location of folder that contains slreportgen.report.SummaryTable class definition file path = getClassFolder returns the path of the folder that contains the class definition file. Return Values path — Class definition file location, returned as a character vector For more information, see the method for the Reporter class, slreportgen.report.Reporter.getClassFolder.
copy	Create copy of reporter object and make deep copies of property values copiedObj = copy(reporterObj) returns a copy of the specified reporter object. The returned copy contains a deep copy of any property value of reporterObj that references a reporter, DOM object, or slreportgen.report.ReporterLayout object.As a result, you can modify the properties of the original or new object without affecting the other object. Input Arguments reporterObj — Reporter object to copy, specified as an object of a reporter class Return Values copiedObj — Copy of reporter, returned as an object of a reporter class For more information, see the method for the slreportgen.report.Reporter class, copy.
getImpl	Get implementation of reporter impl = getImpl(reporter,report) returns the Document Object Model (DOM) object that implements the reporter, reporter, when you append it to the report, report. Note You cannot add content to the reporter after calling this method. Input Arguments reporterObj— Reporter object, specified as an object of slreportgen.report.Reporter or an object of a subclass of slreportgen.report.Reporter report — Report, specified as a mlreportgen.report.Report object Return Values impl — Implementation object, returned as a DOM object. For more information, see the method for the slreportgen.report.Reporter class, getImpl.

Examples

Add Summary Table Reporter to Report

This example shows how to add a summary table for finder results representing named signals in your Simulink® model to a report.

Create a PDF report and load the required model

import mlreportgen.report.*
import slreportgen.report.*
import slreportgen.finder.*

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

% Open the model to report on
model_name = "sf_car";
load_system(model_name);

% Create a chapter for the Summary Table Reporter
titleStr = "Summary Table for Named Signals in "+model_name;
add(rpt,TitlePage(Title=titleStr,Author=""));

Create a SignalFinder object to find all the named signals in the model.

sigFinder = slreportgen.finder.SignalFinder(model_name);
sigFinder.IncludeInternalSignals = true;
sigFinder.IncludeUnnamedSignals = false;
results = find(sigFinder);

Create a summary table reporter for the results of the finder object.

reporter = slreportgen.report.SummaryTable(results);
reporter.Properties = ["Name","Source","DataType","Dimensions"];
reporter.Title = "Named Signals";
add(rpt,reporter);
close(rpt);
rptview(rpt);
close_system(model_name);

More About

finder result class

A finder result class is a Report API class that is a subclass of the mlreportgen.finder.Result class, which is an undocumented, internal class.

Version History

Introduced in R2022a