Metadata-Version: 2.4
Name: policyengine-uk
Version: 2.57.0
Summary: PolicyEngine tax and benefit system for the UK.
Project-URL: Homepage, https://github.com/PolicyEngine/policyengine-uk
Project-URL: Repository, https://github.com/PolicyEngine/policyengine-uk
Project-URL: Issues, https://github.com/PolicyEngine/policyengine-uk/issues
Project-URL: Changelog, https://github.com/PolicyEngine/policyengine-uk/blob/master/CHANGELOG.md
Author-email: PolicyEngine <nikhil@policyengine.org>
Maintainer-email: Nikhil Woodruff <nikhil@policyengine.org>
License-Expression: AGPL-3.0
License-File: LICENSE
Keywords: benefit,microsimulation,social,tax
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.13
Requires-Dist: microdf-python>=1.0.2
Requires-Dist: policyengine-core>=3.19.3
Requires-Dist: pydantic>=2.11.7
Requires-Dist: tables>=3.10.2
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: coverage; extra == 'dev'
Requires-Dist: furo<2023; extra == 'dev'
Requires-Dist: jupyter-book>=2.0.0a0; extra == 'dev'
Requires-Dist: linecheck; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: rich; extra == 'dev'
Requires-Dist: setuptools; extra == 'dev'
Requires-Dist: snowballstemmer<3,>=2; extra == 'dev'
Requires-Dist: sphinx-argparse<1,>=0.3.2; extra == 'dev'
Requires-Dist: sphinx-math-dollar<2,>=1.2.1; extra == 'dev'
Requires-Dist: tqdm; extra == 'dev'
Requires-Dist: wheel; extra == 'dev'
Requires-Dist: yaml-changelog>=0.1.7; extra == 'dev'
Description-Content-Type: text/markdown

# PolicyEngine UK

[![PyPI version](https://badge.fury.io/py/policyengine-uk.svg)](https://badge.fury.io/py/policyengine-uk)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

PolicyEngine UK is [PolicyEngine](https://policyengine.org)'s microsimulation model of the UK tax-benefit system.
It uses the PolicyEngine Core microsimulation framework, which is based on [OpenFisca](https://openfisca.org).

The elements are described in different folders. All the modelling happens within the `policyengine_uk` folder.

- The rates and other system parameters are in the `parameters` folder.
- The formulas and inputs are in the `variables` folder.
- This country package comes also with reforms in the `reforms` folder.

The files that are outside from the `policyengine_uk` folder are used to set up the development environment. Installation instructions are located along with other documentation in the `docs` folder.

The model supports multiple different input datasets provided by the user, one of which is the Family Resources Survey,[^1] containing microdata on household incomes across the UK.
PolicyEngine UK enhances this dataset by fusing it to other surveys and reweighting it to minimize a comprehensive loss metric that measures the difference from an array of administrative totals.

[^1]: Department for Work and Pensions, Office for National Statistics, NatCen Social Research. (2021). Family Resources Survey, 2019-2020. [data collection]. UK Data Service. SN: 8802, http://doi.org/10.5255/UKDA-SN-8802-1


## Fast setup instructions

1. Run `pip install policyengine-uk`

2. Run `policyengine-uk` and go through the prompt to setup microdata.


## Contact

The primary maintainer for PolicyEngine UK is Nikhil Woodruff, co-founder and CTO of PolicyEngine (nikhil@policyengine.org).


## Citation

You may cite the source of your analysis as "PolicyEngine UK release #.#.#, author's calculations."
