quickstats 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f2547d05b38fa8d8820572ba11508cd563789eef
-  data.tar.gz: 837718c9b373634a5b4a66c214402f1c00f4414c
+SHA256:
+  metadata.gz: f597df010147bfe94435eb14527af7fab444cbce2d0a193654be767e6fce58a2
+  data.tar.gz: 63f4f949c7b271f48bbbef88b903f17806446e5f335ead4329fe4d6c29709491
 SHA512:
-  metadata.gz: dd983feb6859c1d233fad61a82af33d9b5d30db587373383d47396adba50940b29da9fd935f92481fb7065160451f0d4cd03ff576f77be49a2f0050fa9ce2eb2
-  data.tar.gz: 0c35ab0c1a82464499adb9ae85d10301e21b43830ff07bc842cfa3f5315554d6869160713c593510f63aadf38ea1dd83a8aafd747d757d5399bd7b95cbf82f5b
+  metadata.gz: 579aae68d531a2e4cd0905bdb1c6a4b4f4191f541372dd5e2cdfd0a723dbf3dff78d6504e0373a086cb0d6c435042ac0ad24c3aea1848eac0211e6739c29d6f7
+  data.tar.gz: 95e97e151fca9bf2fba2dd95c3a9e26ccf9ce91323996f6abd9f7f1e56bd41703f7d7904272cc77f618df01ee8e7a25523a5569f7b0e4a1a9507f265e8c99b7d

data/lib/quickstats.rb

@@ -110,4 +110,17 @@ class QuickStats
   end
 
   alias std_err standard_error
+
+  # Calculates unbiased estimate of quadratic loss (a la' Taguchi)
+  # relative to a specified target value.
+  #
+  # *Arguments*::
+  #   - +target:+ -> the designated target value for the loss function.
+  # *Returns*::
+  #   - the quadratic loss calculated for the data, or NaN if this is a
+  #     new or just-reset QuickStats object.
+  def loss(target:)
+    fail 'Must supply target to loss function' unless target
+    @n > 1 ? (@sample_mean - target)**2 + @sum_sqrs / @n : Float::NAN
+  end
 end

data/quickstats.gemspec

@@ -1,10 +1,10 @@
 # -*- ruby -*-
-_VERSION = "2.0.0"
+_VERSION = "2.1.0"
 
 Gem::Specification.new do |s|
   s.name = "quickstats"
   s.version = _VERSION
-  s.date = "2016-07-12"
+  s.date = "2019-03-18"
   s.summary = "Computationally stable and efficient basic descriptive statistics."
   s.email = "pjs@alum.mit.edu"
   s.description = "This class uses Kalman Filter updating to tally sample mean and sum of squared deviations from the average, along with min, max, and sample size. Sample variance, standard deviation, and standard error are calculated on demand."
@@ -16,6 +16,7 @@ Gem::Specification.new do |s|
     Rakefile
     test/test_quickstats.rb
   ]
-  s.required_ruby_version = '>= 1.8.1'
-  s.license = 'LGPL'
+  s.required_ruby_version = '>= 2.3'
+  s.homepage = 'https://bitbucket.org/paul_j_sanchez/quickstats'
+  s.license = 'LGPL-2.1-or-later'
 end

data/test/test_quickstats.rb

@@ -11,6 +11,7 @@ class QuickStats_test < Test::Unit::TestCase
     assert_true qs.sample_variance.nan?
     assert_true qs.min.nan?
     assert_true qs.max.nan?
+    assert_true qs.loss(target: 0).nan?
 
     qs.add_set [41,43]
     assert_equal 2, qs.n
@@ -20,6 +21,9 @@ class QuickStats_test < Test::Unit::TestCase
     assert_equal 41.0, qs.min
     assert_equal 43.0, qs.max
     assert_equal 1.0, qs.standard_error
+    assert_equal 1.0, qs.loss(target: 42.0)
+    assert_equal 2.0, qs.loss(target: 43.0)
+    assert_equal 65.0, qs.loss(target: 50.0)
     qs.new_obs 42
     assert_equal 3, qs.n
     assert_equal 42.0, qs.sample_mean
@@ -27,6 +31,8 @@ class QuickStats_test < Test::Unit::TestCase
     assert_equal 1.0, qs.standard_deviation
     assert_equal 41.0, qs.min
     assert_equal 43.0, qs.max
+    assert_equal 2.0/3.0, qs.loss(target: 42)
+    assert_equal (1.0 + 2.0/3.0), qs.loss(target: 43)
 
     qs.reset
     assert_equal 0, qs.n
@@ -34,6 +40,7 @@ class QuickStats_test < Test::Unit::TestCase
     assert_true qs.sample_variance.nan?
     assert_true qs.min.nan?
     assert_true qs.max.nan?
+    assert_true qs.loss(target: 0).nan?
   end
 
   def test_aliases

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quickstats
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Paul J Sanchez
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-12 00:00:00.000000000 Z
+date: 2019-03-18 00:00:00.000000000 Z
 dependencies: []
 description: This class uses Kalman Filter updating to tally sample mean and sum of
   squared deviations from the average, along with min, max, and sample size. Sample
@@ -23,9 +23,9 @@ files:
 - lib/quickstats.rb
 - quickstats.gemspec
 - test/test_quickstats.rb
-homepage: 
+homepage: https://bitbucket.org/paul_j_sanchez/quickstats
 licenses:
-- LGPL
+- LGPL-2.1-or-later
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -35,17 +35,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.8.1
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Computationally stable and efficient basic descriptive statistics.
 test_files: []
-has_rdoc: