normal_random 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 00ea628ca5c6f3c8a9d2e12a222c7470945f100f
+  data.tar.gz: 69e204f89522f23538b57db274fba538d9cdc488
+SHA512:
+  metadata.gz: e762e7e8e77750e279b48d69c3e9fb5db6fc058c5da7db830d814f3e9b121cfb05fd9af32c0b4db0b0eaae5755cfee1df2ff69546b109553091ef37f599d5c95
+  data.tar.gz: 96339633231f0c83beb452473783ea4109e9d8fe0964e6a5c21eef794b3ed2764cfdf69489b4b66499d0146d4929bfa74d25f2e70de91dce6b6d6afc22e2758f

data/.gitignore

@@ -0,0 +1,46 @@
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio
+
+*.iml
+
+## Directory-based project format:
+.idea/
+# if you remove the above rule, at least ignore the following:
+
+# User-specific stuff:
+# .idea/workspace.xml
+# .idea/tasks.xml
+# .idea/dictionaries
+
+# Sensitive or high-churn files:
+# .idea/dataSources.ids
+# .idea/dataSources.xml
+# .idea/sqlDataSources.xml
+# .idea/dynamic.xml
+# .idea/uiDesigner.xml
+
+# Gradle:
+# .idea/gradle.xml
+# .idea/libraries
+
+# Mongo Explorer plugin:
+# .idea/mongoSettings.xml
+
+## File-based project format:
+*.ipr
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,89 @@
+PATH
+  remote: .
+  specs:
+    normal_random (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (4.2.3)
+      actionview (= 4.2.3)
+      activesupport (= 4.2.3)
+      rack (~> 1.6)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (4.2.3)
+      activesupport (= 4.2.3)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    activesupport (4.2.3)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    builder (3.2.2)
+    diff-lcs (1.2.5)
+    erubis (2.7.0)
+    i18n (0.7.0)
+    json (1.8.3)
+    loofah (2.0.2)
+      nokogiri (>= 1.5.9)
+    mini_portile (0.6.2)
+    minitest (5.7.0)
+    minitest-rails (2.2.0)
+      minitest (~> 5.7)
+      railties (~> 4.1)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    rack (1.6.4)
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.6)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.2)
+      loofah (~> 2.0)
+    railties (4.2.3)
+      actionpack (= 4.2.3)
+      activesupport (= 4.2.3)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.4.2)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  minitest-rails (~> 2.2)
+  normal_random!
+  rake (~> 10.4)
+  rspec (~> 3.3)
+  yard
+
+BUNDLED WITH
+   1.10.1

data/Rakefile

@@ -0,0 +1,17 @@
+require 'bundler/gem_tasks'
+require 'rake'
+require 'rspec/core/rake_task'
+
+namespace :spec do
+
+  RSpec::Core::RakeTask.new(:normal) do |t|
+    t.pattern ='spec/**/*_spec.rb'
+    t.rcov = false
+  end
+
+end
+
+desc "RSpec tests"
+task "spec" => "spec:normal"
+
+task "default" => "spec"

data/Readme.md

@@ -0,0 +1,45 @@
+# Normal Random
+
+Normal Random is a ruby gem that generates random numbers along a
+normally distributed curve.
+
+## Usage
+
+The `RandomNumber` class works like the standard ruby `Random` class.
+
+```ruby
+  RandomNumber.new.rand #=> 114.67815448792281
+  
+  # or
+  
+  random_number_generator = RandomNumber.new
+  random_number_generator.rand #=> 109.96615852194628
+  random_number_generator.rand #=> 91.78189126576613
+```
+
+## Advanced Usage
+
+  By default `NormalRandom` has a **mu (mean) of 100** and a 
+  **sigma (standard deviation) of 15**. You can specify either 
+  of these by passing the appropriate variables to the `rand`
+  method.
+  
+```ruby
+  random_number_generator = RandomNumber.new
+  
+  random_number_generator.rand(mu: 0, sigma: 1) #=> 0.4813873347443289
+```
+
+# Contributors
+
+`normal_random` is solely Pete Michaud's (me@petermichaud.com) fault, so blame him for everything.
+
+# License
+
+(The MIT License)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/lib/normal_random.rb

@@ -0,0 +1,23 @@
+require 'normal_random/version'
+
+class NormalRandom
+
+  DEFAULT_MU = 100
+  DEFAULT_SIGMA = 15
+
+  attr_accessor :rng
+
+  def initialize
+    self.rng = Random.new
+  end
+
+  def rand(mu: DEFAULT_MU, sigma: DEFAULT_SIGMA)
+    (standard_deviations * sigma) + mu
+  end
+
+  def box_muller
+    Math.sqrt(-2*Math.log(rng.rand))*Math.cos(2*Math::PI*rng.rand)
+  end
+  alias_method :standard_deviations, :box_muller
+
+end

data/lib/normal_random/version.rb

@@ -0,0 +1,3 @@
+class NormalRandom
+  VERSION = '1.0.0'
+end

data/normal_random.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "normal_random/version"
+
+Gem::Specification.new do |s|
+  s.name        = "normal_random"
+  s.version     = NormalRandom::VERSION
+  s.authors     = ["Pete Michaud"]
+  s.email       = ["me@petermichaud.com"]
+  s.homepage    = "http://github.com/PeteMichaud/normal_random"
+  s.summary     = "Generates Normally Distributed, Random Numbers"
+  s.description = "Generates Normally Distributed, Random Numbers"
+  s.rubyforge_project = "normal_random"
+  s.files       = `git ls-files`.split("\n")
+  s.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.licenses    = ['MIT']
+  s.add_development_dependency 'rake', '~> 10.4'
+  s.add_development_dependency 'rspec', '~> 3.3'
+  s.add_development_dependency 'minitest-rails', '~> 2.2'
+  s.add_development_dependency 'minitest', '~> 5.7' if RUBY_PLATFORM == "java"
+end

data/spec/normal_random/rand_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe 'NormalRandom.rand' do
+
+  it "should work without arguments" do
+    NormalRandom.new.rand.should
+      be_within(NormalRandom::DEFAULT_SIGMA*6).
+          of(NormalRandom::DEFAULT_MU)
+  end
+
+  it "should work with mu" do
+    mu = 50
+    NormalRandom.new.rand(mu: mu).should
+    be_within(NormalRandom::DEFAULT_SIGMA*6).
+        of(mu)
+  end
+
+  it "should work with mu and sigma" do
+    mu = 0
+    sigma = 1
+    NormalRandom.new.rand(mu: mu, sigma: sigma).should
+    be_within(sigma*6).
+        of(mu)
+  end
+
+  it "should work with sigma" do
+    sigma = 1
+    NormalRandom.new.rand(sigma: sigma).should
+    be_within(sigma*6).
+        of(NormalRandom::DEFAULT_MU)
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'normal_random'

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: normal_random
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Pete Michaud
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: minitest-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+description: Generates Normally Distributed, Random Numbers
+email:
+- me@petermichaud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".idea/.name"
+- ".idea/.rakeTasks"
+- ".idea/misc.xml"
+- ".idea/modules.xml"
+- ".idea/normal_random.iml"
+- ".idea/vcs.xml"
+- ".idea/workspace.xml"
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- Readme.md
+- lib/normal_random.rb
+- lib/normal_random/version.rb
+- normal_random.gemspec
+- pkg/normal_random-1.0.0.gem
+- spec/normal_random/rand_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/PeteMichaud/normal_random
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: normal_random
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Generates Normally Distributed, Random Numbers
+test_files:
+- spec/normal_random/rand_spec.rb
+- spec/spec_helper.rb
+has_rdoc: