Add Census money income and align the CBO income measures with CBO's definitions

changelog.d/census-money-income.added.md

@@ -0,0 +1 @@
+Add Census Bureau money income for people, families and households (census_money_income, census_family_money_income and census_household_money_income), built from one list for each of the 18 sources in Current Population Reports P60-200, Appendix A, and counting retirement account distributions from age 58, as the Current Population Survey has since the redesigned processing system it introduced in 2019, which covers 2018 income.

changelog.d/census-money-income.fixed.md

@@ -0,0 +1 @@
+Align the CBO household income measures with CBO's published definitions: count Medicare net of Part A and Part B premiums, subtract the premium tax credit from federal taxes, count corporate income tax in market income as well as in taxes, add railroad retirement, survivor benefits, child support and financial assistance to market income, and count WIC, the Medicare Savings Programs, state SSI supplements and state cash assistance as means-tested transfers.

policyengine_us/parameters/gov/household/cbo_federal_tax_subtractions.yaml

@@ -0,0 +1,14 @@
+description: Refundable credits that CBO household federal taxes subtract beyond those in income_tax.
+values:
+  0000-01-01:
+    # CBO's individual income taxes include the premium tax credit, which
+    # income_tax leaves out.
+    - assigned_aca_ptc
+
+metadata:
+  unit: list
+  period: year
+  label: CBO federal tax subtractions
+  reference:
+    - title: Congressional Budget Office, The Distribution of Household Income in 2021, Appendix D (individual income taxes include premium tax credits)
+      href: https://www.cbo.gov/system/files/2024-09/60341-income.pdf#page=42

policyengine_us/parameters/gov/household/cbo_federal_taxes.yaml

@@ -16,3 +16,6 @@ metadata:
   unit: list
   period: year
   label: Modeled CBO federal taxes
+  reference:
+    - title: "Congressional Budget Office, The Distribution of Household Income in 2021, Appendix D (federal taxes: individual income, payroll, corporate income and excise taxes) #page 41-42"
+      href: https://www.cbo.gov/system/files/2024-09/60341-income.pdf#page=41

policyengine_us/parameters/gov/household/cbo_market_income_additions.yaml

@@ -1,12 +1,36 @@
 description: Additional components included in CBO household market income.
 values:
   0000-01-01:
+    # Labor income: employer-paid health insurance premiums and the
+    # employer's share of payroll taxes.
     - employer_sponsored_insurance_premiums
     - employer_social_security_tax
     - employer_medicare_tax
     - employer_federal_unemployment_tax
+    # Labor and capital income include the shares of corporate income taxes
+    # that workers and capital owners bear.
+    - cbo_corporate_income_tax
+    # Other income sources: income received in retirement for past services.
+    # The Current Population Survey records railroad retirement as retirement
+    # income. Survivor benefits are survivors' pensions and annuities and
+    # payments from estates and trusts.
+    - railroad_benefits
+    - survivor_benefits
+    # Other income sources: other nongovernmental sources of income, which
+    # CBO draws from the Current Population Survey. educational_assistance
+    # stays out: it holds Pell Grants and other government aid beside
+    # private scholarships, and the model does not split them.
+    - child_support_received
+    - financial_assistance
 
 metadata:
   unit: list
   period: year
   label: Modeled CBO market income additions
+  reference:
+    - title: Congressional Budget Office, The Distribution of Household Income in 2021, Appendix D (market income)
+      href: https://www.cbo.gov/system/files/2024-09/60341-income.pdf#page=41
+    - title: Congressional Budget Office, Working Paper 2017-09, Measuring Income (income that appears only in the Current Population Survey)
+      href: https://www.cbo.gov/system/files/115th-congress-2017-2018/workingpaper/53345-workingpaper.pdf#page=37
+    - title: IPUMS CPS, INCSS (railroad retirement payments counted as retirement income since 1980)
+      href: https://cps.ipums.org/cps-action/variables/INCSS

policyengine_us/parameters/gov/household/cbo_market_income_subtractions.yaml

@@ -8,3 +8,6 @@ metadata:
   unit: list
   period: year
   label: CBO market income subtractions
+  reference:
+    - title: Congressional Budget Office, The Distribution of Household Income in 2021, Appendix D (market income counts other nongovernmental sources of income)
+      href: https://www.cbo.gov/system/files/2024-09/60341-income.pdf#page=41

