Skip to content

Latest commit

 

History

History
73 lines (61 loc) · 2.73 KB

README.org

File metadata and controls

73 lines (61 loc) · 2.73 KB
Raw

Blue Bird README

About

Blue Bird is a web interface for performing simple sentiment analysis of twitter. It follows a simple method of assigning each tweet a single integer representing each tweets sentiment based off the presence of positive and negative words. It then produces a stacked histogram of all the tweets for a given query.

Installation and Setup

  1. Clone this repository or click the download button in the upper right hand corner.
  2. Install all dependencies listed below.
  3. Open settings and set the host and port to the desired values.

    Default: localhost:8348

  4. Run it the script as ./bluebird it will start out as a background process.
  5. Visit host:port i.e. localhost:8348.
  6. Enter a query and hit analyze. (There may be a long delay, the latency for fetching from twitter is very high)

Usage

Usage is relatively simple visit the webpage and enter a query then hit analyze and Blue Bird will search twitter, analyze the results and provide a stacked histogram of the results. Visit here (or read the source) to get a nice description of the method used to produce the charts before you start making conclusions. That’s all you need to know to get started.

  • How do I make it display “Python” and “Ruby” when I search “#python, #ruby”?

    Under show additional options there is a Labels option, simply type a comma separated list in the same order as above and the labels will be used in place of the search. In this case “Python, Ruby”.

  • How do I augment the word lists being used to judge the sentiment of a tweet?

    Under show additional options there is a positive and a negative words option. In their respective boxes, type a comma separated list of the words you’d like to augment the words list with and click analyze and you’ll get the results.

Dependencies

Python (tested in 2.7)

Can be installed with “easy-install name”

  • bottle
  • rpy2
  • numpy
  • tweepy

R (tested with 2.13.1)

Can be install in R with “install.packages(‘name’)”

  • plyr
  • ggplot2
  • stringr

Notes

  • If you get the following import error: 
    ImportError: libR.so: cannot open shared object file: No such file or directory

    Then you must add the following to your .bashrc

    export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/lib/R/lib

    /usr/lib/R/lib may be a different path depending on your R install. It should be replaced with the directory that contains: libR.so

  • Bug when nothing returned in search. Defaults to one neutral item in the histogram to prevent R from raising an error.