79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
# chanlun — 缠论技术分析 Python 绑定
|
|
|
|
[](https://pypi.org/project/chanlun/)
|
|
[](LICENSE)
|
|
|
|
基于 [chanlun](./chanlun/) Rust 核心库的 PyO3 高性能 Python 绑定，API 与 `chan.py` 完全兼容。
|
|
|
|
## 安装
|
|
|
|
```bash
|
|
pip install chanlun
|
|
```
|
|
|
|
## 快速开始
|
|
|
|
```python
|
|
import chanlun
|
|
|
|
# 创建配置（全部默认值）
|
|
config = chanlun.缠论配置()
|
|
|
|
# 读取 K 线数据文件，创建观察者
|
|
obs = chanlun.观察者.读取数据文件("path/to/data.nb", config)
|
|
|
|
# 查看各层级序列
|
|
print(f"K线数量: {len(obs.普通K线序列)}")
|
|
print(f"笔数量: {len(obs.笔序列)}")
|
|
print(f"线段数量: {len(obs.线段序列)}")
|
|
print(f"中枢数量: {len(obs.中枢序列)}")
|
|
|
|
# 或使用立体分析器进行多周期分析
|
|
analyzer = chanlun.立体分析器("BTCUSD", ["1min", "5min", "30min"], config)
|
|
# 逐根投喂 K 线...
|
|
```
|
|
|
|
## 从源码构建
|
|
|
|
前置依赖: [Rust](https://www.rust-lang.org) + [maturin](https://www.maturin.rs)
|
|
|
|
```bash
|
|
pip install maturin
|
|
|
|
# 开发模式（直接安装到当前 venv）
|
|
maturin develop
|
|
|
|
# 或构建 wheel
|
|
maturin build --release
|
|
pip install target/wheels/chanlun-*.whl
|
|
```
|
|
|
|
也可使用项目内的 `build.sh`:
|
|
|
|
```bash
|
|
./build.sh develop # 开发安装
|
|
./build.sh wheel # 构建 wheel
|
|
./build.sh test # 运行集成测试
|
|
```
|
|
|
|
## 导出类
|
|
|
|
| 类别 | 类名 | 说明 |
|
|
|------|------|------|
|
|
| 枚举 | `买卖点类型`, `相对方向`, `分型结构` | 缠论基础枚举 |
|
|
| 数据 | `缺口`, `K线`, `缠论K线` | K 线数据结构 |
|
|
| 结构 | `分型`, `虚线`, `线段特征`, `特征分型` | 分析层级结构 |
|
|
| 指标 | `平滑异同移动平均线`, `相对强弱指数`, `随机指标` | MACD/RSI/KDJ |
|
|
| 算法 | `笔`, `线段`, `中枢`, `背驰分析` | 识别算法 |
|
|
| 业务 | `缠论配置`, `基础买卖点`, `买卖点`, `观察者`, `K线合成器`, `立体分析器` | 分析框架 |
|
|
|
|
## 兼容性
|
|
|
|
- Python 3.9+
|
|
- 类名 / 方法名 / 字段名 / 签名与 `chan.py` 一致
|
|
- 支持 `.nb` / `.dat` 二进制文件格式（大端字节序）
|
|
|
|
## 许可
|
|
|
|
MIT
|