Skip to contents

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

Additional federal results:

  • v42_self_emp_income: Earned Self-Employment Income for FICA
  • v43_medicare_tax_unearned_income: Medicare Tax on Unearned Income
  • v44_medicare_tax_earned_income: Medicare Tax on Earned Income
  • v45_cares_recovery_rebate: CARES act Recovery Rebates