aifinlab/a-share-factor-analysis

A 股单因子研究 / IC 检验

数据源

SCRIPTS="$SKILLS_ROOT/cn-stock-data/scripts"
ANALYZER="$SKILLS_ROOT/a-share-factor-analysis/scripts/factor_analyzer.py"

# 获取股票池行情（如沪深300成分股）
python "$SCRIPTS/cn_stock_data.py" kline --code [CODE1],[CODE2],... --freq daily --start [回测起始日期]

# 获取财务指标（PE/PB/ROE 等因子原始值）
python "$SCRIPTS/cn_stock_data.py" finance --code [CODE1],[CODE2],...

# 获取实时行情（市值、PE、PB）
python "$SCRIPTS/cn_stock_data.py" quote --code [CODE1],[CODE2],...

# 运行因子分析
python "$ANALYZER" --factor [FACTOR] --period [N] --data [input.json]

Workflow

Step 1: 确定研究范围

1. 明确因子名称（PE/PB/ROE/动量/波动率/换手率等）
2. 确定股票池（沪深300/中证500/全A等，默认沪深300）
3. 确定回测区间（默认近3年）和调仓周期（默认20个交易日）

Step 2: 数据获取与因子构建

1. 获取股票池所有成分股的日线 kline 数据
2. 获取 finance/quote 数据构建因子截面值
3. 整理为 factor_analyzer.py 所需的 JSON 格式（参见 references/factor-analysis-guide.md）

Step 3: 运行因子分析

调用 factor_analyzer.py 计算：

• IC 序列：每期因子值与下期收益的 Rank IC（Spearman 相关系数）
• IR：IC 均值 / IC 标准差，衡量因子稳定性
• 分位组合：按因子值分5组，比较各组平均收益
• 因子换手率：相邻两期 Top/Bottom 组合的持仓变化比例
• 因子衰减：不同持仓周期下 IC 的衰减速度

Step 4: 结果解读

参见 references/factor-analysis-guide.md 的解读标准：

• IC 均值 > 0.03 且 IR > 0.5 → 因子有效
• 分位组合单调性 → 因子区分度
• 换手率过高 → 实际可执行性存疑

Step 5: 输出

风格说明

| 维度 | formal（专业因子研究报告） | brief（快速因子检验） | |------|--------------------------|---------------------| | 篇幅 | 2-4 页 | 半页 | | IC 分析 | IC 序列图描述 + 分布统计 + 显著性检验 | IC 均值 + IR 一行结论 | | 分位分析 | 五分位组合收益表 + 多空收益曲线描述 | Top-Bottom 收益差 | | 因子衰减 | 多周期 IC 衰减表 | 最优持仓周期 | | 换手率 | 月度换手率序列 | 平均换手率 | | 结论 | 因子有效性评级 + 使用建议 + 局限性 | 有效/无效 + 一句话建议 | | 免责声明 | 需要（历史回测不代表未来表现） | 不需要 |

关键规则

1. Rank IC 优先于 Pearson IC：A 股因子值分布偏态严重，必须用 Spearman 秩相关
2. 去极值与中性化：分析前对因子值做 MAD 去极值，formal 模式需做市值/行业中性化
3. 存活偏差：说明是否剔除退市股，ST 股必须剔除
4. 交易成本：分位组合收益需说明是否扣除交易成本（双边千三估算）
5. 数据来源标注：标明因子原始数据来自 cn-stock-data 的哪个接口
6. A 股特色因子：关注涨跌停、ST、壳价值等 A 股特有因素对因子的影响