inflation-linked

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>