Skip to main content

Basic usage script for LabMT1.0 dataset

Project description

TL;DR a simple labMT usage script

This script uses the language assessment by Mechanical Turk (labMT) word list to score the happiness of a corpus. The labMT word list was created by combining the 5000 words most frequently appearing in four sources: Twitter, the New York Times, Google Books, and music lyrics, and then scoring the words for sentiment on Amazon’s Mechanical Turk. The list is described in detail in the publication Dodds’ et al. 2011, PLOS ONE, “Temporal Patterns of Happiness and Information in a Global-Scale Social Network: Hedonometrics and Twitter.”

Given two corpora, the script “” creates a word-shift graph illustrating the words most responsible for the difference in happiness between the two corpora. The corpora should be large (e.g. at least 10,000 words) in order for the difference to be meaningful, as this is a bag-of-words approach. As an example, a random collection of English tweets from both Saturday January 18 2014 and Tuesday January 21 2014 are included in the “example” directory. They can be compared by moving to the test directory, using the command

python example-shift.html

and opening the file example-shift.html in a web browser. For an explanation of the resulting plot, please visit


Cloning the github directly is recommended, i.e.

git clone

and then installing locally using

sudo python install

Tests can be run by navigating to the test directory, and running


which will compare the two days in test/data and print test.html which shifts them, allowing for a changable lens.

This repository can also be installed using pip

pip install labMTsimple

in which case you can download the tests from github and run them, if desired.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for labMTsimple, version 2.1.4
Filename, size File type Python version Upload date Hashes
Filename, size labMTsimple-2.1.4.tar.gz (2.8 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page