Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Output variables

This section contains documentation of output variables in a format that is easy to search and print. The output variables are ordered alphabetically by name. There are no subsections, just a long list of output variables that Tax-Calculator is programmed to calculate.

aftertax_income

Description: After tax income is equal to expanded_income minus combined
Datatype: float

auto_loan_interest_deduction

Description: Deduction for payment of qualified auto loan interest
Datatype: float

benefit_cost_total

Description: Government cost of all benefits received by tax unit
Datatype: float

benefit_value_total

Description: Consumption value of all benefits received by tax unit, which is included in expanded_income
Datatype: float

c00100

Description: Adjusted Gross Income (AGI)
Datatype: float

c01000

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c02500

Description: Social security (OASDI) benefits included in AGI
Datatype: float

c02900

Description: Total of all ‘above the line’ income adjustments to get AGI
Datatype: float

c03260

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c04470

Description: Itemized deductions after limitations (zero for non-itemizers)
Datatype: float

c04600

Description: Personal exemptions after phase-out
Datatype: float

c04800

Description: Regular taxable income
Datatype: float

c05200

Description: Tax amount from Sch X,Y,Z tables
Datatype: float

c05700

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c05800

Description: Total (regular + AMT) income tax liability before credits (equals taxbc plus c09600)
Datatype: float

c07100

Description: Total non-refundable credits used to reduce positive tax liability
Datatype: float

c07180

Description: Nonrefundable credit for child and dependent care expenses from Form 2441
Datatype: float

c07200

Description: Schedule R credit for the elderly and the disabled
Datatype: float

c07220

Description: Child tax credit (adjusted) from Form 8812
Datatype: float

c07230

Description: Education tax credits non-refundable amount from Form 8863 (includes c87668)
Datatype: float

c07240

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c07260

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c07300

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c07400

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c07600

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c08000

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c09200

Description: Income tax liability (including othertaxes) after non-refundable credits are used, but before refundable credits are applied
Datatype: float

c09600

Description: Alternative Minimum Tax (AMT) liability
Datatype: float

c10960

Description: American Opportunity Credit refundable amount from Form 8863
Datatype: float

c11070

Description: Child tax credit (refunded) from Form 8812
Datatype: float

c17000

Description: Sch A: Medical expenses deducted (component of pre-limitation c21060 total)
Datatype: float

c18300

Description: Sch A: State and local taxes plus real estate taxes deducted (component of pre-limitation c21060 total)
Datatype: float

c19200

Description: Sch A: Interest deducted (component of pre-limitation c21060 total)
Datatype: float

c19700

Description: Sch A: Charity contributions deducted (component of pre-limitation c21060 total)
Datatype: float

c20500

Description: Sch A: Net casualty or theft loss deducted (component of pre-limitation c21060 total)
Datatype: float

c20800

Description: Sch A: Net limited miscellaneous deductions deducted (component of pre-limitation c21060 total)
Datatype: float

c21040

Description: Itemized deductions that are phased out
Datatype: float

c21060

Description: Itemized deductions before phase-out (zero for non-itemizers)
Datatype: float

c23650

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c32800

Description: Child and dependent care expenses capped by policy (not by earnings)
Datatype: float

c59660

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

c62100

Description: Alternative Minimum Tax (AMT) taxable income
Datatype: float

c87668

Description: American Opportunity Credit non-refundable amount from Form 8863 (included in c07230)
Datatype: float

care_deduction

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

CDCC_refund

Description: Refundable credit for child and dependent care expenses from Form 2441
Datatype: float

charity_credit

Description: Credit for charitable giving
Datatype: float

codtc_limited

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

combined

Description: Sum of iitax and payrolltax and lumpsum_tax
Datatype: float

credit_claim_urn

Description: Uniform random number used in EITC/ACTC claiming logic, which implies correlated claimning behavior across different credits
Datatype: unchanging_float

ctc_new

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

ctc_nonrefundable

