hexwrench 0.0.1 → 0.0.2

data/README

@@ -7,6 +7,28 @@ by using the Weka wrapper, you agree to use Weka and HexWrench in a GNU GPL comp
 HexWrench comes with a Weka layer, which goal is to turn Welo::Resources in
 weka.core.Instances.
 
+=== Requirements
+
 To use it, you need:
 - JRuby
 - A recent Weka JAR on your $LOAD_PATH
+
+=== Usage
+
+See example/extended.jar to have a usage sample.
+
+=== Important
+Weka supports "related" relationships.
+Current HexWrench implementation partially works:
+- it works as expected for one level of relationship
+- in the case of 2nd and more levels of relationship,
+  it will create a new header (i.e., Attribute from Instances) 
+  per related object. Although this might be the expected behaviour in some
+  cases, it is not the "least-surprise" behaviour, future versions may change 
+  this
+- it breaks when there are "loops" in the relationship graph
+As a conclusion, DO NOT use more than one level of relationships unless you know
+Weka very well and had a look at the source.
+
+== R
+Upcoming.

data/TODO

@@ -1,6 +1,13 @@
-* related feature: 
 * explorer:
-- rename
+- rename to something more correct
 * weka-explorer:
-- populate attributes name on the fly
-- prepare sizes of relationships?
+- get sizes of relationships
+- when there are more than one relationship pointing to one kind of resources,
+  an header for each of them is created, not sure it's what we want, example:
+    class Foo
+      relationship :bar_1, :Bar, ...
+      relationship :bar_2, :Bar, ...
+      relationship :foo, :Foo, ...  #similar for looping relationships
+    end
+- when following relationships recursively, there may be loops in the relationships graphs,
+  we do not check this, not sure if it feasible in an efficient, general purpose, way

data/lib/hexwrench.rb

@@ -1,6 +1,6 @@
 
 module HexWrench
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
   AUTHORS = ["crapooze"]
   WEBSITE = "https://github.com/crapooze/hexwrench"
   LICENCE = "MIT | GPL"

data/lib/hexwrench/weka/explorer.rb

@@ -97,11 +97,11 @@ module HexWrench
         end
 
         def create_instances
-          inst = Weka::Instances.new(relation_name, fast_vector, resources_cnt)
+          Weka::Instances.new(relation_name, fast_vector, resources_cnt)
         end
 
-        def add_resource(resource)
-          values = features.map do |feat|
+        def values_for_resources(resource)
+          features.map do |feat|
             rb_val = resource.send(feat.sym)
             attribute = attribute(feat.sym)
             val = case feat
@@ -118,23 +118,38 @@ module HexWrench
                   when StringFeature
                     attribute.addStringValue(rb_val.to_java)
                   when RelationFeature
-                    header = header(feat.sym)
+                    header = header(feat.sym) 
                     raise NotImplementedError, "no header built for #{feat} yet" unless header
+                    data_instances = Weka::Instances.new(attribute.relation, 0)
                     if feat.relationship.many?
                       rb_val.each do |rb_val_|
-                        header.add_resource(rb_val_)
+                        header.add_resource_to_instances(rb_val_, data_instances)
                       end
                     else
-                      header.add_resource(rb_val)
+                      header.add_resource_to_instances(rb_val, data_instances)
                     end
-                    attribute.addRelation(header.instances)
+                    attribute.addRelation(data_instances) 
                   else
                     rb_val
                   end
             val
           end
+        end
+
+        def new_data_instances
+        end
+
+        def add_values_to_instances(values, instances)
           instances.add(Weka::Instance.new(1.0, values.to_java(Java::double)))
         end
+
+        def add_resource_to_instances(resource, instances)
+          add_values_to_instances(values_for_resources(resource), instances)
+        end
+
+        def add_resource(resource)
+          add_resource_to_instances(resource, instances)
+        end
       end
 
       attr_reader :headers

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: hexwrench
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 27
   prerelease: false
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - crapooze
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-23 00:00:00 +01:00
+date: 2011-02-25 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency