Documentation

slreportgen.webview.WebViewDocument class

Package: slreportgen.webview
Superclasses:

Create a web view document generator

Description

Creates a document generator that generates an HTML document containing a web view of one or more Simulink® models.

Construction

wvdocgen = slreportgen.webview.WebViewDocument(docname,model) creates a document generator that generates an HTML document at the specified location containing a web view of the specified model. Use the generator’s fill method to generate the document.

wvdocgen = slreportgen.webview.WebViewDocument(docname,model1,model2,...modeln)creates a document generator that includes two or more models in the web view that it creates. This constructor assigns an array of default slreportgen.webview.ExportOptions objects to the generator’s ExportOptions property, one for each of the models to be included in the generated document’s web view. You can use the objects to specify custom export options for the models to be exported.

wvdocgen = slreportgen.webview.WebViewDocument(docname,{model1,model2,...modeln}) assigns a default slreportgen.webview.ExportOptions object to the generator’s ExportOptions property that applies to all of the models to be exported.

wvdocgen = slreportgen.webview.WebViewDocument(docname) creates a web view document generator for an initially unspecified model or set of models. Use the Systems property of the generator’s ExportOptions property to specify the model or models to be included in the web view that it generates.

Input Arguments

expand all

Name of the zip file and/or folder containing the report generated by this generator. Use this generator’s PackageType property to specify whether to package the generated report as a file or a folder or both. If you specify an extension, the extension must be.htmx. If you do not specify an extension, the report generator appends .htmx.

Name of the Simulink model to export to an interactive HTML Web view, specified as a character vector.

Output Arguments

expand all

Properties

expand all

Identifier of current hole in document. This is a read-only property.

An array of slreportgen.webview.ExportOptions objects, one for each model or set of models to be exported. The generator’s constructor sets this property with default values for the model or models you specify. Use the properties of the ExportOptions object or objects to customize export of the models to the generated web view. For example, you can specify additional models to include or whether to include the block diagrams of masked subsystems and library blocks.

Whether to overwrite an existing report with the same name. True overwrites the existing report. False generates the report under a new name.

Path of the document output directory.

Packaging to use for output document, specified as one of these character vectors:

  • 'zipped' — Creates a zip file with an .htmx extension

  • 'unzipped' — Creates a folder of files

  • 'both' — Creates both zipped and unzipped output

Path to the HTML template to use to generate this report. The template has an .htmtx extension. This property points by default to a default template. To use a custom template, set this property to the path of the custom template.

Text to display in the title bar of the HTML browser displaying the generated web view document. The default text is “Simulink Web View - Created by Simulink Report Generator."

Methods

Method

Purpose

fillInvokes web view generator’s hole-filling methods (e.g., fillslwebview) to fill the holes in the web view document’s template
fillslwebviewFills template’s slwebview hole with a web view
getExportModelsNames of models to be included in the web view
getExportDiagramsPaths and handles of block diagrams to be included in the web view
getExportSimulinkSubSystemsPaths and handles of subsystem blocks to be included in this web view
getExportStateflowChartsPaths and handles of
getExportStateflowDiagramsArray of Stateflow® diagram paths

Examples

Export Model to a Web View

import slreportgen.webview.*
load_system('f14')
d = WebViewDocument('f14WebView', 'f14');
d(fill);
rptview(d);

close_system('f14');

Export Multiple Models to a Web View

The export options in this example allow you to view the subsystem that implements the Simulink library block, Band-Limited White Noise, in the f14 model and the Stateflow chart that implements the Engine block in the sf_car model. If the example did not enable the export options, the subsystem and chart would appear only as blocks in the exported web view.

import slreportgen.webview.*
load_system('f14');
load_system('sf_car');
wvdoc = WebViewDocument(...
    'myWebview','f14','sf_car'); 
opts = wvdoc.ExportOptions;
 
f14Opts = opts(1);
f14Opts.IncludeMaskedSubsystems = true; 
f14Opts.IncludeSimulinkLibraryLinks = true;

sfcarOpts = opts(2);
sfcarOpts.IncludeMaskedSubsystems = true; 

fill(wvdoc)
rptview(wvdoc)

close_system('f14');
close_system('sf_car');

Export Selected Systems to a Web View

This example exports f14’s root system and Aircraft Dynamics Model subsystem.

import slreportgen.webview.*
load_system('f14');
wvdoc = WebViewDocument('myWebView', ...
    {'f14', 'f14/Aircraft Dynamics Model'});
wvdoc.ExportOptions.SearchScope = 'Current';
fill(wvdoc)
rptview(wvdoc)
close_system('f14');

Export Subsystem’s Ancestors to a Web View

This example exports f14’s root system and Controller subsystem.

wvdoc = slreportgen.webview.WebViewDocument(...
    'mydoc', 'f14/Controller');
wvdoc.ExportOptions.SearchScope = 'CurrentAndAbove';
 
fill(wvdoc)
rptview('myWebView')

Introduced in R2017a

Was this topic helpful?