words 0.4.0 → 0.4.1

data/README.markdown

@@ -6,7 +6,9 @@ Words implements a fast interface to [Wordnet®](http://wordnet.princeton.edu) w
 
 * Version 0.2 Introduced Pure Ruby Backend
 * Version 0.3 Introduced Evocation Support (see examples & below) as developed by the [Wordnet® Evocation Project](http://wordnet.cs.princeton.edu/downloads/evocation/release-0.4/README.TXT) 
-* Version 0.4 Substantial performance increase in pure mode (now faster at some things than the tokyo backend) and simplification of use! Full refactoring. Move to RSpec for testing.
+* Version 0.4 Substantial performance increase in pure mode (now faster at some things than the tokyo backend) and simplification of use! Full refactoring. Move to RSpec for testing. API CHANGES: Words::Words -> Words::Wordnet, close -> close!, connected -> connected? and evocations_enabled? -> evocations?
+
+Documentation: [Yardoc Live](http://yardoc.org/docs/roja-words)
 
 ## Pre-Installation ##
 
@@ -91,7 +93,7 @@ Heres a few little examples of using words within your programs.
     require 'rubygems'
     require 'words'
     
-    data = Words::Wordnet.new # or: data = Words::Words.new(:tokyo) for the tokyo backend
+    data = Words::Wordnet.new # or: data = Words::Wordnet.new(:tokyo) for the tokyo backend
 
     # to specify a wordnet path Words::Words.new(:pure, '/path/to/wordnet')
     # to specify the tokyo dataset Words::Words.new(:pure, :search, '/path/to/data.tct')

data/Rakefile

@@ -1,58 +1,55 @@
+# coding: utf-8
 require 'rubygems'
 require 'rake'
 
 begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "words"
-    gem.summary = %Q{A Fast & Easy to use interface to WordNet® with cross ruby distribution compatability.}
-    gem.description = %Q{Words, with both pure ruby & tokyo-cabinate backends, implements a fast interface to Wordnet® over the same easy-to-use API. The FFI backend makes use of Tokyo Cabinet and the FFI interface, rufus-tokyo, to provide cross ruby distribution compatability and blistering speed. The pure ruby interface operates on a special ruby optimised index along with the basic dictionary files provided by WordNet®. I have attempted to provide ease of use in the form of a simple yet powerful api and installation is a sintch!}
-    gem.email = "roja@arbia.co.uk"
-    gem.homepage = "http://github.com/roja/words"
-    gem.authors = ["Roja Buck"]
-    gem.add_dependency "trollop", ">= 1.15"
-    gem.executables = [ "build_wordnet" ]
-    gem.default_executable = "build_wordnet"
-    gem.rubyforge_project = 'words'
-  end
-  Jeweler::GemcutterTasks.new
-  Jeweler::RubyforgeTasks.new do |rubyforge|
-    rubyforge.doc_task = "rdoc"
-  end
+    require 'jeweler'
+    Jeweler::Tasks.new do |gem|
+	gem.name = "words"
+	gem.summary = %Q{A Fast & Easy to use interface to WordNet® with cross ruby distribution compatability.}
+	gem.description = %Q{Words, with both pure ruby & tokyo-cabinate backends, implements a fast interface to Wordnet® over the same easy-to-use API. The FFI backend makes use of Tokyo Cabinet and the FFI interface, rufus-tokyo, to provide cross ruby distribution compatability and blistering speed. The pure ruby interface operates on a special ruby optimised index along with the basic dictionary files provided by WordNet®. I have attempted to provide ease of use in the form of a simple yet powerful api and installation is a sintch!}
+	gem.email = "roja@arbia.co.uk"
+	gem.homepage = "http://github.com/roja/words"
+	gem.authors = ["Roja Buck"]
+	gem.executables = [ "build_wordnet" ]
+	gem.default_executable = "build_wordnet"
+	gem.rubyforge_project = 'words'
+	gem.add_development_dependency "rspec", ">= 1.2.9"
+    end
+    Jeweler::GemcutterTasks.new
 rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+    puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
 end
 
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+    spec.libs << 'lib' << 'spec'
+    spec.spec_files = FileList['spec/**/*_spec.rb']
 end
 
 begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |test|
-    test.libs << 'test'
-    test.pattern = 'test/**/test_*.rb'
-    test.verbose = true
-  end
+    require 'rcov'
+    Spec::Rake::SpecTask.new(:rcov) do |spec|
+	spec.libs << 'lib' << 'spec'
+	spec.pattern = 'spec/**/*_spec.rb'
+	spec.rcov = true
+    end
 rescue LoadError
-  task :rcov do
-    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-  end
+    task :rcov do
+	abort "RCov is not available. In order to run rcov, you must: sudo gem install rcov"
+    end
 end
 
-task :test => :check_dependencies
+task :spec => :check_dependencies
 
-task :default => :test
+task :default => :spec
 
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
-  
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "words #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
+    version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+    rdoc.rdoc_dir = 'rdoc'
+    rdoc.title = "test #{version}"
+    rdoc.rdoc_files.include('README*')
+    rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.4.1

data/bin/build_wordnet

@@ -7,9 +7,11 @@ require 'pathname'
 require 'rubygems'
 
 # standard library includes
-require 'trollop'
+#require 'trollop'
 require 'zlib'
 require 'net/http'
+require 'optparse'
+require 'pp'
 
 # local includes
 require File.join(File.dirname(__FILE__), '..', 'lib', 'words.rb')
@@ -19,16 +21,50 @@ POS_FILE_TYPE_TO_SHORT = { 'adj' => 'a', 'adv' => 'r', 'noun' => 'n', 'verb' =>
 
 puts "Words Dataset Constructor 2010 (c) Roja Buck"
 
-opts = Trollop::options do
-    opt :quiet, "Don't output verbose program detail.", :default => false
-    opt :wordnet, "Location of the wordnet dictionary directory", :default => "Search..."
-    opt :build_tokyo, "Build the tokyo wordnet dataset?", :default => false
-    opt :build_tokyo_with_evocations, "Build the tokyo dataset with the similarity dataset based on the wordnet evocation project (requires internet connection)?", :default => false
-    opt :build_pure_evocations, "Build the similarity dataset based on the wordnet evocation project for use with the pure words mode (requires internet connection)", :default => false
+opts = { :quiet => false, :build_tokyo => false, :build_tokyo_with_evocations => false, :build_pure_evocations => false, :wordnet => 'Search...' }
+
+optparse = OptionParser.new do|option|
+
+    option.on( '-q', '--quiet', "Don't output verbose program detail. (Default: false)" ) do
+	opts[:quiet] = true
+    end
+
+    option.on( '-w', '--wordnet FILE', "Location of the wordnet dictionary directory. (Default: Search)" ) do|f|
+	opts[:wordnet] = f
+    end
+
+    option.on( '-t', '--build-tokyo', "Build the tokyo wordnet dataset? (Default: false)" ) do
+	opts[:build_tokyo] = true
+    end
+
+    option.on( '-x', '--build-tokyo-with-evocations', "Build the tokyo dataset with the similarity dataset based on the wordnet evocation project? (Default: false) NOTE: requires internet connection." ) do
+	opts[:build_tokyo_with_evocations] = true
+    end
+
+    option.on( '-e', '--build-pure-evocations', "Build the similarity dataset based on the wordnet evocation project for use with the pure words mode. (Default: false) NOTE: requires internet connection." ) do
+	opts[:build_pure_evocations] = true
+    end
+
+    option.on( '-h', '--help', 'Display this screen' ) do
+	puts option
+	exit
+    end
+
+end
+
+optparse.parse!
+
+if !opts[:build_tokyo] && !opts[:build_tokyo_with_evocations] && !opts[:build_pure_evocations]
+    puts "ERROR: You need to specify at least one dataset you want to build."
+    exit
 end
-Trollop::die :build_tokyo, "You need to specify which dataset you want to build." if !opts[:build_tokyo] && !opts[:build_tokyo_with_evocations] && !opts[:build_pure_evocations]
 puts "Verbose mode enabled" if (VERBOSE = !opts[:quiet])
 
+pp "Options:", opts
+
+exit
+
+
 require 'rufus-tokyo' if opts[:build_tokyo] || opts[:build_tokyo_with_evocations]
 
 gem_path = Pathname.new "#{File.dirname(__FILE__)}/.."

data/examples.rb

@@ -1,8 +1,9 @@
 #!/usr/bin/env ruby
+# coding: utf-8
 
-require 'rubygems'
-require 'words'
-#require 'lib/words.rb'
+#require 'rubygems'
+#require 'words'
+require 'lib/words.rb'
 
 if __FILE__ == $0
   

data/lib/evocations.rb

@@ -1,3 +1,5 @@
+# coding: utf-8
+
 # local includes
 require File.join(File.dirname(__FILE__), 'synset.rb')
 
@@ -7,9 +9,7 @@ module Words
 
 	def initialize(evocation_construct, source_synset, wordnet_connection)
 
-	    @wordnet_connection = wordnet_connection
-	    @source = source_synset
-	    @evocation_construct = evocation_construct
+	    @evocation_construct, @source, @wordnet_connection = evocation_construct, source_synset, wordnet_connection
 
 	end
 
@@ -17,16 +17,12 @@ module Words
 
 	    @means ||= @evocation_construct["means"].split('|')
 
-	    @means
-
 	end
 
 	def medians
 
 	    @medians ||= @evocation_construct["medians"].split('|')
 
-	    @medians
-
 	end
 
 	def size

data/lib/homographs.rb

@@ -1,3 +1,5 @@
+# coding: utf-8
+
 # local includes
 require File.join(File.dirname(__FILE__), 'synset.rb')
 
@@ -35,32 +37,24 @@ module Words
 
       @tagsense_counts ||= @raw_homographs["tagsense_counts"].split('|').map { |count| { POS_TO_SYMBOL[count[0,1]] => count[1..-1].to_i }  }
 
-      @tagsense_counts
-
     end
 
     def lemma
 
       @lemma ||= @raw_homographs["lemma"].gsub('_', ' ')
 
-      @lemma
-
     end
 
     def available_pos
 
       @available_pos ||= synset_ids.map { |synset_id| POS_TO_SYMBOL[synset_id[0,1]] }.uniq
 
-      @available_pos
-
     end
 
     def to_s
 
       @to_s ||= [lemma, " " + available_pos.join("/")].join(",")
 
-      @to_s
-
     end
 
     def size(pos = :all)

data/lib/relation.rb

@@ -1,91 +1,90 @@
+# coding: utf-8
+
 # local includes
 require File.join(File.dirname(__FILE__), 'synset.rb')
 
 module Words
 
-  class Relation
+    class Relation
 
-    RELATION_TO_SYMBOL = { "-c" => :member_of_this_domain_topic, "+" => :derivationally_related_form, "%p" => :part_meronym, "~i" => :instance_hyponym, "@" => :hypernym,
-      ";r" => :domain_of_synset_region, "!" => :antonym, "#p" => :part_holonym, "%s" => :substance_meronym, ";u" => :domain_of_synset_usage,
-      "-r" => :member_of_this_domain_region, "#s" => :substance_holonym, "=" => :attribute, "-u" => :member_of_this_domain_usage, ";c" => :domain_of_synset_topic,
-      "%m"=> :member_meronym, "~" => :hyponym, "@i" => :instance_hypernym, "#m" => :member_holonym, "$" => :verb_group, ">" => :cause, "*" => :entailment,
-      "\\" => :pertainym, "<" => :participle_of_verb, "&" => :similar_to, "^" => :see_also }
-    SYMBOL_TO_RELATION = RELATION_TO_SYMBOL.invert
+	RELATION_TO_SYMBOL = { "-c" => :member_of_this_domain_topic, "+" => :derivationally_related_form, "%p" => :part_meronym, "~i" => :instance_hyponym, "@" => :hypernym,
+	    ";r" => :domain_of_synset_region, "!" => :antonym, "#p" => :part_holonym, "%s" => :substance_meronym, ";u" => :domain_of_synset_usage,
+	    "-r" => :member_of_this_domain_region, "#s" => :substance_holonym, "=" => :attribute, "-u" => :member_of_this_domain_usage, ";c" => :domain_of_synset_topic,
+	    "%m"=> :member_meronym, "~" => :hyponym, "@i" => :instance_hypernym, "#m" => :member_holonym, "$" => :verb_group, ">" => :cause, "*" => :entailment,
+	    "\\" => :pertainym, "<" => :participle_of_verb, "&" => :similar_to, "^" => :see_also }
+	SYMBOL_TO_RELATION = RELATION_TO_SYMBOL.invert
 
-    def initialize(relation_construct, source_synset, wordnet_connection)
+	def initialize(relation_construct, source_synset, wordnet_connection)
 
-      @wordnet_connection = wordnet_connection
-      @symbol, @dest_synset_id, @pos, @source_dest = relation_construct.split('.')
-      @dest_synset_id = @pos + @dest_synset_id
-      @symbol = RELATION_TO_SYMBOL[@symbol]
-      @source_synset = source_synset
+	    @wordnet_connection = wordnet_connection
+	    @symbol, @dest_synset_id, @pos, @source_dest = relation_construct.split('.')
+	    @dest_synset_id = @pos + @dest_synset_id
+	    @symbol = RELATION_TO_SYMBOL[@symbol]
+	    @source_synset = source_synset
 
-    end
+	end
 
-    def is_semantic?
+	def is_semantic?
 
-      @source_dest == "0000"
+	    @source_dest == "0000"
 
-    end
+	end
 
-    def source_word
+	def source_word
 
-      is_semantic? ? @source_word = nil : @source_word = @source_synset.words[@source_dest[0..1].to_i(16)-1] unless defined? @source_word
+	    return nil if is_semantic?
+	    @source_word ||= @source_synset.words[@source_dest[0..1].to_i(16)-1]
 
-      @source_word
+	end
 
-    end
+	def destination_word
 
-    def destination_word
+	    return nil if is_semantic?
+	    @destination_word ||= destination.words[@source_dest[2..3].to_i(16)-1]
 
-      is_semantic? ? @destination_word = nil : @destination_word = destination.words[@source_dest[2..3].to_i(16)-1] unless defined? @destination_word
+	end
 
-      @destination_word
+	def relation_type?(type)
 
-    end
+	    case
+	    when SYMBOL_TO_RELATION.include?(type.to_sym)
+		type.to_sym == @symbol
+	    when RELATION_TO_SYMBOL.include?(pos.to_s)
+		POINTER_TO_SYMBOL[type.to_sym] == @symbol
+	    else
+		false
+	    end
 
-    def relation_type?(type)
+	end
 
-      case
-      when SYMBOL_TO_RELATION.include?(type.to_sym)
-        type.to_sym == @symbol
-      when RELATION_TO_SYMBOL.include?(pos.to_s)
-        POINTER_TO_SYMBOL[type.to_sym] == @symbol
-      else
-        false
-      end
+	def relation_type
 
-    end
+	    @symbol
 
-    def relation_type
+	end
 
-      @symbol
+	def destination
 
-    end
+	    @destination ||= Synset.new(@dest_synset_id, @wordnet_connection, nil)
 
-    def destination
+	end
 
-      @destination ||= Synset.new(@dest_synset_id, @wordnet_connection, nil)
+	def to_s
 
-      @destination
+	    if is_semantic?
+		@to_s ||= "Semantic #{relation_type.to_s.gsub('_', ' ')} relation between #{@source_synset.synset_id} and #{@dest_synset_id}"
+	    else
+		@to_s ||= "#{relation_type.to_s.gsub('_', ' ').capitalize} relation between #{@source_synset.synset_id}'s word \"#{source_word}\" and #{@dest_synset_id}'s word \"#{destination_word}\""
+	    end
 
-    end
+	end
 
-    def to_s
+	def inspect
 
-      @to_s = "#{relation_type.to_s.gsub('_', ' ').capitalize} relation between #{@source_synset.synset_id}'s word \"#{source_word}\" and #{@dest_synset_id}'s word \"#{destination_word}\"" if !is_semantic? && !defined?(@to_s)
-      @to_s = "Semantic #{relation_type.to_s.gsub('_', ' ')} relation between #{@source_synset.synset_id} and #{@dest_synset_id}" if  is_semantic? && !defined?(@to_s)
-
-      @to_s
-
-    end
-
-    def inspect
-
-      { :symbol => @symbol, :dest_synset_id => @dest_synset_id, :pos => @pos, :source_dest => @source_dest }.inspect
+	    { :symbol => @symbol, :dest_synset_id => @dest_synset_id, :pos => @pos, :source_dest => @source_dest }.inspect
       
-    end
+	end
 
-  end
+    end
 
 end

data/lib/synset.rb

@@ -1,199 +1,201 @@
+# coding: utf-8
+
 # local includes
 require File.join(File.dirname(__FILE__), 'relation.rb')
 require File.join(File.dirname(__FILE__), 'evocations.rb')
 
 module Words
 
-  class Synset
-
-    SYNSET_TYPE_TO_SYMBOL = {"n" => :noun, "v" => :verb, "a" => :adjective, "r" => :adverb, "s" => :adjective_satallite }
-    SYNSET_TYPE_TO_NUMBER = { "n" => 1, "v" => 2, "a" => 3, "r" => 4, "s" => 5 }
-    NUM_TO_LEX = [ { :lex => :adj_all, :description => "all adjective clusters" },
-      { :lex => :adj_pert, :description => "relational adjectives (pertainyms)" },
-      { :lex => :adv_all, :description => "all adverbs" },
-      { :lex => :noun_Tops, :description => "unique beginner for nouns" },
-      { :lex => :noun_act, :description => "nouns denoting acts or actions" },
-      { :lex => :noun_animal, :description => "nouns denoting animals" },
-      { :lex => :noun_artifact, :description => "nouns denoting man-made objects" },
-      { :lex => :noun_attribute, :description => "nouns denoting attributes of people and objects" },
-      { :lex => :noun_body, :description => "nouns denoting body parts" },
-      { :lex => :noun_cognition, :description => "nouns denoting cognitive processes and contents" },
-      { :lex => :noun_communication, :description => "nouns denoting communicative processes and contents" },
-      { :lex => :noun_event, :description => "nouns denoting natural events" },
-      { :lex => :noun_feeling, :description => "nouns denoting feelings and emotions" },
-      { :lex => :noun_food, :description => "nouns denoting foods and drinks" },
-      { :lex => :noun_group, :description => "nouns denoting groupings of people or objects" },
-      { :lex => :noun_location, :description => "nouns denoting spatial position" },
-      { :lex => :noun_motive, :description => "nouns denoting goals" },
-      { :lex => :noun_object, :description => "nouns denoting natural objects (not man-made)" },
-      { :lex => :noun_person, :description => "nouns denoting people" },
-      { :lex => :noun_phenomenon, :description => "nouns denoting natural phenomena" },
-      { :lex => :noun_plant, :description => "nouns denoting plants" },
-      { :lex => :noun_possession, :description => "nouns denoting possession and transfer of possession" },
-      { :lex => :noun_process, :description => "nouns denoting natural processes" },
-      { :lex => :noun_quantity, :description => "nouns denoting quantities and units of measure" },
-      { :lex => :noun_relation, :description => "nouns denoting relations between people or things or ideas" },
-      { :lex => :noun_shape, :description => "nouns denoting two and three dimensional shapes" },
-      { :lex => :noun_state, :description => "nouns denoting stable states of affairs" },
-      { :lex => :noun_substance, :description => "nouns denoting substances" },
-      { :lex => :noun_time, :description => "nouns denoting time and temporal relations" },
-      { :lex => :verb_body, :description => "verbs of grooming, dressing and bodily care" },
-      { :lex => :verb_change, :description => "verbs of size, temperature change, intensifying, etc." },
-      { :lex => :verb_cognition, :description => "verbs of thinking, judging, analyzing, doubting" },
-      { :lex => :verb_communication, :description => "verbs of telling, asking, ordering, singing" },
-      { :lex => :verb_competition, :description => "verbs of fighting, athletic activities" },
-      { :lex => :verb_consumption, :description => "verbs of eating and drinking" },
-      { :lex => :verb_contact, :description => "verbs of touching, hitting, tying, digging" },
-      { :lex => :verb_creation, :description => "verbs of sewing, baking, painting, performing" },
-      { :lex => :verb_emotion, :description => "verbs of feeling" },
-      { :lex => :verb_motion, :description => "verbs of walking, flying, swimming" },
-      { :lex => :verb_perception, :description => "verbs of seeing, hearing, feeling" },
-      { :lex => :verb_possession, :description => "verbs of buying, selling, owning" },
-      { :lex => :verb_social, :description => "verbs of political and social activities and events" },
-      { :lex => :verb_stative, :description => "verbs of being, having, spatial relations" },
-      { :lex => :verb_weather, :description => "verbs of raining, snowing, thawing, thundering" },
-      { :lex => :adj_ppl, :description => "participial adjectives" } ]
-
-    def initialize(synset_id, wordnet_connection, homographs)
-
-      @wordnet_connection = wordnet_connection
-      @synset_hash = wordnet_connection.synset(synset_id)
-      @homographs = homographs
-
-      # construct some conveniance menthods for relation type access
-      Relation::SYMBOL_TO_RELATION.keys.each do |relation_type|
-        self.class.send(:define_method, "#{relation_type}s?") do
-          relations(relation_type).size > 0
-        end
-        self.class.send(:define_method, "#{relation_type}s") do
-          relations(relation_type)
-        end
-      end
+    class Synset
+
+	SYNSET_TYPE_TO_SYMBOL = {"n" => :noun, "v" => :verb, "a" => :adjective, "r" => :adverb, "s" => :adjective_satallite }
+	SYNSET_TYPE_TO_NUMBER = { "n" => 1, "v" => 2, "a" => 3, "r" => 4, "s" => 5 }
+	NUM_TO_LEX = [ { :lex => :adj_all, :description => "all adjective clusters" },
+	    { :lex => :adj_pert, :description => "relational adjectives (pertainyms)" },
+	    { :lex => :adv_all, :description => "all adverbs" },
+	    { :lex => :noun_Tops, :description => "unique beginner for nouns" },
+	    { :lex => :noun_act, :description => "nouns denoting acts or actions" },
+	    { :lex => :noun_animal, :description => "nouns denoting animals" },
+	    { :lex => :noun_artifact, :description => "nouns denoting man-made objects" },
+	    { :lex => :noun_attribute, :description => "nouns denoting attributes of people and objects" },
+	    { :lex => :noun_body, :description => "nouns denoting body parts" },
+	    { :lex => :noun_cognition, :description => "nouns denoting cognitive processes and contents" },
+	    { :lex => :noun_communication, :description => "nouns denoting communicative processes and contents" },
+	    { :lex => :noun_event, :description => "nouns denoting natural events" },
+	    { :lex => :noun_feeling, :description => "nouns denoting feelings and emotions" },
+	    { :lex => :noun_food, :description => "nouns denoting foods and drinks" },
+	    { :lex => :noun_group, :description => "nouns denoting groupings of people or objects" },
+	    { :lex => :noun_location, :description => "nouns denoting spatial position" },
+	    { :lex => :noun_motive, :description => "nouns denoting goals" },
+	    { :lex => :noun_object, :description => "nouns denoting natural objects (not man-made)" },
+	    { :lex => :noun_person, :description => "nouns denoting people" },
+	    { :lex => :noun_phenomenon, :description => "nouns denoting natural phenomena" },
+	    { :lex => :noun_plant, :description => "nouns denoting plants" },
+	    { :lex => :noun_possession, :description => "nouns denoting possession and transfer of possession" },
+	    { :lex => :noun_process, :description => "nouns denoting natural processes" },
+	    { :lex => :noun_quantity, :description => "nouns denoting quantities and units of measure" },
+	    { :lex => :noun_relation, :description => "nouns denoting relations between people or things or ideas" },
+	    { :lex => :noun_shape, :description => "nouns denoting two and three dimensional shapes" },
+	    { :lex => :noun_state, :description => "nouns denoting stable states of affairs" },
+	    { :lex => :noun_substance, :description => "nouns denoting substances" },
+	    { :lex => :noun_time, :description => "nouns denoting time and temporal relations" },
+	    { :lex => :verb_body, :description => "verbs of grooming, dressing and bodily care" },
+	    { :lex => :verb_change, :description => "verbs of size, temperature change, intensifying, etc." },
+	    { :lex => :verb_cognition, :description => "verbs of thinking, judging, analyzing, doubting" },
+	    { :lex => :verb_communication, :description => "verbs of telling, asking, ordering, singing" },
+	    { :lex => :verb_competition, :description => "verbs of fighting, athletic activities" },
+	    { :lex => :verb_consumption, :description => "verbs of eating and drinking" },
+	    { :lex => :verb_contact, :description => "verbs of touching, hitting, tying, digging" },
+	    { :lex => :verb_creation, :description => "verbs of sewing, baking, painting, performing" },
+	    { :lex => :verb_emotion, :description => "verbs of feeling" },
+	    { :lex => :verb_motion, :description => "verbs of walking, flying, swimming" },
+	    { :lex => :verb_perception, :description => "verbs of seeing, hearing, feeling" },
+	    { :lex => :verb_possession, :description => "verbs of buying, selling, owning" },
+	    { :lex => :verb_social, :description => "verbs of political and social activities and events" },
+	    { :lex => :verb_stative, :description => "verbs of being, having, spatial relations" },
+	    { :lex => :verb_weather, :description => "verbs of raining, snowing, thawing, thundering" },
+	    { :lex => :adj_ppl, :description => "participial adjectives" } ]
 
-    end
+	def initialize(synset_id, wordnet_connection, homographs)
 
-    def synset_type
+	    @wordnet_connection = wordnet_connection
+	    @synset_hash = wordnet_connection.synset(synset_id)
+	    @homographs = homographs
 
-      SYNSET_TYPE_TO_SYMBOL[@synset_hash["synset_type"]]
+	    # construct some conveniance menthods for relation type access
+	    Relation::SYMBOL_TO_RELATION.keys.each do |relation_type|
+		self.class.send(:define_method, "#{relation_type}s?") do
+		    relations(relation_type).size > 0
+		end
+		self.class.send(:define_method, "#{relation_type}s") do
+		    relations(relation_type)
+		end
+	    end
 
-    end
+	end
 
-    def words
+	def synset_type
 
-      @words ||= words_with_lexical_ids.map { |word_with_num| word_with_num[:word] }
+	    SYNSET_TYPE_TO_SYMBOL[@synset_hash["synset_type"]]
 
-      @words
+	end
 
-    end
+	def words
 
-    def lexical_ids
+	    @words ||= map_from_words_with_lexical_ids(:word)
 
-      @words ||= words_with_lexical_ids.map { |word_with_num| word_with_num[:lexical_id] }
+	end
 
-      @words
+	def lexical_ids
 
-    end
+	    @words ||= map_from_words_with_lexical_ids(:lexical_id)
 
-    def size
+	end
 
-      words.size
+	def size
 
-    end
+	    words.size
 
-    def words_with_lexical_ids
+	end
 
-      @words_with_num ||= @synset_hash["words"].split('|').map { |word| word_parts = word.split('.'); { :word => word_parts[0].gsub('_', ' '), :lexical_id => word_parts[1] } }
+	def words_with_lexical_ids
 
-      @words_with_num
+	    @words_with_num ||= @synset_hash["words"].split('|').map { |word| word_parts = word.split('.'); { :word => word_parts[0].gsub('_', ' '), :lexical_id => word_parts[1] } }
 
-    end
+	end
 
-    def lexical_filenum
+	def lexical_filenum
 
-      @synset_hash["lexical_filenum"]
+	    @synset_hash["lexical_filenum"]
 
-    end
+	end
 
-    def lexical_catagory
+	def lexical_catagory
 
-      lexical[:lex]
+	    lexical[:lex]
 
-    end
+	end
 
-    def lexical_description
+	def lexical_description
 
-      lexical[:description]
+	    lexical[:description]
 
-    end
+	end
 
-    def lexical
+	def lexical
 
-      NUM_TO_LEX[lexical_filenum.to_i]
+	    NUM_TO_LEX[lexical_filenum.to_i]
 
-    end
+	end
 
-    def synset_id
+	def synset_id
 
-      @synset_hash["synset_id"]
+	    @synset_hash["synset_id"]
 
-    end
+	end
 
-    def gloss
+	def gloss
 
-      @synset_hash["gloss"]
+	    @synset_hash["gloss"]
 
-    end
+	end
 
-    def lemma
+	def lemma
 
-      @homographs.lemma
+	    @homographs.lemma
 
-    end
+	end
 
-    def homographs
+	def homographs
 
-      @homographs
+	    @homographs
 
-    end
+	end
 
-    def inspect
+	def inspect
 
-      @synset_hash.inspect
+	    @synset_hash.inspect
 
-    end
+	end
 
-    def relations(type = :all)
+	def relations(type = :all)
 
-      @relations ||= @synset_hash["relations"].split('|').map { |relation| Relation.new(relation, self, @wordnet_connection) }
+	    @relations ||= @synset_hash["relations"].split('|').map { |relation| Relation.new(relation, self, @wordnet_connection) }
 
-      case
-      when Relation::SYMBOL_TO_RELATION.include?(type.to_sym)
-        @relations.select { |relation| relation.relation_type == type.to_sym }
-      when Relation::RELATION_TO_SYMBOL.include?(type.to_s)
-        @relations.select { |relation| relation.relation_type == Relation::RELATION_TO_SYMBOL[type.to_s] }
-      else
-        @relations
-      end
+	    case
+	    when Relation::SYMBOL_TO_RELATION.include?(type.to_sym)
+		@relations.select { |relation| relation.relation_type == type.to_sym }
+	    when Relation::RELATION_TO_SYMBOL.include?(type.to_s)
+		@relations.select { |relation| relation.relation_type == Relation::RELATION_TO_SYMBOL[type.to_s] }
+	    else
+		@relations
+	    end
 
-    end
+	end
 
-    def evocations
+	def evocations
       
-      evocations_arr = @wordnet_connection.evocations(synset_id)
-      Evocations.new(evocations_arr, self, @wordnet_connection) unless evocations_arr.nil?
+	    evocations_arr = @wordnet_connection.evocations(synset_id)
+	    Evocations.new(evocations_arr, self, @wordnet_connection) unless evocations_arr.nil?
 
-    end
+	end
 
-    def to_s
+	def to_s
 
-      @to_s ||= "#{synset_type.to_s.capitalize} including word(s): #{words.map { |word| '"' + word + '"' }.join(', ')} meaning: #{gloss}"
+	    @to_s ||= "#{synset_type.to_s.capitalize} including word(s): #{words.map { |word| '"' + word + '"' }.join(', ')} meaning: #{gloss}"
 
-      @to_s
+	end
 
-    end
+	alias word lemma
+
+	private
 
-    alias word lemma
+	def map_from_words_with_lexical_ids(value)
 
-  end
+	    words_with_lexical_ids.map { |word_with_num| word_with_num[value] }
+	    
+	end
+
+    end
 
 end