frbus_shock: stacking warning only on monetary levers (trp_aerr periods=4 gives +2.37pp, not +1pp); poil_aerr labelled 'model units'

未关闭
#212 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 9 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
48/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
python
领域
api

调研方向

Start with integration/src/policyengine_macro/core.py, especially FRBUS_VARIABLES and the fallback near line 730; compare the lever unit strings with the period-stacking guidance in us-frb-model/VALIDATION.md. Check the hosted calls cited in the issue against the documented behavior, then update the affected lever descriptions and poil_aerr units. Done means the exposed levers accurately describe stacking and oil-price units; the optional exogenize mode is a broader follow-up.

由索引模型根据 Issue 内容生成。

描述

bug

What

frbus_shock warns that add-factors stack over periods only for the two monetary levers. Every other lever's units string is silent, and poil_aerr returns "units": "model units". us-frb-model/VALIDATION.md ("Period stacking") says: "Any wrapper exposing a periods argument must document this on every lever it exposes."

Evidence (hosted, us-frb-model@2508a2d, 6 Nov 2026)

Call Label returned What happened
frbus_shock(var="trp_aerr", shock=0.01, periods=4) "0.01 = a 1 percentage point rise in the effective personal tax rate" trp +6.6% → +15.5% of baseline by q4, i.e. +2.37pp, not +1pp. GDP −0.39% vs −0.115% for periods=1
frbus_shock(var="egfe_aerr", shock=0.01, periods=4) (per VALIDATION.md) "0.01 ~ a 1% higher level" level +2.90% by q4, not +1%
frbus_shock(var="poil_aerr", shock=10, periods=4) "model units" the units are $/bbl: +10 gives poil +15.4%. It does not stack (level equation)

Also: the validated sustained +1%-of-GDP purchases experiment (egfe exogenised, VALIDATION.md Test 4, yr-1 multiplier 0.725) cannot be reached through the hosted tool. The nearest call is a one-quarter impulse.

Fix

In integration/src/policyengine_macro/core.py (FRBUS_VARIABLES, ~l.392–450, fallback at l.730):

  1. Add the stacking sentence to egfe_aerr, egse_aerr, trp_aerr, trci_aerr, ecnia_aerr (and any other _aerr lever whose equation carries persistence). Better still, return the realised lever path (variables=[<lever>] by default), so callers see what they got.
  2. Give poil_aerr a real unit ("$/barrel add-error on the oil price level; +10 ≈ +15% at the 2026 LONGBASE price").
  3. Optional: an exogenize mode for egfe/trp, so the Test 4 experiment is reachable hosted.

🤖 Generated with Claude Code

主要语言
HTML
星标
3
派生
0
平均合并
8 天 15 小时
30 天内合并 PR
1

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

PolicyEngine/macro 的其他 Issue

查看 PolicyEngine/macro 的全部 Issue

相似的 Issue

更多 Backend & API Design Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。