本页采用了机器翻译。点击此处可查看最新英文版本。

slwebview

将 Simulink 模型导出为 Web 视图

全页折叠

语法

slwebview
filename = slwebview(sysname)
filename = slwebview(folder)
filename = slwebview(sysname,Name=Value)

说明

slwebview 在报告管理器中启动 Web 视图对话框。

filename = slwebview(sysname) 将子系统 system_name 及其子系统导出到文件 filename。包含子系统的模型必须打开。

示例

filename = slwebview(folder) 导出文件夹中的所有模型。请参阅RecurseFolder以将模型包含在子文件夹中。

filename = slwebview(sysname,Name=Value) 提供一个或多个名称-值参量指定的附加选项。

示例

示例

全部折叠

打开 sldemo_fuelsys 模型。

openExample("sldemo_fuelsys")

将发动机气体动力学子系统及其包含的系统导出至 Web 视图。不要导出其包含的子系统。

fuelsys_web_view = slwebview("sldemo_fuelsys/Engine Gas Dynamics", ...
    SearchScope="CurrentAndAbove")

导航至 Engine_Gas_Dynamics 文件夹并打开 webview.html。

Web view showing the Engine Gas Dynamics subsystem.

有关详细信息，请参阅显示和浏览 Web 视图。

打开 sldemo_fuelsys 模型。

openExample("sldemo_fuelsys")

将模型导出为 Web 视图并允许访问其引用的模型。

fuelsys_web_view = slwebview("sldemo_fuelsys", ...
    "FollowModelReference","on")

导航至 sldemo_fuelsys 文件夹并打开 webview.html。有关详细信息，请参阅显示和浏览 Web 视图。

点击 fuel_rate_control 模块查看模块属性。双击模块以显示引用模型。

Web view showing the sldemo_fuelsys model.

输入参数

全部折叠

导出到 Web 视图文件的系统，指定为字符向量或字符串标量，其中包含系统路径或子系统、模块图、图或子图的句柄。默认情况下，该函数还会导出sysname系统的子系统。使用 SearchScope 名称-值参量来导出与 sysname 相关的其他系统。

示例: "sysname"

包含要导出为 Web 视图文件的一个或多个模型的文件夹的路径，指定为字符向量或字符串标量。该函数导出文件夹中的所有模型。

名称-值参数

全部折叠

将可选参量对指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是相应的值。名称-值参量必须出现在其他参量之后，但对的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并将 Name 括在引号中。

示例: htmlFileName = slwebview(gcs,"LookUnderMasks","all",... "FollowLinks","on") 将当前系统所属的模型层次结构的所有层导出为 Web 视图，包括与库链接和封装交互的能力。

与 sysname 系统相关的导出系统，指定为以下值之一：

  • "CurrentAndBelow" - 导出 sysname 指定的 Simulink® 系统或 Stateflow® 图以及其中包含的所有系统或图。

  • "Current" - 仅导出 Simulink 系统或 sysname 指定的 Stateflow 图。

  • "CurrentAndAbove" - 导出由 sysname 指定的 Simulink 系统或 Stateflow 图，以及包含该系统的所有系统或图。

  • "All" - 导出模型中包含 sysname 指定的系统或图的所有 Simulink 系统或 Stateflow 图。

数据类型: char | string

是否导出封装模块，指定为以下值之一：

  • "none" - 不在 Web 视图中导出封装模块。封装模块包含在导出的系统中，但您无法访问封装模块的内容。

  • "all" - 导出所有封装模块。

数据类型: char | string

是否包括在架构模型中定义的行为组件， 指定为 "on" 或 "off"，或者指定为数值或逻辑 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 在 Web 视图中包含行为组件

  • "off" - 不在 Web 视图中包含行为组件

是否包含用户注释， 指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 在 Web 视图中包含用户注释

  • "off" - 不在 Web 视图中包含用户注释

是否导出在 MATLAB Function 模块或 Stateflow 图中使用的支持 MATLAB 函数， 指定为 "on" 或 "off"，或者指定为数值或逻辑 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 导出 Web 视图中的支持函数或图

  • "off" - 不在 Web 视图中导出支持函数或图

是否访问引用的模型， 指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 在 Web 视图中包含引用模型

  • "off" - 不在 Web 视图中包含引用模型

自 R2024b 起

是否导出引用的子系统， 指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 在 Web 视图中导出引用子系统

  • "off" - 不在 Web 视图中导出引用子系统

是否将模型导出到子文件夹， 指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • “on” - Web 视图包括顶级文件夹中的模型和子文件夹中的模型。

  • "off" - Web 视图仅包含顶级文件夹中的模型，不包含子文件夹中的模型。

