算法应用

EmeyeStudio 提供公式引擎和算法库两种算法应用方式，支持派生变量计算和管理。

功能入口

  • 公式引擎：菜单「工具 → 公式引擎配置」；波形窗口工具栏「公式」按钮
  • 算法库应用：菜单「分析 → 应用算法」；波形窗口工具栏「算法」按钮

核心概念

概念 说明
派生变量 通过公式或算法计算得到的变量
公式引擎 解析和计算数学表达式的引擎
算法库 提供滤波、FFT、磁链观测器等算法的DLL库
变量映射 将数据变量映射到算法输入参数

使用步骤

公式引擎

公式引擎适用于简单的数学表达式计算，支持参数定义和公式配置。

基本操作步骤

  1. 点击菜单「工具 → 公式引擎配置」或波形窗口工具栏「公式」按钮
  2. 在参数定义区添加参数（如 Rs=0.5, Ld=0.005 等）
  3. 在公式编辑器中输入派生变量名和公式表达式
  4. 点击"验证"检查公式语法
  5. 点击"应用"执行计算并生成派生变量

公式语法

运算符

运算符 说明 示例
+ 加法 a + b
- 减法 a - b
* 乘法 a * b
/ 除法 a / b
^ 幂运算 a ^ 2
( ) 括号 (a + b) * c

函数

函数 说明 示例
sin(x) 正弦 sin(theta)
cos(x) 余弦 cos(theta)
tan(x) 正切 tan(theta)
sqrt(x) 平方根 sqrt(a^2 + b^2)
abs(x) 绝对值 abs(error)
log(x) 自然对数 log(value)
exp(x) 指数 exp(x)
atan2(y, x) 反正切 atan2(flux_q, flux_d)

变量引用

引用方式 说明 示例
直接引用 数据变量 id, iq, omega_m
参数引用 定义的参数 Rs, Ld, psi_f
配置引用 工程配置参数 ${Motor.极对数}

算法库应用

算法库提供专业的算法处理功能，适用于复杂的信号处理和电机控制算法。

基本操作步骤

  1. 点击菜单「分析 → 应用算法」或波形窗口工具栏「算法」按钮
  2. 从左侧算法类别树中选择具体算法（如"PMSM磁链观测器"）
  3. 在右侧配置算法参数（如电机参数 Rs、Ld、Lq 等）
  4. 在输入变量映射区选择数据变量映射到算法输入
  5. 设置输出变量前缀和输出选项
  6. 点击"应用"执行算法并生成派生变量

数据分析概览面板

应用算法配置后，右侧"数据分析概览"面板会展示本次分析的状态，帮助您快速确认分析是否成功：

  • 分析状态区：当前激活的配置名、算法、被分析的数据源（文件名 + 点数 + 采样率 + 通道数）、执行状态、执行时间
  • 底部按钮：
  • 编辑配置：打开算法应用对话框查看或修改当前配置
  • 应用配置：用当前配置在当前数据上重新计算

该面板聚焦"状态反馈"，不重复展示算法结果数值——结果在各独立窗口查看（EmAdapt 在深度分析窗口，其他算法在波形派生变量）。

提示：一个算法配置可应用于任意一份数据。若当前数据的通道名与配置创建时的映射不一致，应用时会自动检测匹配度，并在"数据分析概览"面板的"匹配"行显示轻量警告（如"⚠️ 2 个输入未匹配，已跳过"），不弹窗打断操作。全部输入均未匹配时，应用会被阻止并提示"无法计算"。

可用算法类别

  • 电机控制：PMSM磁链观测器、转矩计算器、效率计算器
  • 滤波器：低通滤波器、高通滤波器、带通滤波器
  • 频谱分析：FFT分析、功率谱密度
  • 统计分析：基本统计、滑动窗口统计

算法预设管理

预设文件格式

{
    "name": "PMSM_表贴式_标准参数",
    "algorithm": "PMSM_FluxObserver",
    "version": "1.0",
    "parameters": {
        "motor": {
            "Rs": 0.5,
            "Ld": 0.005,
            "Lq": 0.005,
            "psi_f": 0.1,
            "pole_pairs": 4
        },
        "gains": {
            "K1": 100.0,
            "K2": 100.0
        },
        "sample_time": 0.0001
    },
    "description": "表贴式PMSM标准参数配置"
}

预设存储位置

  • 系统预设：{安装目录}/presets/algorithms/
  • 用户预设：{用户数据目录}/presets/algorithms/

注意事项

  • 派生变量是运行时计算产物，与工程持久数据源的生命周期不同，关闭工程或切换数据后自动失效
  • 派生变量在波形面板中显示，与原始波形通道并列，首次创建时自动分配颜色
  • 应用公式/算法后，派生变量自动添加到波形窗口
  • DAQ采集时，公式引擎和算法库可实时计算派生变量

相关文档