主要内容

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

选择报告生成选项

报告选项对话框

要为报告指定报告生成选项,请在报告资源管理器中使用报告选项对话框。从大纲视图中选择报告时,将出现“报告选项”对话框。

要设置这些选项的默认值,请使用“报告生成器”设置。详情请参阅 H

如果您正在创建基于表单的报告,请使用“报告表单选项”对话框。请参阅报告表单

报告输出文件的位置

选择一个文件夹来存储报告文件。您必须具有该文件夹的写入权限。

文件夹

在报告资源管理器的报告选项对话框中,使用目录字段指定存储生成的报告文件的文件夹的名称。指定您有写入权限的文件夹。

下表总结了报告文件位置选项。

文件夹

选项

与报告设置文件相同的文件夹

Same as setup file

当前工作文件夹

Present working directory

临时文件夹

Temporary directory

另一个文件夹

Custom.

使用浏览按钮(...)从目录列表中选择。

您可以使用 %<VariableName> 符号在自定义文本框中指定一个文件夹。

报告文件名

在报告资源管理器的报告选项对话框中,使用文件名字段指定报告文件的文件名。选择以下选项之一。

文件名

选项

与报告设置文件相同的文件名

Same as setup file(默认值)

文件名与报告设置文件名不同

Custom.

输入报告的名称。

您可以使用 %<VariableName> 符号在自定义文本框中指定文件名。

增加以防止覆盖

若要在保存设置文件更新时保留设置文件的先前版本,请选择如果报告已存在,则递增报告编号以防止覆盖

图像输出文件位置

图像放置在与报告文件同名的文件夹中。例如,testreport.html 图像放在名为 testreport_files 的文件夹中。

报告输出格式

报告输出类型和样式表下,从文件格式列表中选择报告输出格式。您可以生成基于模板或基于报告资源管理器样式表格式的报告。

使用报告模板的文件格式

为了更快地生成报告,请设置文件格式以使用模板。选择以下选项之一:

  • Acrobat (PDF)

  • 直接 PDF (来自模板)

  • 直接 PDFA (来自模板) (自 R2025a 起)

  • HTML (来自模板) - 如果您希望报告的目录展开和折叠,请选择此选项。

  • 多页 HTML (来自模板) - 如果您希望 HTML 报告作为 HTML 页面的链接集合,请选择此选项。 (自 R2024a 起)

  • PDF (来自 Word 模板)

  • 单文件 HTML (来自模板) - 如果您希望报告的目录展开和折叠,并且希望 HTML 报告作为单个文件,请选择此选项。

  • Word (来自模板)

  • Word (RTF)

  • Web (HTML) - 基本 HTML 页面

如果您选择基于模板输出格式,那么您可以使用默认模板或自定义模板。有关使用模板生成报告的更多信息,请参阅 使用模板生成报告。有关自定义模板的信息,请参阅 自定义报告转换模板

使用报告资源管理器样式表的文件格式

名称中不包含基于模板的输出格式使用报告资源管理器样式表进行格式化。对于那些输出格式,从样式表列表中选择一个样式表。

查看器

格式

描述

样式表

Adobe® Acrobat® 阅读器

Adobe Acrobat (PDF)

生成一份您可以使用 Adobe Acrobat 阅读器软件查看的 PDF。

请参阅PDF:图像格式

