taxcalc 5.0.4__tar.gz → 5.2.0__tar.gz

{taxcalc-5.0.4/taxcalc.egg-info → taxcalc-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taxcalc
-Version: 5.0.4
+Version: 5.2.0
 Summary: Tax-Calculator
 Home-page: https://github.com/PSLmodels/Tax-Calculator
 Download-URL: https://github.com/PSLmodels/Tax-Calculator

{taxcalc-5.0.4 → taxcalc-5.2.0}/docs/about/releases.md

@@ -4,6 +4,44 @@ Go [here](https://github.com/PSLmodels/Tax-Calculator/pulls?q=is%3Apr+is%3Aclose
 for a complete commit history.
 
 
+2025-08-08 Release 5.2.0
+------------------------
+(last merged pull request is
+[#2944](https://github.com/PSLmodels/Tax-Calculator/pull/2944))
+
+**This is an enhancement release.**
+
+**API Changes**
+
+**New Features**
+- Make OBBBA reform be current-law policy in several PRs described in
+  [issue
+  2926](https://github.com/PSLmodels/Tax-Calculator/issues/2926) by
+  Martin Holmer
+- Extend CPS and PUF aggregate tests through 2035
+  [[#2944](https://github.com/PSLmodels/Tax-Calculator/pull/2944) by
+  Martin Holmer]
+
+
+2025-07-22 Release 5.1.0
+------------------------
+(last merged pull request is
+[#2933](https://github.com/PSLmodels/Tax-Calculator/pull/2933))
+
+**This is an enhancement release.**
+
+**API Changes**
+
+**New Features**
+- Add `PT_qbid_limited` policy parameter and associated logic
+[[#2923](https://github.com/PSLmodels/Tax-Calculator/pull/2923) by Martin Holmer]
+- Refactor tax-calculation function logic to reduce model execution time
+[[#2924](https://github.com/PSLmodels/Tax-Calculator/pull/2924) by Martin Holmer]
+- OBBBA-enhancement PRs 2927-2933 described in [issue 2926](https://github.com/PSLmodels/Tax-Calculator/issues/2926) by Martin Holmer
+
+**Bug Fixes**
+
+
 2025-07-02 Release 5.0.0
 ------------------------
 (last merged pull request is

{taxcalc-5.0.4 → taxcalc-5.2.0}/docs/index.md

@@ -54,7 +54,7 @@ cross-model validation work with NBER's TAXSIM-35 model is described
 
 ## Latest release
 
-{doc}`5.0.0 (2025-07-02) <about/releases>`
+{doc}`5.2.0 (2025-08-08) <about/releases>`
 
 If you are already using Tax-Calculator, upgrade using the following command:
 ```

{taxcalc-5.0.4 → taxcalc-5.2.0}/extend_tcja.py

@@ -50,7 +50,7 @@ TCJA_PARAMETERS = {
     "STD": {"indexed": True, "category": 4},
     # category 5 ...
     "ID_AllTaxes_c": {"indexed": False, "category": 5},
-    "ID_Charity_crt_cash": {"indexed": False, "category": 5},
+    "ID_Charity_crt_all": {"indexed": False, "category": 5},
     "ID_Casualty_hc": {"indexed": False, "category": 5},
     "ID_Miscellaneous_hc": {"indexed": False, "category": 5},
     "ID_ps": {"indexed": True, "category": 5},

{taxcalc-5.0.4 → taxcalc-5.2.0}/setup.py

@@ -7,7 +7,7 @@ from setuptools import setup
 with open("README.md", "r", encoding="utf-8") as f:
     longdesc = f.read()
 
-VERSION = "5.0.4"
+VERSION = "5.2.0"
 
 config = {
     "description": "Tax-Calculator",

{taxcalc-5.0.4 → taxcalc-5.2.0}/taxcalc/__init__.py

@@ -14,6 +14,6 @@ from taxcalc.taxcalcio import *
 from taxcalc.utils import *
 from taxcalc.cli import *
 
-__version__ = '5.0.4'
+__version__ = '5.2.0'
 __min_python3_version__ = 10
 __max_python3_version__ = 12

{taxcalc-5.0.4 → taxcalc-5.2.0}/taxcalc/calcfunctions.py

@@ -842,26 +842,39 @@ def AGI(ymod1, c02500, c02900, XTOT, MARS, sep, DSI, exact, nu18, taxable_ubi,
 
 
 @iterate_jit(nopython=True)
-def AutoLoanInterestDed(auto_loan_interest, MARS, c00100, exact,
-                        AutoLoanInterestDed_c,
-                        AutoLoanInterestDed_ps,
-                        AutoLoanInterestDed_po_step_size,
-                        AutoLoanInterestDed_po_rate_per_step,
-                        auto_loan_interest_deduction):
-    """
-    Calculates below-the-line deduction on qualified auto loan interest paid.
+def MiscDed(age_head, age_spouse, MARS, c00100, exact,
+            SeniorDed_c, SeniorDed_ps, SeniorDed_prt,
+            auto_loan_interest,
+            AutoLoanInterestDed_c,
+            AutoLoanInterestDed_ps,
+            AutoLoanInterestDed_po_step_size,
+            AutoLoanInterestDed_po_rate_per_step,
+            senior_deduction, auto_loan_interest_deduction):
+    """
+    Calculates below-the-line deduction for elderly head/spouse and
+    deduction on qualified auto loan interest paid.
 
     Parameters
     ----------
-    auto_loan_interest: float
-        Qualified auto loan interest paid
+    age_head: int
+        Age of tax unit head
+    age_head: int
+        Age of tax unit spouse
     MARS: int
         Filing marital status (1=single, 2=joint, 3=separate,
                                4=household-head, 5=widow(er))
     c00100: float
         Adjusted gross income
     exact: int
-        Whether or not to smooth the deduction phase out
+        Whether or not to smooth deduction phase out
+    SeniorDed_c: float
+        Maximum amount of senior deduction per head/spouse aged 65+
+    SeniorDed_ps: list[float]
+        Senior deduction AGI phase-out start level
+    SeniorDed_prt: float
+        Senior deduction phase-out rate
+    auto_loan_interest: float
+        Qualified auto loan interest paid
     AutoLoanInterestDed_c: float
         Deduction cap
     AutoLoanInterestDed_ps: float
@@ -875,9 +888,28 @@ def AutoLoanInterestDed(auto_loan_interest, MARS, c00100, exact,
 
     Returns
     -------
+    senior_deduction: float
+        Deduction available to both itemizers and nonitemizers
     auto_loan_interest_deduction: float
         Deduction available to both itemizers and nonitemizers
     """
+    # calculate senior deduction
+    senior_deduction = 0.
+    if SeniorDed_c > 0.:
+        seniors = 0
+        if age_head >= 65:
+            seniors += 1
+        if MARS == 2 and age_spouse >= 65:
+            seniors += 1
+        if seniors > 0:
+            ded = seniors * SeniorDed_c
+            po_start = SeniorDed_ps[MARS - 1]
+            if c00100 > po_start:
+                excess_agi = c00100 - po_start
+                po_amount = excess_agi * SeniorDed_prt
+                ded = max(0., ded - po_amount)
+            senior_deduction = ded
+    # calculate auto loan interest deduction
     auto_loan_interest_deduction = 0.
     if AutoLoanInterestDed_c > 0. and auto_loan_interest > 0.:
         # cap deduction
@@ -895,23 +927,25 @@ def AutoLoanInterestDed(auto_loan_interest, MARS, c00100, exact,
                 po_amount = excess_agi * po_rate
             ded = max(0., ded - po_amount)
         auto_loan_interest_deduction = ded
-    return auto_loan_interest_deduction
+    return (senior_deduction, auto_loan_interest_deduction)
 
 
 @iterate_jit(nopython=True)
 def ItemDed(e17500, e18400, e18500, e19200,
             e19800, e20100, e20400, g20500,
-            MARS, age_head, age_spouse, c00100, c04470, c21040, c21060,
-            c17000, c18300, c19200, c19700, c20500, c20800,
+            MARS, age_head, age_spouse, c00100, c04600, c04470, c21040, c21060,
+            c17000, c18300, c19200, c19700, c20500, c20800, II_brk6,
             ID_ps, ID_Medical_frt, ID_Medical_frt_add4aged, ID_Medical_hc,
             ID_Casualty_frt, ID_Casualty_hc, ID_Miscellaneous_frt,
-            ID_Miscellaneous_hc, ID_Charity_crt_cash, ID_Charity_crt_noncash,
+            ID_Miscellaneous_hc, ID_Charity_crt_all, ID_Charity_crt_noncash,
             ID_prt, ID_crt, ID_c, ID_StateLocalTax_hc, ID_Charity_frt,
             ID_Charity_hc, ID_InterestPaid_hc, ID_RealEstate_hc,
             ID_Medical_c, ID_StateLocalTax_c, ID_RealEstate_c,
             ID_InterestPaid_c, ID_Charity_c, ID_Casualty_c,
             ID_Miscellaneous_c, ID_AllTaxes_c, ID_AllTaxes_hc,
-            ID_StateLocalTax_crt, ID_RealEstate_crt, ID_Charity_f):
+            ID_AllTaxes_c_ps, ID_AllTaxes_c_po_rate, ID_AllTaxes_c_po_floor,
+            ID_StateLocalTax_crt, ID_RealEstate_crt, ID_Charity_f,
+            ID_reduction_rate):
     """
     Calculates itemized deductions, Form 1040, Schedule A.
 
@@ -942,12 +976,14 @@ def ItemDed(e17500, e18400, e18500, e19200,
         Age in years of spouse
     c00100: float
         Adjusted gross income (AGI)
+    c04600: float
+        Personal exemptions after phase out
     c04470: float
-        Itemized deductions after phase out (0 for non itemizers)
+        Itemized deductions after all limitations (0 for non-itemizers)
     c21040: float
-        Itemized deductions that are phased out
+        Itemized deductions that are limited under the Pease limitations
     c21060: float
-        Itemized deductions before phase out (0 for non itemizers)
+        Itemized deductions before limitation (0 for non-itemizers)
     c17000: float
         Schedule A: medical expenses deducted
     c18300: float
@@ -960,6 +996,8 @@ def ItemDed(e17500, e18400, e18500, e19200,
         Schedule A: net casualty or theft loss deducted
     c20800: float
         Schedule A: net limited miscellaneous deductions deducted
+    II_brk6: list
+        Bottom of top income tax rate bracket
     ID_ps: list
         Itemized deduction phaseout AGI start (Pease)
     ID_Medical_frt: float
@@ -978,8 +1016,8 @@ def ItemDed(e17500, e18400, e18500, e19200,
         miscellaneous expenses
     ID_Miscellaneous_hc: float
         Miscellaneous expense deduction haircut
-    ID_Charity_crt_cash: float
-        Ceiling (as decimal fraction of AGI) for cash charitable
+    ID_Charity_crt_all: float
+        Ceiling (as decimal fraction of AGI) for all charitable
         contribution deductions
     ID_Charity_crt_noncash: float
         Ceiling (as decimal fraction of AGI) for noncash charitable
@@ -1020,10 +1058,16 @@ def ItemDed(e17500, e18400, e18500, e19200,
         Ceiling on the amount of miscellaneous expense deduction
         allowed (dollars)
     ID_AllTaxes_c: list
-        Ceiling on the amount of state and local income, stales, and
+        Cap on the amount of state and local income, sales, and
         real estate deductions allowed (dollars)
     ID_AllTaxes_hc: float
         State and local income, sales, and real estate tax deduciton haircut
+    ID_AllTaxes_c_ps: float
+        AGI level above which ID_AllTaxes_c is reduced
+    ID_AllTaxes_c_po_rate: float
+        ID_AllTaxes_c reduction rate when AGI is above ID_AllTaxes_c_ps
+    ID_AllTaxes_c_po_floor: float
+        Floor below which ID_AllTaxes_c cannot be reduced
     ID_StateLocalTax_crt: float
         Ceiling (as decimal fraction of AGI) for the combination of all
         state and local income and sales tax deductions
@@ -1032,6 +1076,8 @@ def ItemDed(e17500, e18400, e18500, e19200,
         state, local, and foreign real estate tax deductions
     ID_Charity_f: list
         Floor on the amount of charity expense deduction allowed (dollars)
+    ID_reduction_rate: float
+        OBBBA reduction rate for all itemized deductions
 
     Returns
     -------
@@ -1048,12 +1094,13 @@ def ItemDed(e17500, e18400, e18500, e19200,
     c20800: float
         Schedule A: net limited miscellaneous deductions deducted
     c21040: float
-        Itemized deductions that are phased out
+        Itemized deductions that are phased out under Pease limitation
     c21060: float
-        Itemized deductions before phase out (0 for non itemizers)
+        Itemized deductions before any limitation (0 for non-itemizers)
     c04470: float
-        Itemized deductions after phase out (0 for non itemizers)
+        Itemized deductions after all limitations (0 for non-itemizers)
     """
+    # pylint: disable=too-many-statements
     posagi = max(c00100, 0.)
     # Medical
     medical_frt = ID_Medical_frt
@@ -1073,17 +1120,23 @@ def ItemDed(e17500, e18400, e18500, e19200,
     c18400 = min(c18400, ID_StateLocalTax_crt * max(c00100, 0.0001))
     c18500 = min(c18500, ID_RealEstate_crt * max(c00100, 0.0001))
     c18300 = (c18400 + c18500) * (1. - ID_AllTaxes_hc)
-    c18300 = min(c18300, ID_AllTaxes_c[MARS - 1])
+    cap = ID_AllTaxes_c[MARS - 1]
+    if posagi > ID_AllTaxes_c_ps[MARS - 1]:
+        excess_agi = posagi - ID_AllTaxes_c_ps[MARS - 1]
+        cap = max(0., cap - excess_agi * ID_AllTaxes_c_po_rate)
+        cap = max(cap, ID_AllTaxes_c_po_floor[MARS - 1])
+    c18300 = min(c18300, cap)
     # Interest paid
     c19200 = e19200 * (1. - ID_InterestPaid_hc)
     c19200 = min(c19200, ID_InterestPaid_c[MARS - 1])
     # Charity
-    charity_ded_cash = min(ID_Charity_crt_cash * posagi, e19800)
-    charity_ded_noncash = min(ID_Charity_crt_noncash * posagi, e20100)
-    c19700 = charity_ded_cash + charity_ded_noncash
-    # charity floor is zero in present law
-    charity_floor = max(ID_Charity_frt * posagi, ID_Charity_f[MARS - 1])
-    c19700 = max(0., c19700 - charity_floor) * (1. - ID_Charity_hc)
+    floor = max(ID_Charity_frt * posagi, ID_Charity_f[MARS - 1])
+    noncash_ded = max(0., e20100 - floor)
+    charity_ded_noncash = min(ID_Charity_crt_noncash * posagi, noncash_ded)
+    remaining_floor = max(0., floor - e20100)
+    charity_ded_cash = max(0., e19800 - remaining_floor)
+    c19700 = charity_ded_noncash + charity_ded_cash
+    c19700 = min(c19700, ID_Charity_crt_all * posagi) * (1. - ID_Charity_hc)
     c19700 = min(c19700, ID_Charity_c[MARS - 1])
     # Casualty
     c20500 = (max(0., g20500 - ID_Casualty_frt * posagi) *
@@ -1096,8 +1149,8 @@ def ItemDed(e17500, e18400, e18500, e19200,
     c20800 = min(c20800, ID_Miscellaneous_c[MARS - 1])
     # Gross total itemized deductions
     c21060 = c17000 + c18300 + c19200 + c19700 + c20500 + c20800
-    # Limitations on total itemized deductions
-    # (no attempt to adjust c04470 components for limitations)
+    # Pease limitation on total itemized deductions
+    # (no attempt to adjust c04470 components for limitation)
     nonlimited = c17000 + c20500
     limitstart = ID_ps[MARS - 1]
     if c21060 > nonlimited and c00100 > limitstart:
@@ -1108,8 +1161,19 @@ def ItemDed(e17500, e18400, e18500, e19200,
     else:
         c21040 = 0.
         c04470 = c21060
+    # OBBBA limitation on total itemized deductions
+    # (no attempt to adjust c04470 components for limitation)
+    reduction = 0.
+    if ID_reduction_rate > 0.:
+        assert c21040 <= 0.0, "Pease and OBBBA cannot both be in effect"
+        tincome = max(0., c00100 - c04600)
+        texcess = max(0., tincome - II_brk6[MARS - 1])
+        reduction = ID_reduction_rate * texcess
+    c04470 = max(0., c04470 - reduction)
+    # Cap total itemized deductions
+    # (no attempt to adjust c04470 components for limitation)
     c04470 = min(c04470, ID_c[MARS - 1])
-    # Return total itemized deduction amounts and components
+    # Return total itemized deduction amounts and pre-limitation components
     return (c17000, c18300, c19200, c19700, c20500, c20800,
             c21040, c21060, c04470)
 
@@ -1165,7 +1229,7 @@ def AdditionalMedicareTax(e00200, MARS,
 @iterate_jit(nopython=True)
 def StdDed(DSI, earned, STD, age_head, age_spouse, STD_Aged, STD_Dep,
            MARS, MIDR, blind_head, blind_spouse, standard,
-           STD_allow_charity_ded_nonitemizers, e19800, ID_Charity_crt_cash,
+           STD_allow_charity_ded_nonitemizers, e19800, ID_Charity_crt_all,
            c00100, STD_charity_ded_nonitemizers_max):
     """
     Calculates standard deduction, including standard deduction for
@@ -1203,8 +1267,8 @@ def StdDed(DSI, earned, STD, age_head, age_spouse, STD_Aged, STD_Dep,
         deduction
     e19800: float
         Schedule A: cash charitable contributions
-    ID_Charity_crt_cash: float
-        Fraction of AGI cap on cash charitable deductions
+    ID_Charity_crt_all: float
+        Fraction of AGI cap on all charitable deductions
     c00100: float
         Federal AGI
     STD_charity_ded_nonitemizers_max: float
@@ -1238,19 +1302,21 @@ def StdDed(DSI, earned, STD, age_head, age_spouse, STD_Aged, STD_Dep,
         standard = 0.
     # calculate CARES cash charity deduction for nonitemizers
     if STD_allow_charity_ded_nonitemizers:
-        capped_ded = min(e19800, ID_Charity_crt_cash * c00100)
+        capped_ded = min(e19800, ID_Charity_crt_all * c00100)
         standard += min(capped_ded, STD_charity_ded_nonitemizers_max[MARS - 1])
     return standard
 
 
 @iterate_jit(nopython=True)
 def TaxInc(c00100, standard, c04470, c04600, MARS, e00900, c03260, e26270,
-           e02100, e27200, e00650, c01000, auto_loan_interest_deduction,
+           e02100, e27200, e00650, c01000,
+           senior_deduction, auto_loan_interest_deduction,
            PT_SSTB_income, PT_binc_w2_wages, PT_ubia_property,
            PT_qbid_rt, PT_qbid_limited,
            PT_qbid_taxinc_thd, PT_qbid_taxinc_gap, PT_qbid_w2_wages_rt,
-           PT_qbid_alt_w2_wages_rt, PT_qbid_alt_property_rt, c04800,
-           PT_qbid_ps, PT_qbid_prt, qbided):
+           PT_qbid_alt_w2_wages_rt, PT_qbid_alt_property_rt,
+           PT_qbid_ps, PT_qbid_prt, PT_qbid_min_ded, PT_qbid_min_qbi,
+           c04800, qbided):
     """
     Calculates taxable income, c04800, and
     qualified business income deduction, qbided.
@@ -1282,6 +1348,8 @@ def TaxInc(c00100, standard, c04470, c04600, MARS, e00900, c03260, e26270,
         Qualified dividends included in ordinary dividends
     c01000: float
         Limitation on capital losses
+    senior_deduction: float
+        Deduction for elderly head/spouse
     auto_loan_interest_deduction: float
         Deduction for qualified auto loan interest paid
     PT_SSTB_income: int
@@ -1309,12 +1377,16 @@ def TaxInc(c00100, standard, c04470, c04600, MARS, e00900, c03260, e26270,
         Alternative QBID cap rate on pass-through business W-2 wages paid
     PT_qbid_alt_property_rt: float
         Alternative QBID cap rate on pass-through business property owned
-    c04800: float
-        Regular taxable income
     PT_qbid_ps: list
         QBID phaseout taxable income start
     PT_qbid_prt: float
         QBID phaseout rate
+    PT_qbid_min_ded: float
+        Minimum QBID amount
+    PT_qbid_min_qbi: float
+        Minimum QBI necessary to get QBID no less than PT_qbid_min_ded
+    c04800: float
+        Regular taxable income
     qbided: float
         Qualified Business Income (QBI) deduction
 
@@ -1325,8 +1397,10 @@ def TaxInc(c00100, standard, c04470, c04600, MARS, e00900, c03260, e26270,
     qbided: float
         Qualified Business Income (QBI) deduction
     """
-    # calculate taxable income before qualified business income deduction
-    pre_qbid_taxinc = max(0., c00100 - max(c04470, standard) - c04600)
+    # calculate taxable income before qualified business income deduction,
+    # which is assumed to be stacked last in the list of deductions
+    odeds = senior_deduction + auto_loan_interest_deduction
+    pre_qbid_taxinc = max(0., c00100 - max(c04470, standard) - c04600 - odeds)
     # calculate qualified business income deduction
     qbinc = max(0., e00900 - c03260 + e26270 + e02100 + e27200)
     qbid_before_limits = qbinc * PT_qbid_rt
@@ -1371,9 +1445,12 @@ def TaxInc(c00100, standard, c04470, c04600, MARS, e00900, c03260, e26270,
             qbided = max(0., qbided - PT_qbid_prt * excess)
     else:  # if PT_qbid_limited is false
         qbided = qbid_before_limits
+    # apply minimum QBID logic
+    if qbinc >= PT_qbid_min_qbi and qbided < PT_qbid_min_ded:
+        qbided = PT_qbid_min_ded
 
-    # calculate taxable income after qualified business income deduction
-    c04800 = max(0., pre_qbid_taxinc - qbided - auto_loan_interest_deduction)
+    # calculate taxable income after qbided
+    c04800 = max(0., pre_qbid_taxinc - qbided)
     return (c04800, qbided)
 
 
@@ -1823,7 +1900,7 @@ def AMT(e07300, dwks13, standard, f6251, c00100, c18300, taxbc,
     taxbc: float
         Regular tax on regular taxable income before credits
     c04470: float
-        Itemized deductions after phase-out (zero for non itemizers)
+        Itemized deductions after phase-out (zero for non-itemizers)
     c17000: float
         Schedule A: Medical expenses deducted
     c20800: float

{taxcalc-5.0.4 → taxcalc-5.2.0}/taxcalc/calculator.py

@@ -14,7 +14,7 @@ import paramtools
 from taxcalc.calcfunctions import (TaxInc, SchXYZTax, GainsTax, AGIsurtax,
                                    NetInvIncTax, AMT, EI_PayrollTax, Adj,
                                    DependentCare, ALD_InvInc_ec_base, CapGains,
-                                   SSBenefits, UBI, AGI, AutoLoanInterestDed,
+                                   SSBenefits, UBI, AGI, MiscDed,
                                    ItemDed, StdDed, AdditionalMedicareTax,
                                    F2441, EITC, RefundablePayrollTaxCredit,
                                    ChildDepTaxCredit, AdditionalCTC, CTC_new,
@@ -1391,7 +1391,7 @@ class Calculator():
         CapGains(self.__policy, self.__records)
         SSBenefits(self.__policy, self.__records)
         AGI(self.__policy, self.__records)
-        AutoLoanInterestDed(self.__policy, self.__records)
+        MiscDed(self.__policy, self.__records)
         ItemDed(self.__policy, self.__records)
         AdditionalMedicareTax(self.__policy, self.__records)
         StdDed(self.__policy, self.__records)

{taxcalc-5.0.4 → taxcalc-5.2.0}/taxcalc/policy.py

@@ -61,7 +61,7 @@ class Policy(Parameters):
         # following parameters were renamed in PR 2918
         'SS_thd50': 'was renamed SS_thd1 in Tax-Calculator 5.0.0',
         'SS_thd85': 'was renamed SS_thd2 in Tax-Calculator 5.0.0',
-        # following parameters were removed in PR 2619
+        # following parameters were removed in PR 2919
         'PT_rt1': 'was removed in Tax-Calculator 5.0.0',
         'PT_rt2': 'was removed in Tax-Calculator 5.0.0',
         'PT_rt3': 'was removed in Tax-Calculator 5.0.0',
@@ -81,7 +81,7 @@ class Policy(Parameters):
         'PT_EligibleRate_passive': 'was removed in Tax-Calculator 5.0.0',
         'PT_wages_active_income': 'was removed in Tax-Calculator 5.0.0',
         'PT_top_stacking': 'was removed in Tax-Calculator 5.0.0',
-        # following parameters were removed in PR 2620
+        # following parameters were removed in PR 2920
         'ID_AmountCap_Switch': 'was removed in Tax-Calculator 5.0.0',
         'ID_AmountCap_rt': 'was removed in Tax-Calculator 5.0.0',
         'ID_BenefitCap_Switch': 'was removed in Tax-Calculator 5.0.0',
@@ -90,13 +90,25 @@ class Policy(Parameters):
         'ID_BenefitSurtax_crt': 'was removed in Tax-Calculator 5.0.0',
         'ID_BenefitSurtax_trt': 'was removed in Tax-Calculator 5.0.0',
         'ID_BenefitSurtax_em': 'was removed in Tax-Calculator 5.0.0',
-        # following parameters were renamed in PR 2628
+        # following parameters were renamed in PR 2928
         'CDCC_ps': 'was renamed CDCC_ps1 in Tax-Calculator 5.1.0',
         'CDCC_crt': 'was renamed CDCC_po1_rate_max in Tax-Calculator 5.1.0',
         'CDCC_frt': 'was renamed CDCC_po1_rate_min in Tax-Calculator 5.1.0',
         'CDCC_po_step_size': (
-            'was renamed CDCC_po1_step_size'
-            'in Tax-Calculator 5.1.0'
+            'was renamed CDCC_po1_step_size in Tax-Calculator 5.1.0'
+        ),
+        # following parameter was renamed in PR 2929
+        'II_prt': 'was renamed II_em_prt in Tax-Calculator 5.1.0',
+        # following parameter was renamed in PR 2932
+        'ID_Charity_crt_cash': (
+            'was renamed ID_Charity_crt_all in Tax-Calculator 5.1.0'
+        ),
+        # following parameters were renamed in PR 2939
+        'ID_reduction_salt_rate': (
+            'was renamed ID_reduction_rate in Tax-Calculator 5.1.0'
+        ),
+        'ID_reduction_other_rate': (
+            'was renamed ID_reduction_rate in Tax-Calculator 5.1.0'
         ),
     }
     # (2) specify which Policy parameters have been redefined recently