Input variables#
This section contains documentation of input variables in a format that is easy to search and print. The input variables are ordered alphabetically by name. There are no subsections, just a long list of input variables that Taxcalc-Payroll is programmed to use in its calculations. The Availability information indicates which input data files contain the variable.
DSI
#
Description: 1 if claimed as dependent on another return; otherwise 0
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 6a
EIC
#
Description: number of EIC qualifying children (range: 0 to 3)
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch EIC
FLPDYR
#
Description: Calendar year for which taxes are calculated
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040
MARS
#
Required Input Variable
Description: Filing (marital) status: line number of the checked box [1=single, 2=joint, 3=separate, 4=household-head, 5=widow(er)]
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 lines 1-5
MIDR
#
Description: 1 if separately filing spouse itemizes; otherwise 0
Datatype: int
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 39b
RECID
#
Required Input Variable
Description: Unique numeric identifier for filing unit; appears as RECID variable in tc CLI minimal output
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: private info
XTOT
#
Description: Total number of exemptions for filing unit
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 6d
age_head
#
Description: Age in years of taxpayer (i.e. primary adult)
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
age_spouse
#
Description: Age in years of spouse (i.e. secondary adult if present)
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
agi_bin
#
Description: Historical AGI category used in data extrapolation
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: not used in tax calculations
blind_head
#
Description: 1 if taxpayer is blind; otherwise 0
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 39a
blind_spouse
#
Description: 1 if spouse is blind; otherwise 0
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 39a
cmbtp
#
Description: Estimate of income on (AMT) Form 6251 but not in AGI
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 6251 and 1040
e00200
#
Description: Wages, salaries, and tips for filing unit net of pension contributions
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 7
e00200p
#
Description: Wages, salaries, and tips for taxpayer net of pension contributions (pencon_p)
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 7 component
e00200s
#
Description: Wages, salaries, and tips for spouse net of pension contributions (pencon_s)
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 7 component
pencon_p
#
Description: Contributions to defined-contribution pension plans for taxpayer
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: Imputed using IRS tabulations of Form W-2 sample
pencon_s
#
Description: Contributions to defined-contribution pension plans for spouse
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: Imputed using IRS tabulations of Form W-2 sample
e00300
#
Description: Taxable interest income
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 8a
e00400
#
Description: Tax-exempt interest income
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 8b
e00600
#
Description: Ordinary dividends included in AGI
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 9a
e00650
#
Description: Qualified dividends included in ordinary dividends
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 9b
e00700
#
Description: Taxable refunds of state and local income taxes
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 10
e00800
#
Description: Alimony received
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 11
e00900
#
Description: Sch C business net profit/loss for filing unit
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 12
e00900p
#
Description: Sch C business net profit/loss for taxpayer
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 12 component
e00900s
#
Description: Sch C business net profit/loss for spouse
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 12 component
e01100
#
Description: Capital gain distributions not reported on Sch D
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 13
e01200
#
Description: Other net gain/loss from Form 4797
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 14
e01400
#
Description: Taxable IRA distributions
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 15b
e01500
#
Description: Total pensions and annuities
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 16a
e01700
#
Description: Taxable pensions and annuities
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 16b
e02000
#
Description: Sch E total rental, royalty, partnership, S-corporation, etc, income/loss (includes e26270 and e27200)
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 17
e02100
#
Description: Farm net income/loss for filing unit from Sch F
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 18
e02100p
#
Description: Farm net income/loss for taxpayer
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 18 component
e02100s
#
Description: Farm net income/loss for spouse
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 18 component
e02300
#
Description: Unemployment insurance benefits
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 19
e02400
#
Description: Total social security (OASDI) benefits
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 20a
e03150
#
Description: Total deductible IRA contributions
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 32
e03210
#
Description: Student loan interest
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 33
e03220
#
Description: Educator expenses
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 23
e03230
#
Description: Tuition and fees from Form 8917
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 34
e03240
#
Description: Domestic production activities from Form 8903
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 35
e03270
#
Description: Self-employed health insurance deduction
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 29
e03290
#
Description: Health savings account deduction from Form 8889
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 25
e03300
#
Description: Contributions to SEP, SIMPLE and qualified plans
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 line 28
e03400
#
Description: Penalty on early withdrawal of savings
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 30
e03500
#
Description: Alimony paid
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 line 31a
e07240
#
Description: Retirement savings contributions credit from Form 8880
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 50
2014-2016: 1040 line 51
e07260
#
Description: Residential energy credit from Form 5695
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 52
2014-2016: 1040 line 53
e07300
#
Description: Foreign tax credit from Form 1116
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 47
2014-2016: 1040 line 48
e07400
#
Description: General business credit from Form 3800
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 53a
2014-2016: 1040 line 54a
e07600
#
Description: Prior year minimum tax credit from Form 8801
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 53b
2014-2016: 1040 line 54b
e09700
#
Description: Recapture of Investment Credit
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2015: 4255 line 15
2016-2016: 4255 line 20
e09800
#
Description: Unreported payroll taxes from Form 4137 or 8919
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 57
2014-2016: 1040 line 58
e09900
#
Description: Penalty tax on qualified retirement plans
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 58
2014-2016: 1040 line 59
e11200
#
Description: Excess payroll (FICA/RRTA) tax withheld
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 69
2014-2016: 1040 line 71
e17500
#
Description: Itemizable medical and dental expenses. WARNING: this variable is zero below the floor in PUF data.
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 1
e18400
#
Description: Itemizable state and local income/sales taxes
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 5
e18500
#
Description: Itemizable real-estate taxes paid
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 6
e19200
#
Description: Itemizable interest paid
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 15
e19800
#
Description: Itemizable charitable giving: cash/check contributions. WARNING: this variable is already capped in PUF data.
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 16
e20100
#
Description: Itemizable charitable giving: other than cash/check contributions. WARNING: this variable is already capped in PUF data.
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 17
e20400
#
Description: Itemizable miscellaneous deductions. WARNING: this variable is zero below the floor in PUF data.
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 1040 Sch A line 24
g20500
#
Description: Itemizable gross (before 10% AGI disregard) casualty or theft loss
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch A line 20 before disregard subtracted
e24515
#
Description: Sch D: Un-Recaptured Section 1250 Gain
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch D line 19
e24518
#
Description: Sch D: 28% Rate Gain or Loss
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch D line 18
e26270
#
Description: Sch E: Combined partnership and S-corporation net income/loss (includes k1bx14p and k1bx14s amounts and is included in e02000)
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch E line 32
e27200
#
Description: Sch E: Farm rent net income or loss (included in e02000)
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch E line 40
e32800
#
Description: Child/dependent-care expenses for qualifying persons from Form 2441
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 2441 line 3
e58990
#
Description: Investment income elected amount from Form 4952
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 4952 line 4g
e62900
#
Description: Alternative Minimum Tax foreign tax credit from Form 6251
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 6251 line 32
e87530
#
Description: Adjusted qualified lifetime learning expenses for all students
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 8863 Part I line 10 and 8863 Part III line 31
elderly_dependents
#
Description: number of dependents age 65+ in filing unit excluding taxpayer and spouse
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data; not used in tax law
f2441
#
Description: number of child/dependent-care qualifying persons
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: 2441 line 2b
f6251
#
Description: 1 if Form 6251 (AMT) attached to return; otherwise 0
Datatype: int
Availability: taxdata_puf
IRS Form Location:
2013-2016: 6251
a_lineno
#
Description: CPS line number for the person record of the head of the tax filing unit (not used in tax-calculation logic)
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: sample construction info
ffpos
#
Description: CPS family identifier within household (not used in tax-calculation logic)
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: sample construction info
fips
#
Description: FIPS state code (not used in tax-calculation logic)
Datatype: int
Availability: taxdata_puf, taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: sample construction info
h_seq
#
Description: CPS household sequence number (not used in tax-calculation logic)
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: sample construction info
data_source
#
Description: 1 if unit is created primarily from IRS-SOI PUF data; 0 if created primarily from CPS data (not used in tax-calculation logic)
Datatype: int
Availability: taxdata_puf
IRS Form Location:
2013-2016: sample construction info
k1bx14p
#
Description: Partner self-employment earnings/loss for taxpayer (included in e26270 total)
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1065 (Schedule K-1) box 14
k1bx14s
#
Description: Partner self-employment earnings/loss for spouse (included in e26270 total)
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1065 (Schedule K-1) box 14
mcaid_ben
#
Description: Imputed Medicaid benefits expressed as the actuarial value of Medicaid health insurance
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
mcare_ben
#
Description: Imputed Medicare benefits expressed as the actuarial value of Medicare health insurance
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
n24
#
Description: Number of children who are Child-Tax-Credit eligible, one condition for which is being under age 17
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
nu06
#
Description: Number of dependents under 6 years old
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
nu13
#
Description: Number of dependents under 13 years old
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
nu18
#
Description: Number of people under 18 years old in the filing unit
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
n1820
#
Description: Number of people age 18-20 years old in the filing unit
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
n21
#
Description: Number of people 21 years old or older in the filing unit
Datatype: int
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: imputed from CPS data
other_ben
#
Description: Non-imputed benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: determined using government benefit program data
p08000
#
Description: Other tax credits (but not including Sch R credit)
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2013: 1040 line 53
2014-2016: 1040 line 54
p22250
#
Description: Sch D: Net short-term capital gains/losses
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch D line 7
p23250
#
Description: Sch D: Net long-term capital gains/losses
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 1040 Sch D line 15
e87521
#
Description: Total tentative AmOppCredit amount for all students
Datatype: float
Availability: taxdata_puf
IRS Form Location:
2013-2016: 8863 Part I line 1 and 8863 Part III line 30
s006
#
Description: Filing unit sampling weight; appears as WEIGHT variable in tc CLI minimal output
Datatype: float
Availability: taxdata_puf, taxdata_cps
IRS Form Location:
2013-2016: not used in filing unit tax calculations
snap_ben
#
Description: Imputed SNAP benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
housing_ben
#
Description: Imputed housing benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
ssi_ben
#
Description: Imputed SSI benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
tanf_ben
#
Description: Imputed TANF benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
vet_ben
#
Description: Imputed Veteran’s benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
wic_ben
#
Description: Imputed WIC benefits
Datatype: float
Availability: taxdata_cps
IRS Form Location:
2014-20??: imputed using the C-TAM model
PT_SSTB_income
#
Description: Value of one implies business income is from a specified service trade or business (SSTB); value of zero implies business income is from a qualified trade or business
Datatype: int
Availability:
IRS Form Location:
2018-20??: specified in custom data
PT_binc_w2_wages
#
Description: Filing unit’s share of total W-2 wages paid by the pass-through business
Datatype: float
Availability:
IRS Form Location:
2018-20??: specified in custom data
PT_ubia_property
#
Description: Filing unit’s share of total business property owned by the pass-through business
Datatype: float
Availability:
IRS Form Location:
2018-20??: specified in custom data