Description of Output Columns
In usincometaxes: Calculate Federal and State Income Taxes in the United States

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)

usincometaxes returns tax results as a data frame, with each column representing tax information such as federal and state income taxes owed or other line items. Each row corresponds to a row in the input data frame. Users can specify the amount of output with the return_all_information parameter in taxsim_calculate_taxes(). Setting return_all_information to TRUE returns a data frame with 42 columns of detailed tax information. FALSE returns 9 columns of key information. FALSE leads to quicker calculations and downloads from the NBER's servers.

usincometaxes provides the same output as TAXSIM 35. Setting return_all_information to FALSE equates to setting idtl to 0 in TAXSIM, while TRUE corresponds to 2.

Standard columns

Returned columns when return_all_information = FALSE.

taxsimid: ID number from the input data set, so users can match the tax information with the input data set.
fiitax: Federal income tax liability including capital gains rates, surtaxes, AMT and refundable and non-refundable credits.
siitax: State income tax liability.
fica: Total FICA taxes, including the employers and employees share.
frate: Marginal federal tax rate.
srate: Marginal state tax rate, if a state was identified.
ficar: FICA rate.
tfica: Taxpayer liability for FICA.

Marginal rates are with respect to wage income unless another rate is requested. If detailed intermediate results are requested, the following 35 columns of data are added:.

Detailed columns

Returned columns when return_all_information = TRUE.

All standard columns shown above, plus:

credits: Total refundable and non-refundable federal credits
v10_federal_agi: Federal AGI
v11_ui_agi: UI in AGI
v12_soc_sec_agi: Social Security in AGI
v13_zero_bracket_amount: Zero Bracket Amount
v14_personal_exemptions: Personal Exemptions
v15_exemption_phaseout: Exemption Phaseout
v16_deduction_phaseout: Deduction Phaseout
v17_itemized_deductions: Itemized Deductions Allowed (Zero for non-itemizers)
v18_federal_taxable_income: Federal Taxable Income
v19_tax_on_taxable_income: Tax on Taxable Income (no special capital gains rates)
v20_exemption_surtax: Exemption Surtax
v21_general_tax_credit: General Tax Credit
v22_child_tax_credit_adjusted: Child Tax Credit (as adjusted)
v23_child_tax_credit_refundable: Additional Child Tax Credit (refundable)
v24_child_care_credit: Child Care Credit
v25_eitc: Earned Income Credit (total federal)
v26_amt_income: Income for the Alternative Minimum Tax
v27_amt_liability: AMT Liability after credit for regular tax and other allowed credits.
v28_fed_income_tax_before_credit:Federal Income Tax Before Credits (includes special treatment of Capital gains, exemption surtax (1988-1996) and 15% rate phaseout (1988-1990) but not AMT)
v29_fica: FICA

The following columns are zero if no state is specified:

v30_state_household_income: State Household Income (imputation for property tax credit)
v31_state_rent_expense: State Rent Expense (imputation for property tax credit)
v32_state_agi: State AGI
v33_state_exemption_amount: State Exemption amount
v34_state_std_deduction_amount: State Standard Deduction
v35_state_itemized_deduction: State Itemized Deductions
v36_state_taxable_income: State Taxable Income
v37_state_property_tax_credit: State Property Tax Credit
v38_state_child_care_credit: State Child Care Credit
v39_state_eitc: State EIC
v40_state_total_credits: State Total Credits
v41_state_bracket_rate: State Bracket Rate
staxbc: State tax liability before credits