Repository navigation
Funded defined contribution pillar, part 2: steady state - #1284
Conversation
Codecov Report❌ Patch coverage is
Additional details and impacted files@@ Coverage Diff @@
## master #1284 +/- ##
==========================================
+ Coverage 79.57% 79.83% +0.25%
==========================================
Files 24 24
Lines 6924 7028 +104
==========================================
+ Hits 5510 5611 +101
- Misses 1414 1417 +3
Flags with carried forward coverage won't be shown. Click here to find out more.
🚀 New features to boost your workflow:
|
Households pay FDC contributions and receive annuity benefits through
the budget constraint (outside net_taxes and the government budget).
FOC_labor values the annuity a contribution buys via
fdc_labor_wedge. Fund assets F (aggregates.get_F, in next-period
detrended units like b_{s+1}) add to domestic savings in
get_K_splits; pre-retirement balances of the deceased are bequeathed;
immigrants arrive with their age's FDC holdings per survivor. SS
output adds F and FDC profiles. run_TPI raises NotImplementedError
while fdc_tau > 0.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add pension contribution wedge to aggregate budget tracking
A cap of zero means the fund holds no reserve: the whole spread is paid to the government each period, or covered by a transfer from the government when the wedge is negative. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The reserve, its revenue to the government, and the government's transfer to it belong to the funded defined contribution fund only, so name them for it and keep them distinct from the pay-as-you-go pension variables: fdc_fund_reserves, fdc_fund_revenue, fdc_fund_transfer, aggregates.get_fdc_fund_reserves, and the parameter fdc_fund_reserve_max_GDPratio. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The fund keeps the spread between r_p and r_fdc as a reserve only on the time path until period tG1, when the whole balance is paid to the government (or a deficit covered by it); from then on the spread goes to the government budget each period. So the steady state holds no reserve: get_fdc_fund_reserves returns a zero reserve with the spread as FDC fund revenue (or a transfer from the government when negative). This removes the steady-state reserve between its floor and ceiling, whose sensitivity to r_p (about 50 times in testing_params) failed the steady-state resource constraint check on CI. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
@jdebacker. This PR looks good to me. I made one last change that I submitted as a PR to your branch. I updated two docstrings in One note that I think we should save for the Part 3 PR #1285 is to make sure to remove the |
Update docstrings in fiscal.py
Brings in the merged FDC_SS (PSLmodels#1284), Rick's fiscal.py docstring updates, and the uv.lock update. Resolves conflicts in ogcore/aggregates.py, tests/test_aggregates.py, and CHANGELOG.md by keeping the FDC_TPI versions, which contain the steady-state FDC fund reserve code from FDC_SS plus its time path. Updates the D_G_path docstring for the payout of the reserve at tG1. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Brings in upstream/master (with the merged FDC_SS, PSLmodels#1284) through FDC_TPI. Resolves the conflict in the get_G_ss and get_TR docstrings in ogcore/fiscal.py by keeping the upstream wording, with the payout at the end of tG1 - 1 and without the note that the time path is not yet implemented. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This PR is stacked on #1283 (FDC part 1), so its first commit is #1283's. Review only the second commit, "Solve the steady state with the funded defined contribution pillar", until #1283 merges.
This is part 2 of 4 for the funded defined contribution (FDC) pillar: the steady state. With
fdc_tau = 0(the default) every result is unchanged: the off path adds0.0to the existing terms, and the small-model steady state matches part 1 exactly.What changes when
fdc_tau > 0Household budget. Consumption is reduced by the contribution and increased by the annuity, through
household.fdc_net_flow. These flows stay out oftax.net_taxes, so they are neither government revenue nor outlays, and the tax outputs are unaffected.Labor FOC.
household.fdc_labor_wedgeadds two terms:Contributions are therefore not treated as a pure tax.
Capital market. Fund assets F (
aggregates.get_F) are aggregated likeget_B, in next-period detrended units like b_{s+1}. They add to domestic savings:get_K_splits(B + F, …).Bequests. Balances of members who die before retirement are bequeathed (added to
get_BQ). After retirement, the balances of those who die stay in the annuity pool.Immigrants arrive with the FDC holdings per survivor of their age, as they do with b. This is used in
get_Fand in the immigrant term ofget_I.New SS outputs:
F,fdc_contrib,fdc_benefits,fdc_holdings,agg_fdc_contrib,agg_fdc_benefits.Time path.
TPI.run_TPIraisesNotImplementedErrorwhile the pillar is on. Part 3 adds the time path.Checks (small model,
tests/testing_params.json)fdc_taufdc_tau = 0.10would be 0.4956 instead of 0.4970. The accrual offsets about half of the labor response.Simplifications to review
before_tax_incomeor in the incomefactorcalibration.K_dnow includes the fund's holdings.Status
tests/test_household.py,test_aggregates.py,test_pensions.py,test_parameters.py,test_tax.py(non-local).test_SS.pyandtest_TPI.py: everything passes except 5test_SS_fsolvecases. All 5 also fail on upstream master, which fails 6 of 7 of those cases in the same run.TPI.run_TPIraisesNotImplementedErrorwhile the pillar is on. Part 3 (Funded defined contribution pillar, part 3: transition path #1285) removes it.🤖 Generated with Claude Code