PyTwoWay

PyTwoWay is the Python package associated with the following paper:

“How Much Should we Trust Estimates of Firm Effects and Worker Sorting?” by Stéphane Bonhomme, Kerstin Holzheu, Thibaut Lamadon, Elena Manresa, Magne Mogstad, and Bradley Setzler. No. w27368. National Bureau of Economic Research, 2020.

The package provides implementations for a series of estimators for models with two sided heterogeneity:

1. two way fixed effect estimator as proposed by Abowd Kramarz and Margolis

2. homoskedastic bias correction as in Andrews et al

3. heteroskedastic correction as in KSS

4. a group fixed estimator as in BLM

5. a group correlated random effect as presented in the main paper

If you want to give it a try, you can start the example notebook here: . This starts a fully interactive notebook with a simple example that generates data and runs the estimators.

The code is relatively efficient. Solving large sparse linear models relies on PyAMG. This is the code we use to estimate the different decompositions on US data. Data cleaning is handled by BipartitePandas.

The package provides a Python interface as well as an intuitive command line interface. Installation is handled by pip or Conda (TBD). The source of the package is available on GitHub at PyTwoWay. The online documentation is hosted here.

Quick Start

To install via pip, from the command line run:

pip install pytwoway

To run PyTwoWay via the command line interface, from the command line run:

pytw --my-config config.txt --fe --cre

Example config.txt:

data = file.csv
filetype = csv
col_dict = "{'i': 'your_workerid_col', 'j': 'your_firmid_col', 'y': 'your_compensation_col', 't': 'your_year_col'}"

Authors

Thibaut Lamadon, Assistant Professor in Economics, University of Chicago, lamadon@uchicago.edu

Adam A. Oppenheimer, Research Professional, University of Chicago, oppenheimer@uchicago.edu

Citation

Please use following citation to cite PyTwoWay in academic publications:

Bibtex entry:

@techreport{bhlmms2020,
  title={How Much Should We Trust Estimates of Firm Effects and Worker Sorting?},
  author={Bonhomme, St{\'e}phane and Holzheu, Kerstin and Lamadon, Thibaut and Manresa, Elena and Mogstad, Magne and Setzler, Bradley},
  year={2020},
  institution={National Bureau of Economic Research}
}

Development

If you want to contribute to the package, the easiest way is to use poetry to set up a local environment:

poetry install
poetry run python -m pytest

To push the package to PiP, increase the version number in the pyproject.toml file and then

poetry build poetry publish

Finally to build the package for conda and upload it

conda skeleton pypi pytwoway conda config –set anaconda_upload yes conda-build pytwoway -c tlamadon –output-folder pytwoway

User documentation

• Home
• From Terminal
• From Python
• From Stata

Notebook examples

• Simple
  • Simulate some data
  • Create a TwoWay object using your data
  • Clean data
  • Now we can run the CRE estimator
  • We can also run the FE estimator
  • Finally, we can investigate the results
• Monte Carlo
  • First, optionally set parameter values for the simulated data
  • Second, create a simulated Monte Carlo object using the parameter choices
  • Third, optionally set parameter values for the Monte Carlo simulation
  • Fourth, run the Monte Carlo simulation using the parameter choices
  • Fifth and finally, plot parameter estimates (plots show the difference from the truth)
• BLM
  • Simulate some data
  • Initialize and run BLMEstimator
  • Finally, we can investigate the results

Under the hood

• Python API
  • Overview
  • Modules and Methods
• TwoWay
• BLMEstimator
• CREEstimator
• FEEstimator
• TwoWayMonteCarlo