PSL module that estimates partial-equilibrium behavioral responses to tax changes simulated by Tax-Calculator
Branch: master
Clone or download
Latest commit df35a9d Feb 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
behresp
conda.recipe Handle GitHub organization name change Dec 7, 2018
continuous_integration
docs
.coveragerc Add assumption_errors to tbi.py and add more tests Oct 22, 2018
.gitignore Add many other files to repo Oct 16, 2018
.travis.yml Add Travis-CI tests under Python 3.7 Dec 13, 2018
LICENSE.md Add many other files to repo Oct 16, 2018
Makefile
PSL_catalog.json
README.md Update B-R documentation Feb 9, 2019
RELEASES.md
RELEASING.md
appveyor.yml Add behresp/conftest.py file Oct 20, 2018
environment.yml
gitpr
gitpr.bat Add many other files to repo Oct 16, 2018
gitsync
gitsync.bat Add many other files to repo Oct 16, 2018
setup.cfg Add behresp/conftest.py file Oct 20, 2018
setup.py

README.md

PSL cataloged Python 3.6+ Build Status Codecov

Behavioral-Responses

This document tells you how to begin using or contributing to Behavioral-Responses. Begin by reading the Tax-Calculator user guide and then the Behavioral-Responses user guide that describes how to write Python scripts that use Behavioral-Responses together with Tax-Calculator on your own computer.

What is Behavioral-Responses?

Behavioral-Responses, which is part of the Policy Simulation Library (PSL) collection of USA tax models, estimates partial-equilibrium behavioral responses to changes in the US federal individual income and payroll tax system as simulated by Tax-Calculator. It provides two ways of doing this: (1) the response function, which contains higher-level logic that supports the TaxBrain "Partial Equilibrium Simulation" capability and requires specification of only the elasticities, and (2) the quantity_response function, which contains lower-level logic that requires specification of the quantity whose response is to be estimated, requires specification of the marginal tax rates and elasticities to be used in the response calculation, and allows the response estimation to be conducted by subgroup with different elasticities for each subgroup.

Disclaimer

Results will change as the underlying models improve. A fundamental reason for adopting open source methods in this project is so that people from all backgrounds can contribute to the models that our society uses to assess economic policy; when community-contributed improvements are incorporated, the model will produce different results.

Getting Started

If you want to report a bug, create a new issue here providing details on what you think is wrong with Behavioral-Responses.

If you want to request an enhancement, create a new issue here providing details on what you think should be added to Behavioral-Responses.

If you want to propose code changes, follow the directions in the Tax-Calculator contributor guide on how to fork and clone the Behavioral-Responses git repository. Before developing any code changes be sure to read completely the Tax-Calculator contributor guide and then read about the Tax-Calculator pull-request workflow. When reading both documents, be sure to mentally substitute Behavioral-Response for Tax-Calculator and behresp for taxcalc.

The Behavioral-Responses release history provides a high-level summary of past pull requests and access to a complete list of merged, closed, and pending pull requests.

Citing Behavioral-Responses

Please cite the source of your analysis as "Behavioral-Responses release #.#.#, author's calculations." If you wish to link to Behavioral-Responses, https://PSLmodels.github.io/Behavioral-Responses/ is preferred. Additionally, we strongly recommend that you describe the elasticity parameters used, and provide a link to the materials required to replicate your analysis or, at least, note that those materials are available upon request.