# CausalTensor
CausalTensor is a python package for doing causal inference and policy evaluation using panel data.
## What is CausalTensor
CausalTensor is a suite of tools for addressing questions like "What is the impact of strategy X to outcome Y" given time-series data colleting from multiple units. Answering such questions has wide range of applications from econometrics, operations research, business analytics, polictical science, to healthcare. Please visit our [complete documentation](https://causaltensor.readthedocs.io/) for more information.
## Installing CausalTensor
CausalTensor is compatible with Python 3 or later and also depends on numpy. The simplest way to install CausalTensor and its dependencies is from PyPI with pip, Python's preferred package installer.
$ pip install causaltensor
Note that CausalTensor is an active project and routinely publishes new releases. In order to upgrade CausalTensor to the latest version, use pip as follows.
$ pip install -U causaltensor
## Using CausalTensor
We have implemented the following estimators including the traditional method Difference-in-Difference and recent proposed methods such as Synthetic Difference-in-Difference, Matrix Completion with Nuclear Norm Minimization, and De-biased Convex Panel Regression.
| Estimator | Reference |
| ----------- | ----------- |
| [Difference-in-Difference (DID)](https://en.wikipedia.org/wiki/Difference_in_differences) | [Implemented through two-way fixed effects regression.](http://web.mit.edu/insong/www/pdf/FEmatch-twoway.pdf) |
| [De-biased Convex Panel Regression (DC-PR)](https://arxiv.org/abs/2106.02780) | Vivek Farias, Andrew Li, and Tianyi Peng. "Learning treatment effects in panels with general intervention patterns." Advances in Neural Information Processing Systems 34 (2021): 14001-14013. |
| [Synthetic Control (OLS SC)](http://www.jstor.org/stable/3132164) | Abadie, Alberto, and Javier Gardeazabal. “The Economic Costs of Conflict: A Case Study of the Basque Country.” The American Economic Review 93, no. 1 (2003): 113–32. |
| [Synthetic Difference-in-Difference (SDID)](https://arxiv.org/pdf/1812.09970.pdf) | Dmitry Arkhangelsky, Susan Athey, David A. Hirshberg, Guido W. Imbens, and Stefan Wager. "Synthetic difference-in-differences." American Economic Review 111, no. 12 (2021): 4088-4118. |
| [Matrix Completion with Nuclear Norm Minimization (MC-NNM)](https://arxiv.org/abs/1710.10251)| Susan Athey, Mohsen Bayati, Nikolay Doudchenko, Guido Imbens, and Khashayar Khosravi. "Matrix completion methods for causal panel data models." Journal of the American Statistical Association 116, no. 536 (2021): 1716-1730. |
Please visit our [documentation](https://causaltensor.readthedocs.io/) for the usage instructions. Or check the following simple demo as a tutorial:
- [Panel Data Example](https://colab.research.google.com/github/TianyiPeng/causaltensor/blob/main/tutorials/Panel%20Data%20Example.ipynb)
- [Panel Data with Multiple Treatments](https://colab.research.google.com/github/TianyiPeng/causaltensor/blob/main/tutorials/Panel_Regression_with_Multiple_Interventions.ipynb)
- [MC-NNM with covariates and missing data](https://colab.research.google.com/github/TianyiPeng/causaltensor/blob/main/tests/MCNNM_test.ipynb)
Raw data
{
"_id": null,
"home_page": null,
"name": "causaltensor",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "causal, inference, panel, matrix, tensor",
"author": "Tianyi Peng",
"author_email": "tianyipeng95@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/27/76/a04fd24cc42c6c1acef64977a6217986607715671e28be96b196dacf7e39/causaltensor-0.1.10.tar.gz",
"platform": null,
"description": "# CausalTensor\n CausalTensor is a python package for doing causal inference and policy evaluation using panel data. \n\n\n## What is CausalTensor\nCausalTensor is a suite of tools for addressing questions like \"What is the impact of strategy X to outcome Y\" given time-series data colleting from multiple units. Answering such questions has wide range of applications from econometrics, operations research, business analytics, polictical science, to healthcare. Please visit our [complete documentation](https://causaltensor.readthedocs.io/) for more information. \n\n## Installing CausalTensor\nCausalTensor is compatible with Python 3 or later and also depends on numpy. The simplest way to install CausalTensor and its dependencies is from PyPI with pip, Python's preferred package installer.\n\n $ pip install causaltensor\n\nNote that CausalTensor is an active project and routinely publishes new releases. In order to upgrade CausalTensor to the latest version, use pip as follows.\n\n $ pip install -U causaltensor\n \n## Using CausalTensor\nWe have implemented the following estimators including the traditional method Difference-in-Difference and recent proposed methods such as Synthetic Difference-in-Difference, Matrix Completion with Nuclear Norm Minimization, and De-biased Convex Panel Regression. \n\n| Estimator | Reference |\n| ----------- | ----------- |\n| [Difference-in-Difference (DID)](https://en.wikipedia.org/wiki/Difference_in_differences) | [Implemented through two-way fixed effects regression.](http://web.mit.edu/insong/www/pdf/FEmatch-twoway.pdf) |\n| [De-biased Convex Panel Regression (DC-PR)](https://arxiv.org/abs/2106.02780) | Vivek Farias, Andrew Li, and Tianyi Peng. \"Learning treatment effects in panels with general intervention patterns.\" Advances in Neural Information Processing Systems 34 (2021): 14001-14013. |\n| [Synthetic Control (OLS SC)](http://www.jstor.org/stable/3132164) | Abadie, Alberto, and Javier Gardeazabal. \u201cThe Economic Costs of Conflict: A Case Study of the Basque Country.\u201d The American Economic Review 93, no. 1 (2003): 113\u201332. |\n| [Synthetic Difference-in-Difference (SDID)](https://arxiv.org/pdf/1812.09970.pdf) | Dmitry Arkhangelsky, Susan Athey, David A. Hirshberg, Guido W. Imbens, and Stefan Wager. \"Synthetic difference-in-differences.\" American Economic Review 111, no. 12 (2021): 4088-4118. |\n| [Matrix Completion with Nuclear Norm Minimization (MC-NNM)](https://arxiv.org/abs/1710.10251)| Susan Athey, Mohsen Bayati, Nikolay Doudchenko, Guido Imbens, and Khashayar Khosravi. \"Matrix completion methods for causal panel data models.\" Journal of the American Statistical Association 116, no. 536 (2021): 1716-1730. |\n\nPlease visit our [documentation](https://causaltensor.readthedocs.io/) for the usage instructions. Or check the following simple demo as a tutorial:\n\n- [Panel Data Example](https://colab.research.google.com/github/TianyiPeng/causaltensor/blob/main/tutorials/Panel%20Data%20Example.ipynb)\n- [Panel Data with Multiple Treatments](https://colab.research.google.com/github/TianyiPeng/causaltensor/blob/main/tutorials/Panel_Regression_with_Multiple_Interventions.ipynb)\n- [MC-NNM with covariates and missing data](https://colab.research.google.com/github/TianyiPeng/causaltensor/blob/main/tests/MCNNM_test.ipynb)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Package for causal inference in panels",
"version": "0.1.10",
"project_urls": {
"Homepage": "https://github.com/TianyiPeng/causaltensor",
"Repository": "https://github.com/TianyiPeng/causaltensor"
},
"split_keywords": [
"causal",
" inference",
" panel",
" matrix",
" tensor"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5d212ec62feb26573cba6b042dcddf50dc1427d05b2a9e68c8e898e42149f5e5",
"md5": "7fd01e19e24ff51f133fedb3fdc48eb1",
"sha256": "e8aa7b2d57418ad5af7fe4e4035e527b590d9eb0989084164c720480f6d78663"
},
"downloads": -1,
"filename": "causaltensor-0.1.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7fd01e19e24ff51f133fedb3fdc48eb1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 41493,
"upload_time": "2025-02-07T16:58:54",
"upload_time_iso_8601": "2025-02-07T16:58:54.456992Z",
"url": "https://files.pythonhosted.org/packages/5d/21/2ec62feb26573cba6b042dcddf50dc1427d05b2a9e68c8e898e42149f5e5/causaltensor-0.1.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2776a04fd24cc42c6c1acef64977a6217986607715671e28be96b196dacf7e39",
"md5": "695feceaea6d5df9c13ac66ac758170e",
"sha256": "80c85d0ec0664f023e57cec484aacdb3bc879dc755f3dff062997e0c866a875d"
},
"downloads": -1,
"filename": "causaltensor-0.1.10.tar.gz",
"has_sig": false,
"md5_digest": "695feceaea6d5df9c13ac66ac758170e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 30656,
"upload_time": "2025-02-07T16:58:55",
"upload_time_iso_8601": "2025-02-07T16:58:55.529202Z",
"url": "https://files.pythonhosted.org/packages/27/76/a04fd24cc42c6c1acef64977a6217986607715671e28be96b196dacf7e39/causaltensor-0.1.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-07 16:58:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TianyiPeng",
"github_project": "causaltensor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "causaltensor"
}