一、安装配置
**注意:** python 版本必须大于等于 3.8
1.方法一
直接从github安装:
```
pip install git@github.com:waditu/czsc.git -U
```
2.方法二
直接从github指定分支安装最新版:
```
pip install git+https://github.com/waditu/czsc.git@V0.9.46 -U
```
3.方法三
从`pypi`安装:
```
pip install czsc -U -i https://pypi.python.org/simple
```
下载完成以后的样子.
各类的python编辑工具都可以使用.
二、第一个最简单的例子(最简入门.py )
# -*- coding: utf-8 -*-
"""
CZSC 框架最简入门示例
5分钟快速入门
"""
from czsc import mock, CZSC, RawBar
from czsc.enum import Freq
def main():
print("="*60)
print("CZSC 框架最简入门")
print("="*60)
# 步骤1:生成模拟数据
print("\n步骤1:生成模拟数据")
df = mock.generate_symbol_kines(
symbol="000001",
freq="日线",
sdt="20230101",
edt="20240101",
seed=42
)
print(f"✅ 生成 {len(df)} 条K线数据")
# 步骤2:转换为 RawBar 对象
print("\n步骤2:转换为 RawBar 对象")
bars = []
for i, row in df.iterrows():
bar = RawBar(
symbol=row['symbol'], id=i, freq=Freq.D, dt=row['dt'],
open=row['open'], close=row['close'], high=row['high'],
low=row['low'], vol=row['vol'], amount=row['amount']
)
bars.append(bar)
print(f"✅ 转换完成,共 {len(bars)} 条")
# 步骤3:使用 CZSC 进行分析
print("\n步骤3:使用 CZSC 进行缠论分析")
c = CZSC(bars)
print(f"✅ 品种: {c.symbol}")
print(f"✅ 周期: {c.freq}")
print(f"✅ K线数量: {len(c.bars_raw)}")
print(f"✅ 分型数量: {len(c.fx_list)}")
print(f"✅ 笔数量: {len(c.bi_list)}")
# 显示最后3笔
if len(c.bi_list) >= 3:
print(f"\n最近3笔信息:")
for i, bi in enumerate(c.bi_list[-3:]):
direction = "↗️ 向上" if bi.direction.value == "向上" else "↘️ 向下"
print(f" 笔{i+1}: {direction} | 开始:{bi.sdt.strftime('%m-%d')} | 结束:{bi.edt.strftime('%m-%d')} | 力度:{bi.power:.2f}")
print("\n" + "="*60)
print("🎉 恭喜!你已经完成了第一个 CZSC 分析")
print("="*60)
if __name__ == '__main__':
main()
成功运行以后,会得到下面的内容,祝好运!
% python 最简入门.py
============================================================
CZSC 框架最简入门
============================================================
步骤1:生成模拟数据
✅ 生成 366 条K线数据
步骤2:转换为 RawBar 对象
✅ 转换完成,共 366 条
步骤3:使用 CZSC 进行缠论分析
✅ 品种: 000001
✅ 周期: 日线
✅ K线数量: 359
✅ 分型数量: 112
✅ 笔数量: 24
最近3笔信息:
笔1: ↘️ 向下 | 开始:11-13 | 结束:11-29 | 力度:10.80
笔2: ↗️ 向上 | 开始:11-29 | 结束:12-02 | 力度:6.09
笔3: ↘️ 向下 | 开始:12-02 | 结束:12-16 | 力度:7.74
============================================================
🎉 恭喜!你已经完成了第一个 CZSC 分析
============================================================