ruby_native_statistics 2.0.0.rc.1-aarch64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d2c12ffe4c45a7f5fb1bb3cc58c542dc602296fdd9c5a2dc64b4d82cf5697341
+  data.tar.gz: 8ef1f584495a6f7dab48a1a5e112376a2d2d3dab4f0237a1cef90958f7479648
+SHA512:
+  metadata.gz: 03a75a94a434e79bc5c59668e7d75471f3444119b2e184f5e7cdc31366bcac6166f178832b9d31cac1fb2f7852e0c50e70103e03a198c497a79c940fde25d554
+  data.tar.gz: 2f97cecdf1f0da003e922876c002c51af3715d41d9516099857006bb5b234fa0a8a9da45a7548b917d80288ced9f8426185fd7ef0d4c8c5523aa90fffb5eb162

data/.ruby-version

@@ -0,0 +1 @@
+3.4.4

data/README.md

@@ -0,0 +1,64 @@
+# Ruby Native Statistics
+
+[![Test status](https://github.com/corybuecker/ruby-native-statistics/workflows/Test%20suite/badge.svg)](https://github.com/corybuecker/ruby-native-statistics/actions)
+
+This is a native extension to Ruby that adds native (Rust) statistical functions to the Array class. At present the following functions are provided:
+
+- [Sample Standard Deviation](https://en.wikipedia.org/wiki/Standard_deviation#Corrected_sample_standard_deviation) (stdev, stdevs)
+- [Population Standard Deviation](https://en.wikipedia.org/wiki/Standard_deviation#Uncorrected_sample_standard_deviation) (stdevp)
+- [Sample Variance](https://en.wikipedia.org/wiki/Variance#Population_variance_and_sample_variance) (var)
+- [Population Variance](https://en.wikipedia.org/wiki/Variance#Population_variance_and_sample_variance) (varp)
+- [Median](https://en.wikipedia.org/wiki/Median) (median)
+- [Mean](https://en.wikipedia.org/wiki/Arithmetic_mean) (mean)
+- [Percentile](https://en.wikipedia.org/wiki/Quantile) (percentile)
+
+Check the Github Actions build to see the currently supported versions of Ruby. This list will match whatever stable versions are specified at https://www.ruby-lang.org/en/downloads/.
+
+It is generally more performant than calculating these values with pure Ruby. For a comparison, run the benchmarks with `rake benchmark`.
+
+Here's the data converted to a Markdown table:
+
+| Benchmark (Ruby 3.4.4)  | Run 1    | Run 2    | Run 3    | Run 4    | Run 5    |
+|--------------------------|----------|----------|----------|----------|----------|
+| bench_ruby_median        | 0.000676 | 0.000611 | 0.000619 | 0.000620 | 0.000583 |
+| bench_native_median      | 0.000179 | 0.000167 | 0.000127 | 0.000118 | 0.000188 |
+| bench_ruby_stdev         | 0.000780 | 0.000767 | 0.000730 | 0.000718 | 0.000733 |
+| bench_native_stdev       | 0.000046 | 0.000027 | 0.000034 | 0.000026 | 0.000043 |
+| bench_ruby_mean          | 0.000261 | 0.000240 | 0.000242 | 0.000250 | 0.000241 |
+| bench_native_mean        | 0.000033 | 0.000023 | 0.000022 | 0.000028 | 0.000022 |
+
+## Found a bug? Need a function?
+
+If you found a bug or need a particular function, please let me know! I work on this gem in my spare time, mainly for learning purposes. Feel free to open a PR or a Github issue and I'll take a look as soon as possible.
+
+## Usage
+
+    require 'ruby_native_statistics'
+    r = [1,3,21,32,42]
+
+    # calculate sample standard deviation, you can also use "stdevs"
+    p r.stdev
+
+    # calculate population standard deviation
+    p r.stdevp
+
+    # calculate sample variance
+    p r.var
+
+    # calculate population variance
+    p r.varp
+
+    # calculate mean
+    p r.mean
+
+    # calculate median
+    p r.median
+
+    # calculate percentile
+    p r.percentile(0.3333)
+
+## Implementation notes
+
+### Percentile
+
+Percentile uses the same rounding method as Excel, sometimes called R7.

data/Rakefile

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'minitest/test_task'
+Minitest::TestTask.create
+
+require 'rb_sys/extensiontask'
+GEMSPEC = Gem::Specification.load('ruby_native_statistics.gemspec')
+RbSys::ExtensionTask.new('ruby_native_statistics', GEMSPEC) do |ext|
+  ext.lib_dir = 'lib/ruby_native_statistics'
+end
+
+require 'rake/testtask'
+Rake::TestTask.new benchmark: [:clean, :clobber, 'compile:release'] do |t|
+  t.libs << 'test'
+  t.test_files = ['test/**/*_benchmark.rb']
+end
+
+task :default => ['compile:dev', :test]

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org>

data/changelog.md

@@ -0,0 +1,50 @@
+# Version 2.0.0
+
+- Replace the C-based implementation with a Rust-based implementation. The public API is mostly unchanged (see README.md) with the exception of the error messages.
+- Test and publish cross-platform Gems for Linux x86_64, Linux aarch64, and macOS arm64.
+
+# Version 1.1.1
+
+- Update all supported Ruby versions
+- Update all dependencies
+
+# Version 1.1.0
+
+- Fix percentile bug reported by @Gbird22
+
+# Version 1.0.3
+
+- Update all supported Ruby versions
+- Update all dependencies
+
+# Version 1.0.2
+
+- Better differentiate `gemspec` and `Gemfile` between runtime and development dependencies
+
+# Version 1.0.1
+
+- Update all supported Ruby versions
+- Update all dependencies
+
+# Version 1.0.0
+
+- Update all supported Ruby versions
+- Update all dependencies
+
+# Version 0.9.0
+
+- Add median function
+
+# Version 0.8.2
+
+- Bug fix for build process
+
+# Version 0.8.1
+
+- Internal and build-related changes only
+
+Yanked due to a bug introduced in the build.
+
+# Version 0.8
+
+- Added mean method

data/lib/ruby_native_statistics/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RubyNativeStatistics
+  VERSION = '2.0.0.rc.1'
+end

data/lib/ruby_native_statistics.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'ruby_native_statistics/version'
+require 'ruby_native_statistics/ruby_native_statistics'

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: ruby_native_statistics
+version: !ruby/object:Gem::Version
+  version: 2.0.0.rc.1
+platform: aarch64-linux
+authors:
+- Cory Buecker
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.21'
+description: A Ruby gem providing high-performance statistical functions implemented
+  in Rust for better performance than pure Ruby implementations.
+email:
+- cory.buecker@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- README.md
+- Rakefile
+- UNLICENSE
+- changelog.md
+- lib/ruby_native_statistics.rb
+- lib/ruby_native_statistics/ruby_native_statistics.so
+- lib/ruby_native_statistics/version.rb
+homepage: https://github.com/corybuecker/ruby-native-statistics
+licenses:
+- Unlicense
+metadata:
+  allowed_push_host: https://rubygems.org
+  changelog_uri: https://github.com/corybuecker/ruby-native-statistics/CHANGELOG.md
+  source_code_uri: https://github.com/corybuecker/ruby-native-statistics
+  bug_tracker_uri: https://github.com/corybuecker/ruby-native-statistics/issues
+  documentation_uri: https://github.com/corybuecker/ruby-native-statistics/blob/main/README.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.5.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: High performance, native (Rust) implementations of various statistical functions.
+test_files: []