policyengine-us 1.425.6__py3-none-any.whl → 1.426.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/README.md +206 -1
  2. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/income/age_multiplier_over_threshold.yaml +11 -0
  3. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/income/age_threshold.yaml +9 -0
  4. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/{income.yaml → income/all.yaml} +1 -1
  5. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/income/base.yaml +11 -0
  6. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/substitution/age_multiplier_over_threshold.yaml +11 -0
  7. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/substitution/age_threshold.yaml +9 -0
  8. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/substitution/all.yaml +6 -0
  9. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/substitution/by_position_and_decile.yaml +71 -0
  10. policyengine_us/parameters/gov/states/ma/dta/tcap/gross_income/earned.yaml +2 -2
  11. policyengine_us/parameters/gov/states/ma/eec/ccfa/income/countable_income/sources.yaml +3 -3
  12. policyengine_us/tests/policy/baseline/gov/simulation/labor_supply_response/income_elasticity.yaml +12 -6
  13. policyengine_us/tests/policy/baseline/gov/simulation/labor_supply_response/integration.yaml +45 -0
  14. policyengine_us/tests/policy/baseline/gov/simulation/labor_supply_response/labor_supply_behavioral_response.yaml +2 -24
  15. policyengine_us/tests/policy/baseline/gov/simulation/labor_supply_response/substitution_elasticity.yaml +10 -35
  16. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/eaedc/dependent_care_deduction/ma_eaedc_dependent_care_deduction.yaml +13 -13
  17. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/eaedc/dependent_care_deduction/ma_eaedc_dependent_care_deduction_person.yaml +8 -8
  18. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/eaedc/ma_eaedc.yaml +2 -2
  19. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/tafdc/income/deductions/ma_tafdc_dependent_care_deduction_person.yaml +6 -6
  20. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/tafdc/income/earned/ma_tafdc_partially_disregarded_earned_income.yaml +7 -7
  21. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/tafdc/integration.yaml +14 -14
  22. policyengine_us/tests/policy/baseline/gov/states/ma/dta/tcap/tafdc/ma_tafdc.yaml +1 -1
  23. policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/copay/ma_ccfa_total_copay.yaml +4 -4
  24. policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/eligibility/ma_ccfa_activity_eligible.yaml +20 -20
  25. policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/ma_ccfa.yaml +7 -7
  26. policyengine_us/tests/policy/baseline/gov/usda/snap/eligibility/student/is_snap_ineligible_student.yaml +2 -2
  27. policyengine_us/tests/policy/baseline/gov/usda/snap/eligibility/work_requirements/meets_snap_abawd_work_requirements.yaml +17 -17
  28. policyengine_us/tests/policy/baseline/gov/usda/snap/eligibility/work_requirements/meets_snap_general_work_requirements.yaml +7 -7
  29. policyengine_us/tests/policy/baseline/gov/usda/snap/income/deductions/self_employment_income/integration.yaml +6 -6
  30. policyengine_us/tests/policy/baseline/gov/usda/snap/income/deductions/self_employment_income/snap_self_employment_expense_deduction.yaml +4 -4
  31. policyengine_us/tests/policy/baseline/gov/usda/snap/income/deductions/self_employment_income/snap_self_employment_income_after_expense_deduction.yaml +1 -1
  32. policyengine_us/tests/policy/baseline/gov/usda/snap/integration.yaml +1 -1
  33. policyengine_us/tests/policy/baseline/gov/usda/snap/snap.yaml +5 -5
  34. policyengine_us/variables/gov/simulation/labor_supply_response/income_elasticity.py +27 -1
  35. policyengine_us/variables/gov/simulation/labor_supply_response/substitution_elasticity.py +43 -18
  36. policyengine_us/variables/gov/states/ma/dta/tcap/eaedc/dependent_care_deduction/ma_eaedc_dependent_care_deduction_person.py +1 -1
  37. policyengine_us/variables/gov/states/ma/dta/tcap/tafdc/income/deductions/ma_tafdc_dependent_care_deduction_person.py +1 -1
  38. policyengine_us/variables/gov/states/ma/eec/ccfa/eligibility/ma_ccfa_activity_eligible.py +3 -1
  39. policyengine_us/variables/gov/usda/snap/eligibility/student/is_snap_ineligible_student.py +1 -1
  40. policyengine_us/variables/gov/usda/snap/eligibility/work_requirements/meets_snap_abawd_work_requirements.py +3 -1
  41. policyengine_us/variables/gov/usda/snap/eligibility/work_requirements/meets_snap_general_work_requirements.py +3 -1
  42. policyengine_us/variables/gov/usda/snap/income/deductions/self_employment/snap_self_employment_expense_deduction.py +1 -1
  43. policyengine_us/variables/gov/usda/snap/income/deductions/self_employment/snap_self_employment_income_after_expense_deduction.py +1 -1
  44. policyengine_us/variables/gov/usda/snap/income/deductions/snap_dependent_care_deduction.py +5 -1
  45. {policyengine_us-1.425.6.dist-info → policyengine_us-1.426.0.dist-info}/METADATA +1 -1
  46. {policyengine_us-1.425.6.dist-info → policyengine_us-1.426.0.dist-info}/RECORD +49 -42
  47. policyengine_us/parameters/gov/simulation/labor_supply_responses/elasticities/substitution.yaml +0 -70
  48. {policyengine_us-1.425.6.dist-info → policyengine_us-1.426.0.dist-info}/WHEEL +0 -0
  49. {policyengine_us-1.425.6.dist-info → policyengine_us-1.426.0.dist-info}/entry_points.txt +0 -0
  50. {policyengine_us-1.425.6.dist-info → policyengine_us-1.426.0.dist-info}/licenses/LICENSE +0 -0