Description: Portion of total CTC amount that is nonrefundable
Datatype: float

ctc_refundable

Description: Portion of total CTC amount that is refundable
Datatype: float

ctc_total

Description: Total CTC amount (c07220 + c11070 + odc + ctc_new)
Datatype: float

dwks10

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

dwks13

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

dwks14

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

dwks18

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

dwks43

Description: separate tax on long-term capital gains and qualified dividends
Datatype: float

earned

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

earned_p

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

earned_s

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

eitc

Description: Earned Income Credit
Datatype: float

exact

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: int

expanded_income

Description: Broad income measure that includes benefit_value_total
Datatype: float

fstax

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

iitax

Description: Total federal individual income tax liability; appears as INCTAX variable in tc CLI minimal output
Datatype: float

invinc_agi_ec

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

invinc_ec_base

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

lumpsum_tax

Description: Lumpsum (or head) tax; appears as LSTAX variable in tc CLI minimal output
Datatype: float

mtr_inctax

Description: Marginal income tax rate (in percentage terms) on extra taxpayer earnings (e00200p)
Datatype: float

mtr_paytax

Description: Marginal payroll tax rate (in percentage terms) on extra taxpayer earnings (e00200p)
Datatype: float

niit

Description: Net Investment Income Tax from Form 8960
Datatype: float

nontaxable_ubi

Description: Amount of UBI benefit excluded from AGI
Datatype: float

num

Description: 2 when MARS is 2 (married filing jointly); otherwise 1
Datatype: int

odc

Description: Other Dependent Credit
Datatype: float

othertaxes

Description: Other taxes: sum of niit, e09700, e09800 and e09900 (included in c09200)
Datatype: float

overtime_income_deduction

Description: Deduction for qualified overtime income
Datatype: float

payrolltax

Description: Total (employee + employer) payroll tax liability; appears as PAYTAX variable in tc CLI minimal output (payrolltax = ptax_was)
Datatype: float

personal_nonrefundable_credit

Description: Personal nonrefundable credit
Datatype: float

personal_refundable_credit

Description: Personal refundable credit
Datatype: float

pre_c04600

Description: Personal exemption before phase-out
Datatype: float

ptax_amc

Description: Additional Medicare Tax from Form 8959 (included in othertaxes and iitax)
Datatype: float

ptax_er_p

Description: Taxpayer’s employer share of OASDI+HI FICA payroll tax on wages and salaries; excludes self-employment tax (which has no employer share) and is therefore invariant under the soi_iitax bucketing switch
Datatype: float

ptax_er_s

Description: Spouse’s employer share of OASDI+HI FICA payroll tax on wages and salaries; excludes self-employment tax (which has no employer share) and is therefore invariant under the soi_iitax bucketing switch
Datatype: float

ptax_oasdi

Description: Employee + employer OASDI FICA tax plus self-employment tax
Datatype: float

ptax_was

Description: Employee + employer OASDI + HI FICA tax
Datatype: float

qbided

Description: Qualified Business Income (QBI) deduction
Datatype: float

recovery_rebate_credit

Description: Recovery Rebate Credit, from American Rescue Plan Act of 2021
Datatype: float

refund

Description: Total refundable income tax credits
Datatype: float

senior_deduction

Description: Deduction for elderly head and/or spouse
Datatype: float

setax

Description: Self-employment tax (included in othertaxes and iitax)
Datatype: float

sey

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

standard

Description: Standard deduction (zero for itemizers)
Datatype: float

surtax

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

taxable_ubi

Description: Amount of UBI benefit included in AGI
Datatype: float

taxbc

Description: Regular tax on regular taxable income before credits
Datatype: float

tip_income_deduction

Description: Deduction for qualified tip income
Datatype: float

ubi

Description: Universal Basic Income benefit for filing unit
Datatype: float

ymod

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float

ymod1

Description: search taxcalc/calcfunctions.py for how calculated and used
Datatype: float