municipal-bond

name	municipal-bond
description	市政债分析工具，计算应税等价收益率(TEY)、税后收益率，对比一般责任债(GO)与收益债(Revenue)的信用特征。适用于固定收益教学、免税债券税务效应学习与市政债信用分析原理演示；采用简化信用指标且未覆盖再融资期权/税收豁免细节，不适用于实盘债券投资决策、信用风险评估或税务筹划。
version	1.0.0
author	wangyi

municipal-bond

市政债券分析工具，计算免税收益率等效、应税等价收益率，对比一般责任债（GO）与收益债（Revenue）的信用特征。

📌 说明：本工具基于简化模型实现，仅使用 Python 标准库。结果仅供学习参考，不构成投资建议或交易依据。

脚本API

taxable_equivalent_yield(tax_free_yield, federal_tax_rate, state_tax_rate=0.0, amt_applicable=False)

计算应税等价收益率（TEY）。 必填: tax_free_yield, federal_tax_rate

after_tax_yield(taxable_yield, federal_tax_rate, state_tax_rate=0.0)

计算应税债券的税后收益率。 必填: taxable_yield, federal_tax_rate

compare_taxable_vs_tax_free(taxable_yield, tax_free_yield, federal_tax_rate, state_tax_rate=0.0)

对比应税债券与免税债券。 必填: taxable_yield, tax_free_yield, federal_tax_rate

go_bond_credit_analysis(credit_metrics)

一般责任债（GO Bond）信用分析。 必填: credit_metrics

revenue_bond_credit_analysis(net_revenue, debt_service, operating_expenses, gross_revenue, reserve_balance=0)

收益债（Revenue Bond）信用分析。 必填: net_revenue, debt_service, operating_expenses, gross_revenue

analyze_municipal_bond(bond_type='GO', tax_free_yield=0.03, taxable_benchmark_yield=0.04, federal_tax_rate=0.37, state_tax_rate=0.05, credit_metrics=None, revenue_metrics=None)

统一市政债券分析接口。

调用示例

python scripts/main.py \
  --net-revenue <net_revenue> \
  --debt-service <debt_service> \
  --operating-expenses <operating_expenses> \
  --gross-revenue <gross_revenue> \
  --reserve-balance <reserve_balance>