RubyGems - ankusa - Versions diffs - 0.0.8 → 0.0.9 - Mend

ankusa 0.0.8 → 0.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (35) hide show

data/README.rdoc +2 -1
data/Rakefile +4 -26
data/lib/ankusa.rb +1 -0
data/lib/ankusa/classifier.rb +3 -0
data/lib/ankusa/naive_bayes.rb +8 -4
data/lib/ankusa/version.rb +3 -0
metadata +6 -33
data/docs/classes/Ankusa.html +0 -182
data/docs/classes/Ankusa/CassandraStorage.html +0 -615
data/docs/classes/Ankusa/Classifier.html +0 -315
data/docs/classes/Ankusa/FileSystemStorage.html +0 -272
data/docs/classes/Ankusa/HBaseStorage.html +0 -594
data/docs/classes/Ankusa/KLDivergenceClassifier.html +0 -194
data/docs/classes/Ankusa/MemoryStorage.html +0 -467
data/docs/classes/Ankusa/NaiveBayesClassifier.html +0 -231
data/docs/classes/Ankusa/TextHash.html +0 -275
data/docs/classes/String.html +0 -172
data/docs/created.rid +0 -1
data/docs/files/README_rdoc.html +0 -294
data/docs/files/lib/ankusa/cassandra_storage_rb.html +0 -108
data/docs/files/lib/ankusa/classifier_rb.html +0 -101
data/docs/files/lib/ankusa/extensions_rb.html +0 -108
data/docs/files/lib/ankusa/file_system_storage_rb.html +0 -108
data/docs/files/lib/ankusa/hasher_rb.html +0 -109
data/docs/files/lib/ankusa/hbase_storage_rb.html +0 -108
data/docs/files/lib/ankusa/kl_divergence_rb.html +0 -101
data/docs/files/lib/ankusa/memory_storage_rb.html +0 -101
data/docs/files/lib/ankusa/naive_bayes_rb.html +0 -101
data/docs/files/lib/ankusa/stopwords_rb.html +0 -101
data/docs/files/lib/ankusa_rb.html +0 -112
data/docs/fr_class_index.html +0 -36
data/docs/fr_file_index.html +0 -38
data/docs/fr_method_index.html +0 -95
data/docs/index.html +0 -24
data/docs/rdoc-style.css +0 -208

data/docs/classes/String.html DELETED

@@ -1,172 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: String</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">String</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../files/lib/ankusa/extensions_rb.html">
-                lib/ankusa/extensions.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                Object
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000001">numeric?</a>&nbsp;&nbsp;
-      <a href="#M000002">to_ascii</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000001" class="method-detail">
-        <a name="M000001"></a>
-        <div class="method-heading">
-          <a href="#M000001" class="method-signature">
-          <span class="method-name">numeric?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000001-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000001-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/ankusa/extensions.rb, line 4</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">numeric?</span>
-    <span class="ruby-keyword kw">true</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Float</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">false</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
-        <div class="method-heading">
-          <a href="#M000002" class="method-signature">
-          <span class="method-name">to_ascii</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000002-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/ankusa/extensions.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ascii</span>
-    <span class="ruby-comment cmt"># from http://www.jroller.com/obie/tags/unicode</span>
-    <span class="ruby-identifier">converter</span> = <span class="ruby-constant">Iconv</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'ASCII//IGNORE//TRANSLIT'</span>, <span class="ruby-value str">'UTF-8'</span>)
-    <span class="ruby-identifier">converter</span>.<span class="ruby-identifier">iconv</span>(<span class="ruby-keyword kw">self</span>).<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'U*'</span>).<span class="ruby-identifier">select</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">cp</span><span class="ruby-operator">|</span> <span class="ruby-identifier">cp</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">127</span> }.<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'U*'</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-value str">&quot;&quot;</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/docs/created.rid DELETED

	@@ -1 +0,0 @@
1	- Wed, 05 Jan 2011 17:44:50 -0500

data/docs/files/README_rdoc.html DELETED

