Skip to content
Poisson pseudo-likelihood regression with multiple levels of fixed effects
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
guides Update undocumented.md Mar 19, 2019
src (minor) Change path of dev "reload" option Mar 19, 2019
test
.gitignore Update readme Feb 27, 2019
LICENSE Update readme Feb 27, 2019
README.md

README.md

ppmlhdfe: Poisson pseudo-likelihood regression with multiple levels of fixed effects

ppmlhdfe is a Stata package that implements Poisson pseudo-maximum likelihood regressions (PPML) with multi-way fixed effects, as described in Correia, Guimarães, Zylkin (2019a). The estimator employed is robust to statistical separation and convergence issues, due to the procedures developed in Correia, Guimarães, Zylkin (2019b).

Citation

Text

  • Sergio Correia, Paulo Guimarães, Thomas Zylkin: “Verifying the existence of maximum likelihood estimates for generalized linear models”, 2019; arXiv:1903.01633.
  • Sergio Correia, Paulo Guimarães, Thomas Zylkin: “ppmlhdfe: Fast Poisson Estimation with High-Dimensional Fixed Effects”, 2019; arXiv:1903.01690.

Bibtex

@Misc{1903.01633,
  Author = {Sergio Correia and Paulo Guimarães and Thomas Zylkin},
  Title = {Verifying the existence of maximum likelihood estimates for generalized linear models},
  Year = {2019},
  Eprint = {arXiv:1903.01633},
}

@Misc{1903.01690,
  Author = {Sergio Correia and Paulo Guimarães and Thomas Zylkin},
  Title = {{ppmlhdfe: Fast Poisson Estimation with High-Dimensional Fixed Effects}},
  Year = {2019},
  Eprint = {arXiv:1903.01690},
}

References

Quick information on the command can be glanced from the help file.

For detailed information:

  • The ppmlhdfe paper explains the command in depth, provides examples, etc.
  • The paper on statistical separation discusses the crucial step of solving the separation issue, that can otherwise lead to incorrect convergence (or no convergence) in Poisson and other GLM models.

For introductory guides on separation, and on how ppmlhdfe internally address it, see the following documents:

  • Separation primer: a quick practical introduction to separation in Poisson models.
  • Separation benchmarks: shows how separation affects all common statistical packages.
  • Undocumented options: this pages briefly lists otherwise undocumented options of ppmlhdfe, which might be useful for advanced users.

Installation

ppmlhdfe requires the latest versions of ftools and reghdfe.

To install stable versions from SSC:

cap ado uninstall ftools
cap ado uninstall reghdfe
cap ado uninstall ppmlhdfe

ssc install ftools
ssc install reghdfe
ssc install ppmlhdfe

clear all
ftools, compile
reghdfe, compile

* Test program
sysuse auto, clear
reghdfe price weight, a(turn)
ppmlhdfe price weight, a(turn)

To install the latest versions from Github:

* Install ftools
cap ado uninstall ftools
net install ftools, from("https://raw.githubusercontent.com/sergiocorreia/ftools/master/src/")

* Install reghdfe
cap ado uninstall reghdfe
net install reghdfe, from("https://raw.githubusercontent.com/sergiocorreia/reghdfe/master/src/")

* Install ppmlhdfe
cap ado uninstall ppmlhdfe
net install ppmlhdfe, from("https://raw.githubusercontent.com/sergiocorreia/ppmlhdfe/master/src/")

* Create compiled files
ftools, compile
reghdfe, compile

* Check versions
ppmlhdfe, version

* Clear programs already in memory
program drop _all

* Test program
sysuse auto, clear
reghdfe price weight, a(turn)
ppmlhdfe price weight, a(turn)
You can’t perform that action at this time.