@@ -1 +1,206 @@
1
- # Elasticities
1
+ # Labor Supply Response Elasticities
2
+
3
+ This directory contains parameters for labor supply response elasticities used in behavioral microsimulation analysis.
4
+
5
+ ## Overview
6
+
7
+ Labor supply elasticities measure how individuals adjust their work behavior in response to changes in economic incentives:
8
+
9
+ - **Substitution elasticity**: How labor supply responds to changes in the effective marginal wage rate (after-tax wage)
10
+ - **Income elasticity**: How labor supply responds to changes in disposable income
11
+
12
+ ## Age Heterogeneity: The Multiplier Approach
13
+
14
+ Both elasticity types support age-based heterogeneity through an **age multiplier** that scales base elasticities for individuals aged 65 and over. This approach is based on empirical research showing that older workers have higher labor supply elasticities than working-age adults.
15
+
16
+ ### Research Findings
17
+
18
+ - **French (2005)**: Elasticities 3.0x-3.25x higher for age 60 vs age 40 workers
19
+ - **CBO Working Papers (2012-12, 2012-13)**: Frisch elasticity ranges from 0.27 to 0.53 (central: 0.40) for working-age adults
20
+ - **General pattern**: Retirement-age individuals (62-70) have particularly high elasticities, especially on the extensive margin (whether to work at all)
21
+
22
+ ### Why a Multiplier Approach?
23
+
24
+ The multiplier approach was chosen over separate age-specific parameters because:
25
+ 1. **Evidence-based**: Literature consistently shows older workers are more elastic, but doesn't provide income-decile-specific multipliers
26
+ 2. **Parsimony**: 13 total parameters instead of 44 (11 base elasticities + 2 age multipliers)
27
+ 3. **Transparency**: Users can easily understand and adjust one multiplier value
28
+ 4. **Flexibility**: Multiplier can range from 1.0 (no age effect) to 3.0+ (French 2005 finding)
29
+
30
+ ## Substitution Elasticity Structure
31
+
32
+ The substitution elasticity uses a two-step calculation:
33
+
34
+ ### Step 1: Base Elasticity (by position and decile)
35
+
36
+ Base elasticities vary by:
37
+ 1. **Position**: primary earner vs secondary earner within tax unit
38
+ 2. **Decile**: 10 income deciles (for primary earners only)
39
+
40
+ This creates 11 base elasticity parameters:
41
+ - 10 for primary earners by decile
42
+ - 1 for secondary earners (all deciles)
43
+
44
+ ### Step 2: Age Multiplier
45
+
46
+ For individuals aged 65 and over, the base elasticity is multiplied by `age_multiplier_65_and_over`.
47
+
48
+ **Formula**:
49
+ - If age < 65: `elasticity = base_elasticity`
50
+ - If age >= 65: `elasticity = base_elasticity × age_multiplier_65_and_over`
51
+
52
+ ### Global Override
53
+
54
+ The `all` parameter overrides all base elasticities and age multipliers if set to non-zero.
55
+
56
+ ## Income Elasticity Structure
57
+
58
+ The income elasticity uses a simpler two-parameter structure:
59
+
60
+ 1. **Base elasticity**: Applied to all working-age individuals (under 65)
61
+ 2. **Age multiplier**: Applied to individuals 65 and over
62
+
63
+ **Formula**:
64
+ - If age < 65: `elasticity = base`
65
+ - If age >= 65: `elasticity = base × age_multiplier_65_and_over`
66
+
67
+ The `all` parameter overrides base and multiplier if set to non-zero.
68
+
69
+ ## Default Values
70
+
71
+ - All base elasticities default to 0 (no behavioral response)
72
+ - Age multipliers default to 2.0 (conservative estimate based on literature)
73
+ - Users must explicitly set base elasticity values to enable behavioral responses
74
+
75
+ ## Usage Examples
76
+
77
+ ### Example 1: No behavioral response (default)
78
+ ```yaml
79
+ substitution:
80
+ by_position_and_decile:
81
+ primary:
82
+ 1: 0
83
+ 2: 0
84
+ # ... all zeros
85
+ secondary: 0
86
+ age_multiplier_65_and_over: 2.0 # Doesn't matter since base is 0
87
+
88
+ income:
89
+ base: 0
90
+ age_multiplier_65_and_over: 2.0 # Doesn't matter since base is 0
91
+ ```
92
+
93
+ Result: Everyone has zero elasticity regardless of age.
94
+
95
+ ### Example 2: Same elasticity for all ages
96
+ ```yaml
97
+ substitution:
98
+ by_position_and_decile:
99
+ primary:
100
+ 1: 0.31 # CBO-style values
101
+ 2: 0.27
102
+ # ... other deciles
103
+ secondary: 0.40
104
+ age_multiplier_65_and_over: 1.0 # No age effect
105
+
106
+ income:
107
+ base: -0.04
108
+ age_multiplier_65_and_over: 1.0 # No age effect
109
+ ```
110
+
111
+ Result: Same elasticity for everyone regardless of age.
112
+
113
+ ### Example 3: Higher elasticity for elderly (RECOMMENDED)
114
+ ```yaml
115
+ substitution:
116
+ by_position_and_decile:
117
+ primary:
118
+ 1: 0.31
119
+ 2: 0.27
120
+ # ... other deciles
121
+ secondary: 0.40
122
+ age_multiplier_65_and_over: 2.0 # Conservative estimate
123
+
124
+ income:
125
+ base: -0.04
126
+ age_multiplier_65_and_over: 2.0
127
+ ```
128
+
129
+ Result:
130
+ - Age 40, primary earner, decile 1: elasticity = 0.31
131
+ - Age 70, primary earner, decile 1: elasticity = 0.31 × 2.0 = 0.62
132
+ - Age 40: income elasticity = -0.04
133
+ - Age 70: income elasticity = -0.04 × 2.0 = -0.08
134
+
135
+ ### Example 4: Aggressive multiplier based on French (2005)
136
+ ```yaml
137
+ substitution:
138
+ age_multiplier_65_and_over: 3.0 # Upper end of literature
139
+
140
+ income:
141
+ base: -0.04
142
+ age_multiplier_65_and_over: 3.0
143
+ ```
144
+
145
+ Result:
146
+ - Age 70, primary earner, decile 1 (base 0.31): elasticity = 0.31 × 3.0 = 0.93
147
+ - Age 70: income elasticity = -0.04 × 3.0 = -0.12
148
+
149
+ ## Multiplier Value Guidance
150
+
151
+ Based on literature review (see `age_heterogeneity_analysis.md`):
152
+
153
+ | Multiplier | Interpretation | Source |
154
+ |------------|----------------|--------|
155
+ | 1.0 | No age difference | Ignores evidence |
156
+ | 1.5 | Conservative | Lower end of estimates |
157
+ | 2.0 | **Recommended default** | Conservative but evidence-based |
158
+ | 2.5 | Moderate | Midpoint of French (2005) range |
159
+ | 3.0 | Aggressive | French (2005) finding for age 60 vs 40 |
160
+ | 3.25 | Upper bound | Upper end of French (2005) range |
161
+
162
+ **Note**: The exact multiplier value has uncertainty. We recommend starting with 2.0 and conducting sensitivity analysis with values in the 1.5-3.0 range.
163
+
164
+ ## References
165
+
166
+ - [French (2005): "The Effects of Health, Wealth, and Wages on Labour Supply and Retirement Behaviour"](https://academic.oup.com/restud/article-abstract/72/2/395/1558553) - Review of Economic Studies 72(2): 395-427
167
+ - [CBO Working Paper 2012-12: "A Review of Recent Research on Labor Supply Elasticities"](https://www.cbo.gov/publication/43675) - McClelland & Mok
168
+ - [CBO Working Paper 2012-13: "Review of Estimates of the Frisch Elasticity of Labor Supply"](https://www.cbo.gov/publication/43676) - Reichling & Whalen
169
+
170
+ ## Implementation Notes
171
+
172
+ - Age is determined from the `age` variable for the year (`period.this_year`)
173
+ - Age 65 is the cutoff: age < 65 uses base elasticity, age >= 65 applies multiplier
174
+ - Primary earner is defined as the highest earner within the tax unit
175
+ - Earnings deciles are determined using hardcoded markers (TODO: parametrize)
176
+ - Negative total earnings result in zero elasticity (using `max_(earnings, 0)`)
177
+ - Zero base elasticity remains zero even with multiplier (0 × multiplier = 0)
178
+
179
+ ## Technical Details
180
+
181
+ ### How Primary/Secondary Earner is Determined
182
+
183
+ Within each tax unit, the person with the highest total earnings (employment + self-employment) is designated as the primary earner. All other earners in the unit are secondary earners. This means:
184
+ - Single-person tax units: That person is always primary
185
+ - Multi-person tax units: Only the highest earner gets primary elasticity; others get zero (since secondary earner base elasticities default to 0)
186
+
187
+ ### Earnings Decile Markers
188
+
189
+ Current hardcoded decile boundaries (TODO: parametrize):
190
+ - Decile 1: $0 - $14,000
191
+ - Decile 2: $14,000 - $28,000
192
+ - Decile 3: $28,000 - $39,000
193
+ - Decile 4: $39,000 - $50,000
194
+ - Decile 5: $50,000 - $61,000
195
+ - Decile 6: $61,000 - $76,000
196
+ - Decile 7: $76,000 - $97,000
197
+ - Decile 8: $97,000 - $138,000
198
+ - Decile 9: $138,000 - $1,726,000
199
+ - Decile 10: $1,726,000+
200
+
201
+ ### Negative Earnings Handling
202
+
203
+ To prevent negative earnings from causing sign flips in economic responses, the code applies `max_(earnings, 0)` before calculating elasticities. This means:
204
+ - Positive net earnings: Normal elasticity calculation
205
+ - Negative net earnings: Treated as zero earnings, resulting in zero substitution elasticity
206
+ - Income elasticity still applies to individuals with negative earnings
@@ -0,0 +1,11 @@
1
+ description: Multiplier applied to base income elasticity for individuals at or above the age threshold. Research suggests income effects are stronger for older workers. French (2005) shows much higher elasticities near retirement age. A multiplier of 2.0 is conservative. Set to 1.0 for no age difference.
2
+ values:
3
+ 2020-01-01: 2.0
4
+ metadata:
5
+ unit: /1
6
+ label: elasticity multiplier for ages at or above threshold
7
+ reference:
8
+ - title: "French (2005): The Effects of Health, Wealth, and Wages on Labour Supply and Retirement Behaviour"
9
+ href: https://academic.oup.com/restud/article-abstract/72/2/395/1558553
10
+ - title: "CBO Working Paper 2012-12: A Review of Recent Research on Labor Supply Elasticities"
11
+ href: https://www.cbo.gov/publication/43675
@@ -0,0 +1,9 @@
1
+ description: Age at which the age multiplier begins to apply. Individuals at this age or older will have their base elasticity multiplied by the age multiplier. Default is 65 (typical retirement age), but can be adjusted to reflect different retirement patterns or policy scenarios (e.g., 62 for early retirement, 67 for full retirement age).
2
+ values:
3
+ 2020-01-01: 65
4
+ metadata:
5
+ unit: year
6
+ label: age threshold for elasticity multiplier
7
+ reference:
8
+ - title: "French (2005): The Effects of Health, Wealth, and Wages on Labour Supply and Retirement Behaviour"
9
+ href: https://academic.oup.com/restud/article-abstract/72/2/395/1558553
@@ -1,4 +1,4 @@
1
- description: Percent change (of the change in disposable income) in labor supply given a 1% change in disposable income.
1
+ description: Percent change (of the change in disposable income) in labor supply given a 1% change in disposable income. This parameter overrides the base income elasticity and age multiplier if provided.
2
2
  values:
3
3
  2020-01-01: 0
4
4
  metadata:
@@ -0,0 +1,11 @@
1
+ description: Base income elasticity of labor supply for working-age individuals (under 65). This value is multiplied by the age multiplier for individuals 65 and over. Typically negative, indicating that higher income reduces labor supply.
2
+ values:
3
+ 2020-01-01: 0
4
+ metadata:
5
+ unit: /1
6
+ label: base income elasticity below threshold
7
+ reference:
8
+ - title: "CBO Working Paper 2012-12: A Review of Recent Research on Labor Supply Elasticities"
9
+ href: https://www.cbo.gov/publication/43675
10
+ - title: "CBO Working Paper 2012-13: Review of Estimates of the Frisch Elasticity of Labor Supply"
11
+ href: https://www.cbo.gov/publication/43676
@@ -0,0 +1,11 @@
1
+ description: Multiplier applied to all substitution elasticities for individuals at or above the age threshold. Research shows older workers have higher labor supply elasticities than working-age adults. French (2005) finds elasticities 3x higher for age 60 vs age 40. A multiplier of 2.0 is conservative. Set to 1.0 for no age difference.
2
+ values:
3
+ 2020-01-01: 2.0
4
+ metadata:
5
+ unit: /1
6
+ label: elasticity multiplier for ages at or above threshold
7
+ reference:
8
+ - title: "French (2005): The Effects of Health, Wealth, and Wages on Labour Supply and Retirement Behaviour"
9
+ href: https://academic.oup.com/restud/article-abstract/72/2/395/1558553
10
+ - title: "CBO Working Paper 2012-12: A Review of Recent Research on Labor Supply Elasticities"
11
+ href: https://www.cbo.gov/publication/43675
@@ -0,0 +1,9 @@
1
+ description: Age at which the age multiplier begins to apply. Individuals at this age or older will have their base elasticity multiplied by the age multiplier. Default is 65 (typical retirement age), but can be adjusted to reflect different retirement patterns or policy scenarios (e.g., 62 for early retirement, 67 for full retirement age).
2
+ values:
3
+ 2020-01-01: 65
4
+ metadata:
5
+ unit: year
6
+ label: age threshold for elasticity multiplier
7
+ reference:
8
+ - title: "French (2005): The Effects of Health, Wealth, and Wages on Labour Supply and Retirement Behaviour"
9
+ href: https://academic.oup.com/restud/article-abstract/72/2/395/1558553
@@ -0,0 +1,6 @@
1
+ description: Percent change (of the change in the effective marginal wage) in labor supply given a 1% change in the effective marginal wage. This parameter overrides all other substitution elasticities if provided.
2
+ values:
3
+ 2020-01-01: 0
4
+ metadata:
5
+ unit: /1
6
+ label: substitution elasticity of labor supply
@@ -0,0 +1,71 @@
1
+ metadata:
2
+ label: by position and decile
3
+ unit: /1
4
+ propagate_metadata_to_children: true
5
+ reference:
6
+ - title: "CBO Working Paper 2012-12: A Review of Recent Research on Labor Supply Elasticities"
7
+ href: https://www.cbo.gov/publication/43675
8
+ - title: "CBO Working Paper 2012-13: Review of Estimates of the Frisch Elasticity of Labor Supply"
9
+ href: https://www.cbo.gov/publication/43676
10
+ - title: "French (2005): The Effects of Health, Wealth, and Wages on Labour Supply and Retirement Behaviour"
11
+ href: https://academic.oup.com/restud/article-abstract/72/2/395/1558553
12
+ primary:
13
+ metadata:
14
+ label: primary adult
15
+ description: The highest earner within the tax unit. Elasticity varies by earnings decile.
16
+ 1:
17
+ metadata:
18
+ label: primary adult, 1st decile substitution elasticity
19
+ values:
20
+ 2020-01-01: 0
21
+ 2:
22
+ metadata:
23
+ label: primary adult, 2nd decile substitution elasticity
24
+ values:
25
+ 2020-01-01: 0
26
+ 3:
27
+ metadata:
28
+ label: primary adult, 3rd decile substitution elasticity
29
+ values:
30
+ 2020-01-01: 0
31
+ 4:
32
+ metadata:
33
+ label: primary adult, 4th decile substitution elasticity
34
+ values:
35
+ 2020-01-01: 0
36
+ 5:
37
+ metadata:
38
+ label: primary adult, 5th decile substiticity
39
+ values:
40
+ 2020-01-01: 0
41
+ 6:
42
+ metadata:
43
+ label: primary adult, 6th decile substitution elasticity
44
+ values:
45
+ 2020-01-01: 0
46
+ 7:
47
+ metadata:
48
+ label: primary adult, 7th decile substitution elasticity
49
+ values:
50
+ 2020-01-01: 0
51
+ 8:
52
+ metadata:
53
+ label: primary adult, 8th decile substitution elasticity
54
+ values:
55
+ 2020-01-01: 0
56
+ 9:
57
+ metadata:
58
+ label: primary adult, 9th decile substitution elasticity
59
+ values:
60
+ 2020-01-01: 0
61
+ 10:
62
+ metadata:
63
+ label: primary adult, 10th decile substitution elasticity
64
+ values:
65
+ 2020-01-01: 0
66
+ secondary:
67
+ metadata:
68
+ label: secondary adult, all deciles substitution elasticity
69
+ description: Any earner in the tax unit who is not the primary (highest) earner.
70
+ values:
71
+ 2020-01-01: 0
@@ -1,8 +1,8 @@
1
1
  description: Massachusetts counts the following income sources as earned income under the Transitional Cash Assistance Program.
2
2
  values:
3
3
  2021-01-01:
4
- - employment_income
5
- - self_employment_income
4
+ - employment_income_before_lsr
5
+ - self_employment_income_before_lsr
6
6
 
7
7
  metadata:
8
8
  unit: list
@@ -1,10 +1,10 @@
1
1
  description: Massachusetts counts these income sources as countable income under the Child Care Financial Assistance program.
2
2
  values:
3
3
  2020-01-01:
4
- - employment_income
5
- - self_employment_income
4
+ - employment_income_before_lsr
5
+ - self_employment_income_before_lsr
6
6
  - dividend_income
7
- - interest_income
7
+ - interest_income
8
8
  - rental_income
9
9
  - pension_income
10
10
  - veterans_benefits
@@ -1,13 +1,19 @@
1
- - name: Default income elasticity is zero
1
+ - name: Income elasticity for person under 65 uses base
2
2
  period: 2023
3
3
  input:
4
- gov.simulation.labor_supply_responses.elasticities.income: 0
4
+ age: 50
5
+ gov.simulation.labor_supply_responses.elasticities.income.all: 0
6
+ gov.simulation.labor_supply_responses.elasticities.income.base: -0.04
7
+ gov.simulation.labor_supply_responses.elasticities.income.age_multiplier_over_threshold: 2.0
5
8
  output:
6
- income_elasticity: 0
9
+ income_elasticity: -0.04
7
10
 
8
- - name: Custom income elasticity value
11
+ - name: Income elasticity for person 65+ applies multiplier
9
12
  period: 2023
10
13
  input:
11
- gov.simulation.labor_supply_responses.elasticities.income: -0.2
14
+ age: 70
15
+ gov.simulation.labor_supply_responses.elasticities.income.all: 0
16
+ gov.simulation.labor_supply_responses.elasticities.income.base: -0.04
17
+ gov.simulation.labor_supply_responses.elasticities.income.age_multiplier_over_threshold: 2.0
12
18
  output:
13
- income_elasticity: -0.2
19
+ income_elasticity: -0.08
@@ -0,0 +1,45 @@
1
+ - name: Couple with different ages (under 65 and 65+) with multiplier approach
2
+ period: 2023
3
+ input:
4
+ people:
5
+ person1:
6
+ age: 67
7
+ employment_income_before_lsr: 60_000
8
+ self_employment_income_before_lsr: 0
9
+ person2:
10
+ age: 55
11
+ employment_income_before_lsr: 40_000
12
+ self_employment_income_before_lsr: 0
13
+ tax_units:
14
+ tax_unit:
15
+ members: [person1, person2]
16
+ gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
17
+ gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.5: 0.20
18
+ gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.secondary: 0.30
19
+ gov.simulation.labor_supply_responses.elasticities.substitution.age_multiplier_over_threshold: 2.0
20
+ gov.simulation.labor_supply_responses.elasticities.income.all: 0
21
+ gov.simulation.labor_supply_responses.elasticities.income.base: -0.04
22
+ gov.simulation.labor_supply_responses.elasticities.income.age_multiplier_over_threshold: 2.0
23
+ output:
24
+ substitution_elasticity:
25
+ - 0.40 # person1: 67 years old, primary earner (60k), decile 5 (50k-61k), base 0.20 × multiplier 2.0 = 0.40
26
+ - 0 # person2: 55 years old, secondary earner, gets 0 since not primary
27
+ income_elasticity:
28
+ - -0.08 # person1: 67 years old, base -0.04 × multiplier 2.0 = -0.08
29
+ - -0.04 # person2: 55 years old, base -0.04 (no multiplier)
30
+
31
+ - name: Person with negative net earnings has zero substitution elasticity
32
+ period: 2023
33
+ input:
34
+ age: 66
35
+ employment_income_before_lsr: 25_000
36
+ self_employment_income_before_lsr: -30_000
37
+ gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
38
+ gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.1: 0.25
39
+ gov.simulation.labor_supply_responses.elasticities.substitution.age_multiplier_over_threshold: 2.0
40
+ gov.simulation.labor_supply_responses.elasticities.income.all: 0
41
+ gov.simulation.labor_supply_responses.elasticities.income.base: -0.04
42
+ gov.simulation.labor_supply_responses.elasticities.income.age_multiplier_over_threshold: 2.25
43
+ output:
44
+ substitution_elasticity: 0 # Negative net earnings (-5k) treated as 0, resulting in zero elasticity
45
+ income_elasticity: -0.09 # Income elasticity still applies: -0.04 × 2.25 = -0.09
@@ -1,31 +1,9 @@
1
- - name: No elasticities means no response
2
- period: 2023
3
- input:
4
- employment_income_before_lsr: 50_000
5
- self_employment_income_before_lsr: 10_000
6
- gov.simulation.labor_supply_responses.elasticities.income: 0
7
- gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
8
- output:
9
- labor_supply_behavioral_response: 0
10
-
11
- - name: Zero income and substitution elasticities
12
- period: 2023
13
- input:
14
- employment_income_before_lsr: 50_000
15
- self_employment_income_before_lsr: 10_000
16
- income_elasticity_lsr: 0
17
- substitution_elasticity_lsr: 0
18
- gov.simulation.labor_supply_responses.elasticities.income: 0
19
- gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
20
- output:
21
- labor_supply_behavioral_response: 0
22
-
23
1
  - name: Negative total earnings with elasticities off
24
2
  period: 2023
25
3
  input:
26
4
  employment_income_before_lsr: 30_000
27
5
  self_employment_income_before_lsr: -40_000 # Net negative earnings
28
- gov.simulation.labor_supply_responses.elasticities.income: 0
6
+ gov.simulation.labor_supply_responses.elasticities.income.all: 0
29
7
  gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
30
8
  output:
31
9
  labor_supply_behavioral_response: 0
@@ -35,7 +13,7 @@
35
13
  input:
36
14
  employment_income_before_lsr: 50_000
37
15
  self_employment_income_before_lsr: -10_000 # Net positive earnings = 40_000
38
- gov.simulation.labor_supply_responses.elasticities.income: 0
16
+ gov.simulation.labor_supply_responses.elasticities.income.all: 0
39
17
  gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
40
18
  output:
41
19
  labor_supply_behavioral_response: 0
@@ -1,48 +1,23 @@
1
- - name: Default substitution elasticity is zero
1
+ - name: Primary earner under 65 in decile 5 with base elasticity
2
2
  period: 2023
3
3
  input:
4
+ age: 50
4
5
  employment_income_before_lsr: 50_000
5
6
  self_employment_income_before_lsr: 0
6
7
  gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
8
+ gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.5: 0.15
9
+ gov.simulation.labor_supply_responses.elasticities.substitution.age_multiplier_over_threshold: 2.0
7
10
  output:
8
- substitution_elasticity: 0
11
+ substitution_elasticity: 0.15
9
12
 
10
- - name: Global substitution elasticity override
13
+ - name: Primary earner 65+ in decile 5 with multiplier effect
11
14
  period: 2023
12
15
  input:
16
+ age: 70
13
17
  employment_income_before_lsr: 50_000
14
18
  self_employment_income_before_lsr: 0
15
- gov.simulation.labor_supply_responses.elasticities.substitution.all: 0.25
16
- output:
17
- substitution_elasticity: 0.25
18
-
19
- - name: Primary earner in decile 1 with default parameters
20
- period: 2023
21
- input:
22
- employment_income_before_lsr: 10_000
23
- self_employment_income_before_lsr: 0
24
19
  gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
25
- gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.1: 0.1
26
- gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.secondary: 0.2
20
+ gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.5: 0.15
21
+ gov.simulation.labor_supply_responses.elasticities.substitution.age_multiplier_over_threshold: 2.0
27
22
  output:
28
- substitution_elasticity: 0 # TODO: Debug why single person isn't getting primary earner elasticity
29
-
30
- - name: Negative total earnings should have zero elasticity
31
- period: 2023
32
- input:
33
- employment_income_before_lsr: 50_000
34
- self_employment_income_before_lsr: -60_000 # Net negative earnings
35
- gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
36
- gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.1: 0.2
37
- output:
38
- substitution_elasticity: 0 # max_(earnings, 0) = 0, so elasticity = 0
39
-
40
- - name: Positive net earnings after self-employment loss
41
- period: 2023
42
- input:
43
- employment_income_before_lsr: 50_000
44
- self_employment_income_before_lsr: -5_000 # Net positive earnings = 45_000
45
- gov.simulation.labor_supply_responses.elasticities.substitution.all: 0
46
- gov.simulation.labor_supply_responses.elasticities.substitution.by_position_and_decile.primary.5: 0.15 # 45k falls in decile 5
47
- output:
48
- substitution_elasticity: 0.15
23
+ substitution_elasticity: 0.30
@@ -1,17 +1,17 @@
1
- - name: Case 1, one child age of 5.
1
+ - name: Case 1, one child age of 5.
2
2
  period: 2022
3
3
  input:
4
4
  people:
5
5
  person1:
6
6
  age: 35
7
- is_tax_unit_dependent: false
8
- weekly_hours_worked: 40
7
+ is_tax_unit_dependent: false
8
+ weekly_hours_worked_before_lsr: 40
9
9
  ma_eaedc_eligible_dependent: false
10
10
  person2:
11
11
  age: 5
12
12
  is_tax_unit_dependent: true
13
13
  pre_subsidy_childcare_expenses: 3_600
14
- weekly_hours_worked: 0
14
+ weekly_hours_worked_before_lsr: 0
15
15
  ma_eaedc_eligible_dependent: true
16
16
  spm_units:
17
17
  spm_unit:
@@ -33,13 +33,13 @@
33
33
  person1:
34
34
  age: 35
35
35
  is_tax_unit_dependent: false
36
- weekly_hours_worked: 40
36
+ weekly_hours_worked_before_lsr: 40
37
37
  ma_eaedc_eligible_dependent: false
38
38
  person2:
39
39
  age: 1
40
40
  is_tax_unit_dependent: true
41
41
  pre_subsidy_childcare_expenses: 2_040
42
- weekly_hours_worked: 0
42
+ weekly_hours_worked_before_lsr: 0
43
43
  ma_eaedc_eligible_dependent: true
44
44
  spm_units:
45
45
  spm_unit:
@@ -60,20 +60,20 @@
60
60
  people:
61
61
  person1:
62
62
  age: 35
63
- is_tax_unit_dependent: false
64
- weekly_hours_worked: 40
63
+ is_tax_unit_dependent: false
64
+ weekly_hours_worked_before_lsr: 40
65
65
  ma_eaedc_eligible_dependent: false
66
66
  person2:
67
67
  age: 1
68
68
  is_tax_unit_dependent: true
69
69
  pre_subsidy_childcare_expenses: 2_040
70
- weekly_hours_worked: 0
70
+ weekly_hours_worked_before_lsr: 0
71
71
  ma_eaedc_eligible_dependent: true
72
72
  person3:
73
73
  age: 5
74
74
  is_tax_unit_dependent: true
75
75
  pre_subsidy_childcare_expenses: 2_760
76
- weekly_hours_worked: 0
76
+ weekly_hours_worked_before_lsr: 0
77
77
  ma_eaedc_eligible_dependent: true
78
78
  spm_units:
79
79
  spm_unit:
@@ -94,14 +94,14 @@
94
94
  people:
95
95
  person1:
96
96
  age: 35
97
- is_tax_unit_dependent: false
98
- weekly_hours_worked: 25
97
+ is_tax_unit_dependent: false
98
+ weekly_hours_worked_before_lsr: 25
99
99
  ma_eaedc_eligible_dependent: false
100
100
  person2:
101
101
  age: 2
102
102
  is_tax_unit_dependent: true
103
103
  pre_subsidy_childcare_expenses: 3_600
104
- weekly_hours_worked: 0
104
+ weekly_hours_worked_before_lsr: 0
105
105
  ma_eaedc_eligible_dependent: true
106
106
  spm_units:
107
107
  spm_unit: