Engee 文档

设置

设置窗口debug article icon 1 是一个*Engee*工具,用于自定义块、模型和模拟。

要打开模型和模拟设置窗口,请单击模型工作区中的齿轮图标debug article icon 1

设置窗口由三个选项卡组成:

和其他选项卡。

要在设置选项卡之间切换,请单击其标题或将鼠标悬停在状态栏上:

settings windows icons cn

要访问区块设置,请双击区块图标,或在已打开设置窗口的区块上单击一次:

settings params 1 cn

区块设置

区块设置窗口的选项卡因所选区块而异。默认情况下,每个区块都有两个主选项卡 - 信息

  • 主要*选项卡指定了程序块的参数,以及其他可以控制其行为的特殊设置。例如,对于功能 ,它可以编辑程序块的源代码:

    settings params 2 cn

    程序块参数可以使用表达式指定(详见此处)。
  • 信息 标签提供所选程序块的有用信息。可通过此选项卡更改程序块名称。单击documentation icon main 进入所选程序块的参考文档。

    settings params 3 cn

属性 "选项卡

settings first cn

该选项卡用于配置 Engee 中模型的基本参数。该选项卡提供了求解器、事件检测和回调控制选项。通过这些选项,您可以影响模型计算,控制模型对事件的响应,并使用自定义功能来增强建模能力。

因此,该选项卡由以下字段组成:

  • 标题 - 显示当前模型的名称(默认为 newmodel_1)。

  • 模式 - 定义模拟执行方式,平衡模型初始化速度和计算速度。有两种模式可供选择:

    • 快速初始化 - 一种模式是通过简化键入和禁用优化来尽可能快地运行模型。该模式适用于调试大型模型,需要尽量缩短仿真启动时间,例如模型结构经常变化时;

    • 快速计数 - 该模式旨在通过更深入的代码优化和计算算法的高度专业化最大限度地减少计算时间。该模式最适用于需要高性能和最短计算时间的最终计算或模拟。

  • 控制模拟速度 - 指定在一实际秒内应遍历多少秒的模拟。使用该设置可减慢模拟速度,简化分析和与模型的交互。

  • 开始 - 初始模拟时间(默认为 0.0)。

  • 结束 - 最终模拟时间(默认为 10)。

  • 类型 - 选择类型求解器 (音调不变 / 可变螺距):

    音调不变 可变螺距

    settings first 1 1 cn

    • 解析器 - 求解器选择(默认为 Euler)。

    • 步长 - 积分步长值(默认为 "0.01")。

    settings first 1 cn

    • 最大步长 - 设置最大积分步长(默认为 auto)。

    • 最小步长 - 设置最小积分步长(默认为 "自动")。

    • 初始步长 - 设置初始积分步长(默认为 "自动")。

    • 相对精度 - 设置相对积分精度(默认为 "自动")。

    • 绝对精度 - 设置绝对积分精度(默认为 "自动")。

    • 高密度渲染 - 启用/禁用紧密分配功能。如果选中,Engee 将以更高频率输出结果(默认为 "开")。

    • 间隔 - 密集输出的间隔时间(默认为 1e-2)。

  • 在活动期间保存信号 - 在检测到事件时保存信号(默认启用)。

  • 信号阈值 - 用于检测事件的信号阈值(默认为 1e-10)。

  • 编辑源代码 - 打开回调的源代码编辑器。该选项用于对模型行为进行更高级的控制。

选项卡 "代码生成"

settings second cn

代码生成器功能 一文中了解 代码生成 标签的功能。

有关 Engee 代码生成的更多信息,请参阅系列文章代码生成

选项卡 "调试"

debug article 1 cn

