ruby-fann 0.7.2 → 0.7.3

data/History.txt

@@ -7,3 +7,8 @@
 
   * 1 major enhancement:
     * Include docs
+
+== 0.7.3 2007-12-19
+
+  * 1 minor enhancement
+    * Directives to build native extensions

data/Manifest.txt

@@ -5,14 +5,17 @@ README.txt
 Rakefile
 config/hoe.rb
 config/requirements.rb
-doc
+ext/ruby_fann/MANIFEST
+ext/ruby_fann/Makefile
 ext/ruby_fann/extconf.rb
 ext/ruby_fann/fann_augment.h
 ext/ruby_fann/neural_network.c
 lib/ruby_fann.rb
-lib/ruby_fann/version.rb
 lib/ruby_fann/neurotica.rb
+lib/ruby_fann/version.rb
 log/debug.log
+neurotica1.png
+neurotica2.vrml
 script/destroy
 script/generate
 script/txt2html
@@ -20,10 +23,17 @@ setup.rb
 tasks/deployment.rake
 tasks/environment.rake
 tasks/website.rake
+test/test.train
 test/test_helper.rb
+test/test_neurotica.rb
 test/test_ruby_fann.rb
+test/test_ruby_fann_functional.rb
+verify.train
 website/index.html
 website/index.txt
 website/javascripts/rounded_corners_lite.inc.js
 website/stylesheets/screen.css
 website/template.rhtml
+xor.train
+xor_cascade.net
+xor_float.net

data/README.txt

@@ -1 +1,12 @@
-README
+= RubyFann
+Bindings to use FANN from within ruby/rails environment.  
+Requires:
+	FANN 2.1 or greater (preferably in /usr/local/lib)
+	Ruby 1.8.6 or greater.
+	gnu make tools or equiv for native code in ext
+
+== Examples
+  train = RubyFann::TrainData.new(:inputs=>[[0.3, 0.4, 0.5], [0.1, 0.2, 0.3]], :desired_outputs=>[[0.7], [0.8]])
+  fann = RubyFann::Standard.new(:num_inputs=>5, :hidden_neurons=>[2, 8, 4, 3, 4], :num_outputs=>1)
+  fann.train_on_data(train, 1000, 10, 0.1)
+  outputs = fann.run([3.0, 2.0, 3.0])    

data/config/hoe.rb

@@ -35,7 +35,7 @@ VERS = RubyFann::VERSION::STRING + (REV ? ".#{REV}" : "")
 RDOC_OPTS = ['--quiet', '--title', 'ruby_fann documentation',
     "--opname", "index.html",
     "--line-numbers", 
-    "--main", "README",
+    "--main", "README.txt",
     "--inline-source"]
 
 class Hoe
@@ -61,7 +61,7 @@ hoe = Hoe.new(GEM_NAME, VERS) do |p|
   p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
   #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
   
-  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  p.spec_extras = {:extensions => "ext/ruby_fann/extconf.rb"}    # A hash of extra values to set in the gemspec.
   
 end
 

data/ext/ruby_fann/MANIFEST

@@ -0,0 +1,3 @@
+extconf.rb
+fann_augment.h
+neural_network.c

data/ext/ruby_fann/Makefile

