Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id A2497200C5C for ; Thu, 20 Apr 2017 13:34:04 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id A0F16160BB7; Thu, 20 Apr 2017 11:34:04 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 53AC1160BCE for ; Thu, 20 Apr 2017 13:34:03 +0200 (CEST) Received: (qmail 66520 invoked by uid 500); 20 Apr 2017 11:34:02 -0000 Mailing-List: contact notifications-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@commons.apache.org Delivered-To: mailing list notifications@commons.apache.org Received: (qmail 65624 invoked by uid 99); 20 Apr 2017 11:34:01 -0000 Received: from Unknown (HELO svn01-us-west.apache.org) (209.188.14.144) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 20 Apr 2017 11:34:01 +0000 Received: from svn01-us-west.apache.org (localhost [127.0.0.1]) by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id BBFA33A520B for ; Thu, 20 Apr 2017 11:34:00 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1010778 [35/39] - in /websites/production/commons/content/proper/commons-rng: ./ commons-rng-client-api/ commons-rng-client-api/apidocs/ commons-rng-client-api/apidocs/org/apache/commons/rng/ commons-rng-client-api/apidocs/org/apache/commo... Date: Thu, 20 Apr 2017 11:33:54 -0000 To: notifications@commons.apache.org From: erans@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20170420113400.BBFA33A520B@svn01-us-west.apache.org> archived-at: Thu, 20 Apr 2017 11:34:04 -0000 Modified: websites/production/commons/content/proper/commons-rng/userguide/index.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/userguide/index.html (original) +++ websites/production/commons/content/proper/commons-rng/userguide/index.html Thu Apr 20 11:33:45 2017 @@ -1,13 +1,13 @@ - + RNG – The Commons RNG User Guide - Table of Contents @@ -40,8 +40,8 @@ Apache Commons RNG ™
    -
  • Last Published: 12 December 2016
    • -
  • |
  • Version: 1.0
    • +
  • Last Published: 09 April 2017
    • +
  • |
  • Version: 1.1-SNAPSHOT
  • @@ -268,7 +268,7 @@
-

Copyright © 2016 +

Copyright © 2016-2017 The Apache Software Foundation. All Rights Reserved.

Modified: websites/production/commons/content/proper/commons-rng/userguide/rng.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/userguide/rng.html (original) +++ websites/production/commons/content/proper/commons-rng/userguide/rng.html Thu Apr 20 11:33:45 2017 @@ -1,13 +1,13 @@ - + RNG – The Apache Commons RNG User Guide @@ -40,8 +40,8 @@ Apache Commons RNG ™
    -
  • Last Published: 12 December 2016
    • -
  • |
  • Version: 1.0
    • +
  • Last Published: 20 April 2017
    • +
  • |
  • Version: 1.1-SNAPSHOT
  • @@ -335,10 +335,11 @@ rngNew.restoreState(stateNew);Generation of random deviates for various distributions. 
    import org.apache.commons.rng.sampling.distribution.ContinuousSampler;
-import org.apache.commons.rng.sampling.distribution.BoxMullerGaussianSampler;
+import org.apache.commons.rng.sampling.distribution.GaussianSampler;
+import org.apache.commons.rng.sampling.distribution.MarsagliaNormalizedGaussianSampler;
 
-ContinuousSampler sampler = new BoxMullerGaussianSampler(RandomSource.create(RandomSource.MT_64),
-                                                         45.6, 2.3);
+ContinuousSampler sampler = new GaussianSampler(new MarsagliaNormalizedGaussianSampler(RandomSource.create(RandomSource.MT_64)),
+                                                45.6, 2.3);
 double random = sampler.sample();
    import org.apache.commons.rng.sampling.distribution.DiscreteSampler;
@@ -377,13 +378,13 @@ String word = sampler.sample().get(0);The API for instantiating generators is defined in package org.apache.commons.rng.simple.
    
 
      
 
    • Enum RandomSource determines which algorithm to use for generating the sequence of random values.
    
-
    The org.apache.commons.rng.simple.internal package contain classes for supporting initialization (a.k.a. "seeding") of the generators. They must not be used directly in applications, as all the necessary utilities are accessible through methods defined in RandomSource.
    
+
    The org.apache.commons.rng.simple.internal package contains classes for supporting initialization (a.k.a. "seeding") of the generators. They must not be used directly in applications, as all the necessary utilities are accessible through methods defined in RandomSource.
    
 
      
 
    • ProviderBuilder: contains methods for instantiating the concrete RNG implementations based on the source identifier; it also takes care of calling the appropriate classes for seed type conversion.
      • 
 
    • SeedFactory: contains factory methods for generating random seeds.
      • 
 
    • SeedConverter: interface for classes that transform between supported seed types.
      • 
 
    • Various classes that implement SeedConverter in order to transform from caller's seed to "native" seed.
    
-
    The org.apache.commons.rng.core. package contain the implementation of the algorithms for the generation of pseudo-random sequences. Applications should not directly import or use classes defined in this package: all generators can be instantiated through the RandomSource factory.
    