policyengine_us/parameters/gov/household/cbo_means_tested_transfers.yaml

@@ -1,4 +1,6 @@
 description: Means-tested transfers included in CBO household income after transfers and taxes.
+# CBO also counts low-income subsidies for Medicare Part D and the
+# Affordable Care Act's cost-sharing subsidies, which the model does not value.
 values:
   0000-01-01:
     - medicaid
@@ -11,11 +13,79 @@ values:
     - reduced_price_school_meals
     - spm_unit_energy_subsidy
     - general_assistance
+    # CBO names child nutrition programs without listing them. WIC is section
+    # 17 of the Child Nutrition Act of 1966 (42 U.S.C. 1786, in the Child
+    # Nutrition chapter of Title 42), so this list counts it there.
+    - wic
+    # Medicaid pays Medicare premiums and cost sharing for Medicare
+    # Savings Program enrollees (42 U.S.C. 1396a(a)(10)(E)).
+    - msp_cost
+    # State supplements to Supplemental Security Income.
+    - al_ssp
+    - ak_ssp
+    - ca_state_supplement
+    - ca_capi
+    - co_state_supplement
+    - ct_ssp
+    - de_ssp
+    - dc_ossp
+    - fl_oss
+    - ga_ssp
+    - hi_oss
+    - id_aabd
+    - in_ssp
+    - ia_ssa
+    - ks_sspp
+    - ky_ssp
+    - la_oss
+    - me_ssp
+    - md_paa
+    - ma_state_supplement
+    - mi_ssp
+    - mn_msa
+    - mo_ssp
+    - mt_ssp
+    - ne_aabd
+    - nv_oss
+    - nh_ssp
+    - nj_ssp
+    - nm_ssi_state_supplement
+    - ny_ssp
+    - nc_sa
+    - oh_rss
+    - ok_ssp
+    - or_ssp
+    - pa_ssp
+    - ri_ssp
+    - sc_ssi_state_supplement
+    - sd_ssp
+    - tx_ssi_state_supplement
+    - ut_ssp
+    - vt_aabd
+    - va_ag
+    - wa_ssp
+    - wi_ssp
+    - wy_ssp
+    # State and local cash assistance: Colorado Old Age Pension,
+    # Massachusetts Emergency Aid to the Elderly, Disabled and Children,
+    # and Washington State Family Assistance and Refugee Cash Assistance.
+    - co_oap
+    - ma_eaedc
+    - wa_sfa
+    - wa_rca
 
 metadata:
   unit: list
   period: year
   label: CBO means-tested transfers
   reference:
-    - title: Congressional Budget Office, Reconciling the Official Poverty Measure and CBO’s Distributional Analysis of Household Income, Including In-Kind Transfers
+    - title: Congressional Budget Office, The Distribution of Household Income in 2021, Appendix D (means-tested transfers)
+      href: https://www.cbo.gov/system/files/2024-09/60341-income.pdf#page=41
+    - title: Congressional Budget Office, The Distribution of Household Income, 2022 (other transfers)
+      href: https://www.cbo.gov/publication/61911
+    - title: Congressional Budget Office, Reconciling the Official Poverty Measure and CBO's Distributional Analysis of Household Income, Including In-Kind Transfers
       href: https://www.cbo.gov/publication/61157
+    - title: 42 U.S. Code § 1786 - Special supplemental nutrition program for women, infants, and children
+      href: https://www.law.cornell.edu/uscode/text/42/1786
+    - title: 42 U.S. Code § 1396a(a)(10)(E) - Medicare cost-sharing for qualified Medicare beneficiaries
+      href: https://www.law.cornell.edu/uscode/text/42/1396a#a_10_E

policyengine_us/parameters/gov/household/cbo_social_insurance_benefits.yaml

@@ -2,11 +2,19 @@ description: Social insurance benefits included in CBO household income.
 values:
   0000-01-01:
     - social_security
-    - medicare_gross_cost
+    # CBO measures Medicare as the average cost to the government net of
+    # offsetting receipts. medicare_cost subtracts the Part A and Part B
+    # premiums from the average cost per enrollee; Part D premiums stay in.
+    - medicare_cost
     - total_unemployment_compensation
     - workers_compensation
 
 metadata:
   unit: list
   period: year
   label: CBO social insurance benefits
