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

Advisor.authoring.generateConfigurationParameterDataFile

命名空间: Advisor.authoring

生成用于自定义配置参数检查的 XML 数据文件

全页折叠

语法

Advisor.authoring.generateConfigurationParameterDataFile(dataFile,source)
Advisor.authoring.generateConfigurationParameterDataFile(dataFile,source,Name,Value)

说明

Advisor.authoring.generateConfigurationParameterDataFile(dataFile,source) 生成一个名为 dataFile 的 XML 数据文件，其中指定了 source 的配置参数。数据文件使用标签来指定所需的配置参数设置。创建配置参数检查时，需要使用数据文件。数据文件中指定的每个模型配置参数均为一项子检查。

示例

Advisor.authoring.generateConfigurationParameterDataFile(dataFile,source,Name,Value) 生成一个名为 dataFile 的 XML 数据文件，其中指定了 source 的配置参数。它还可以通过一个或多个可选的 Name,Value 参量指定其他选项。数据文件使用标签来指定所需的配置参数设置。创建配置参数检查时，需要使用数据文件。数据文件中指定的每个模型配置参数均为一项子检查。

示例

示例

全部折叠

创建包含所有配置参数的数据文件。您可以使用数据文件创建配置参数。

通过输入以下命令打开模型 vdp：

openExample('simulink_general/VanDerPolOscillatorExample')

model = 'vdp';
dataFile = 'myDataFile.xml';
Advisor.authoring.generateConfigurationParameterDataFile( ...
               dataFile, model);

数据文件 myDataFile.xml 包含标记，用于指定每个配置参数的子检查信息。myDataFile.xml 指定您所需的配置参数设置。以下指定配置参数 AbsTol 的 XML 标记。如果配置参数设置为 1e-6，则 myDataFile.xml 中指定的配置参数子检查通过。

<!-- Absolute tolerance: (AbsTol)-->
  <PositiveModelParameterConstraint>
     <parameter>AbsTol</parameter>
     <value>1e-6</value>
     </PositiveModelParameterConstraint>

创建包含求解器窗格配置参数的数据文件。您可以使用数据文件创建带有修复操作的求解器窗格配置参数检查。

通过输入以下命令打开模型 vdp：

openExample('simulink_general/VanDerPolOscillatorExample')

model = 'vdp';
dataFile = 'myDataFile.xml';
Advisor.authoring.generateConfigurationParameterDataFile( ...
               dataFile, model, 'Pane', 'Solver', 'FixValues', true);

数据文件 myDataFile.xml 包含标记，用于指定每个配置参数的子检查信息。myDataFile.xml 指定您所需的配置参数设置。以下指定配置参数 AbsTol 的 XML 标记。如果配置参数设置为 1e-6，则 myDataFile.xml 中指定的配置参数子检查通过。如果子检查未通过，检查修复操作会将配置参数修改为 1e-6。

<!-- Absolute tolerance: (AbsTol)-->
  <PositiveModelParameterConstraint>
     <parameter>AbsTol</parameter>
     <value>1e-6</value>
     <fixvalue>1e-6</fixvalue>
     </PositiveModelParameterConstraint>

输入参数

全部折叠

要创建的 XML 数据文件的名称，以字符向量形式指定。

示例: 'myDataFile.xml'

用于指定配置参数的模型名称或 Simulink.ConfigSet 对象

示例: 'vdp'

名称-值参数

全部折叠

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

如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: 'Pane', 'Solver', 'FixValues', true 指定一个带有求解器窗格配置参数和修复标记的 dataFile。

可以选择将数据文件中的配置参数限制为以逗号分隔的 'Pane' 与以下值之一组合而成的窗格：

  • Solver

  • Data Import/Export

  • Optimization

  • Diagnostics

  • Hardware Implementation

  • Model Referencing

  • Code Generation

示例: 'Pane','Solver' 将 dataFile 限制为 Solver 窗格上的配置参数。

数据类型: char

将 FixValues 设置为 true 可以为 dataFile 提供修复标签。当您使用带有修复标记的 dataFile 生成自定义配置参数检查时，每个配置参数子检查都有一个修复操作。指定为以逗号分隔的 'FixValues' 和 true 或 false 的组合。

示例: 'FixValues,true 指定在 dataFile 中进行修复标记。

数据类型: logical

版本历史记录

在 R2014a 中推出

另请参阅

主题