使用报告资源管理器创建报告

创建报告设置文件

要设置报告，您需要创建一个设置文件，并添加组件，这些组件是描述报告内容的 MATLAB® 对象。例如，此示例中的完成报告使用组件创建了标题页、章节、正文和图窗。

提示：要打开此示例的已完成报告设置文件，在 MATLAB 命令行窗口中，输入：

setedit magic-square.rpt

要创建报告设置文件：

1.打开报告资源管理器。在 MATLAB 工具条的 App 选项卡中的数据库连接和报告部分，点击报告生成器。

2.选择文件 > 新建以创建报告设置文件。新的报告设置的默认名称为 Unnamed.rpt。

3.在“报告资源管理器”的右侧窗格中，为报告设置以下属性：

This report creates a series of magic squares
and displays them as images.

A magic square is a matrix in which the 
columns, rows, and diagonal add up to the 
same number.

4.要保存报告，请选择文件 > 另存为，然后为报告设置文件命名 magic_square.rpt。在左侧窗格中，新文件名显示在报告生成器下。

指定报告变量

要指定要显示的方块的数量和大小，以及是否将幻方显示为数值数组或彩色方块图像，请使用 Evaluate MATLAB Expression 组件在 MATLAB 工作区中创建这些变量：

要将组件添加到设置文件中：

1.在“报告资源管理器”的左侧窗格中，选择报告设置文件。

2.在中间窗格的 MATLAB 部分，选择评估 MATLAB 表达式。

3.在右侧窗格中，点击将组件添加到当前报告。左侧窗格显示了 magic_squares 报告下的新组件。

4.在右侧窗格中，为 Eval 组件指定以下属性：

% This MATLAB code sets up two variables
% that define how the report runs.

% magicSizeVector is a list of MxM
% Magic Square sizes to insert into
% the report. Note that magic
% squares cannot be 2x2.

magicSizeVector=[4 8 16 32];

% largestDisplayedArray sets the
% limit of array size that will be
% inserted into the report with the
% Insert Variable component.

largestDisplayedArray=15;

disp("Error during eval:"+evalException.message)

创建标题页

要创建报告的标题页，请使用 Title Page 组件：

1.在左侧窗格中，选择 Eval 组件。

2.在中间窗格的格式部分，选择标题页组件。然后，在右侧窗格中，点击将组件添加到当前报告。

在左侧窗格中，图标 表示 Eval 组件不能有子组件，因此 Title Page 组件是 Eval 组件的同级组件。

3.在右侧窗格的主选项卡中，为标题页组件指定以下属性：

4.在摘要选项卡的摘要文本下，输入：

An introduction to Magic Squares and their meaning.

添加第一章

要向报告添加一章，请使用 Chapter/Subsection 组件：

1.在左侧窗格中，选择标题页组件。

2.在中间窗格的格式部分，选择章节/小节组件。然后，在右侧窗格中，点击将组件添加到当前报告。左侧窗格显示 Eval、标题页和章节组件，它们彼此为同级组件。

3.在右侧窗格中，对于标题，选择 Custom。然后，在右侧的框中输入 Magic Squares Explained。

在第一章开头添加引言

要在第一章中包含引言文本，请添加 Paragraph 和 Text 组件：

1.在左侧窗格中，选择章节组件。

2.在中间窗格的格式部分，添加一个段落组件和两个文本组件。

在左侧窗格中，图标 表示 Chapter 和 Paragraph 组件可以有子组件，因此新 Text 组件是 Paragraph 组件的子组件，而后者是 Chapter 组件的子组件。

3.在左侧窗格中，选择第一个文本组件。然后，在右侧窗格的要包含在报告中的文本框中，输入：

%<help("magic")>

分隔符 %< 和 > 评估 MATLAB 代码并将结果插入报告。在此示例中，该命令显示关于 magic 函数的信息。

4.在左侧窗格中，选择第二个文本组件。然后，在右侧窗格的要包含在报告中的文本框中，输入：

The German artist Albrecht Durer (1471-1528) 
created many woodcuts and prints with religious
and scientific symbolism. One of his most famous
works, Melancholia I, explores the depressed state 
of mind that opposes inspiration and expression.
Renaissance astrologers believed that the Jupiter magic
square (shown in the upper right portion of the image)
could aid in the cure of melancholy. The engraving's 
date (1514) can be found in the lower row of numbers
in the square.

添加图像

要创建阿尔布雷希特·丢勒的蚀刻画图像并将其包含在报告中，请使用 Figure Snapshot 组件：