PDF(请参阅PDF 样式表

Word 处理器

  • Word Document (RTF)

  • Rich Text Format

生成与大多数文字处理软件包兼容的输出,包括 Microsoft® Word 软件

请参阅RTF:隐藏内容的显示

Print(请参阅RTF(DSSSL 打印)和 Word 样式表

DocBook

DocBook (no transform)

生成 DocBook 格式的报告

不适用

提示

要创建和使用自定义样式,请参阅 创建新的样式表

PDF:图像格式

PDF 报告仅支持 JPEG (.jpg) 和可缩放矢量图 (.svg)。

SVG 格式仅支持 Simulink® 模型和 Stateflow® 图。例如,当您为 PDF 报告选择 SVG 格式时,MATLAB® 图窗不会以 SVG 格式显示。

RTF:隐藏内容的显示

RTF 报告使用占位符(字段代码)来表示动态生成的内容,例如页码或图像。

在 Windows® 平台上,要显示该内容,请按 Ctrl+A,然后按 F9

在 Linux®Mac 平台上,使用您用于查看 RTF 文档的程序的字段代码更新接口。

更改默认输出格式

Report Generator 设置窗格中,使用格式 ID 设置指定报告的默认输出格式。

样式表

对于每种输出格式,您可以从每种报告输出格式的多个样式表中进行选择。有关详细信息,请参阅:

注意

一些 Web 和打印样式表包含生成的标题列表,其中包括表标题和带有标题的图窗。

PDF 样式表

PDF 样式表

描述

Default print style sheet

显示标题页、目录、标题列表

Standard Print

显示标题页、目录、标题列表

Simple Print

隐藏标题页面、目录、标题列表

Compact Simple Print

最小化页数,隐藏标题、目录和标题列表

Large Type Print

使用 12 号字体(比标准打印略大)

Very Large Type Print

使用 24 号字体和横向纸张方向

Compact Print

最小化空白以减少页数

Unnumbered Chapters & Sections

使用未编号的章节

Numbered Chapters & Sections

使用编号章节

Paginated Sections

打印带分页符的节

Custom Header

允许您指定自定义页眉和页脚

Custom Titlepage

允许您指定自定义标题页内容和演示

Verbose Print

允许您指定高级打印选项

网页样式表

网页样式表

描述

Default HTML style sheet

只有一个单页的 HTML 文档

Simulink book HTML style sheet

多页 HTML;隐藏章标题和目录

Truth Table HTML style sheet

多页 HTML;隐藏章标题和目录

Multi-page Web

HTML,每章单独一页

Single-page Web

只有一个单页的 HTML 文档

Single-page Unnumbered Chapters & Sections

单页 HTML;章节未编号

Single-page Numbered Chapters & Sections

单页 HTML;章节均已编号

Single-page Simple

单页上的 HTML;隐藏标题页和目录

Multi-page Simple

多页上的 HTML;隐藏标题页和目录

Multi-page Unnumbered Chapters & Sections

多页 HTML;章节未编号

Multi-page Numbered Chapters & Sections

多页 HTML;章节均已编号

RTF(DSSSL 打印)和 Word 样式表

RTF 或 Word 样式表

描述

Standard Print

显示标题页、目录、标题列表

Simple Print

隐藏标题页面、目录、标题列表

Compact Simple Print

最小化页数,隐藏标题、目录和标题列表

Large Type Print

使用 12 号字体(比标准打印略大)

Very Large Type Print

使用 24 号字体和横向纸张方向

Compact Print

最小化空白以减少页数

Unnumbered Chapters & Sections

使用未编号的章节

Numbered Chapters & Sections

使用编号章节

报告生成处理

报告选项对话框包括用于控制报告处理的选项。

选项

用途

生成后查看报告

报告生成完成后,与报告输出格式关联的查看器将显示该报告。

在 Linux 或 Macintosh 平台上打开 Microsoft Word 文档会调用 soffice 命令。要在 Linux 计算机上使用 soffice 命令,必须安装 Apache® OpenOffice® 或 LibreOffice®。在 Macintosh 上,您必须在 /Applications 文件夹中安装 Apache OpenOffice

要手动查看报告,请从报告的报告选项中指定的位置(报告文件位置下)打开文件。

生成前自动保存

在生成报告之前自动保存报告设置文件。

编译模型以报告编译的信息

确保报告反映编译的值。

默认情况下,Simulink Report Generator™ 报告 Simulink 参数的未编译值。某些参数的未编译值(例如信号数据类型)可能与仿真期间使用的编译值不同。

此选项使报告生成器在报告模型参数之前编译模型。生成报告后,报告生成器将模型返回到未编译状态。

注意

当您选择此选项时,每当报告生成需要仿真模型时(例如,报告包含模型仿真 (Simulink Report Generator)组件),报告生成器都会反编译该模型,然后重新编译该模型(如有必要),以报告模型内容。如果一份报告需要多次编译,处理起来会非常耗时。

为了尽量减少编译,请考虑使用单独的报告来报告模型的内容和对该模型进行仿真的结果。

生成后计算此字符串

指定 MATLAB 代码以便在报告生成后进行处理。例如,您可以指定关闭一个模型。