-// NEVER SPECIFY BOTH behavior AND growdiff_response IN SAME RUN
+// This JSON economic assumption file specifies a non-zero substitution
+// elasticity for taxable income, which causes a response in taxable income
+// to a reform-induced change in marginal tax rates
{
"consumption": {
},
"behavior": {
- // specify non-zero substitution elasticity of taxable income,
- // which is response of taxable income to change in marginal tax rate
"_BE_sub": {"2013": [0.25]}
},
"growdiff_baseline": {
},
"growdiff_response": {
- // MUST BE EMPTY BECAUSE ASSUMING BEHAVIORAL RESPONSE
+ },
+ "growmodel": {
}
}
diff --git a/docs/cookbook/ingredients/assumpA.json b/docs/cookbook/ingredients/assumpA.json
index 1f02b7d07..d2d384f8b 100644
--- a/docs/cookbook/ingredients/assumpA.json
+++ b/docs/cookbook/ingredients/assumpA.json
@@ -1,15 +1,16 @@
-// NEVER SPECIFY BOTH behavior AND growdiff_response IN SAME RUN
+// This JSON economic assumption file specifies a non-zero substitution
+// elasticity for taxable income, which causes a response in taxable income
+// to a reform-induced change in marginal tax rates
{
"consumption": {
},
"behavior": {
- // specify non-zero substitution elasticity of taxable income,
- // which is response of taxable income to change in marginal tax rate
"_BE_sub": {"2013": [0.25]}
},
"growdiff_baseline": {
},
"growdiff_response": {
- // MUST BE EMPTY BECAUSE ASSUMING BEHAVIORAL RESPONSE
+ },
+ "growmodel": {
}
}
diff --git a/docs/cookbook/recipe03.res b/docs/cookbook/recipe03.res
index 2c4c2f33e..938cbf881 100644
--- a/docs/cookbook/recipe03.res
+++ b/docs/cookbook/recipe03.res
@@ -4,8 +4,8 @@ WARNING: Tax-Calculator packages for Python 2.7 will
no longer be provided beginning in 2019
because Pandas is stopping development for 2.7
SOLUTION: upgrade to Python 3.6 now
-Filing Units Receiving EITC and Average Positive EITC by AGI category
-AGI category Num(#M) Avg($K)
+Filing Units Receiving EITC and Average Positive EITC by AGI Category
+AGI Category Num(#M) Avg($K)
[-9e+99, 1.0) 0.059 1.340
[1.0, 5000.0) 1.772 0.711
[5000.0, 10000.0) 3.672 1.638
diff --git a/docs/index.html b/docs/index.html
index 7a7113507..5797405c5 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -41,6 +41,10 @@ Flexible quantity_response +utility function is available in Tax-Calculator release 0.20.0 and +higher, and there is a new Cookbook recipe to illustrate its use +
Fix data and logic bugs so that the Child Tax Credit for those with kids age 17 is now lower and so that the income tax liability for those with large business @@ -79,7 +83,8 @@
Policy Parameters that specify tax reforms
Input Variables that specify tax filing units
Output Variables that describe tax results
-Response Parameters that specify reform responses
+Assumption Parameters that specify economic +assumptions
Back to Section Contents Back to Document Contents
@@ -335,26 +340,26 @@This part explains how to specify response assumption files used in +
This part explains how to specify economic assumption files used in non-static tax analysis. If you want to start out doing static analysis, you can skip this part now and come back to read it whenever you want to go beyond static analysis. The next part of this section discusses filing-unit input files.
-The details of economic response assumptions are contained in a +
The details of economic assumptions are contained in a text file that you write with a text editor. The assumptions are -expressed by specifying which response parameters are changed from +expressed by specifying which parameters are changed from their default values, all of which are zero. The timing and magnitude of -these response parameter changes are written in JSON, a simple and +these parameter changes are written in JSON, a simple and widely-used data-specification language.
-For examples of response assumption files and the general rules for +
For examples of economic assumption files and the general rules for writing JSON assumption files, go -to this +to this page.
-If you want to upload policy reform and response assumption files +
If you want to upload policy reform and economic assumption files to TaxBrain, you can go directly to this section's last part, which discusses uploading files to TaxBrain. If you want to analyze your @@ -408,7 +413,7 @@
Third, when you want to estimate how your reform affects total tax liabilities and/or the distribution of tax liabilities, you -can always upload your policy reform and response assumption files +can always upload your policy reform and economic assumption files to TaxBrain. Combining this option with the first option provides a complete tax analysis capability. The last part of this section @@ -491,7 +496,7 @@
Example (6) produces 2021 output for the filing units in the test.csv file using the policy reform specified in -the ref3.json file and the response assumptions +the ref3.json file and the economic assumptions specified in the res1.json file. The output results produced by this non-static analysis are written to the test-21-#-ref3-res1.csv file.
@@ -948,7 +953,7 @@Any policy reform or response assumption files you can use with tc +
Any policy reform or economic assumption files you can use with tc can be uploaded to trigger a TaxBrain run. As mentioned above the main advantages of doing this is getting access to the proprietary puf.csv input file, getting fast execution of both reform @@ -1202,7 +1207,7 @@
This section contains documentation of several sets of parameters that characterize responses to a tax reform. Consumption @@ -1213,36 +1218,31 @@
All the response parameters can be used by the tc CLI, but only +
All the assumption parameters can be used by the tc CLI, but only those with a TB Name appear in the TaxBrain GUI. All these -dynamic response parameters control advanced features of -Tax-Calculator, so understanding the +assumption parameters control advanced features of Tax-Calculator, so +understanding the source -code that uses them is essential. Default response parameter values are -zero and are projected into the future at that value, which implies no -response to the reform. Using the default no-reform-response -assumption for all the response parameters generates a static analysis -of the tax reform. The benefit value consumption parameters have a -default value of one, which implies the consumption value of the -in-kind benefits is equal to the government cost of providing the -benefits.
- -Note that some of the response parameters are incompatible with -each other, and therefore, cannot be used together. The behavior -parameters can not have non-zero values with specifying non-zero -growdiff response parameters.
- +code that uses them is essential. Default values of most +assumption parameters are zero and are projected into the future at +that value, which implies no response to the reform. Using the +default no-reform-response assumption for all the response parameters +generates a static analysis of the tax reform. The benefit value +consumption parameters have a default value of one, which implies the +consumption value of the in-kind benefits is equal to the government +cost of providing the benefits.Response Parameter — Consumption
tc Name: _MPC_e17500
Long Name: Marginal propensity to consume medical expenses
Description: Defined as dollar change in medical-expense consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Response Parameter — Consumption
tc Name: _MPC_e18400
Long Name: Marginal propensity to consume state-and-local taxes
Description: Defined as dollar change in state-and-local-taxes consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Response Parameter — Consumption
tc Name: _MPC_e19800
Long Name: Marginal propensity to consume charity cash contributions
Description: Defined as dollar change in charity-cash-contribution consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Response Parameter — Consumption
tc Name: _MPC_e20400
Long Name: Marginal propensity to consume miscellaneous deduction expenses
Description: Defined as dollar change in miscellaneous-deduction-expense consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Response Parameter — Consumption
tc Name: _BEN_housing_value
Long Name: Consumption value of housing benefits
Description: Consumption value per dollar of housing benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_snap_value
Long Name: Consumption value of SNAP benefits
Description: Consumption value per dollar of SNAP benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_tanf_value
Long Name: Consumption value of TANF benefits
Description: Consumption value per dollar of TANF benefits, some of which are cash benefits and some of which are in-kind benefits.
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_vet_value
Long Name: Consumption value of veterans benefits
Description: Consumption value per dollar of veterans benefits, some of which are in-kind benefits (only about 48% are cash benefits).
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_wic_value
Long Name: Consumption value of WIC benefits
Description: Consumption value per dollar of WIC benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_mcare_value
Long Name: Consumption value of Medicare benefits
Description: Consumption value per dollar of Medicare benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_mcaid_value
Long Name: Consumption value of Medicaid benefits
Description: Consumption value per dollar of Medicaid benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Response Parameter — Consumption
tc Name: _BEN_other_value
Long Name: Consumption value of other benefits
Description: Consumption value per dollar of other benefits, some of which are in-kind benefits (somewhere between 52% and 76% are in-kind benefits).
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _MPC_e17500
Long Name: Marginal propensity to consume medical expenses
Description: Defined as dollar change in medical-expense consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Assumption Parameter — Consumption
tc Name: _MPC_e18400
Long Name: Marginal propensity to consume state-and-local taxes
Description: Defined as dollar change in state-and-local-taxes consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Assumption Parameter — Consumption
tc Name: _MPC_e19800
Long Name: Marginal propensity to consume charity cash contributions
Description: Defined as dollar change in charity-cash-contribution consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Assumption Parameter — Consumption
tc Name: _MPC_e20400
Long Name: Marginal propensity to consume miscellaneous deduction expenses
Description: Defined as dollar change in miscellaneous-deduction-expense consumption divided by dollar change in income. Typical value is in [0,1] range.
Default Value:
2013: 0.0
Assumption Parameter — Consumption
tc Name: _BEN_housing_value
Long Name: Consumption value of housing benefits
Description: Consumption value per dollar of housing benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_snap_value
Long Name: Consumption value of SNAP benefits
Description: Consumption value per dollar of SNAP benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_tanf_value
Long Name: Consumption value of TANF benefits
Description: Consumption value per dollar of TANF benefits, some of which are cash benefits and some of which are in-kind benefits.
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_vet_value
Long Name: Consumption value of veterans benefits
Description: Consumption value per dollar of veterans benefits, some of which are in-kind benefits (only about 48% are cash benefits).
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_wic_value
Long Name: Consumption value of WIC benefits
Description: Consumption value per dollar of WIC benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_mcare_value
Long Name: Consumption value of Medicare benefits
Description: Consumption value per dollar of Medicare benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_mcaid_value
Long Name: Consumption value of Medicaid benefits
Description: Consumption value per dollar of Medicaid benefits, all of which are in-kind benefits.
Default Value:
2013: 1.0
Assumption Parameter — Consumption
tc Name: _BEN_other_value
Long Name: Consumption value of other benefits
Description: Consumption value per dollar of other benefits, some of which are in-kind benefits (somewhere between 52% and 76% are in-kind benefits).
Default Value:
2013: 1.0
Response Parameter — Growdiff
tc Name: _ABOOK
Long Name: ABOOK additive difference from default projection
Description: Default projection is in growfactors.csv file. ABOOK extrapolates input variables: e07300 and e07400.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ACGNS
Long Name: ACGNS additive difference from default projection
Description: Default projection is in growfactors.csv file. ACGNS extrapolates input variables: e01200, p22250, p23250, e24515 and e24518.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ACPIM
Long Name: ACPIM additive difference from default projection
Description: Default projection is in growfactors.csv file. ACPIM extrapolates input variables: e03270, e03290 and e17500.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ACPIU
Long Name: ACPIU additive difference from default projection
Description: Default projection is in growfactors.csv file. ACPIU is the price inflation rate used to inflate many policy parameters. Note that non-zero values of this parameter will not affect historically known values of policy parameters.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ADIVS
Long Name: ADIVS additive difference from default projection
Description: Default projection is in growfactors.csv file. ADIVS extrapolates input variables: e00600 and e00650.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _AINTS
Long Name: AINTS additive difference from default projection
Description: Default projection is in growfactors.csv file. AINTS extrapolates input variables: e00300 and e00400.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _AIPD
Long Name: AIPD additive difference from default projection
Description: Default projection is in growfactors.csv file. AIPD extrapolates input variables: e19200.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ASCHCI
Long Name: ASCHCI additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHCI extrapolates input variables: e00900, e00900p and e00900s when they are positive.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ASCHCL
Long Name: ASCHCL additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHCL extrapolates input variables: e00900, e00900p and e00900s when they are negative.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ASCHEI
Long Name: ASCHEI additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHEI extrapolates input variables: e02000 when positive, and e26270, k1bx14p, k1bx14s and e27200 for all values.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ASCHEL
Long Name: ASCHEL additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHEL extrapolates input variable: e02000 when negative.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ASCHF
Long Name: ASCHF additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHF extrapolates input variables: e02100, e02100p and e02100s.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ASOCSEC
Long Name: ASOCSEC additive difference from default projection
Description: Default projection is in growfactors.csv file. ASOCSEC extrapolates input variable: e02400.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _ATXPY
Long Name: ATXPY additive difference from default projection
Description: Default projection is in growfactors.csv file. ATXPY extrapolates input variables: e00700, e00800, e01400, e01500, e01700, e03150, e03210, e03220, e03230, e03300, e03400, e03500, e07240, e07260, p08000, e09700, e09800, e09900, e11200, e18400, e18500, e19800, e20100, e20400, g20500, e07600, e32800, e58990, e62900, e87530, e87521 and cmbtp.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _AUCOMP
Long Name: AUCOMP additive difference from default projection
Description: Default projection is in growfactors.csv file. AUCOMP extrapolates input variable: e02300.
Default Value:
2013: 0.0
Response Parameter — Growdiff
tc Name: _AWAGE
Long Name: AWAGE additive difference from default projection
Description: Default projection is in growfactors.csv file. AWAGE extrapolates input variables: e00200, e00200p and e00200s. Also, AWAGE is the wage growth rate used to inflate the OASDI maximum taxable earnings policy parameter, _SS_Earnings_c. Note that non-zero values of this parameter will not affect historically known values of _SS_Earnings_c.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ABOOK
Long Name: ABOOK additive difference from default projection
Description: Default projection is in growfactors.csv file. ABOOK extrapolates input variables: e07300 and e07400.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ACGNS
Long Name: ACGNS additive difference from default projection
Description: Default projection is in growfactors.csv file. ACGNS extrapolates input variables: e01200, p22250, p23250, e24515 and e24518.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ACPIM
Long Name: ACPIM additive difference from default projection
Description: Default projection is in growfactors.csv file. ACPIM extrapolates input variables: e03270, e03290 and e17500.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ACPIU
Long Name: ACPIU additive difference from default projection
Description: Default projection is in growfactors.csv file. ACPIU is the price inflation rate used to inflate many policy parameters. Note that non-zero values of this parameter will not affect historically known values of policy parameters.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ADIVS
Long Name: ADIVS additive difference from default projection
Description: Default projection is in growfactors.csv file. ADIVS extrapolates input variables: e00600 and e00650.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _AINTS
Long Name: AINTS additive difference from default projection
Description: Default projection is in growfactors.csv file. AINTS extrapolates input variables: e00300 and e00400.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _AIPD
Long Name: AIPD additive difference from default projection
Description: Default projection is in growfactors.csv file. AIPD extrapolates input variables: e19200.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ASCHCI
Long Name: ASCHCI additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHCI extrapolates input variables: e00900, e00900p and e00900s when they are positive.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ASCHCL
Long Name: ASCHCL additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHCL extrapolates input variables: e00900, e00900p and e00900s when they are negative.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ASCHEI
Long Name: ASCHEI additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHEI extrapolates input variables: e02000 when positive, and e26270, k1bx14p, k1bx14s and e27200 for all values.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ASCHEL
Long Name: ASCHEL additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHEL extrapolates input variable: e02000 when negative.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ASCHF
Long Name: ASCHF additive difference from default projection
Description: Default projection is in growfactors.csv file. ASCHF extrapolates input variables: e02100, e02100p and e02100s.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ASOCSEC
Long Name: ASOCSEC additive difference from default projection
Description: Default projection is in growfactors.csv file. ASOCSEC extrapolates input variable: e02400.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _ATXPY
Long Name: ATXPY additive difference from default projection
Description: Default projection is in growfactors.csv file. ATXPY extrapolates input variables: e00700, e00800, e01400, e01500, e01700, e03150, e03210, e03220, e03230, e03300, e03400, e03500, e07240, e07260, p08000, e09700, e09800, e09900, e11200, e18400, e18500, e19800, e20100, e20400, g20500, e07600, e32800, e58990, e62900, e87530, e87521 and cmbtp.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _AUCOMP
Long Name: AUCOMP additive difference from default projection
Description: Default projection is in growfactors.csv file. AUCOMP extrapolates input variable: e02300.
Default Value:
2013: 0.0
Assumption Parameter — Growdiff
tc Name: _AWAGE
Long Name: AWAGE additive difference from default projection
Description: Default projection is in growfactors.csv file. AWAGE extrapolates input variables: e00200, e00200p and e00200s. Also, AWAGE is the wage growth rate used to inflate the OASDI maximum taxable earnings policy parameter, _SS_Earnings_c. Note that non-zero values of this parameter will not affect historically known values of _SS_Earnings_c.
Default Value:
2013: 0.0
Assumption Parameter — Growmodel
tc Name: _active
Long Name: GrowModel is active
Description: True in any year implies GrowModel is active in all years.
Default Value:
2013: False
Back to Section Contents Back to Document Contents
diff --git a/docs/index.htmx b/docs/index.htmx index 77a982d0a..222aa21c9 100644 --- a/docs/index.htmx +++ b/docs/index.htmx @@ -40,6 +40,10 @@ ensure you are viewing the most recent version of this page rather than an older version that your browser has saved in its cache of previously visited pages. +Flexible quantity_response +utility function is available in Tax-Calculator release 0.20.0 and +higher, and there is a new Cookbook recipe to illustrate its use +
Fix data and logic bugs so that the Child Tax Credit for those with kids age 17 is now lower and so that the income tax liability for those with large business diff --git a/docs/recipe00.graph.html b/docs/recipe00.graph.html index a01851df8..b5f7658c1 100644 --- a/docs/recipe00.graph.html +++ b/docs/recipe00.graph.html @@ -15,11 +15,11 @@