1.在左侧窗格中，选择章节组件。

2.在中间窗格的 MATLAB 部分，添加一个 Evaluate MATLAB Expression 组件。在左侧窗格中，Eval 组件作为 Chapter 组件的子组件，位于 Paragraph 组件上方。

3.在工具栏上，使用“向下移动”按钮 将 Eval 组件移动到段落组件下方，位于两个文本组件之后。

4.在右侧窗格中，为 Eval 组件指定以下属性：

% This MATLAB code loads a self-portrait of 
% Albrecht Durer, a German artist. There is
% a magic square in the upper right corner
% of the image.

durerData=load("durer.mat","-mat");
figure(Units="Pixels",...
    Position=[200 200 size(durerData.X,2)*.5 size(durerData.X,1)*.5]);

image(durerData.X);
colormap(durerData.map);
axis("image");
set(gca,...
    Xtick=[], ...
    Ytick=[], ...
    Units="normal", ...
    Position=[0 0 1 1]);

clear durerData

disp("Error during eval:"+evalException.message)

5.在中间窗格的 Handle Graphics 部分，添加一个图窗快照组件。然后，在右侧窗格中，指定以下属性：

6.在中间窗格的 MATLAB 部分，添加一个 Evaluate MATLAB Expression 组件。然后，在右侧窗格中，指定以下属性：

% This command deletes the Durer image
delete(gcf);

disp("Error during eval:"+evalException.message)

为每个幻方创建一个章节

要为报告添加一个章节，以包含由变量 magicSizeVector 指定的每个幻方，请使用 For Loop 组件：

1.在左侧窗格中，选择章节组件。

2.在中间窗格的逻辑和流控制部分，添加一个 For Loop 组件。在左侧窗格中，For Loop 组件作为 Chapter 组件的子组件，位于 Paragraph 组件上方。

3.在工具栏上，使用“向左移动”按钮 将 For 组件移动到与 Chapter 组件同级的位置。

4.在右侧窗格中，为 For 组件指定以下属性：

5.在中间窗格的 MATLAB 部分，添加一个 Evaluate MATLAB Expression 组件。然后，在右侧窗格中，指定以下属性：

Magic_Square_Size = magicSizeVector(MAGIC_SQUARE_INDEX);

disp("Error during eval:"+evalException.message)

6.在中间窗格的格式部分，添加一个章节/小节组件。然后，在右侧窗格中，对于标题，选择 Automatic。

7.在中间窗格的 MATLAB 部分，将插入变量组件添加到报告中。然后，在右侧窗格中，指定以下属性：

显示每个幻方

报告以彩色图像显示小幻方数组和大方阵。要确定使用哪种方法，请添加 Logical If、Logical Then 和 Logical Else 组件：

1.在左侧窗格中，选择变量组件。

2.在中间窗格的 MATLAB 部分，添加一个 Evaluate MATLAB Expression 组件。然后，在右侧窗格中，指定以下属性：

% This MATLAB code produces a magic
% square of size Magic_Square_Size
% and creates an image of that square.

mySquare=magic(Magic_Square_Size);
clf
imagesc(mySquare);
title(sprintf("Magic Square N=%i",Magic_Square_Size))
set(gca,Ydir="normal");
axis equal;
axis tight;

disp("Error during eval:"+evalException.message)

3.在中间窗格的逻辑和流程控制部分，添加一个逻辑 If 组件，以确定是将幻方显示为数值数组还是图像。然后，在右侧窗格中，将测试表达式设置为

Magic_Square_Size<=largestDisplayedArray

4.在中间窗格的逻辑和流控制部分，添加一个逻辑 Else 组件。

5.在左侧窗格中，再次选择 if 组件。然后，在中间窗格的逻辑和流控制部分，添加一个逻辑 Then 组件。在左侧窗格中，then 组件出现在 else 组件上方。

6.在左侧窗格中，选择 then 组件。

7.在中间窗格的 MATLAB 部分，添加一个插入变量组件。然后，在右侧窗格中，指定以下属性：

8.在左侧窗格中，选择 else 组件。

9.在中间窗格的 Handle Graphics 部分，添加一个图窗循环组件和一个图窗快照组件。然后，在右侧窗格中，指定以下属性：

10.保存报告。

生成报告

要生成报告，在工具栏上点击报告按钮 。报告生成以下内容：

处理完成后，MATLAB 网页浏览器将打开并显示 HTML 文件。