Tax-Calculator CalcFunctions

Tax-Calculator CalcFunctions

taxcalc.calcfunctions

Tax-Calculator functions that calculate payroll and individual income taxes.

These functions are imported into the Calculator class.

Note: the parameter_indexing_CPI_offset policy parameter is the only policy parameter that does not appear here; it is used in the policy.py file to possibly adjust the price inflation rate used to index policy parameters (as would be done in a reform that introduces chained-CPI indexing).

taxcalc.calcfunctions.AGI(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.AGIsurtax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.ALD_InvInc_ec_base(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.AMT(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.AdditionalCTC(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.AdditionalMedicareTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.Adj(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.AfterTaxIncome(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.AmOppCreditParts(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.BenefitLimitation(calc)[source]

Limits the benefits of select itemized deductions to a fraction of deductible expenses.

Parameters

calc (Calculator object) – calc represents the reform while self represents the baseline

Returns

The function modifies calc

Return type

None

taxcalc.calcfunctions.BenefitPrograms(calc)[source]

Calculate total government cost and consumption value of benefits delivered by non-repealed benefit programs.

Parameters

calc (Calculator object) – calc represents the reform while self represents the baseline

Returns

The function modifies calc

Return type

None

taxcalc.calcfunctions.BenefitSurtax(calc)[source]

Computes itemized-deduction-benefit surtax and adds the surtax amount to income tax, combined tax, and surtax liabilities.

Parameters

calc (Calculator object) – calc represents the reform while self represents the baseline

Returns

The function modifies calc

Return type

None

taxcalc.calcfunctions.C1040(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.CTC_new(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.CapGains(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.CharityCredit(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.ChildDepTaxCredit(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.ComputeBenefit(calc, ID_switch)[source]

Calculates the value of the benefits accrued from itemizing.

Parameters
  • calc (Calculator object) – calc represents the reform while self represents the baseline

  • ID_switch (list) – Deductions subject to the surtax on itemized deduction benefits

Returns

benefit – Imputed benefits from itemizing deductions

Return type

float

taxcalc.calcfunctions.DependentCare(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.EITC(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.EITCamount(basic_frac, phasein_rate, earnings, max_amount, phaseout_start, agi, phaseout_rate)[source]

Returns EITC amount given specified parameters. English parameter names are used in this function because the EITC formula is not available on IRS forms or in IRS instructions; the extensive IRS EITC look-up table does not reveal the formula.

Parameters
  • basic_frac (list) – Fraction of maximum earned income credit paid at zero earnings

  • phasein_rate (list) – Earned income credit phasein rate

  • earnings (float) – Earned income for filing unit

  • max_amount (list) – Maximum earned income credit

  • phaseout_start (list) – Earned income credit phaseout start AGI

  • agi (float) – Adjusted Gross Income (AGI)

  • phaseout_rate (list) – Earned income credit phaseout rate

Returns

eitc – Earned Income Credit

Return type

float

taxcalc.calcfunctions.EI_PayrollTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.EducationTaxCredit(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.ExpandIncome(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.F2441(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.FairShareTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.GainsTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.IITAX(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.ItemDed(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.ItemDedCap(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.LumpSumTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.NetInvIncTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.NonrefundableCredits(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.PersonalTaxCredit(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.RefundablePayrollTaxCredit(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.SSBenefits(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.SchR(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.SchXYZ(taxable_income, MARS, e00900, e26270, e02000, e00200, PT_rt1, PT_rt2, PT_rt3, PT_rt4, PT_rt5, PT_rt6, PT_rt7, PT_rt8, PT_brk1, PT_brk2, PT_brk3, PT_brk4, PT_brk5, PT_brk6, PT_brk7, II_rt1, II_rt2, II_rt3, II_rt4, II_rt5, II_rt6, II_rt7, II_rt8, II_brk1, II_brk2, II_brk3, II_brk4, II_brk5, II_brk6, II_brk7, PT_EligibleRate_active, PT_EligibleRate_passive, PT_wages_active_income, PT_top_stacking)[source]

Returns Schedule X, Y, Z tax amount for specified taxable_income.

Parameters
  • taxable_income (float) – Taxable income

  • MARS (int) – Filing (marital) status. (1=single, 2=joint, 3=separate, 4=household-head, 5=widow(er))

  • e00900 (float) – Schedule C business net profit/loss for filing unit

  • e26270 (float) – Schedule E: combined partnership and S-corporation net income/loss

  • e02000 (float) – Schedule E total rental, royalty, parternship, S-corporation, etc, income/loss

  • e00200 (float) – Wages, salaries, and tips for filing unit net of pension contributions

  • PT_rt1 (float) – Pass through income tax rate 1

  • PT_rt2 (float) – Pass through income tax rate 2

  • PT_rt3 (float) – Pass through income tax rate 3

  • PT_rt4 (float) – Pass through income tax rate 4

  • PT_rt5 (float) – Pass through income tax rate 5

  • PT_rt6 (float) – Pass through income tax rate 6

  • PT_rt7 (float) – Pass through income tax rate 7

  • PT_rt8 (float) – Pass through income tax rate 8

  • PT_brk1 (list) – Pass through income tax bracket (upper threshold) 1

  • PT_brk2 (list) – Pass through income tax bracket (upper threshold) 2

  • PT_brk3 (list) – Pass through income tax bracket (upper threshold) 3

  • PT_brk4 (list) – Pass through income tax bracket (upper threshold) 4

  • PT_brk5 (list) – Pass through income tax bracket (upper threshold) 5

  • PT_brk6 (list) – Pass through income tax bracket (upper threshold) 6

  • PT_brk7 (list) – Pass through income tax bracket (upper threshold) 7

  • II_rt1 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 1

  • II_rt2 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 2

  • II_rt3 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 3

  • II_rt4 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 4

  • II_rt5 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 5

  • II_rt6 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 6

  • II_rt7 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 7

  • II_rt8 (float) – Personal income (regular/non-AMT/non-pass-through) tax rate 8

  • II_brk1 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 1

  • II_brk2 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 2

  • II_brk3 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 3

  • II_brk4 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 4

  • II_brk5 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 5

  • II_brk6 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 6

  • II_brk7 (list) – Personal income (regular/non-AMT/non-pass/through) tax bracket (upper threshold) 7

  • PT_EligibleRate_active (float) – Share of active business income eligible for PT rate schedule

  • PT_EligibleRate_passive (float) – Share of passive business income eligible for PT rate schedule

  • PT_wages_active_income (bool) – Wages included in (positive) active business eligible for PT rates

  • PT_top_stacking (bool) – PT taxable income stacked on top of regular taxable income

Returns

  • reg_tax (float) – Individual income tax liability on non-pass-through income

  • pt_tax (float) – Individual income tax liability from pass-through income

taxcalc.calcfunctions.SchXYZTax(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.StdDed(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.TaxInc(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.

taxcalc.calcfunctions.Taxes(income, MARS, tbrk_base, rate1, rate2, rate3, rate4, rate5, rate6, rate7, rate8, tbrk1, tbrk2, tbrk3, tbrk4, tbrk5, tbrk6, tbrk7)[source]

Taxes function returns tax amount given the progressive tax rate schedule specified by the rate* and (upper) tbrk* parameters and given income, filing status (MARS), and tax bracket base (tbrk_base).

Parameters
  • income (float) – Taxable income

  • MARS (int) – Filing (marital) status. (1=single, 2=joint, 3=separate, 4=household-head, 5=widow(er))

  • tbrk_base (float) – Amount of income used to determine the braket the filer is in

  • rate1 (list) – Income tax rate 1

  • rate2 (list) – Income tax rate 2

  • rate3 (list) – Income tax rate 3

  • rate4 (list) – Income tax rate 4

  • rate5 (list) – Income tax rate 5

  • rate6 (list) – Income tax rate 6

  • rate7 (list) – Income tax rate 7

  • rate8 (list) – Income tax rate 8

  • tbrk1 (list) – Income tax bracket (upper threshold) 1

  • tbrk2 (list) – Income tax bracket (upper threshold) 2

  • tbrk3 (list) – Income tax bracket (upper threshold) 3

  • tbrk4 (list) – Income tax bracket (upper threshold) 4

  • tbrk5 (list) – Income tax bracket (upper threshold) 5

  • tbrk6 (list) – Income tax bracket (upper threshold) 6

  • tbrk7 (list) – Income tax bracket (upper threshold) 7

Returns

Return type

None

taxcalc.calcfunctions.UBI(*args, **kwargs)

wrapper function nested in make_wrapper function nested in iterate_jit decorator.