Metadata-Version: 2.4
Name: tidequant
Version: 0.1.0
Summary: TideQuant因子层: 算子库、表达式因子求值与历史因子生成引擎
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: jsonargparse
Requires-Dist: loguru
Requires-Dist: numba
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: pyarrow
Requires-Dist: setproctitle
Requires-Dist: tqdm

# TideQuant 潮汐量化
顺势而生,逆势有度

本包发布的是 TideQuant 的**因子层**: 算子库、表达式因子求值,
以及从历史逐笔数据生成因子库的引擎。交易执行、交易所对接与看板
不在这个包里。

## 安装

```bash
pip install tidequant
```

## 因子计算

```python
from tidequant.factor import OPS, evaluate, parse

node = parse("cs_zscore(ts_mean(amount / volume, 20))")
value = evaluate(node, lambda leaf: load(leaf))
```

`OPS` 是算子表,`register` 可以往里加自定义算子。算子分三族:
`ts_` 时序、`cs_` 截面、`ew_` 指数加权。

## 生成历史因子库

读取逐笔 trade 数据,按 interval 聚合字段因子,再对 `factors.json`
里的表达式因子沿整个时间轴求值:

```bash
python -m tidequant.engine.history_factor_generator \
    --tbt_folder data/binance/trades --out_folder data/factors_15m \
    --start_dt 2022-07-01 --end_dt 2026-07-01 --interval 15m
```

已生成的因子自动跳过,中断后重跑自动续写。用 `--factors_path`
指向自己的因子名单文件即可替换内置的 `factors.json`。

因子库读写接口在 `tidequant.data.FactorBase`。