使用该选项卡可在变量窗口variables article 2 1 中显示模型信息并保存仿真结果。该选项卡有助于调试模型,包括以下操作:

  • 数据类型 - 显示模型块之间信号线的数据类型。如果模型中存在不正确的数据类型,选择 数据类型 功能将自动显示诊断窗口model diagnosis main ,显示错误信息。

    *数据类型显示示例

    datatypes function engee cn

  • 信号尺寸 - 显示模型块之间信号线的尺寸。模型信号可以是标量、矢量和矩阵。

    不同信号的映射示例
    • *标量信号*是没有方向的单一数据值,是最简单的信号类型:

      example dimension scalar

      scalar_signal = 1 #Пример 标量ного сигнала
      
      #Вывод
      1
    • 矢量信号 - 同类型数据的有序集合,以矢量形式组织,有方向,可包含多个元素。

      example dimension vector

      vector_signal = [1, 2, 3] #Пример 向量ного сигнала
      
      #Вывод
      3-element Vector{Int64}:
       1
       2
       3
    • *矩阵信号*是由行和列组成的二维数据数组,可包含不同类型的数据。矩阵可用于同时表示多个信号。

      example dimension matrix

      matrix_signal = [1:2 2:3 3:4]
      
      #Вывод
      2×3 Matrix{Int64}:
       1  2  3
       2  3  4
  • 信号采样频率 - 显示模型块的采样率。采样步长过小可能会导致数据量增大,从而减慢模拟速度。步长过大可能会导致模型计算精度下降。请根据您的模型和目标选择最佳选项。

    *采样率显示示例。

    sample rate 0 cn

    • 颜色突出 - 通过 信号采样频率 选项的子项,可以用颜色突出显示以下选项之一:当前采样率信号、信号源或不突出显示任何内容(默认选择)。根据信号的采样率,离散信号可以用不同的颜色显示。

      *颜色高亮示例

      sample rate 1 cn

  • 区块的执行顺序 - 可以查看模型中模块的执行顺序。模型执行顺序将以数字显示,其中 1 表示模型中第一个可执行块。该选项有助于控制程序块的执行顺序,避免不必要的依赖关系,并提高模型的可读性。

    *执行顺序示例

    order feature models

  • 写下物理变量 - 允许您从库数据块 物理建模 中写入数据。有三个选项可用于设置记录:

    • 不要写下任何东西- 禁用写入物理变量。如果未设置 写下物理变量 标志,则默认使用该选项。

    • 记录所选区块- 仅记录所选区块的数据。要启用块数据记录功能,请右键单击所选块并在右键菜单中选择 记录物理信号

      physical variables recording 1 cn

    • 写下来- 记录模型中库 物理建模 中所有图块的数据。在这种情况下,没有必要对每个区块分别进行记录。

      记录的变量显示在窗口 图表 graphs icon 1 和应用程序数据检查员 中。

  • 将模拟结果保存到工作区 - 可以将模型模拟结果保存到工作区(变量窗口img65 )。有关保存仿真结果的更多信息,请参阅文章软件处理 Engee 中的模拟结果

  • 物理变量初始化的结果 - 在物理变量窗口variable viewer icon 中显示物理变量值。

  • 分步执行 - 允许您一次运行一个时间步长的模型。启用该设置后,Engee 仿真菜单顶部将增加额外的按钮:

    stepping through sim

    在该模式下,您可以自定义参数:

    • 存储步数 - 参数定义内存中将存储多少模拟步骤。这对了解模型如何达到当前状态以及调试都很有用,因为它允许您比较每一步的变化。

    • 保存步骤的间隔时间 - 参数设置多少时间步后模型状态将被存储。

    • 前进/后退 - 参数设置模型前进的步数:

      • 前进一步move forward - 模拟按指定步数继续进行。例如,如果参数 "前进/后退步长 "的值为 "2",则模拟将前进两步。

      • 后退move back - 模拟按指定步数后退。Engee 恢复模型状态的工作点,并返回所选的步数。

  • 显示信号的瞬时值 - 允许标记信号,以显示模拟或逐步执行过程中的瞬时值。

    instant values 1

  • 动画速度 - 控制有限自动机 的速度(在图表 块内支持)。它有四种模式:关闭(默认)、慢速、中速和快速。

    image3

  • 断点 - 打开编辑器,创建暂停模型执行的点(详情请参见建模中的断点 )。

    breakpoints 1