Federal Individual Income Tax Microsimulation Model
Python Tcl Batchfile Shell Makefile Awk Jupyter Notebook
Latest commit 06bd761 Nov 24, 2017 @martinholmer martinholmer Merge pull request #1701 from martinholmer/cps-sub-sample
Determine appropriate subsample size for cps.csv data
Failed to load latest commit information.
conda.recipe Update conda.recipe/install_local_taxcalc_package.sh Aug 20, 2017
continuous_integration Make test_docs_up_to_date a local_test Nov 12, 2017
docs Rename docs/make.py as docs/make_index.py Nov 20, 2017
file-upload-tests Update file-upload-test results for 0.10.2 Oct 10, 2017
read-the-docs Drop Behavioral_example.ipynb and simplify test_notebooks.py logic Oct 23, 2017
taxcalc Merge pull request #1701 from martinholmer/cps-sub-sample Nov 24, 2017
.coveragerc Revert .coveragerc settings Oct 20, 2017
.gitattributes add versioning with versioneer Jan 30, 2015
.gitignore Rename docs directory as read-the-docs directory Apr 11, 2017
.travis.yml Make test_docs_up_to_date a local_test Nov 12, 2017
CODING.md Update CODING.md documentation Oct 15, 2017
DATAPREP.md Fix typos in DATAPREP.md May 4, 2017
LICENSE.md Update LICENSE.md Oct 15, 2015
MANIFEST.in Rely on pd.read_csv compression='infer' default Jul 17, 2017
ODD_RECORDS.md Update output variable documentation Apr 28, 2017
README.md Minor tax-calculator/README.md edit Jun 10, 2017
RELEASES.md Update again the RELEASES.md info Nov 18, 2017
TESTING.md Make reform comparison tests use puf subsample Aug 3, 2017
appveyor.yml Update comments in appveyor.yml Oct 12, 2017
environment.yml Add pytest-xdist plug-in to taxcalc-dev environment Jul 28, 2017
readthedocs.yml Add YAML file for readtheodcs Mar 1, 2016
setup.cfg update setup.cfg to fix pytest deprec warning Dec 31, 2016
setup.py Rely on Python 3.6 Oct 12, 2017
versioneer.py resolve E226, E241, E121 Aug 10, 2015


Developing Tax-Calculator

This document tells you how to begin contributing to Tax-Calculator by reporting a bug, improving the documentation or making an enhancement to the Python source code. If you only want to use Tax-Calculator, you should begin by reading the user documentation that describes how to use Tax-Calculator on your own computer (without doing any programming) and how to use the Tax-Calculator web application called TaxBrain.

What is Tax-Calculator?

Tax-Calculator simulates the US federal individual income tax system. In conjunction with micro data that represent the US population and a set of behavioral assumptions, Tax-Calculator can be used to conduct revenue scoring and distributional analyses of tax policies. Tax-Calculator is written in Python, an interpreted language that can execute on Windows, Mac, or Linux.


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 Tax-Calculator.

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

If you want to propose code changes, follow the directions in the Contributor Guide on how to clone the Tax-Calculator git repository. Before developing any code changes be sure to read completely the Contributor Guide and then read about our coding style and testing procedures. The Tax-Calculator release history provides a summary of past and current development work.

If you are relying on Tax-Calculator capabilities in your own project, be sure to read the definition of the Tax-Calculator Public API.

Citing Tax-Calculator

Tax-Calculator (Version #.#.#)[Source code], https://github.com/open-source-economics/tax-calculator