@@ -0,0 +1,149 @@
+
+SHELL = /bin/sh
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = /usr/local/lib/ruby/1.8/i686-darwin8.11.1
+hdrdir = $(topdir)
+VPATH = $(srcdir):$(topdir):$(hdrdir)
+prefix = $(DESTDIR)/usr/local
+exec_prefix = $(prefix)
+sitedir = $(prefix)/lib/ruby/site_ruby
+rubylibdir = $(libdir)/ruby/$(ruby_version)
+docdir = $(datarootdir)/doc/$(PACKAGE)
+dvidir = $(docdir)
+datarootdir = $(prefix)/share
+archdir = $(rubylibdir)/$(arch)
+sbindir = $(exec_prefix)/sbin
+psdir = $(docdir)
+localedir = $(datarootdir)/locale
+htmldir = $(docdir)
+datadir = $(datarootdir)
+includedir = $(prefix)/include
+infodir = $(datarootdir)/info
+sysconfdir = $(prefix)/etc
+mandir = $(datarootdir)/man
+libdir = $(exec_prefix)/lib
+sharedstatedir = $(prefix)/com
+oldincludedir = $(DESTDIR)/usr/include
+pdfdir = $(docdir)
+sitearchdir = $(sitelibdir)/$(sitearch)
+bindir = $(exec_prefix)/bin
+localstatedir = $(prefix)/var
+sitelibdir = $(sitedir)/$(ruby_version)
+libexecdir = $(exec_prefix)/libexec
+
+CC = gcc
+LIBRUBY = $(LIBRUBY_SO)
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static
+
+RUBY_EXTCONF_H = 
+CFLAGS   =  -fno-common -g -O2  -fno-common -pipe -fno-common 
+INCFLAGS = -I. -I. -I/usr/local/lib/ruby/1.8/i686-darwin8.11.1 -I.
+CPPFLAGS =  
+CXXFLAGS = $(CFLAGS) 
+DLDFLAGS = -L.   
+LDSHARED = cc -dynamic -bundle -undefined suppress -flat_namespace
+AR = ar
+EXEEXT = 
+
+RUBY_INSTALL_NAME = ruby
+RUBY_SO_NAME = ruby
+arch = i686-darwin8.11.1
+sitearch = i686-darwin8.11.1
+ruby_version = 1.8
+ruby = /usr/local/bin/ruby
+RUBY = $(ruby)
+RM = rm -f
+MAKEDIRS = mkdir -p
+INSTALL = /usr/bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+
+#### End of system configuration section. ####
+
+preload = 
+
+libpath = . $(libdir)
+LIBPATH =  -L"." -L"$(libdir)"
+DEFFILE = 
+
+CLEANFILES = mkmf.log
+DISTCLEANFILES = 
+
+extout = 
+extout_prefix = 
+target_prefix = 
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED) -ldoublefann  -lpthread -ldl -lobjc  
+SRCS = neural_network.c
+OBJS = neural_network.o
+TARGET = neural_network
+DLLIB = $(TARGET).bundle
+EXTSTATIC = 
+STATIC_LIB = 
+
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+
+TARGET_SO     = $(DLLIB)
+CLEANLIBS     = $(TARGET).bundle $(TARGET).il? $(TARGET).tds $(TARGET).map
+CLEANOBJS     = *.o *.a *.s[ol] *.pdb *.exp *.bak
+
+all:		$(DLLIB)
+static:		$(STATIC_LIB)
+
+clean:
+		@-$(RM) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES)
+
+distclean:	clean
+		@-$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		@-$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+
+realclean:	distclean
+install: install-so install-rb
+
+install-so: $(RUBYARCHDIR)
+install-so: $(RUBYARCHDIR)/$(DLLIB)
+$(RUBYARCHDIR)/$(DLLIB): $(DLLIB)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+install-rb: pre-install-rb install-rb-default
+install-rb-default: pre-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+$(RUBYARCHDIR):
+	$(MAKEDIRS) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .cxx .cpp .C .o
+
+.cc.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cxx.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cpp.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.C.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.c.o:
+	$(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) -c $<
+
+$(DLLIB): $(OBJS)
+	@-$(RM) $@
+	$(LDSHARED) -o $@ $(OBJS) $(LIBPATH) $(DLDFLAGS) $(LOCAL_LIBS) $(LIBS)
+
+
+
+$(OBJS): ruby.h defines.h

data/ext/ruby_fann/neural_network.c

@@ -1002,11 +1002,11 @@ static VALUE test_data(VALUE self, VALUE train_data)
 // 	return INT2NUM(fann_get_multiplier(f));
 // }
 
