slreportgen.report.ModelConfiguration Class

Name or handle of open or loaded Simulink^® model, specified as a string scalar, character vector, or handle.

Configuration set title, specified as a character vector, string scalar, mlreportgen.dom.Text object, mlreportgen.dom.InternalLink object, or mlreportgen.dom.ExternalLink object.

If the FormatPolicy property is set to "Inline Text" and the Title property is set to:

In both cases, to format the title, use the TextFormatter property of this ModelConfiguration reporter.

If you do not specify a title, the title is the model name followed by Configuration Set. For example:

sf_car Configuration Set

Format for reporting the configuration set, specified as one of these strings or character vectors:

Table formatter for the tables that the ModelConfiguration reporter generates, specified as an mlreportgen.report.BaseTable object. The default value of this property is a BaseTable object with the TableStyleName property set to the ModelConfigurationTable style, which is defined in the default template for a ModelConfiguration reporter. To customize the appearance of the table, modify the properties of the default BaseTable object or replace the object with your own BaseTable object. If you add content to the Title property, the content appears in front of the table title in the generated report.

Paragraph formatter for any model configuration content that is generated as a paragraph, specified as an mlreportgen.dom.Paragraph object. The default value of this property is a Paragraph object with the StyleName property set to the ModelConfigurationParagraph style, which is defined in the default template for a ModelConfiguration reporter. To customize the appearance of the paragraph, modify the properties of the default Paragraph object or replace the object with your own Paragraph object. If you add content to the paragraph object, the content appears in front of the model configuration content in the generated report.

Text formatter for any model configuration content that is generated as inline text, specified as an mlreportgen.dom.Text object. By default, the value of this property is an empty Text object. To customize the appearance of the text, modify the properties of the default mlreportgen.dom.Text object or replace the object with a customized mlreportgen.dom.Text object. If you add content to the Text object, the content appears in front of the model configuration content in the generated report.

Maximum number of table columns in value tables, specified as a positive integer. If a property value is reported using a table and the number of columns is greater than the value of the MaxCols property, the table is sliced vertically. Slicing divides the table into multiple tables.

Maximum number of nested levels in the structured object hierarchy to report, specified as a nonnegative integer. The top level of the hierarchy is the configuration set object (Simulink.ConfigSet). Levels less than or equal to the value of DepthLimit are flattened into a sequence of interlinked tables. Levels greater than the depth limit are not reported. If you set the DepthLimit property to 0, hierarchically structured types are not expanded.

Maximum number of objects in an object hierarchy to report, specified as a positive integer.

Whether to include the configuration set title, specified as true or false.

When IncludeTitle is true, the configuration set title (the content of the Title property) is included in the:

The configuration set title is always included in the title for the paragraph or table that contains the configuration set components, regardless of the value of the IncludeTitle property.

Whether a title includes the data type of the value that the title describes, specified as true or false.

Data Types: logical

Whether to show configuration set or component properties that have empty values, specified as a true or false.

Data Types: logical

Whether to show configuration set or component properties that use the default values, specified as true or false.

Data Types: logical

Function or expression to filter configuration set and component object properties from a report, specified as a function handle, string scalar, or character vector. Specify a function as a function handle. Specify an expression as a string scalar or character vector. If PropertyFilterFcn is empty, all properties are included in the report.

If you provide a function handle, the associated function must:

Run the following command to access the supporting files used in this example.

openExample('rptgenext/SimulinkReportGeneratorFilesExample');

For example, this code uses the PropertyFilterFcn property to prevent the display of the Name and Description properties:

import slreportgen.report.*

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

model = "sf_car";
load_system(model);
reporter = ModelConfiguration(model);

filterFcnHandle = @(variableName,variableObject,propertyName) ...
    (propertyName == "Name") ||  ...
    (propertyName == "Description");

reporter.PropertyFilterFcn = filterFcnHandle;
append(rpt,reporter);
close(rpt);
rptview(rpt);

If you provide a string scalar or a character vector, it must contain an expression. The expression:

For example, this code uses the PropertyFilterFcn property to prevent the display of the Name and Description properties:

import slreportgen.report.*

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

model = "sf_car";
load_system(model);
reporter = ModelConfiguration(model);


filterStr = "isFiltered = " +...
    "strcmp(propertyName,'Name')||strcmp(propertyName,'Description');";
reporter.PropertyFilterFcn = filterStr;

append(rpt,reporter);
close(rpt);
rptview(rpt);

Format or precision used to display noninteger numeric values, specified as a string scalar, character vector, or positive integer.

Specify the format as a string scalar or a character vector. See the formatSpec argument on the sprintf reference page.

Specify the precision as a positive integer. See the precision argument on the num2str reference page.

Example: "%.2f" displays double values with two digits to the right of the decimal place.

Example: 2 displays a maximum number of two significant digits.

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

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.

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.

Data Types: char | string

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.