| 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>