仅当您指定 folder 作为输入参量时，此属性才适用。

Web 视图输出包的名称，指定为字符向量或字符串标量。Web 视图输出是一个 ZIP 文件或解压后的 Web 视图文件夹，或两种输出类型兼有。PackageName 的默认值是模型名称。

数据类型: char | string

放置打包的 Web 视图的路径，指定为字符向量或字符串标量。要将打包的 Web 视图保存在与模型相同的文件夹中，请使用 $model 作为 PackageFolder。PackageFolder 的默认值是当前工作目录。

数据类型: char | string

Web 视图输出包的类型，指定为以下值之一：

  • "both" - 创建压缩和解压后的输出

  • "zipped" - 创建一个带有 .htmx 扩展名的 ZIP 文件

  • "unzipped" - 创建一个文件夹

数据类型: char | string

要包含的可选视图，指定为包含以下一个或两个值的元胞数组：

  • "requirements"

  • "coverage"

请参阅在 Web 视图中包含模型要求和覆盖率数据。

数据类型: cell

在导出 Web 视图后，是否在 Web 浏览器中显示 Web 视图， 指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 在导出 Web 视图时，在 Web 浏览器中显示 Web 视图。

  • "off" - 在导出 Web 视图时，不在 Web 浏览器中显示 Web 视图。

在导出 Web 视图时是否显示状态栏， 指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false) 表示。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - 在导出 Web 视图时显示状态栏

  • "off" - 在导出 Web 视图时不显示状态栏

是否以增量方式导出模型， 指定为 "on" 或 "off"，或者指定为数字或逻辑值 1(true)或 0(false)。值 "on" 等同于 true，而 "off" 等同于 false。因此，您可以将此属性的值用作逻辑值。该值以类型为 matlab.lang.OnOffSwitchState. 的 on/off 逻辑值存储。

  • "on" - slwebview 重用缓存的 Web 视图。

    • slwebview 为自上次使用 slwebview 以来未发生任何更改的顶层模型重用缓存的 Web 视图。

    • 如果 FollowModelReference 或 FollowSubsystemReference 也设置为 "on"，则 slwebview 也会重用自上次使用 slwebview 以来未发生任何更改的引用模型或子系统的缓存 Web 视图。

  • "off" - slwebview 重新生成所有之前导出的 Web 视图。

slwebview 仅在更改使模型变为脏状态时，才会重新生成 Web 视图。不会使模型变为脏状态的模型行为或模型外观更改不会触发重新生成 Web 视图的操作。例如，更改可调参数的名称会污染模型，但更改可调参数的值不会污染模型。要强制 Web 视图重新生成，请删除当前仿真缓存文件夹中的模型仿真缓存文件。

提示

slwebview 在当前仿真缓存文件夹中缓存 Web 视图。要重用现有的 Web 视图，请使用通用仿真缓存文件夹进行 Web 视图导出。

数据类型: logical

输出参量

全部折叠

显示 Web 视图的 HTML 文件的名称，以字符向量形式返回。导出 Web 视图会在文件夹中创建相应的支持文件。

提示

  • Web 视图是模型的交互式呈现，您可以在 Web 浏览器中查看。您可以分层浏览 Web 视图来检查特定的子系统并查看模块和信号的属性。

    您可以使用 Web 视图与未安装 Simulink 的人共享模型。

    注意

    当使用颜色来区分采样时间时，只有引用模型的颜色在 Web 视图中可见。不支持应用于引用子系统的颜色。

  • 要在 Linux® 计算机上使用 -batch 启动选项运行 MATLAB 时生成 Web 视图，请执行以下操作：

    1. 创建一个 Linux shell 文件。

    2. 在 shell 文件中，将打开模型并生成 Web 视图的命令存储在一个变量中。您可以输入多个以分号分隔的命令。

    3. 在 shell 文件中，使用 xvfb-run 运行 MATLAB，并使用 -batch 启动选项，然后执行命令。有关 xfvb-run 的详细信息，请参阅 Ubuntu 网站上的 xvfb-run。

    4. 将 shell 文件保存到 MATLAB 路径下的一个目录中。

    5. 在 Linux 终端中，导航至包含 shell 文件的目录。

    6. 执行 shell 文件。

    此示例代码定义了一个 Linux Bash shell，用于为模型 myModel 执行 slwebview。

    #!/bin/bash

MATLAB_COMMANDS="open_system("myModel.slx"); 
slwebview("myModel.slx");"
xvfb-run matlab -batch "$MATLAB_COMMANDS exit;"

版本历史记录

在 R2006a 中推出

全部展开

另请参阅

主题