创建函数类型的习题

为了帮助学生掌握 MATLAB^® 编程技能，您可以编写希望学生使用函数解答的习题。

要编写函数类型的习题，请执行以下操作：

转至 MATLAB Grader™ 主页（如果需要，请登录）。
添加习题。
- 要将习题添加到题库中，请执行以下操作：在内容选项卡中，点击所需题库中的添加习题。
- 要将习题添加到课程中，请执行以下操作：在课程选项卡中，点击要向其中添加习题的课程。在要添加新习题的作业中，点击添加习题。
从您自己的题库或 MATLAB Grader 习题目录中选择现有习题，或者从空白模板开始创建您自己的习题。

如果您在创建函数类型的习题时需要其他帮助，请点击相关项目旁边的问号图标以获取相应说明。

提示

您可以随时点击选择不同习题以放弃草稿，返回添加习题，并进行重新选择。

在编写编程习题草稿时，请记住保存正在进行的工作。有两个选项：

存为草稿 - 您可以在“草稿”模式下继续开发此习题。
存为终稿 - 习题已完成。如果该习题属于您正在开发的 MATLAB Grader 课程，则在课程发布时，学生可以看到该习题。学生只能查看处于“存为终稿”状态的习题。如果您想在发布某个习题后将其从学生视图中删除，请打开该习题，然后点击设置为草稿。

步骤 1：描述待解答的习题

为学生创建标题和详细的习题描述。
使用富文本编辑器，您可以添加格式化文本、方程、链接和图像。
注意
编写习题描述时，请明确定义输入变量的数量和类型，以及预期输出的数量和类型。具体说明值的类型或测量的单位。
可以选择提供参考答案、学生答案和评判可以使用的数据和代码文件。在引用的文件中添加这些项目。
将习题类型设置为函数。此设置向 MATLAB Grader 指示，学生答案必须格式化为 MATLAB 函数。

下图显示了函数类型的习题的标题和描述。

Image showing title and problem description

步骤 2：编写习题答案

编写随后可用于评判学生答案的参考答案。

参考答案是您的答案。学生看不到该答案。
该函数必须至少返回一个输出。您可以在评判中按名称调用参考答案，并将输出值与学生函数返回的值进行比较。

步骤 3：编写代码和注释来帮助学生

为学生提供答案模板。

学生模板提供学生开始用来编写答案的代码。您可以决定向学生提供多少代码。
点击挂锁图标以防止学生更改您提供的代码。
使用注释向学生提供编程说明和提示。
您必须告诉学生应如何为函数命名，以便您可以在评判中调用该函数。请考虑在学生模板中锁定具有该函数名称的行。

预览习题显示画面

要查看内容的格式，请点击学生预览。预览区域会显示学生在 MATLAB Grader 中解答习题时看到的视图。

您可以与学生预览进行交互，以查看评判结果、反馈和错误消息。

学生还可以选择使用 MATLAB Online™ 编写和提交自己的答案。他们可以使用 MATLAB 的工作区、实时编辑器和调试功能编写 MATLAB Grader 习题的答案，而无需下载、安装或设置 MATLAB。

要预览在 MATLAB Online 中向学生显示的习题，请执行以下操作：

将习题保存为终稿。
点击学生预览。
点击在 MATLAB Online 中打开。

MATLAB Online 在浏览器左侧的 MATLAB Grader 面板中显示习题描述、评判和输出选项卡，以及运行自测和提交按钮。与 MATLAB Online 中的其他面板一样，学生可以将 MATLAB Grader 面板移动到窗口的左侧或右侧。

您可以访问在 MATLAB Online 中提交答案了解有关学生工作流的详细信息。

步骤 4：创建评判以测试学生答案

用于测试函数类型的学生习题答案的评判比您为脚本类型的习题编写的评判更复杂。本节简要描述了 UI 元素。有关为此类习题编写评判的详细信息和示例，请参阅为函数类型的学生答案编写评判。

当学生提交答案时，您创建的评判将用来评估学生答案。您可以根据需要编写任意数量的测试。

指定要使用的评判方法。
在评判下，选择评判方法。
- 正确/错误 - MATLAB Grader 将习题视为通过/不通过。
- 加权评分 - 当为单个习题创建多个评判时，您可以选择为每个测试给予部分学分。
要了解有关评判方法的详细信息，请参阅评判方法。
编写评判代码。
1. 点击添加习题评判。MATLAB Grader 会自动为评判编号。
2. 提供有关测试的简短描述。
3. 选择测试类型。
  - 函数或关键字存在 - 提供学生必须在答案中使用的函数和关键字。
  - 函数或关键字缺失 - 提供学生必须避免在答案中使用的函数或关键字。
  - MATLAB 代码 - 使用 MATLAB 代码编写评判。您可以创建输入，调用参考函数和学生函数，以及捕获输出和确定输出的正确性。可以使用 MATLAB 代码将多个评判合并到单个测试中。
受变量作用域的限制，评判只能访问测试脚本所创建的变量。
向学生提供额外反馈。
如果答案未通过评判，MATLAB Grader 会提供默认反馈。您可以使用富文本格式（包括格式化文本、超文本链接、图像和数学方程）向学生提供额外反馈。
您也可以选择指定测试是否为自测。自测是指学生可以在不提交答案的情况下运行的测试。
1. 默认情况下，评判不是自测。
2. 要将评判作为自测，请选择自测。
  当您选择将评判作为自测时：
  - MATLAB Grader 会为学生添加运行自测按钮。
  - 当学生点击运行自测时，MATLAB Grader 会根据标记为自测的评判运行学生的答案，并提供教师对这些测试的反馈。
在编写自测时，请记住，学生可以看到用于评判自测的代码。您肯定不希望在自测中无意间包含解答习题所需的代码。

有关如何为函数类型的习题编写评判的帮助，请参阅为函数类型的学生答案编写评判。

步骤 5：编写调用学生函数的代码

编写调用学生函数的脚本。当学生点击运行函数时，该脚本会运行。

此字段为学生提供了一种在提交答案进行评判之前测试其函数的方法。
您可以选择用测试学生函数的代码预填充此字段。通常，该脚本会创建有代表性的输入作为变量，然后使用这些输入调用学生函数。MATLAB Grader 会以一种有意义的方式向学生显示输出。
当学生点击提交时，此代码不会运行。

步骤 6：保存习题

保存编程习题时，有两个选项：

存为草稿 - 您可以在“草稿”模式下继续开发此习题。
存为终稿 - 习题已完成。如果该习题属于您正在开发的 MATLAB Grader 课程，则在课程发布时，学生可以看到该习题。学生只能查看处于“存为终稿”状态的习题。如果您想在发布某个习题后将其从学生视图中删除，请打开该习题，然后点击设置为草稿。