+
    The org.apache.commons.rng.core package contains the implementation of the algorithms for the generation of pseudo-random sequences. Applications should not directly import or use classes defined in this package: all generators can be instantiated through the RandomSource factory.
    
 
      
 
    • Class RandomProviderDefaultState implements the RandomProviderState interface to enable "save/restore" for all RestorableUniformRandomProvider instances created through the RandomSource factory methods.
      • 
 
    • BaseProvider: base class for all concrete RNG implementations; it contains higher-level algorithms nextInt(int n) and nextLong(long n) common to all implementations.
      • 
@@ -406,166 +407,266 @@ String word = sampler.sample().get(0);All runs were performed on a platform with the following characteristics:
      
 
        
 
      • CPU: Intel(R) Core(TM) i7-3770 CPU @ 3.40GHz
        • 
-
      • Java runtime: 1.7.0_95-b00
        • 
-
      • JVM: OpenJDK 64-Bit Server VM 24.95-b01
      
+
    • Java version: 1.8.0_121 (build 1.8.0_121-8u121-b13-3-b13)
      • 
+
    • JVM: OpenJDK 64-Bit Server VM (build 25.121-b13, mixed mode)
    
 
    The following tables indicate the performance (as measured by JMH) for generating
    
 
      
 
    • a sequence of 32-bits integers (a.k.a. Java type int)
      • 
 
    • a sequence of 64-bits integers (a.k.a. Java type long)
      • 
 
    • a sequence of 64-bits floating point numbers (a.k.a. Java type double)
    
-
    The first column is the RNG identifier (see RandomSource); the performance value is the ratio of the (JMH) score with respect to the score of RandomSource.JDK.
    
+
    The first column is the RNG identifier (see RandomSource).
    
 
    In these tables, lower is better.
    
 
      
 
    • Generating int values
 
-
+
-
+
-
+
-
+
-
+
-
-
-
-
-
-
-
+
+
+
+
-
+
+
+
+
-
+
-
+
-
-
-
+
+
+
+
+
+
+
+
+
-
+
      
 
      
 RNG identifierScore ratio
      Score (normalized to the score of RandomSource.JDK)
      
 
      
 MWC_2560.42168
      0.43405
      
 
      
 SPLIT_MIX_640.42845
      0.46945
      
 
      
 TWO_CMRES0.46360
      0.53129
      
 
      
 XOR_SHIFT_1024_S0.48818
      0.57792
      
 
      ISAAC0.56263
      
 KISS0.56340
      MT_640.62591
      0.61673
      
 
      ISAAC0.61966
      
 MT0.65198
      0.67974
      MT_640.68905
      
 
      
 WELL_512_A0.83364
      0.83342
      
 
      
 WELL_1024_A0.88204
      0.89916
      
 
      WELL_44497_A0.99618
      
 JDK
 1.00000
      WELL_19937_C1.10156
      WELL_19937_A1.10758
      WELL_44497_A1.18293
      
 
      
 WELL_44497_B1.00641
      1.23908
      • 
+
    • Generating long values
+
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
      
 
      WELL_19937_A1.09770
      RNG identifierScore (normalized to the score of RandomSource.JDK)
      
 
      SPLIT_MIX_640.20866
      TWO_CMRES0.24560
      XOR_SHIFT_1024_S0.26774
      MWC_2560.31939
      MT_640.32588
      KISS0.49883
      MT0.53191
      ISAAC0.54878
      WELL_1024_A0.64829
      WELL_512_A0.66269
      WELL_19937_A0.94553
      
 WELL_19937_C1.13420
      • 
-
    • Generating long values
+0.99949
+
+JDK
+1.00000
+
+WELL_44497_A
+1.03821
+
+WELL_44497_B
+1.09792
      • 
+
    • Generating double values
 
-
+
-
+
-
+
-
+
-
-
-
-
+
+
+
+
-
+
-
-
-
-
+
+
+
+
-
+
-
+
-
+
-
+
-
-
-
-
      
 
      
 RNG identifierScore ratio
      Score (normalized to the score of RandomSource.JDK)
      
 
      
 SPLIT_MIX_640.23505
      0.27214
      
 
      
 XOR_SHIFT_1024_S0.26918
      0.30975
      
 
      
 TWO_CMRES0.28069
      0.31785
      
 
      MT_640.34193
      
 MWC_2560.40359
      0.37810
      MT_640.38516
      
 
      
 KISS0.55043
      0.51777
      
 
      MT0.63092
      
 ISAAC0.63944
      0.62528
      MT0.63868
      
 
      
 WELL_512_A0.65085
      0.66895
      
 
      
 WELL_1024_A0.71561
      0.70950
      
 
      
 JDK
 1.00000
      
 
      
 WELL_19937_A1.03761
      1.06693
      
 
      
 WELL_44497_A1.06495
      1.15398
      
 
      WELL_44497_B1.14565
      
 WELL_19937_C1.23338
      • 
-
    • Generating double values
