通达信符号如何自定义公式引用？

Question

在通达信公式系统中，如何正确引用自定义公式的输出结果？常见问题表现为：当用户在主图或副图指标中调用已编写的自定义公式（如“ZLMM”）时，返回值为空或显示“无效引用”。其核心原因在于未规范使用公式名称与线名的调用语法，例如未通过"公式名.线名"格式引用，或跨周期、跨市场调用时未加前缀。此外，函数REF、FILTER等时序操作与自定义公式结合使用时易出现逻辑错误。如何确保自定义公式被其他公式稳定调用并返回预期数值？

Answer 1

一、通达信公式系统中自定义公式引用机制解析

在通达信的公式系统中，用户可通过“公式管理器”创建自定义指标（如“ZLMM”），并在主图或副图中调用其输出线。然而，常见问题表现为返回值为空或提示“无效引用”，其本质是未遵循严格的引用语法规范。

通达信公式的输出结果是以“线名”为单位进行命名和暴露的。例如，若在“ZLMM”公式中定义了：
MA1: MA(CLOSE, 5);
则“MA1”即为该公式的输出线名称，外部调用时必须使用完整路径：ZLMM.MA1。

若仅写“ZLMM”或“MA1”，系统无法识别，导致空值或报错。

1.1 基础语法：公式名.线名 的引用格式

• 正确格式："ZLMM.MA1"
• 错误格式："MA1" 或 "ZLMM"
• 注意：双引号可省略，但建议保留以增强可读性
• 线名区分大小写，需严格匹配
• 若公式无显式线名（如仅赋值变量），则无法被外部引用

1.2 跨周期引用：添加周期前缀

当需要在日线图中引用“ZLMM”在周线上的输出时，必须添加周期标识：

场景	正确引用格式	说明
当前周期引用	ZLMM.MA1	默认同周期
引用周线数据	WEEK$ZLMM.MA1	使用WEEK$前缀
引用月线数据	MONTH$ZLMM.MA1	支持MONTH$、MIN$n等
引用5分钟线	MIN5$ZLMM.MA1	n≤240

二、跨市场与跨证券引用的前缀规则

在涉及不同市场（如沪市、深市、北交所）或ETF、期货时，需添加市场前缀以确保引用唯一性：

• SZ$ZLMM.MA1：表示深市股票中的ZLMM公式输出
• SH$ZLMM.MA1：表示沪市股票中的ZLMM公式输出
• BJS$ZLMM.MA1：北交所专用前缀
• FU$ZLMM.MA1：期货市场引用

若未加前缀，系统默认当前证券所在市场，但在组合策略或多市场回测中易引发逻辑混乱。

三、时序函数与自定义公式结合的风险点

当在主公式中使用REF(ZLMM.MA1, 1)或FILTER(ZLMM.MA1 > 10, 5)时，需注意以下逻辑陷阱：

3.1 REF函数的延迟陷阱

REF用于获取历史值，但若ZLMM本身含未来函数（如ZIG、BACKSET），则REF可能返回非预期值。示例：

// ZLMM 公式内部
ZIG_SIGNAL: ZIG(3, 5);  // 含未来函数

// 主公式调用
LAST_SIGNAL: REF(ZLMM.ZIG_SIGNAL, 1);
    

此场景下，ZIG_SIGNAL在实时行情中会漂移，导致REF结果不稳定。

3.2 FILTER函数的触发条件冲突

FILTER用于去重信号，但若输入源为跨周期数据，其时间对齐可能出错：

// 错误用法
FILTER(WEEK$ZLMM.BUY_SIGNAL, 3)
    

因周线BUY_SIGNAL仅每周更新一次，在日线中FILTER可能连续多日不触发或误触发。

四、确保稳定调用的工程化实践

为提升公式的可维护性与稳定性，建议采用如下开发模式：

4.1 输出线命名规范化

1. 避免使用通用名如“X”、“A1”
2. 采用语义化命名，如“ZLMM_BUY_ENTRY”
3. 在公式末尾注释说明各输出线用途
4. 统一前缀管理，便于批量调用

4.2 构建调用依赖图谱

使用Mermaid绘制公式间依赖关系，辅助调试：

graph TD
            A[ZLMM] --> B[MA1]
            A --> C[BUY_SIGNAL]
            D[主策略] --> B
            D --> C
            E[风险控制模块] --> B
            F[信号过滤器] --> C

该图谱可帮助识别循环引用、冗余计算等问题。

4.3 单元测试与边界验证

在实盘部署前，应在不同周期、不同证券类型下测试引用有效性。建议测试用例包括：

测试项	输入条件	预期输出
同周期引用	日线ZLMM.MA1	数值连续无断点
跨周期引用	WEEK$ZLMM.MA1	周频更新
跨市场引用	SZ$ZLMM.BUY_SIGNAL	深市有效
REF操作	REF(ZLMM.MA1, 2)	滞后两根K线
FILTER去重	FILTER(ZLMM.SIGNAL,1)	相邻信号去重