Repository navigation
Conversation
Codecov Report❌ Patch coverage is
Additional details and impacted files@@ Coverage Diff @@
## master #1283 +/- ##
==========================================
- Coverage 79.81% 79.56% -0.25%
==========================================
Files 24 24
Lines 6811 6920 +109
==========================================
+ Hits 5436 5506 +70
- Misses 1375 1414 +39
Flags with carried forward coverage won't be shown. Click here to find out more.
🚀 New features to boost your workflow:
|
Adds fdc_tau (a cohort pension parameter, default 0), fdc_earn_cap, fdc_earn_cap_factor, and fdc_earn_floor_factor, and the functions that compute a household's funded defined contribution account over its life: contributions, balances earning r_p through the retirement period, a fair annuity-due priced on income-group mortality and the r_p path, end-of-period holdings, and the accrual derivatives. Not yet wired into the household problem or aggregates. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Nov 15, 2026
… accounts Remove fdc_earn_cap and fdc_earn_cap_factor. With pension_earn_cap true, FDC contributions are paid only on labor income up to dc_earn_cap_factor times avg_labor_inc_t1_model_units, the cap shared with the notional defined contribution system, under any pension_system. fdc_earn_floor_factor is now a cohort pension parameter entered and indexed like db_earn_cap_factor and dc_earn_cap_factor (a single value is value / e^(g_y t); regimes may change it by cohort), so the floor and the cap move together. fdc_earn_bands returns arrays by period and age, read down each cohort's diagonal. Specifications checks that the cap is at least the floor wherever fdc_tau is positive. Also resolves the leftover conflict markers in default_parameters.json from the upstream merge and moves the FDC changelog entries to an Unreleased section. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This is the first of four PRs that add a funded defined contribution (FDC) pension pillar to OG-Core. Contributions go into individual accounts that are invested at the household portfolio return
r_p. At retirement each balance buys an actuarially fair life annuity. Unlike the existing PAYG systems, the accounts are held by a fund outside the government budget, and its assets add to the domestic capital supply.This PR adds only the parameters and the account calculations. Nothing reads them yet, so model results are unchanged.
Design
pension_systemis selected, which allows combinations such as NDC plus a funded premium pension, and PAYG-to-funded reforms.fdc_tau = 0(the default) turns it off.fdc_tau× (labor income in the FDC band) in period t, at ages below the retirement age, out of period-t resources.r_p, the same timing as private savingsb. Each contribution therefore earns the return through the retirement period itself, one period more than the NDC crediting formula.r_ppath, so each group's annuity pool pays out exactly what it holds. A household already retired when the time path begins re-annuitizes its remaining balance.Parameters
fdc_tau(default0.0). This is a cohort pension parameter, added toCOHORT_PENSION_PARAMS, sopension_regimescan set it by birth cohort just liketau_p.pension_earn_captrue, contributions are paid only on labor income up todc_earn_cap_factor×avg_labor_inc_t1_model_units. This is the cap shared with the NDC system, and it applies under anypension_system. Withpension_earn_capfalse, there is no cap.fdc_earn_floor_factor(default[0.0]) sets the lower cutoff, for example to cover only the earnings above a DB band.db_earn_cap_factoranddc_earn_cap_factor. A single value is deflated by e^{-g_y t}, so it is fixed in real terms, andpension_regimescan change it by cohort.Specificationsraises an error if, withpension_earn_captrue, the cap is below the floor at any period and age wherefdc_tauis positive.Functions (
ogcore/pensions.py)fdc_lifetimeand its numba corefdc_lifetime_loopcompute one household's account over its life:fdc_sscomputes the steady-state accounts of every income group.fdc_annuity_factor_loop,fdc_earn_bands,fdc_mort_rates, and theFDCLifetimenamed tuple.Planned follow-up PRs
net_taxes), an accrual term inFOC_labor, pre-retirement holdings inBQ, fund assets F inget_K_splits(B + F, …), and outputs.r_ppath pricing, initial holdings from the baseline steady state, and re-pricing at t=0 of cohorts already annuitized.Tests
New tests in
tests/test_pensions.py:fdc_tau = 0, every account quantity is zero;fdc_tauset by cohort throughpension_regimes;tests/test_pensions.py,tests/test_parameters.py, andtests/test_household.pypass locally (non-localtests).🤖 Generated with Claude Code