+  reference:
+    - title: "Congressional Budget Office, The Distribution of Household Income in 2021, Appendix A note 3 (Medicare net of offsetting receipts) and Appendix D (social insurance benefits) #page 27,41"
+      href: https://www.cbo.gov/system/files/2024-09/60341-income.pdf#page=27
+    - title: Congressional Budget Office, Reconciling the Official Poverty Measure and CBO's Distributional Analysis of Household Income (Medicare benefits net of premiums)
+      href: https://www.cbo.gov/publication/61157

policyengine_us/parameters/gov/household/census_money_income_sources/alimony.yaml

@@ -0,0 +1,11 @@
+description: The Census Bureau counts these sources as alimony, source 15 of 18 in money income.
+values:
+  0000-01-01:
+    - alimony_income
+metadata:
+  unit: list
+  period: year
+  label: Census money income alimony sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 15 (alimony) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/child_support.yaml

@@ -0,0 +1,11 @@
+description: The Census Bureau counts these sources as child support, source 16 of 18 in money income.
+values:
+  0000-01-01:
+    - child_support_received
+metadata:
+  unit: list
+  period: year
+  label: Census money income child support sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 16 (child support) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/disability_benefits.yaml

@@ -0,0 +1,18 @@
+description: The Census Bureau counts these sources as disability benefits, source 9 of 18 in money income.
+# pfml_benefits holds state paid family and medical leave benefits;
+# Appendix A lists state temporary sickness payments among the sources
+# of disability benefits. The model has no variable for Black lung
+# payments, another source Appendix A lists here. Railroad Retirement Board
+# disability annuities sit in railroad_benefits, under pension or
+# retirement income.
+values:
+  0000-01-01:
+    - disability_benefits
+    - pfml_benefits
+metadata:
+  unit: list
+  period: year
+  label: Census money income disability benefits sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 9 (disability benefits) #page 1,3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=1

policyengine_us/parameters/gov/household/census_money_income_sources/dividends.yaml

@@ -0,0 +1,12 @@
+description: The Census Bureau counts these sources as dividends, source 12 of 18 in money income.
+# Appendix A leaves out capital gains from the sale of stock.
+values:
+  0000-01-01:
+    - dividend_income
+metadata:
+  unit: list
+  period: year
+  label: Census money income dividends sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 12 (dividends) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/earnings.yaml

@@ -0,0 +1,23 @@
+description: The Census Bureau counts these sources as earnings, source 1 of 18 in money income.
+values:
+  0000-01-01:
+    # Money wage or salary income, before deductions such as pension
+    # contributions.
+    - employment_income
+    # Net income from nonfarm self-employment, including a business,
+    # professional enterprise or partnership.
+    - self_employment_income
+    - sstb_self_employment_income
+    - partnership_s_corp_income
+    # Net income from farm self-employment. Appendix A counts rent paid as
+    # a share of the crops in farm gross receipts; farm_rent_income holds
+    # the crop and livestock shares reported on Form 4835.
+    - farm_operations_income
+    - farm_rent_income
+metadata:
+  unit: list
+  period: year
+  label: Census money income earnings sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 1 (earnings) #page 1-2"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=1

policyengine_us/parameters/gov/household/census_money_income_sources/educational_assistance.yaml

@@ -0,0 +1,11 @@
+description: The Census Bureau counts these sources as educational assistance, source 14 of 18 in money income.
+values:
+  0000-01-01:
+    - educational_assistance
+metadata:
+  unit: list
+  period: year
+  label: Census money income educational assistance sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 14 (educational assistance) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/financial_assistance.yaml

@@ -0,0 +1,11 @@
+description: The Census Bureau counts these sources as financial assistance from outside of the household, source 17 of 18 in money income.
+values:
+  0000-01-01:
+    - financial_assistance
+metadata:
+  unit: list
+  period: year
+  label: Census money income financial assistance from outside of the household sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 17 (financial assistance from outside of the household) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/index.yaml

@@ -0,0 +1,3 @@
+description: The Census Bureau counts these sources as money income, one list for each of the 18 sources in Current Population Reports P60-200, Appendix A.
+metadata:
+  label: Census money income sources

policyengine_us/parameters/gov/household/census_money_income_sources/interest.yaml

@@ -0,0 +1,11 @@
+description: The Census Bureau counts these sources as interest, source 11 of 18 in money income.
+values:
+  0000-01-01:
+    - interest_income
+metadata:
+  unit: list
+  period: year
+  label: Census money income interest sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 11 (interest) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/other_income.yaml

