neuronet 8.0.251113 → 9.0.251116

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f23ce75292128094b31f4eac5245ac41a7b3cf42026aa4bbb2ce74e19fd255
-  data.tar.gz: ec4105888e4bc67361a9f4d1bde5edbfe94f7363bbe1233e39fc29fc3c2e6de7
+  metadata.gz: 8fcd067b50961b58b6b651d90ecf266b12c8af3b25eb4bb991793f29a0db700a
+  data.tar.gz: 0a29c998e309ffb0896f9a1e9b0649cf957ac4648aa6c80233455ca76745d4b8
 SHA512:
-  metadata.gz: 5222bf678484647b6911c489d304206ed3730438b7810a0a19e08a633a2e422e0afb2ff7cbb84272ffc7080136d361dd1d1ee9cdd3424b21aea6b274bd6f306c
-  data.tar.gz: 4082141fd54fedf66e3449334b5546abe0b78ee6306eee2e3acd15864ff93b446af8f0a0ed520d27e98c991f7bd3a62222b00b652d0289616ea5ea2c167eb5c7
+  metadata.gz: 402fd261d78682ea719677878c038efd81d65255f5aafeffcc4a39a9b5f63e28abcf1d10b22cc6a736b4d9a21ced6941d0aaee40a8aaf4db6c0c59d7c4881f6b
+  data.tar.gz: 9d600982412e31bbd631d3c47976e8b29c33d324e7b6d04e164401634448dbc484fe43519ab2e8a4a96fe2580fd876636e7a4ae97d12bdf06206fc691cc2270f

data/README.md

@@ -1,6 +1,6 @@
 # Neuronet
 
-* [VERSION 8.0.251113](https://github.com/carlosjhr64/neuronet/releases)
+* [VERSION 9.0.251116](https://github.com/carlosjhr64/neuronet/releases)
 * [github](https://www.github.com/carlosjhr64/neuronet)
 * [rubygems](https://rubygems.org/neuronet)
 
@@ -68,6 +68,9 @@ When reading the library, this is order the order I would read it:
 Once you understand these files, the rest should all make sense.
 For some math on neural networks,
 see the [Wiki](https://github.com/carlosjhr64/neuronet/wiki).
+Finally, out of all my testing,
+probably the best demonstration here that Neuronet works is
+[examples/test_logic](examples/test_logic).
 
 ## LICENSE
 

data/lib/neuronet/backpropagate.rb

@@ -6,12 +6,22 @@ module Neuronet
     # Back-propagates errors, updating bias and connection weights.
     # Clamps updates to [-max, +max].
     # Recursively calls on connected neurons.
-    # rubocop: disable Metrics, Style
     def backpropagate(error)
+      return if @backpropagated
+
+      @backpropagated = true
+      update_bias(error)
+      update_connections(error)
+    end
+
+    # rubocop: disable Style/NestedTernaryOperator
+    def update_bias(error)
       bmax = Config.bias_clamp
       b = bias + error
       self.bias = b.abs > bmax ? (b.positive? ? bmax : -bmax) : b
+    end
 
+    def update_connections(error)
       wmax = Config.weight_clamp
       connections.each do |c|
         n = c.neuron
@@ -20,6 +30,18 @@ module Neuronet
         n.backpropagate(error)
       end
     end
-    # rubocop: enable Metrics, Style
+    # rubocop: enable Style/NestedTernaryOperator
+
+    def reset_backpropagated!
+      return unless @backpropagated
+
+      @backpropagated = false
+      connections.each { |c| c.neuron.reset_backpropagated! }
+    end
+
+    def backpropagate!(error)
+      reset_backpropagated!
+      backpropagate(error)
+    end
   end
 end

data/lib/neuronet/input_neuron.rb

@@ -23,5 +23,6 @@ module Neuronet
     end
 
     def backpropagate(_) = nil
+    def reset_backpropagated! = nil
   end
 end

data/lib/neuronet/neuron_stats.rb

@@ -15,12 +15,13 @@ module Neuronet
     def downstream_params_tally
       return 0 if (size = connections.size).zero?
 
+      # Note that this is an Integer calculation:
       1 + size + connections.sum { it.neuron.downstream_params_tally }
     end
 
     # Sum of activations + 1.  It's a component of the sensitivity measure nju.
     # See [wiki](https://github.com/carlosjhr64/neuronet/wiki)
-    def mju = 1 + connections.sum { it.neuron.activation }
+    def mju = 1.0 + connections.sum { it.neuron.activation }
 
     # Sensitivity measure nju:
     #     𝒆 ~ 𝜀𝝁 + 𝑾 𝓑𝒂'𝒆'
@@ -31,7 +32,7 @@ module Neuronet
     #     https://github.com/carlosjhr64/neuronet/blob/master/test/tc_epsilon
     # rubocop: disable Metrics
     def nju
-      return 0 if connections.empty?
+      return 0.0 if connections.empty?
 
       mju + connections.sum do |connection|
         n = connection.neuron

data/lib/neuronet/noisy_backpropagate.rb

@@ -3,12 +3,17 @@
 module Neuronet
   # Noisy Backpropagate
   module NoisyBackpropagate
-    # rubocop: disable Metrics, Style
-    def backpropagate(error)
+    include Backpropagate
+
+    # rubocop: disable Style/NestedTernaryOperator
+    def update_bias(error)
       bmax = Config.bias_clamp
       b = bias + (error * (rand + rand))
       self.bias = b.abs > bmax ? (b.positive? ? bmax : -bmax) : b
+    end
 
+    # rubocop: disable Metrics/AbcSize
+    def update_connections(error)
       wmax = Config.weight_clamp
       connections.each do |c|
         n = c.neuron
@@ -17,6 +22,7 @@ module Neuronet
         n.backpropagate(error)
       end
     end
-    # rubocop: enable Metrics, Style
+    # rubocop: enable Metrics/AbcSize
+    # rubocop: enable Style/NestedTernaryOperator
   end
 end

data/lib/neuronet/trainable.rb

@@ -12,7 +12,7 @@ module Neuronet
       errors = targets.zip(actuals).map { |target, actual| target - actual }
       error, index = pivot(errors)
       neuron = output_layer[index]
-      neuron.backpropagate(error / nju)
+      neuron.backpropagate!(error / nju)
     end
 
     def pivot(errors)
@@ -25,5 +25,12 @@ module Neuronet
       end
       [error, index]
     end
+
+    def sum_of_squared_errors(pairs)
+      pairs.sum do |inputs, targets|
+        actuals = self * inputs
+        targets.zip(actuals).sum { |t, a| (e = t - a) * e }
+      end
+    end
   end
 end

data/lib/neuronet.rb

@@ -2,7 +2,7 @@
 
 # Neuronet
 module Neuronet
-  VERSION = '8.0.251113'
+  VERSION = '9.0.251116'
 
   autoload :Arrayable,          'neuronet/arrayable'
   autoload :Exportable,         'neuronet/exportable'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: neuronet
 version: !ruby/object:Gem::Version
-  version: 8.0.251113
+  version: 9.0.251116
 platform: ruby
 authors:
 - CarlosJHR64
 bindir: bin
 cert_chain: []
-date: 2025-11-14 00:00:00.000000000 Z
+date: 2025-11-18 00:00:00.000000000 Z
 dependencies: []
 description: |
   Library to create neural networks.