+1.15598
+
+WELL_44497_B
+1.19013
      • 
+
    • Sampling from a N(0,1) Gaussian distribution (MarsagliaNormalizedGaussianSampler implementation)
 
-
+
-
+
-
+
-
+
-
+
-
+
-
-
-
-
+
+
+
+
-
+
+
+
+
-
+
+
+
+
-
-
+
+
+
+
+
+
+
+
      
 
      
 RNG identifierScore ratio
      Score (normalized to the score of RandomSource.JDK)
      
 
      
 SPLIT_MIX_640.28609
      0.46750
      
 
      
 XOR_SHIFT_1024_S0.32866
      0.48672
      
 
      
 TWO_CMRES0.34069
      0.54703
      
 
      
 MWC_2560.39083
      0.55824
      
 
      
 MT_640.39368
      0.58233
      
 
      KISS0.60581
      
 ISAAC0.64429
      0.64820
      KISS0.66279
      
 
      
 MT0.67086
      0.68759
      
 
      WELL_512_A0.77854
      
 WELL_1024_A0.73629
      0.82204
      WELL_19937_A0.93504
      
 
      WELL_512_A0.78037
      WELL_19937_C0.98401
      
 
      WELL_44497_A0.99620
      
 JDK
 1.00000
      WELL_44497_B1.03380
      • 
+
    • Comparing MarsagliaNormalizedGaussianSampler with java.util.Random
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
+
+
-
+
-
-
+
+
-
      
 
      RNG identifierScore (normalized to the score of nextGaussian() method)
      SPLIT_MIX_640.30320
      XOR_SHIFT_1024_S0.31566
      TWO_CMRES0.35477
      MWC_2560.36204
      MT_640.37767
      ISAAC0.42038
      KISS0.42985
      MT0.44593
      WELL_512_A0.50492
      WELL_1024_A0.53313
      
 WELL_19937_A1.11497
      0.60641
      WELL_19937_C0.63817
      
 
      
 WELL_44497_A1.13362
      0.64607
      
 
      WELL_19937_C1.15334
      JDK0.64854
      
 
      
 WELL_44497_B1.22613
    +0.67046

5. Quality

This section reports results of performing "stress tests" that aim at detecting failures of an implementation to produce sequences of numbers that follow a uniform distribution.

@@ -649,7 +750,7 @@ String word = sampler.sample().get(0);
-

Copyright © 2016 +

Copyright © 2016-2017 The Apache Software Foundation. All Rights Reserved.

Modified: websites/production/commons/content/proper/commons-rng/userguide/why_not_java_random.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/userguide/why_not_java_random.html (original) +++ websites/production/commons/content/proper/commons-rng/userguide/why_not_java_random.html Thu Apr 20 11:33:45 2017 @@ -1,13 +1,13 @@ - + RNG – Why not java.util.Random ? @@ -40,8 +40,8 @@ Apache Commons RNG ™
    -
  • Last Published: 12 December 2016
    • -
  • |
  • Version: 1.0
    • +
  • Last Published: 09 April 2017
    • +
  • |
  • Version: 1.1-SNAPSHOT
  • @@ -232,7 +232,7 @@
-

Copyright © 2016 +

Copyright © 2016-2017 The Apache Software Foundation. All Rights Reserved.

Modified: websites/production/commons/content/proper/commons-rng/xref-test/index.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/xref-test/index.html (original) +++ websites/production/commons/content/proper/commons-rng/xref-test/index.html Thu Apr 20 11:33:45 2017 @@ -4,7 +4,7 @@ - Apache Commons RNG 1.0 Reference + Apache Commons RNG 1.1-SNAPSHOT Reference Modified: websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/CollectionSamplerTest.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/CollectionSamplerTest.html (original) +++ websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/CollectionSamplerTest.html Thu Apr 20 11:33:45 2017 @@ -64,6 +64,6 @@ 56 }
- + Modified: websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/ListSamplerTest.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/ListSamplerTest.html (original) +++ websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/ListSamplerTest.html Thu Apr 20 11:33:45 2017 @@ -179,6 +179,6 @@ 171 }
- + Modified: websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/PermutationSamplerTest.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/PermutationSamplerTest.html (original) +++ websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/PermutationSamplerTest.html Thu Apr 20 11:33:45 2017 @@ -219,6 +219,6 @@ 211 }
- + Modified: websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/distribution/ContinuousSamplerParametricTest.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/distribution/ContinuousSamplerParametricTest.html (original) +++ websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/distribution/ContinuousSamplerParametricTest.html Thu Apr 20 11:33:45 2017 @@ -140,6 +140,6 @@ 132 }
- + Modified: websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/distribution/ContinuousSamplerTestData.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/distribution/ContinuousSamplerTestData.html (original) +++ websites/production/commons/content/proper/commons-rng/xref-test/org/apache/commons/rng/sampling/distribution/ContinuousSamplerTestData.html Thu Apr 20 11:33:45 2017 @@ -54,6 +54,6 @@ 46 }
- +