Class: ClassifierReborn::Bayes
- Inherits:
-
Object
- Object
- ClassifierReborn::Bayes
- Defined in:
- lib/classifier-reborn/bayes.rb
Constant Summary collapse
- CategoryNotFoundError =
Class.new(StandardError)
Instance Method Summary collapse
-
#add_category(category) ⇒ Object
(also: #append_category)
Allows you to add categories to the classifier.
-
#categories ⇒ Object
Provides a list of category names For example: b.categories => [‘This’, ‘That’, ‘the_other’].
-
#classifications(text) ⇒ Object
Returns the scores in each category the provided
text
. -
#classify(text) ⇒ Object
Return the classification without the score.
-
#classify_with_score(text) ⇒ Object
Returns the classification of the provided
text
, which is one of the categories given in the initializer along with the score. -
#disable_threshold ⇒ Object
Dynamically disable threshold for classify results.
-
#enable_threshold ⇒ Object
Dynamically enable threshold for classify results.
-
#initialize(*args) ⇒ Bayes
constructor
The class can be created with one or more categories, each of which will be initialized and given a training method.
-
#method_missing(name, *args) ⇒ Object
Provides training and untraining methods for the categories specified in Bayes#new For example: b = ClassifierReborn::Bayes.new ‘This’, ‘That’, ‘the_other’ b.train_this “This text” b.train_that “That text” b.untrain_that “That text” b.train_the_other “The other text”.
-
#threshold ⇒ Object
Retrieve the current threshold value.
-
#threshold=(a_float) ⇒ Object
Dynamically set the threshold value.
-
#threshold_disabled? ⇒ Boolean
is threshold processing disabled?.
-
#threshold_enabled? ⇒ Boolean
Is threshold processing enabled?.
-
#train(category, text) ⇒ Object
Provides a general training method for all categories specified in Bayes#new For example: b = ClassifierReborn::Bayes.new ‘This’, ‘That’, ‘the_other’ b.train :this, “This text” b.train “that”, “That text” b.train “The other”, “The other text”.
-
#untrain(category, text) ⇒ Object
Provides a untraining method for all categories specified in Bayes#new Be very careful with this method.
Constructor Details
#initialize(*args) ⇒ Bayes
The class can be created with one or more categories, each of which will be initialized and given a training method. E.g.,
b = ClassifierReborn::Bayes.new 'Interesting', 'Uninteresting', 'Spam'
Options available are:
language: 'en' Used to select language specific stop words
auto_categorize: false When true, enables ability to dynamically declare a category
enable_threshold: false When true, enables a threshold requirement for classifition
threshold: 0.0 Default threshold, only used when enabled
20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
# File 'lib/classifier-reborn/bayes.rb', line 20 def initialize(*args) @categories = Hash.new = { language: 'en', auto_categorize: false, enable_threshold: false, threshold: 0.0 } args.flatten.each { |arg| if arg.kind_of?(Hash) .merge!(arg) else add_category(arg) end } @total_words = 0 @category_counts = Hash.new(0) @category_word_count = Hash.new(0) @language = [:language] @auto_categorize = [:auto_categorize] @enable_threshold = [:enable_threshold] @threshold = [:threshold] end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(name, *args) ⇒ Object
Provides training and untraining methods for the categories specified in Bayes#new For example:
b = ClassifierReborn::Bayes.new 'This', 'That', 'the_other'
b.train_this "This text"
b.train_that "That text"
b.untrain_that "That text"
b.train_the_other "The other text"
174 175 176 177 178 179 180 181 182 183 184 |
# File 'lib/classifier-reborn/bayes.rb', line 174 def method_missing(name, *args) cleaned_name = name.to_s.gsub(/(un)?train_([\w]+)/, '\2') category = CategoryNamer.prepare_name(cleaned_name) if @categories.has_key? category args.each { |text| eval("#{$1}train(category, text)") } elsif name.to_s =~ /(un)?train_([\w]+)/ raise StandardError, "No such category: #{category}" else super #raise StandardError, "No such method: #{name}" end end |
Instance Method Details
#add_category(category) ⇒ Object Also known as: append_category
Allows you to add categories to the classifier. For example:
b.add_category "Not spam"
WARNING: Adding categories to a trained classifier will result in an undertrained category that will tend to match more criteria than the trained selective categories. In short, try to initialize your categories at initialization.
202 203 204 |
# File 'lib/classifier-reborn/bayes.rb', line 202 def add_category(category) @categories[CategoryNamer.prepare_name(category)] ||= Hash.new(0) end |
#categories ⇒ Object
Provides a list of category names For example:
b.categories
=> ['This', 'That', 'the_other']
190 191 192 |
# File 'lib/classifier-reborn/bayes.rb', line 190 def categories # :nodoc: @categories.keys.collect {|c| c.to_s} end |
#classifications(text) ⇒ Object
Returns the scores in each category the provided text
. E.g.,
b.classifications "I hate bad words and you"
=> {"Uninteresting"=>-12.6997928013932, "Interesting"=>-18.4206807439524}
The largest of these scores (the one closest to 0) is the one picked out by #classify
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 |
# File 'lib/classifier-reborn/bayes.rb', line 102 def classifications(text) score = Hash.new word_hash = Hasher.word_hash(text, @language) training_count = @category_counts.values.reduce(:+).to_f @categories.each do |category, category_words| score[category.to_s] = 0 total = (@category_word_count[category] || 1).to_f word_hash.each do |word, count| s = category_words.has_key?(word) ? category_words[word] : 0.1 score[category.to_s] += Math.log(s/total) end # now add prior probability for the category s = @category_counts.has_key?(category) ? @category_counts[category] : 0.1 score[category.to_s] += Math.log(s / training_count) end return score end |
#classify(text) ⇒ Object
Return the classification without the score
129 130 131 132 133 134 135 |
# File 'lib/classifier-reborn/bayes.rb', line 129 def classify(text) result, score = classify_with_score(text) if threshold_enabled? result = nil if score < @threshold || score == Float::INFINITY end return result end |
#classify_with_score(text) ⇒ Object
Returns the classification of the provided text
, which is one of the categories given in the initializer along with the score. E.g.,
b.classify "I hate bad words and you"
=> ['Uninteresting', -4.852030263919617]
124 125 126 |
# File 'lib/classifier-reborn/bayes.rb', line 124 def classify_with_score(text) (classifications(text).sort_by { |a| -a[1] })[0] end |
#disable_threshold ⇒ Object
Dynamically disable threshold for classify results
153 154 155 |
# File 'lib/classifier-reborn/bayes.rb', line 153 def disable_threshold @enable_threshold = false end |
#enable_threshold ⇒ Object
Dynamically enable threshold for classify results
148 149 150 |
# File 'lib/classifier-reborn/bayes.rb', line 148 def enable_threshold @enable_threshold = true end |
#threshold ⇒ Object
Retrieve the current threshold value
138 139 140 |
# File 'lib/classifier-reborn/bayes.rb', line 138 def threshold @threshold end |
#threshold=(a_float) ⇒ Object
Dynamically set the threshold value
143 144 145 |
# File 'lib/classifier-reborn/bayes.rb', line 143 def threshold=(a_float) @threshold = a_float end |
#threshold_disabled? ⇒ Boolean
is threshold processing disabled?
163 164 165 |
# File 'lib/classifier-reborn/bayes.rb', line 163 def threshold_disabled? !@enable_threshold end |
#threshold_enabled? ⇒ Boolean
Is threshold processing enabled?
158 159 160 |
# File 'lib/classifier-reborn/bayes.rb', line 158 def threshold_enabled? @enable_threshold end |
#train(category, text) ⇒ Object
Provides a general training method for all categories specified in Bayes#new For example:
b = ClassifierReborn::Bayes.new 'This', 'That', 'the_other'
b.train :this, "This text"
b.train "that", "That text"
b.train "The other", "The other text"
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 |
# File 'lib/classifier-reborn/bayes.rb', line 51 def train(category, text) category = CategoryNamer.prepare_name(category) # Add the category dynamically or raise an error if !@categories.has_key?(category) if @auto_categorize add_category(category) else raise CategoryNotFoundError.new("Cannot train; category #{category} does not exist") end end @category_counts[category] += 1 Hasher.word_hash(text, @language).each do |word, count| @categories[category][word] += count @category_word_count[category] += count @total_words += count end end |
#untrain(category, text) ⇒ Object
Provides a untraining method for all categories specified in Bayes#new Be very careful with this method.
For example:
b = ClassifierReborn::Bayes.new 'This', 'That', 'the_other'
b.train :this, "This text"
b.untrain :this, "This text"
78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 |
# File 'lib/classifier-reborn/bayes.rb', line 78 def untrain(category, text) category = CategoryNamer.prepare_name(category) @category_counts[category] -= 1 Hasher.word_hash(text, @language).each do |word, count| if @total_words >= 0 orig = @categories[category][word] || 0 @categories[category][word] -= count if @categories[category][word] <= 0 @categories[category].delete(word) count = orig end if @category_word_count[category] >= count @category_word_count[category] -= count end @total_words -= count end end end |