czsc 信号函数详解:bar_accelerate_V221118 均线偏离加速判定(kline 类信号)
czsc 信号函数详解:bar_accelerate_V221118 均线偏离加速判定(kline 类信号)
本文依据仓库文档 bar_accelerate_V221118.md 编写,并结合 Rust 源码实现展开原理级讲解。
导读
本文深入解析 czsc(缠中说禅技术分析工具)K 线类信号函数 bar_accelerate_V221118:它通过"收盘价相对均线的偏离值序列"来判定当前行情是否处于均线单边加速状态,输出 上涨 / 下跌 / 其他 三类完全分类结果。读完本文你将掌握该信号的参数模板、判定逻辑、Rust 源码级实现细节,以及如何将其接入 czsc 的信号体系用于量化策略构建。
一、信号是什么:模块归属与设计定位
bar_accelerate_V221118 是 czsc 信号函数库中归属于 bar 模块、kline 类别的标准信号,其定义与实现位于 crates/czsc-signals/src/bar.rs。
在 czsc 的信号索引文档 signals-bar.md 中,bar 模块共登记了 46 个信号,其中"加速"一族包含三个演进版本:
| 信号名 | 参数模板 | 判定思路 |
|---|---|---|
bar_accelerate_V221110 |
"{freq}_D{di}W{window}_加速V221110 |
区间最高/最低 + 阳阴占比(区间加速走势判定) |
bar_accelerate_V221118 |
"{freq}_D{di}W{window}#{ma_type}#{timeperiod}_加速V221118 |
均线偏离值全正/全负 + 末三根单调(均线偏离加速判定) |
bar_accelerate_V240428 |
"{freq}_D{di}W{w}T{t}_加速V240428 |
滚动差分 + 75 分位阈值 + 倍量K线计数 |
三者同为"加速"主题,但口径截然不同:V221110 看的是收盘价在区间内的相对位置,V221118 看的是收盘价相对均线的偏离及其单调性,V240428 看的是滚动差分幅度。本文聚焦 V221118 这一均线偏离版本。
二、参数模板:如何构造信号名
"{freq}_D{di}W{window}#{ma_type}#{timeperiod}_加速V221118"
信号名由三部分组成(对应信号七段结构中的 k1_k2_k3):
{freq}:K 线周期,例如日线、60分钟,对应信号k1字段;D{di}W{window}#{ma_type}#{timeperiod}:参数区,对应k2字段,例如D1W13#SMA#10;加速V221118:信号类型标识,对应k3字段。
该模板在 bar.rs 中以 #<a href="https://link.gitcode.com/i/bb9b77ece7ee9eb8c09ccd1ebdd28a45" target="_blank">signal(...)] 过程宏属性声明,并通过 k2 = format!("D{}W{}#{}#{}", di, window, ma_type, timeperiod) 实际拼装(见 [bar.rs)。
参数说明(默认值)
| 参数 | 含义 | 默认值 | 约束 |
|---|---|---|---|
di |
倒数第 di 根 K 线为窗口截止点 |
1 |
>= 1 |
window |
观察窗口长度(统计的 K 线根数) | 13 |
必须 > 3,否则直接输出 其他 |
ma_type |
均线类型 | SMA |
内部统一转大写,支持 SMA / EMA / WMA 等 |
timeperiod |
均线周期 | 10 |
正整数 |
注意:
window <= 3时无法满足"最后三根"单调性判断,源码在 bar.rs 提前返回其他。
三、信号逻辑:均线偏离加速的三步判定
依据文档,判定过程分三步:
- 计算窗口内每根
close - ma偏离值:取截止到倒数第di根的最近window根 K 线,对每一根计算收盘价与对应均线值的差值delta = close - ma; - 全部偏离为正,且最后三根偏离值递增,判
上涨:即窗口内所有偏离值> 0,且delta[n-1] > delta[n-2] > delta[n-3],说明价格持续站在均线上方且正在加速远离; - 全部偏离为负,且最后三根偏离值递减,判
下跌,否则其他:即所有偏离值< 0,且delta[n-1] < delta[n-2] < delta[n-3],说明价格持续压在均线下方且加速下行。
对应源码 bar.rs 的核心实现:
let delta: Vec<f64> = bars
.iter()
.zip(ma_sub.iter())
.map(|(b, m)| b.close - *m)
.collect();
let all_pos = delta.iter().all(|x| *x > 0.0);
let all_neg = delta.iter().all(|x| *x < 0.0);
let n = delta.len();
let v1 = if all_pos && delta[n - 1] > delta[n - 2] && delta[n - 2] > delta[n - 3] {
"上涨"
} else if all_neg && delta[n - 1] < delta[n - 2] && delta[n - 2] < delta[n - 3] {
"下跌"
} else {
"其他"
};
设计要点:该信号是典型的"完全分类"信号——任何行情下必然落入 上涨 / 下跌 / 其他 之一。其中"其他"涵盖三类情况:偏离值正负混杂、偏离全正但末三根未递增、偏离全负但末三根未递减。这种严格完全分类的设计便于在策略中直接使用,无需担心空值。
四、信号输出:标准七段信号结构
该信号最终通过 make_kline_signal_v1 构造标准七段信号:
Signal('日线_D1W13#SMA#10_加速V221118_上涨_任意_任意_0')
Signal('日线_D1W13#SMA#10_加速V221118_下跌_任意_任意_0')
信号格式为 k1_k2_k3_v1_v2_v3_score(7 个部分、6 个下划线,定义见 crates/czsc-core/src/objects/signal.rs)。其中:
k1 = 日线(频率)、k2 = D1W13#SMA#10(参数区)、k3 = 加速V221118(类型);v1 = 上涨 / 下跌 / 其他(判定结果)、v2 = 任意、v3 = 任意(K 线级信号不细分)、score = 0。
构造链路为 make_kline_signal_v1 → make_signal7(见 crates/czsc-signals/src/utils/sig.rs),后者会调用 Signal::from_str 对生成的字符串做严格格式校验,格式非法时直接 panic,从源头保证信号对象合法性。
五、源码级实现原理:均线缓存与窗口切片
1. 均线序列复用 TaCache
信号不重复计算均线,而是通过 update_ma_cache 按 (freq, ma_type, timeperiod) 组成缓存键,复用全局 TaCache 中的均线序列(见 crates/czsc-signals/src/utils/ta.rs):
let cache_key = format!("{}_{}_{}", c.freq, ma_type, timeperiod);
update_ma_cache(c, &cache_key, &ma_type, timeperiod, cache);
let Some(ma) = cache.series.get(&cache_key) else {
return make_kline_signal_v1(&k1, &k2, k3, "其他");
};
缓存机制会按 K 线 id 判断是否需要增量更新:若倒数第二根 bar 的 id 已在缓存中,则只对新增尾部窗口重算均线,避免全量重算。均线类型映射见 ta.rs:
let calc = |close: &[f64]| match ma_type_u.as_str() {
"SMA" => calc_sma_cache_style(close, timeperiod),
"EMA" => calc_ema_cache_style(close, timeperiod),
"WMA" => calc_wma_cache_style(close, timeperiod),
_ => calc_sma_cache_style(close, timeperiod),
};
即 SMA / EMA / WMA 有独立实现,其他类型回退到 SMA。
2. 窗口切片 get_sub_elements
K 线子窗口与均线子窗口均通过 get_sub_elements 截取,语义对齐 Python 的切片逻辑(见 crates/czsc-signals/src/utils/sig.rs):
di == 1时返回最后n根;di > 1时返回[-n-di+1 : -di+1]区间;- 数量不足时返回可用区间(可能为空)。
let bars = get_sub_elements(&c.bars_raw, di, window);
let ma_sub = get_sub_elements(ma.as_slice(), di, window);
if bars.len() != window || ma_sub.len() != window {
return make_kline_signal_v1(&k1, &k2, k3, "其他");
}
若取到的窗口长度不足 window,说明历史数据不够,同样安全返回 其他。均线序列与 K 线序列按同一 di/window 切片后逐根做差,保证价格与均线一一对齐。
3. 数据充分性兜底
从源码结构看,di 偏大或历史 bar 不足都会导致窗口长度不达标,从而落入 其他 分支;这与 V221110/V240428 版本中"len() > di + window + 10 才计算"的防御思路一致,属于信号函数通用的边界保护模式。
六、对齐说明与跨语言一致性
文档明确标注:
偏离序列与三根单调条件对齐 Python
bar_accelerate_V221118。
czsc 项目存在 Rust 内核与 Python 层的双轨实现(Rust 端信号库见 crates/czsc-signals/src/lib.rs,通过 #<a href="https://link.gitcode.com/i/446c45c9cb7afba1cf92bce90cfb88e5" target="_blank">signal_module] 过程宏批量注册),因此该信号在 [bar.rs 的注释中明确声明"对齐说明":偏离序列的构造口径、以及"最后三根单调递增/递减"的条件判断,与 Python 版 bar_accelerate_V221118 完全一致。这意味着同一组参数在 Rust 端与 Python 端会输出相同信号,是跨语言回测一致性的基础保证(仓库单元测试 tests/unit/test_core_parity.py 亦在验证同类一致性)。
七、实战使用:如何在策略中引用该信号
1. 直接构造信号字符串
在策略因子或事件回测中,可直接按模板构造目标信号,例如日线 SMA10 均线、13 根窗口的加速上涨:
日线_D1W13#SMA#10_加速V221118_上涨_任意_任意_0
2. 结合参数模板微调
- 缩短窗口(如
W5)更灵敏但更易被末三根单调条件过滤; - 更换均线(如
#EMA#)改变"偏离"基准,EMA 响应更快,SMA 更平滑; - 调整
timeperiod(如#SMA#20)改变均线周期与行情节奏的匹配度。
3. 与其他信号组合
bar_accelerate_V221118 属 K 线类(kline)信号,可与 tas(技术指标)、cxt(缠论结构)、pos(仓位管理)等类别的信号在 v2/v3 层面组合成复合因子,或作为事件驱动的过滤条件。完整信号家族索引可查阅 signals-bar.md 及同目录下的 signals-tas.md、signals-cxt.md 等索引文档。
小结
bar_accelerate_V221118 通过"均线偏离全正/全负 + 末三根单调"的简洁规则,将行情状态完全分类为 上涨 / 下跌 / 其他,捕捉价格相对均线的加速远离状态。其实现体现了 czsc 信号体系的三条工程准则:参数模板化(信号名即参数,可读可追溯)、计算缓存化(TaCache 复用均线序列)、跨语言对齐(与 Python 版口径一致)。理解它之后,你可以对照同族的 bar_accelerate_V221110.md 与 bar_accelerate_V240428.md 对比三种"加速"口径的差异,并在策略中按需选用。