Code for CHI2014 paper and JSM 2014 presentation
Jupyter Notebook Python TeX Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Code to recreate the results for the paper: Estimating County Health Statistics with Twitter, Aron Culotta, CHI 2014.

Note that this is not intended as a library for Twitter analysis; instead, its main goal is to allow other researchers to reproduce results. This is unfortunately not that easy to do, since it relies on Twitter data (which is hard to share) and LIWC and PERMA lexicons (which are not freely available).

I've also included an iPython notebook for the reweighting experiments presented at JSM 2014.


  • Dependencies are listed in requirements.txt.
  • Additionally, uses the tokenizer from QUAC, which as of this writing does not allow easy_install. So, you'll have to install QUAC manually following these instructions, then add quac to your PYTHONPATH.
  • Once all dependencies are installed, run python develop, which will install some command-line aliases used by (twcounty-expt, twcounty-json2tsv, twcounty-tsv2feats, twcounty-tsv2stats).


  • Paths to LIWC and PERMA lexicons should be in environmental variables $LIWC and $PERMA. (Unfortunately, these are not free for download.) The expected format is:
1     Pronoun
2     Adjective
he    1
pretty     2
  • The code expects tweets in /data/twcounty/json/. Each file should be named after the FIPS of the county from which the tweets originated. The contents should be the raw json returned by the Twitter API. As sharing raw tweets violates Twitter's TOS, please send email to Aron Culotta (aronwc at, and I'll send you the list of tweet IDs. You will then have to submit queries to the Twitter API to retrieve the raw content.

The county health outcome data come from the 2013 report from

Reproducing results

Once everything is installed and the data is in place, you should be able to run the script Results will be written to paper/tables and paper/figs. Pickled data files and raw results will be in /data/twcounty/features.