-// Train with inputs (array of arrays) & desired_outputs (array of arrays)
-// inputs & desired outputs should be of same length
-// All sub-arrays on inputs should be of same length
-// All sub-arrays on desired outputs should be of same length
-// Sub-arrays on inputs & desired_outputs can be different sizes from one another
+/** Perform cascade training with training data created with RubyFann::TrainData.new
+		max_epochs - The maximum number of neurons in trained network
+ 		neurons_between_reports - The number of neurons between printing a status report to stdout.
+ 		desired_error - The desired <get_MSE> or <get_bit_fail>, depending on which stop function
+ 		is chosen by <set_train_stop_function>.  */
 static VALUE cascadetrain_on_data(VALUE self, VALUE train_data, VALUE max_neurons, VALUE neurons_between_reports, VALUE desired_error)
 {
 	Check_Type(train_data, T_DATA);

data/lib/ruby_fann/version.rb

@@ -2,7 +2,7 @@ module RubyFann #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 7
-    TINY  = 2
+    TINY  = 3
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/neurotica2.vrml

@@ -0,0 +1,304 @@
+#VRML V2.0 utf8
+Group { children [
+  Transform {
+    scale 0.028 0.028 0.028
+    children [
+ Background { skyColor 1.000 1.000 1.000 }
+# node 8471040
+Transform {
+  translation 6.000 46.000 30.000
+  scale 2.000 2.000 2.000
+  children [
+    Transform {
+      children [
+        Shape {
+          geometry Sphere { radius 1.0 }
+          appearance Appearance {
+            material Material {
+              ambientIntensity 0.33
+              diffuseColor 0.000 0.000 0.000
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+# node 8470590
+Transform {
+  translation 50.000 6.000 71.000
+  scale 2.000 2.000 2.000
+  children [
+    Transform {
+      children [
+        Shape {
+          geometry Sphere { radius 1.0 }
+          appearance Appearance {
+            material Material {
+              ambientIntensity 0.33
+              diffuseColor 0.000 0.000 0.000
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+# edge 8471040 -> 8470590
+ Group { children [
+Transform {
+  children [
+    Shape {
+      geometry Cylinder {
+        bottom FALSE top FALSE
+        height 38.822 radius 1.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+Transform {
+  translation 0 24.411 0
+  children [
+    Shape {
+      geometry Cone {bottomRadius 3.500 height 10.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+  ]
+}
+      ]
+      center 0 5.000 0
+      rotation -0.000 0 -22.000 -3.975
+      translation 24.000 17.000 0.000
+    }
+] }
+# node 8470810
+Transform {
+  translation 28.000 46.000 5.000
+  scale 2.000 2.000 2.000
+  children [
+    Transform {
+      children [
+        Shape {
+          geometry Sphere { radius 1.0 }
+          appearance Appearance {
+            material Material {
+              ambientIntensity 0.33
+              diffuseColor 0.000 0.000 0.000
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+# edge 8470810 -> 8470590
+ Group { children [
+Transform {
+  children [
+    Shape {
+      geometry Cylinder {
+        bottom FALSE top FALSE
+        height 25.133 radius 1.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+Transform {
+  translation 0 17.566 0
+  children [
+    Shape {
+      geometry Cone {bottomRadius 3.500 height 10.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+  ]
+}
+      ]
+      center 0 5.000 0
+      rotation -0.000 0 -11.000 -3.644
+      translation 35.000 17.000 0.000
+    }
+] }
+# node 8470760
+Transform {
+  translation 50.000 46.000 21.000
+  scale 2.000 2.000 2.000
+  children [
+    Transform {
+      children [
+        Shape {
+          geometry Sphere { radius 1.0 }
+          appearance Appearance {
+            material Material {
+              ambientIntensity 0.33
+              diffuseColor 0.000 0.000 0.000
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+# edge 8470760 -> 8470590
+ Group { children [
+Transform {
+  children [
+    Shape {
+      geometry Cylinder {
+        bottom FALSE top FALSE
+        height 19.035 radius 1.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+Transform {
+  translation 0 14.518 0
+  children [
+    Shape {
+      geometry Cone {bottomRadius 3.500 height 10.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+  ]
+}
+      ]
+      center 0 5.000 0
+      rotation -0.000 0 1.000 -3.142
+      translation 46.000 17.000 0.000
+    }
+] }
+# node 8470710
+Transform {
+  translation 72.000 46.000 9.000
+  scale 2.000 2.000 2.000
+  children [
+    Transform {
+      children [
+        Shape {
+          geometry Sphere { radius 1.0 }
+          appearance Appearance {
+            material Material {
+              ambientIntensity 0.33
+              diffuseColor 0.000 0.000 0.000
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+# edge 8470710 -> 8470590
+ Group { children [
+Transform {
+  children [
+    Shape {
+      geometry Cylinder {
+        bottom FALSE top FALSE
+        height 24.018 radius 1.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+Transform {
+  translation 0 17.009 0
+  children [
+    Shape {
+      geometry Cone {bottomRadius 3.500 height 10.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+  ]
+}
+      ]
+      center 0 5.000 0
+      rotation -0.000 0 11.000 -3.644
+      translation 57.000 17.000 0.000
+    }
+] }
+# node 8470650
+Transform {
+  translation 94.000 46.000 90.000
+  scale 2.000 2.000 2.000
+  children [
+    Transform {
+      children [
+        Shape {
+          geometry Sphere { radius 1.0 }
+          appearance Appearance {
+            material Material {
+              ambientIntensity 0.33
+              diffuseColor 0.000 0.000 0.000
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+# edge 8470650 -> 8470590
+ Group { children [
+Transform {
+  children [
+    Shape {
+      geometry Cylinder {
+        bottom FALSE top FALSE
+        height 37.531 radius 1.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+Transform {
+  translation 0 23.765 0
+  children [
+    Shape {
+      geometry Cone {bottomRadius 3.500 height 10.000 }
+      appearance Appearance {
+        material Material {
+          ambientIntensity 0.33
+          diffuseColor 0.000 0.000 1.000
+        }
+      }
+    }
+  ]
+}
+      ]
+      center 0 5.000 0
+      rotation -0.000 0 22.000 -3.975
+      translation 68.000 17.000 0.000
+    }
+] }
+  ] }
+  Viewpoint {position 1.852 0.963 6.147}
+] }

data/test/test.train

@@ -0,0 +1,3 @@
+1 3 1
+0.200000 0.300000 0.400000 
+3.140000 

data/test/test_neurotica.rb

@@ -1,8 +1,8 @@
 require 'test/unit'
 require "rubygems" 
 require "graphviz"
-require 'ext/ruby_fann/neural_network'
-require 'lib/ruby_fann/neurotica'
+require 'ruby_fann/neural_network'
+require 'ruby_fann/neurotica'
 
 class NeuroticaTest < Test::Unit::TestCase
   def test_basic_output

data/test/test_ruby_fann.rb

@@ -1,5 +1,6 @@
 require 'test/unit'
-require 'ext/ruby_fann/neural_network'
+require 'rubygems'
+require 'ruby_fann/neural_network'
 
 class MyShortcut < RubyFann::Shortcut
   def initialize

data/test/test_ruby_fann_functional.rb

@@ -1,5 +1,6 @@
 require 'test/unit'
-require 'ext/ruby_fann/neural_network'
+require 'rubygems'
+require 'ruby_fann/neural_network'
 
 class RubyFannFunctionalTest < Test::Unit::TestCase
   XOR_INPUT_DATA =  [[-1, -1], [-1, 1], [1, -1], [1, 1]]

data/verify.train

@@ -0,0 +1,3 @@
+1 3 1
+0.200000 0.300000 0.400000 
+3.140000 

data/website/index.html

@@ -35,10 +35,13 @@
       <p>Get Version</p>
       <a href="http://rubyforge.org/projects/ruby-fann" class="numbers">0.7.2</a>
     </div>
-    <h2>What</h2>
+    <p><em>Bindings to use <a href="http://leenissen.dk/fann/"><span class="caps">FANN</span></a> (Fast Artificial Neural Network) from within ruby/rails environment.</em></p>
 
 
-	<p>Bindings to use <span class="caps">FANN</span> (Fast Artificial Neural Network) from within ruby/rails environment.</p>
+	<h2>Documentation</h2>
+
+
+	<p>Get your documentation here: <a href="http://ruby-fann.rubyforge.org/rdoc">Docs</a></p>
 
 
 	<h2>Installing</h2>
@@ -49,7 +52,7 @@
 
 	<p><a href="http://leenissen.dk/fann/">http://leenissen.dk/fann/</a></p>
 </li>
-		<li>Then, install the ruby bindings:
+		<li>Then, install ruby-fann:
 <pre class='syntax'><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">ruby</span><span class="punct">-</span><span class="ident">fann</span></pre></li>
 	</ul>
 
@@ -68,16 +71,17 @@
 
 
 	<p><pre class='syntax'>
+<span class="ident">require</span> <span class="punct">'</span><span class="string">rubygems</span><span class="punct">'</span>
 <span class="ident">require</span> <span class="punct">'</span><span class="string">ruby_fann/neural_network</span><span class="punct">'</span>
 <span class="ident">training_data</span> <span class="punct">=</span> <span class="constant">RubyFann</span><span class="punct">::</span><span class="constant">TrainData</span><span class="punct">.</span><span class="ident">new</span><span class="punct">(</span>
   <span class="symbol">:inputs=</span><span class="punct">&gt;[[</span><span class="number">0.3</span><span class="punct">,</span> <span class="number">0.4</span><span class="punct">,</span> <span class="number">0.5</span><span class="punct">],</span> <span class="punct">[</span><span class="number">0.1</span><span class="punct">,</span> <span class="number">0.2</span><span class="punct">,</span> <span class="number">0.3</span><span class="punct">]],</span> 
   <span class="symbol">:desired_outputs=</span><span class="punct">&gt;[[</span><span class="number">0.7</span><span class="punct">],</span> <span class="punct">[</span><span class="number">0.8</span><span class="punct">]])</span>
-<span class="ident">neural_network</span> <span class="punct">=</span> <span class="constant">RubyFann</span><span class="punct">::</span><span class="constant">Standard</span><span class="punct">.</span><span class="ident">new</span><span class="punct">(</span>
-  <span class="symbol">:num_inputs=</span><span class="punct">&gt;</span><span class="number">5</span><span class="punct">,</span> 
+<span class="ident">fann</span> <span class="punct">=</span> <span class="constant">RubyFann</span><span class="punct">::</span><span class="constant">Standard</span><span class="punct">.</span><span class="ident">new</span><span class="punct">(</span>
+  <span class="symbol">:num_inputs=</span><span class="punct">&gt;</span><span class="number">3</span><span class="punct">,</span> 
   <span class="symbol">:hidden_neurons=</span><span class="punct">&gt;[</span><span class="number">2</span><span class="punct">,</span> <span class="number">8</span><span class="punct">,</span> <span class="number">4</span><span class="punct">,</span> <span class="number">3</span><span class="punct">,</span> <span class="number">4</span><span class="punct">],</span> 
   <span class="symbol">:num_outputs=</span><span class="punct">&gt;</span><span class="number">1</span><span class="punct">)</span>
-<span class="ident">neural_network</span><span class="punct">.</span><span class="ident">train_on_data</span><span class="punct">(</span><span class="ident">training_data</span><span class="punct">,</span> <span class="number">1000</span><span class="punct">,</span> <span class="number">10</span><span class="punct">,</span> <span class="number">0.1</span><span class="punct">)</span>
-<span class="ident">outputs</span> <span class="punct">=</span> <span class="ident">neural_network</span><span class="punct">.</span><span class="ident">run</span><span class="punct">([</span><span class="number">3.0</span><span class="punct">,</span> <span class="number">2.0</span><span class="punct">,</span> <span class="number">3.0</span><span class="punct">])</span>    
+<span class="ident">fann</span><span class="punct">.</span><span class="ident">train_on_data</span><span class="punct">(</span><span class="ident">training_data</span><span class="punct">,</span> <span class="number">1000</span><span class="punct">,</span> <span class="number">1</span><span class="punct">,</span> <span class="number">0.1</span><span class="punct">)</span>
+<span class="ident">outputs</span> <span class="punct">=</span> <span class="ident">fann</span><span class="punct">.</span><span class="ident">run</span><span class="punct">([</span><span class="number">0.7</span><span class="punct">,</span> <span class="number">0.9</span><span class="punct">,</span> <span class="number">0.2</span><span class="punct">])</span>    
 </pre></p>
 
 
@@ -107,7 +111,7 @@
 
 	<p>Comments are welcome. Send an email to <a href="mailto:steven@7bpeople.com">Steven Miers</a> email via the <a href="http://groups.google.com/group/ruby_fann">forum</a></p>
     <p class="coda">
-      <a href="steven@7bpeople.com">Steven Miers</a>, 18th December 2007<br>
+      <a href="steven@7bpeople.com">Steven Miers</a>, 19th December 2007<br>
     </p>
 </div>
 

data/website/index.txt

@@ -1,16 +1,17 @@
 h1. ruby-fann
 
-h2. What
+_Bindings to use "FANN":http://leenissen.dk/fann/ (Fast Artificial Neural Network) from within ruby/rails environment._
 
-Bindings to use FANN (Fast Artificial Neural Network) from within ruby/rails environment.  
+h2. Documentation
 
+Get your documentation here: "Docs":http://ruby-fann.rubyforge.org/rdoc
 
 h2. Installing
 
 * First, Go here & install FANN for your platform:
 
  "http://leenissen.dk/fann/":http://leenissen.dk/fann/
-* Then, install the ruby bindings:
+* Then, install ruby-fann:
 <pre syntax="ruby">sudo gem install ruby-fann</pre>
 
 h2. Requirements:
@@ -23,16 +24,17 @@ h2. Requirements:
 h2. Demonstration of usage
 
 <pre syntax="ruby">
+require 'rubygems'
 require 'ruby_fann/neural_network'
 training_data = RubyFann::TrainData.new(
   :inputs=>[[0.3, 0.4, 0.5], [0.1, 0.2, 0.3]], 
   :desired_outputs=>[[0.7], [0.8]])
-neural_network = RubyFann::Standard.new(
-  :num_inputs=>5, 
+fann = RubyFann::Standard.new(
+  :num_inputs=>3, 
   :hidden_neurons=>[2, 8, 4, 3, 4], 
   :num_outputs=>1)
-neural_network.train_on_data(training_data, 1000, 10, 0.1)
-outputs = neural_network.run([3.0, 2.0, 3.0])    
+fann.train_on_data(training_data, 1000, 1, 0.1)
+outputs = fann.run([0.7, 0.9, 0.2])    
 </pre>
 
 h2. Forum

data/xor.train

@@ -0,0 +1,9 @@
+4 2 1
+-1 -1 
+-1 
+-1 1 
+1 
+1 -1 
+1 
+1 1 
+-1 

data/xor_cascade.net

@@ -0,0 +1,34 @@
+FANN_FLO_2.1
+num_layers=4
+learning_rate=0.700000
+connection_rate=1.000000
+network_type=1
+learning_momentum=0.000000
+training_algorithm=2
+train_error_function=0
+train_stop_function=0
+cascade_output_change_fraction=0.010000
+quickprop_decay=-0.000100
+quickprop_mu=1.750000
+rprop_increase_factor=1.200000
+rprop_decrease_factor=0.500000
+rprop_delta_min=0.000000
+rprop_delta_max=50.000000
+rprop_delta_zero=0.100000
+cascade_output_stagnation_epochs=12
+cascade_candidate_change_fraction=0.010000
+cascade_candidate_stagnation_epochs=12
+cascade_max_out_epochs=150
+cascade_max_cand_epochs=150
+cascade_num_candidate_groups=2
+bit_fail_limit=3.49999999999999977796e-01
+cascade_candidate_limit=1.00000000000000000000e+03
+cascade_weight_multiplier=4.00000000000000022204e-01
+cascade_activation_functions_count=10
+cascade_activation_functions=3 5 7 8 10 11 14 15 16 17 
+cascade_activation_steepnesses_count=4
+cascade_activation_steepnesses=2.50000000000000000000e-01 5.00000000000000000000e-01 7.50000000000000000000e-01 1.00000000000000000000e+00 
+layer_sizes=3 1 1 1 
+scale_included=0
+neurons (num_inputs, activation_function, activation_steepness)=(0, 0, 0.00000000000000000000e+00) (0, 0, 0.00000000000000000000e+00) (0, 0, 0.00000000000000000000e+00) (3, 14, 7.50000000000000000000e-01) (4, 7, 1.00000000000000000000e+00) (5, 5, 5.00000000000000000000e-01) 
+connections (connected_to_neuron, weight)=(0, 1.69368225817805306832e+00) (1, 2.08920519418653682919e+00) (2, 2.08209278669541841822e+00) (0, 3.34013988327298427805e+00) (1, 2.93217698586362640611e+00) (2, 3.22640486156344952207e+00) (3, 3.11359130974472542164e+00) (0, 3.15916855833715426449e-01) (1, 2.36476269687895951366e-01) (2, -2.40909157788608524475e-01) (3, 4.02651493128943016586e+01) (4, -2.06887458728570478028e-01) 

data/xor_float.net

@@ -0,0 +1,34 @@
+FANN_FLO_2.1
+num_layers=3
+learning_rate=0.700000
+connection_rate=1.000000
+network_type=0
+learning_momentum=0.000000
+training_algorithm=2
+train_error_function=1
+train_stop_function=1
+cascade_output_change_fraction=0.010000
+quickprop_decay=-0.000100
+quickprop_mu=1.750000
+rprop_increase_factor=1.200000
+rprop_decrease_factor=0.500000
+rprop_delta_min=0.000000
+rprop_delta_max=50.000000
+rprop_delta_zero=0.100000
+cascade_output_stagnation_epochs=12
+cascade_candidate_change_fraction=0.010000
+cascade_candidate_stagnation_epochs=12
+cascade_max_out_epochs=150
+cascade_max_cand_epochs=150
+cascade_num_candidate_groups=2
+bit_fail_limit=1.00000000000000002082e-03
+cascade_candidate_limit=1.00000000000000000000e+03
+cascade_weight_multiplier=4.00000000000000022204e-01
+cascade_activation_functions_count=10
+cascade_activation_functions=3 5 7 8 10 11 14 15 16 17 
+cascade_activation_steepnesses_count=4
+cascade_activation_steepnesses=2.50000000000000000000e-01 5.00000000000000000000e-01 7.50000000000000000000e-01 1.00000000000000000000e+00 
+layer_sizes=3 4 2 
+scale_included=0
+neurons (num_inputs, activation_function, activation_steepness)=(0, 0, 0.00000000000000000000e+00) (0, 0, 0.00000000000000000000e+00) (0, 0, 0.00000000000000000000e+00) (3, 5, 1.00000000000000000000e+00) (3, 5, 1.00000000000000000000e+00) (3, 5, 1.00000000000000000000e+00) (0, 5, 1.00000000000000000000e+00) (4, 5, 1.00000000000000000000e+00) (0, 5, 1.00000000000000000000e+00) 
+connections (connected_to_neuron, weight)=(0, 1.77563726355814255342e+00) (1, 1.70865512093591309650e+00) (2, -1.35620772409434886541e+00) (0, 2.54763445407383049002e+00) (1, 2.38503950578006485017e+00) (2, 1.82714622361575518283e+00) (0, 2.23745614983482665750e+00) (1, 2.06383714945245611005e+00) (2, -2.08187721657654112306e+00) (3, -2.44900226502112489113e-01) (4, 4.89073018141245707824e+00) (5, -4.73615236757579260995e+00) (6, -4.61604992747759812488e+00) 

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: ruby-fann
 version: !ruby/object:Gem::Version 
-  version: 0.7.2
-date: 2007-12-18 00:00:00 -06:00
+  version: 0.7.3
+date: 2007-12-19 00:00:00 -06:00
 summary: Bindings to use FANN from within ruby/rails environment.
 require_paths: 
 - lib
@@ -37,14 +37,17 @@ files:
 - Rakefile
 - config/hoe.rb
 - config/requirements.rb
-- doc
+- ext/ruby_fann/MANIFEST
+- ext/ruby_fann/Makefile
 - ext/ruby_fann/extconf.rb
 - ext/ruby_fann/fann_augment.h
 - ext/ruby_fann/neural_network.c
 - lib/ruby_fann.rb
-- lib/ruby_fann/version.rb
 - lib/ruby_fann/neurotica.rb
+- lib/ruby_fann/version.rb
 - log/debug.log
+- neurotica1.png
+- neurotica2.vrml
 - script/destroy
 - script/generate
 - script/txt2html
@@ -52,13 +55,20 @@ files:
 - tasks/deployment.rake
 - tasks/environment.rake
 - tasks/website.rake
+- test/test.train
 - test/test_helper.rb
+- test/test_neurotica.rb
 - test/test_ruby_fann.rb
+- test/test_ruby_fann_functional.rb
+- verify.train
 - website/index.html
 - website/index.txt
 - website/javascripts/rounded_corners_lite.inc.js
 - website/stylesheets/screen.css
 - website/template.rhtml
+- xor.train
+- xor_cascade.net
+- xor_float.net
 test_files: 
 - test/test_helper.rb
 - test/test_neurotica.rb
@@ -75,8 +85,8 @@ extra_rdoc_files:
 - website/index.txt
 executables: []
 
-extensions: []
-
+extensions: 
+- ext/ruby_fann/extconf.rb
 requirements: []
 
 dependencies: []