From b675c9e70a3615c2943abcb368db13530254e323 Mon Sep 17 00:00:00 2001 From: martinholmer Date: Fri, 18 May 2018 17:43:00 -0400 Subject: [PATCH] Update user documentation --- docs/index.html | 75 ++++++++++++++++++++++++++----------------------- docs/index.htmx | 4 +++ 2 files changed, 44 insertions(+), 35 deletions(-) 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 @@

What's New

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 @@ -79,7 +83,8 @@

Document Contents

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

TaxBrain GUI

@@ -198,8 +203,8 @@

Initiate Dynamic Analysis

effect of tax reforms on economic growth.

Clicking on one of these choices will allow you to specify some -addition economic response parameters and initiate the dynamic -analysis using your response parameter assumptions. +additional economic assumption parameters and initiate the dynamic +analysis using your economic assumptions.

Back to Section Contents   Back to Document Contents

@@ -335,26 +340,26 @@

Specify Tax Reform

Specify Analysis Assumptions

-

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 @@

Specify Filing Units

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 @@

Initiate Reform Analysis

one or more filing units. A baseline file is optional; no baseline file implies the policy baseline is current-law policy. A policy reform file is optional; no reform file implies no reform (that is, -you want to analyze current-law policy). A response assumption file +you want to analyze current-law policy). An economic assumption file is also optional; no assumption file implies you want to conduct static analysis. The output files written by tc are built-up from the name of the input file, baseline file, reform file, and @@ -517,7 +522,7 @@

Initiate Reform Analysis

test-20-#-#-#.csv. The first # symbol indicates we did not specify a baseline file and the second # symbol indicates we did not specify a policy reform file and the -third # symbol indicates we did not specify a response +third # symbol indicates we did not specify an economic assumption file. The variables included in the minimal output file include: RECID (of filing unit in the input file), @@ -641,7 +646,7 @@

Initiate Reform Analysis

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 @@

Tabulate Reform Results

Upload Files to TaxBrain

-

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 @@

Output Variables

Back to Document Contents

-

Response Parameters

+

Assumption Parameters

This section contains documentation of several sets of parameters that characterize responses to a tax reform. Consumption @@ -1213,36 +1218,31 @@

Response Parameters

used to specify baseline differences and/or reform responses in the annual rate of growth in economic variables.

-

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.

Section Contents

Consumption Parameters

Behavior Parameters

Growdiff Parameters

+

Growmodel Parameters

Consumption Parameters

-

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

Back to Section Contents

@@ -1256,7 +1256,12 @@

Behavior Parameters

Growdiff Parameters

-

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

+ + +

Growmodel Parameters

+ +

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