@@ -1,294 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>File: README.rdoc</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-  <div id="fileHeader">
-    <h1>README.rdoc</h1>
-    <table class="header-table">
-    <tr class="top-aligned-row">
-      <td><strong>Path:</strong></td>
-      <td>README.rdoc
-      </td>
-    </tr>
-    <tr class="top-aligned-row">
-      <td><strong>Last Update:</strong></td>
-      <td>Wed Jan 05 17:43:40 -0500 2011</td>
-    </tr>
-    </table>
-  </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <h1>ankusa</h1>
-<p>
-<a href="../classes/Ankusa.html">Ankusa</a> is a text classifier in Ruby
-that can use either Hadoop&#8216;s HBase or Cassandra for storage. Because
-it uses HBase or Cassandra as a backend, the training corpus can be many
-terabytes in size (though additional memory and single file storage
-abilities also exist for smaller corpora).
-</p>
-<p>
-<a href="../classes/Ankusa.html">Ankusa</a> currently provides both a Naive
-Bayes and Kullback-Leibler divergence classifier. It ignores common words
-(a.k.a, stop words) and stems all others. Additionally, it uses Laplacian
-smoothing in both classification methods.
-</p>
-<h2>Installation</h2>
-<p>
-First, install HBase/Hadoop or Cassandra (&gt;= 0.7.0-rc2). Then, install
-the appropriate gem:
-</p>
-<pre>
-  gem install hbaserb
-  # or
-  gem install cassandra
-</pre>
-<p>
-If you&#8216;re using HBase, make sure the HBase Thrift interface has been
-started as well. Then:
-</p>
-<pre>
-  gem install ankusa
-</pre>
-<h2>Basic Usage</h2>
-<p>
-Using the naive Bayes classifier:
-</p>
-<pre>
-  require 'rubygems'
-  require 'ankusa'
-  require 'ankusa/hbase_storage'
-  # connect to HBase
-  storage = Ankusa::HBaseStorage.new 'localhost'
-  c = Ankusa::NaiveBayesClassifier.new storage
-  # Each of these calls will return a bag-of-words
-  # has with stemmed words as keys and counts as values
-  c.train :spam, &quot;This is some spammy text&quot;
-  c.train :good, &quot;This is not the bad stuff&quot;
-  # This will return the most likely class (as symbol)
-  puts c.classify &quot;This is some spammy text&quot;
-  # This will return Hash with classes as keys and
-  # membership probability as values
-  puts c.classifications &quot;This is some spammy text&quot;
-  # If you have a large corpus, the probabilities will
-  # likely all be 0.  In that case, you must use log
-  # likelihood values
-  puts c.log_likelihoods &quot;This is some spammy text&quot;
-  # get a list of all classes
-  puts c.classnames
-  # close connection
-  storage.close
-</pre>
-<h2>KL Diverence Classifier</h2>
-<p>
-There is a Kullback–Leibler divergence classifier as well. KL divergence
-is a distance measure (though not a true metric because it does not satisfy
-the triangle inequality). The KL classifier simply measures the relative
-entropy between the text you want to classify and each of the classes. The
-class with the shortest &quot;distance&quot; is the best class. You may
-find that for a especially large corpus it may be slightly faster to use
-this classifier (since prior probablities are never calculated, only
-likelihoods).
-</p>
-<p>
-The API is the same as the NaiveBayesClassifier, except rather than calling
-&quot;classifications&quot; if you want actual numbers you call
-&quot;distances&quot;.
-</p>
-<pre>
-  require 'rubygems'
-  require 'ankusa'
-  require 'ankusa/hbase_storage'
-  # connect to HBase
-  storage = Ankusa::HBaseStorage.new 'localhost'
-  c = Ankusa::KLDivergenceClassifier.new storage
-  # Each of these calls will return a bag-of-words
-  # has with stemmed words as keys and counts as values
-  c.train :spam, &quot;This is some spammy text&quot;
-  c.train :good, &quot;This is not the bad stuff&quot;
-  # This will return the most likely class (as symbol)
-  puts c.classify &quot;This is some spammy text&quot;
-  # This will return Hash with classes as keys and
-  # distances &gt;= 0 as values
-  puts c.distances &quot;This is some spammy text&quot;
-  # get a list of all classes
-  puts c.classnames
-  # close connection
-  storage.close
-</pre>
-<h2>Storage Methods</h2>
-<p>
-<a href="../classes/Ankusa.html">Ankusa</a> has a generalized storage
-interface that has been implemented for HBase, Cassandra, single file, and
-in-memory storage.
-</p>
-<p>
-Memory storage can be used when you have a very small corpora
-</p>
-<pre>
-  require 'ankusa/memory_storage'
-  storage = Ankusa::MemoryStorage.new
-</pre>
-<p>
-FileSystem storage can be used when you have a very small corpora and want
-to persist the classification results.
-</p>
-<pre>
-  require 'ankusa/file_system_storage'
-  storage = Ankusa::FileSystemStorage.new '/path/to/file'
-  # Do classification ...
-  storage.save
-</pre>
-<p>
-The FileSystem storage does NOT save to the filesystem automatically, the
-save method must be invoked to save and persist the results
-</p>
-<p>
-HBase storage:
-</p>
-<pre>
-  require 'ankusa/hbase_storage'
-  # defaults: host='localhost', port=9090, frequency_tablename=&quot;ankusa_word_frequencies&quot;, summary_tablename=&quot;ankusa_summary&quot;
-  storage = Ankusa::HBaseStorage.new host, port, frequency_tablename, summary_tablename
-</pre>
-<p>
-For Cassandra storage:
-</p>
-<ul>
-<li>You will need Cassandra version 0.7.0-rc2 or greater.
-</li>
-<li>You will need to set a max number classes since current implementation of
-the Ruby Cassandra client doesn&#8216;t support table scans.
-</li>
-<li>Prior to using the Cassandra storage you will need to run the following
-command from the cassandra-cli: &quot;create keyspace ankusa with
-replication_factor = 1&quot;. This should be fixed with a new release
-candidate for Cassandra.
-</li>
-</ul>
-<p>
-To use the Cassandra storage class:
-</p>
-<pre>
-  require 'ankusa/cassandra_storage'
-  # defaults: host='127.0.0.1', port=9160, keyspace = 'ankusa', max_classes = 100
-  storage = Ankusa::HBaseStorage.new host, port, keyspace, max_classes
-</pre>
-<h2>Running Tests</h2>
-<p>
-You can run the tests for any of the four storage methods. For instance,
-for memory storage:
-</p>
-<pre>
-  rake test_memory
-</pre>
-<p>
-For the other methods you will need to edit the file test/config.yml and
-set the configuration params. Then:
-</p>
-<pre>
-  rake test_hbase
-  # or
-  rake test_cassandra
-  # or
-  rake test_filesystem
-</pre>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>