Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mimno/jsLDA

An implementation of latent Dirichlet allocation in javascript
https://github.com/mimno/jsLDA

Last synced: 3 months ago
JSON representation

An implementation of latent Dirichlet allocation in javascript

Awesome Lists containing this project

README

        

jsLDA
=====

An implementation of latent Dirichlet allocation in javascript. A [live demonstration](http://mimno.infosci.cornell.edu/jsLDA/jslda.html) is available.

Instructions:
------------

When you first load the page, it will request a file containing documents and a file containing stopwords. The default example is a corpus of paragraphs from US State of the Union speeches.

Click the "Run 50 iterations" button to start training. The browser may appear to freeze for a while.
Initially all words have been assigned randomly to topics.
We train a model by cycling through every word token in the documents and sampling a topic for that word.
An "iteration" corresponds to one pass through the documents.

The topics on the left side of the page should now look more interesting. Run more iterations if you would like -- there's probably still a lot of room for improvement after only 50 iterations.

Once you're satisfied with the model, you can click on a topic from the list on the right to sort documents in descending order by their use of that topic. Proportions are weighted so that longer documents will come first.

You can also explore correlations between topics by clicking the "Topic Correlations" tab. This view shows a force directed layout with connections between topics that have correlations above a certain threshold. You can control this threshold with the slider: a low cutoff will display more edges, while a high cutoff will remove all but the strongest correlations.

Topic correlations are actually pointwise mutual information scores. This score measures whether two topics occur
in the same document more often than we would expect by chance. Previous versions of this script calculated correlations
on logratios; PMI is simpler to calculate.

Using your own corpus:
---------------------

To use your own corpus, the best way is to place the files in this repository in the document root of a web server.
Replace the files `documents.txt` and `stoplist.txt` with your own corpus and stop list.
The documents file is a tab-delimited text file with one document per line. Each line has three fields:

[doc ID] [tab] [label] [tab] [text...]

(this is the default format for Mallet). The "label" field is currently unused, but I plan to support timestamps, labels, etc.

The format for stopwords is one word per line. The "Vocabulary" tab may be useful in customizing a stoplist. Unicode is supported, so most languages that have meaningful whitespace (ie not CJK) should work.

The page works best in Chrome. Safari and Firefox work too, but may be considerably slower. It doesn't seem to work in IE.

Download results:
----------------

You can create reports about your topic model. Hit the `Downloads` tab.
Reports are in CSV format. The `sampling state` file contains the same information as a Mallet state file, but in a more compact format.