| name | inflation-linked |
| description | 通胀挂钩债券定价工具，支持TIPS/ILB本金指数调整、真实收益率与盈亏平衡通胀率计算。适用于固定收益教学、通胀保护债券机制学习与费雪方程原理演示；采用简化通胀路径假设且未覆盖通缩底线/流动性溢价/税收效应，不适用于实盘交易、通胀对冲或资产配置决策。 |
| version | 1.0.0 |
| author | wangyi |
inflation-linked
通胀挂钩债券分析工具，支持TIPS定价、通胀指数调整本金、真实收益率与盈亏平衡通胀率计算。
📌 说明：本工具基于简化模型实现，仅使用 Python 标准库。结果仅供学习参考，不构成投资建议或交易依据。
脚本API
inflation_index_ratio(base_cpi, current_cpi)
计算通胀指数比率。
必填: base_cpi, current_cpi
adjust_principal(face_value, base_cpi, current_cpi, deflation_protection=True)
调整本金（含通缩保护）。
必填: face_value, base_cpi, current_cpi
price_tips(face_value, coupon_rate, real_yield, maturity_years, base_cpi, current_cpi, future_cpi_path=None, payment_frequency=2)
TIPS定价。
必填: face_value, coupon_rate, real_yield, maturity_years, base_cpi, current_cpi
fisher_equation(nominal_rate, inflation_rate)
费雪方程：名义利率、真实利率与通胀率的关系。
必填: nominal_rate, inflation_rate
breakeven_inflation(nominal_yield, real_yield)
计算盈亏平衡通胀率。
必填: nominal_yield, real_yield
tips_vs_nominal_analysis(face_value, coupon_rate_tips, real_yield, nominal_yield, maturity_years, base_cpi, current_cpi, expected_inflation, payment_frequency=2)
TIPS与名义国债对比分析。
必填: face_value, coupon_rate_tips, real_yield, nominal_yield, maturity_years, base_cpi, current_cpi, expected_inflation
调用示例
python scripts/main.py \
--face-value <face_value> \
--coupon-rate-tips <coupon_rate_tips> \
--real-yield <real_yield> \
--nominal-yield <nominal_yield> \
--maturity-years <maturity_years> \
--base-cpi <base_cpi> \
--current-cpi <current_cpi> \
--expected-inflation <expected_inflation> \
--payment-frequency <payment_frequency>
