From 228500ebe4121af6f5538709e64f0d8c07634449 Mon Sep 17 00:00:00 2001 From: Bodi Yang Date: Tue, 2 Apr 2024 15:21:05 -0400 Subject: [PATCH] add model interaction --- docs/about/history.md | 2 +- docs/about/model_interaction.md | 10 ++++++++++ docs/about/roadmap.md | 18 ------------------ docs/index.md | 7 +++---- 4 files changed, 14 insertions(+), 23 deletions(-) create mode 100644 docs/about/model_interaction.md delete mode 100644 docs/about/roadmap.md diff --git a/docs/about/history.md b/docs/about/history.md index a9db954..0bd3f19 100644 --- a/docs/about/history.md +++ b/docs/about/history.md @@ -15,6 +15,6 @@ However, in the progess of model expansion, many payroll tax featured developmen From the perspective of model management, many research organizations also build their tax model systems consisted of an income tax model and payroll tax model. It is thus considered better to have Tax-Calculator and Taxcalc-Payroll seperately serveing as income tax calculator and payroll tax calculator. -Taxcalc-Payroll inherits the software infrastructure from Tax-Calculator. These two models are highly integrated, with most tax calaulation functions can be called by each other. Users can still conduct both income and payroll tax analysis from one either model. +Taxcalc-Payroll inherits the software infrastructure from Tax-Calculator. These two models are highly integrated, with most tax calaulation functions can be called by each other. Users can still conduct both income and payroll tax analysis from either model. diff --git a/docs/about/model_interaction.md b/docs/about/model_interaction.md new file mode 100644 index 0000000..39439b2 --- /dev/null +++ b/docs/about/model_interaction.md @@ -0,0 +1,10 @@ +Model Interaction +======= + +Taxcalc-Payroll is the microsimulation model conducting the static analysis of federal individual income and payroll taxes, it interacts with other models to conduct higher level analysis, like revenue estimation and non-static analysis. + +Taxcalc-Payroll takes the input data (reweighted PUF and CPS data) from [Tax-Data](https://github.com/PSLmodels/taxdata) to conduct tax revenue estimation. Taxcalc-Payroll works with [Behavior Response Package](https://github.com/PSLmodels/Behavioral-Responses) to conduct the conventional analysis. + +To be noticed, Tax-Calculator and Taxcalc-Payroll are highly integrated. Users can call most of Tax-Calculator's functions from Taxcalc-Payroll. This means the user can do both income tax and payroll tax analysis from the model. (this also holds for Tax-Calculator) + +Please refer to [AEI OSPC webpage](https://www.ospc.org/taxmodels/) for a more detailed documentation. \ No newline at end of file diff --git a/docs/about/roadmap.md b/docs/about/roadmap.md deleted file mode 100644 index 25488c8..0000000 --- a/docs/about/roadmap.md +++ /dev/null @@ -1,18 +0,0 @@ -Roadmap -======= - -Because Tax-Calculator itself does only static analysis of federal individual income and payroll taxes, it must interact with other models in order to analyze business taxes or conduct non-static analysis. These other models typically use Tax-Calculator to estimate reform-induced changes in after-tax incomes and marginal tax rates, and then use that information to calculate how other taxes or non-static behavior cause changes in individual incomes or expenses. These changes are then fed back to Tax-Calculator so that individual tax liabilities, as well as aggregate and distribution results, can be recalculated. All these interactions between Tax-Calculator and other models are handled by [Tax-Brain](https://github.com/PSLmodels/Tax-Brain#tax-brain). - -The **future development of Tax-Calculator** itself will focus on the following activities: - -* Fix bugs in tax-calculation logic. - -* Add new policy parameters to enable parametric simulation of new reforms. - -* Update actual policy parameter values as they become available each year. - -* Update filing-unit data used by Tax-Calculator as they become available. - -* Add ability to use publicly-available synthetic filing-unit data derived from a recent IRS-SOI PUF file. - -* Improve documentation of model logic and data. \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 92c4c6c..f4ada5c 100644 --- a/docs/index.md +++ b/docs/index.md @@ -46,10 +46,9 @@ The cross-model validation work with NBER's TAXSIM model is described ## A parallel project with Tax-Calculator -Taxcalc-Payroll focuses on payroll tax analysis. It is a parallel project with Tax-Calculator -which aims to be focusing more on income tax analysis. Taxcalc-Payroll inherits the infrastructure -from Tax-Calculator. Two models are highly integrated. Users can do both income tax and payroll tax - analysis in either of the model +Tax-Calculator and Taxcalc-Payroll are the microsimulation models for income tax and paryroll tax analysis. +They are parallel projects. Two models are highly integrated. Users can do both income tax and payroll tax +analysis from either model. Please read the details at {doc}`about/history`.