Installation

Note: It is not necessary to install TMA to experiment with its capabilities on your (reasonably sized) dataset at http://geordi.cs.uiowa.edu/tma

TMA works with modern *Nix distributions and OS X 10.4+. To avoid conflicts, you may want to setup your environment using a virtual environment.

Dependencies

TMA has the following dependencies that must be installed by the user for full TMA functionality:

Python

• python 2.7 (2.5 and 2.6 may also work, this needs to be checked) http://www.python.org/
• django 1.5+ https://www.djangoproject.com [BSD license]
• numpy 1.3+ http://numpy.scipy.org/ [BSD]

Other

• sqlite3 http://www.sqlite.org/
• make http://www.gnu.org/software/make/ [GPL]
• gcc http://gcc.gnu.org/ [GPL]
• gnu scientific library http://www.gnu.org/software/gsl/ [GPL]
• pdftotext command line utility from Xpdf or the poppler-utils package is needed to convert pdf documents to text (not needed if working strictly with text) [GPL].

Included Dependencies

TMA also integrates (pieces from) the following projects -- no installation is necessary from the user:

• TMVE http://code.google.com/p/tmve/ [MIT]
• jQuery http://jquery.com/ [MIT/GPL]
• D3 http://d3js.org/ [BSD]
• Flot http://code.google.com/p/flot/ [MIT]
• lda-c http://www.cs.princeton.edu/~blei/lda-c/ [GPL]
• ctm-c http://www.cs.princeton.edu/~blei/ctm-c/ [GPL]
• hdp (Chong Wang) http://www.cs.princeton.edu/~chongw/software/hdp.tar.gz [GPL]
• BeautifulSoup 3.21 http://www.crummy.com/software/BeautifulSoup/ [MIT]
• Endless Pagination http://code.google.com/p/django-endless-pagination/ [MIT]
• Porter2 Stemmer http://dirolf.com/project/pyporter2.html [MIT]

Installation

Check out the TMA repository

git clone git://github.com/cjrd/TMA.git

OPTIONAL (to obtain Wikipedia co-occurrence scores) download the zipped Wikipedia co-occurrence database located at http://mlg.eng.cam.ac.uk/creed/wiki_cocc_100percent.zip and move the sqlite wiki_cocc_100percent.sqlite file to TMA/data

From within the TMA folder run make

make if you correctly installed gcc, make, and gsl then you should only receive a few warnings

Navigate to the src directory

cd src

Make sure the static directory contains the desired content

python manage.py collectstatic

Run a local django server

python manage.py runserver &

A file user-settings.txt will be created in the src directory. Open this file using your favorite text editor, feel free to fill in your information (name, email) as well as a Django secrect key--this won't really matter since you're running locally--and if you would like to obtain Bing coherence score, fill in the bing-api-key obtained from the Bing search API in the Azure Marketplace -- you receive 5000 free search queries per month.

With the django server running, open a web browser (Firefox, Chrome, Safari) and navigate to:

localhost:8000/tma

You should see the same display as http://geordi.cs.uiowa.edu/tma/

Adjustments to the output of TMA can largely be controlled in TMA/src/settings.py