@@ -0,0 +1,26 @@
+description: The Census Bureau counts these sources as other income, source 18 of 18 in money income.
+# Appendix A's other income covers payments received regularly that no
+# other source covers, such as state foster child payments, military
+# family allotments and foreign government pensions. The model has no
+# variables for the last two, and of foster payments only the two Los
+# Angeles County payments below.
+values:
+  0000-01-01:
+    # Guaranteed income pilot payments.
+    - gi_cash_assistance
+    # Alaska's annual dividend and the energy relief paid with it.
+    - ak_permanent_fund_dividend
+    - ak_energy_relief
+    # Contributed cash payments that are zero unless a reform turns them on.
+    - basic_income
+    - trump_dividend
+    # Los Angeles County payments to parenting and expectant foster youth.
+    - ca_la_infant_supplement
+    - ca_la_expectant_parent_payment
+metadata:
+  unit: list
+  period: year
+  label: Census money income other income sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 18 (other income) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/pension_or_retirement_income.yaml

@@ -0,0 +1,24 @@
+description: The Census Bureau counts these sources as pension or retirement income, source 10 of 18 in money income.
+values:
+  0000-01-01:
+    # Pensions, annuities and paid-up insurance policies.
+    - pension_income
+    # Military retirement pay. Survivor annuities under the military
+    # retirement plans count as survivor benefits.
+    - military_retirement_pay
+    # IRA, Keogh and 401(k) payments, at the ages Census counts them.
+    - census_retirement_distributions
+    # Railroad retirement, one of the eight sources Appendix A lists here.
+    # railroad_benefits also holds the Railroad Retirement Board's disability
+    # and survivor annuities, which Appendix A counts as disability and
+    # survivor benefits; the model does not split that variable.
+    - railroad_benefits
+metadata:
+  unit: list
+  period: year
+  label: Census money income pension or retirement income sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 10 (pension or retirement income) #page 1,3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=1
+    - title: "Census Bureau, 2026 Current Population Survey Annual Social and Economic Supplement data dictionary, retirement distributions by age (DST_VAL1, DST_VAL1_YNG, DBTN_VAL) #page 57-58"
+      href: https://www2.census.gov/programs-surveys/cps/datasets/2026/march/asec2026_ddl_pub_full.pdf#page=57

policyengine_us/parameters/gov/household/census_money_income_sources/public_assistance.yaml

@@ -0,0 +1,20 @@
+description: The Census Bureau counts these sources as public assistance, source 6 of 18 in money income.
+values:
+  0000-01-01:
+    - tanf
+    - general_assistance
+    # Colorado Old Age Pension covers people 60 and older, a wider group
+    # than source 5's 65 and older.
+    - co_oap
+    # Massachusetts Emergency Aid to the Elderly, Disabled and Children.
+    - ma_eaedc
+    # Washington State Family Assistance and Refugee Cash Assistance.
+    - wa_sfa
+    - wa_rca
+metadata:
+  unit: list
+  period: year
+  label: Census money income public assistance sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 6 (public assistance) #page 1,3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=1

policyengine_us/parameters/gov/household/census_money_income_sources/rents_royalties_estates_and_trusts.yaml

@@ -0,0 +1,13 @@
+description: The Census Bureau counts these sources as rents, royalties, and estates and trusts, source 13 of 18 in money income.
+values:
+  0000-01-01:
+    # rental_income includes royalties.
+    - rental_income
+    - estate_income
+metadata:
+  unit: list
+  period: year
+  label: Census money income rents, royalties, and estates and trusts sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 13 (rents, royalties, and estates and trusts) #page 2-3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=2

policyengine_us/parameters/gov/household/census_money_income_sources/social_security.yaml

@@ -0,0 +1,12 @@
+description: The Census Bureau counts these sources as Social Security, source 4 of 18 in money income.
+# Appendix A counts benefits before the deduction for Medicare premiums.
+values:
+  0000-01-01:
+    - social_security
+metadata:
+  unit: list
+  period: year
+  label: Census money income Social Security sources
+  reference:
+    - title: "Census Bureau, Current Population Reports P60-200, Appendix A, source 4 (Social Security) #page 1,3"
+      href: https://www2.census.gov/programs-surveys/cps/methodology/Appendix%20A%20P60-200%20income%20measurement%20definition.pdf#page=1