tiny_outcome 3.0.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86b4b40958991ec5019ebaa4595fd5526cb06547d1e649dadf8dd7098355b45c
-  data.tar.gz: 546ace5ff2dde2fa8cd3d4e6e982101d90c57293157a66458ba870cb6860e305
+  metadata.gz: 117564a93dd35781e19d6f1420eb763f2a39ed5feb38a7a3bd3279ad8f1ed4d2
+  data.tar.gz: 5dd7829f20e626b261a004ef3f83a8e48d8e978fc8d400d36f63d62e6f6bfd42
 SHA512:
-  metadata.gz: 442b6a72cbf0f0457c10de8ce1a8f78b8b7c5187a634c3816e8b3dea5d5eb0c33bed7a1d01f5bc86c1373c6a323df46df6dd6dc78da0b94ba0856e714cba221c
-  data.tar.gz: e92cbdef295da8f77501608c9d8a4511b2b1f2c184b7eba8e8896ac901c125b5ad2c330c7fc07f346b81b31fd0cd2650b175f301cb6f6248814014216b147aaf
+  metadata.gz: 02c0184cb9692db7ffce8fd91cd1ec1b830df1b0bebf453c7fd25744ead1cc2af5ba2e9c990b4eed23d3668231edeb79840b4121ddf65d5ac2bbf57a6e1a85c5
+  data.tar.gz: 3fb696f998d6598d04453b5dbe1ac70216ff340884b9a6d89a6b990338619e7c34197b43a10d7a2403ea4b5ff3ba915cd988c4c1a5b0982c6f39ca7383538006

data/lib/tiny_outcome.rb

@@ -32,7 +32,10 @@ class TinyOutcome
               :warmup,
               :probability,
               :one_count,
-              :value
+              :value,
+              :min,
+              :max,
+              :avg
 
   WARM_FULL = :full
   WARM_TWO_THIRDS = :two_thirds
@@ -49,6 +52,9 @@ class TinyOutcome
     @probability = 0.0
     @one_count = 0
     @samples = 0
+    @min = 1.0
+    @max = 0.0
+    @avg = 0.0
     @warmth = 0
     @value = [0] * @precision
     @value_index = 0
@@ -68,10 +74,7 @@ class TinyOutcome
     (full? ? @value.rotate(@value_index) : @value)[..(samples-1)].join.to_i(2)
   end
 
-  # add a sample to the historic outcomes. the new sample is added to the
-  # low-order bits. the new sample is literally left-shifted into the value. the
-  # only reason this is a custom method is because some metadata needs to be
-  # updated when a new sample is added
+  # add a sample to the historic outcomes
   def <<(sample)
     raise "Invalid sample: #{sample}" unless sample == 0 || sample == 1
 
@@ -91,7 +94,7 @@ class TinyOutcome
     @one_count += 1 if sample == 1
     @probability = @one_count / samples.to_f
 
-    value
+    @value
   end
 
   # true if #probability is >= percentage
@@ -117,6 +120,30 @@ class TinyOutcome
     samples == precision
   end
 
+  # updates, and memoizes, the min/max/avg numbers. if you read the min/max/avg
+  # attributes you are getting the MEMOIZED values.
+  def update_stats!
+    return if @samples == 0
+
+    @min = 1.0
+    @max = 0.0
+    @avg = 0.0
+
+    sum = 0.0
+    raw = (full? ? @value.rotate(@value_index) : @value)[..(samples-1)]
+    group_size = [@samples, 100].min
+    num_groups = @samples - group_size
+    raw.each_cons(group_size) do |samples_group|
+      curr = samples_group.count(1) / samples.to_f
+      sum += curr
+
+      @min = curr if curr < @min
+      @max = curr if curr > @max
+    end
+
+    @avg = sum / (@num_groups.to_f + 1.0)
+  end
+
   # convenient way to see what's up
   def to_hash
     [:value,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tiny_outcome
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.1
 platform: ruby
 authors:
 - Jeff Lunt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-03 00:00:00.000000000 Z
+date: 2023-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest