Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/org/apache/commons/rng/sampling/package-tree.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/org/apache/commons/rng/sampling/package-tree.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/org/apache/commons/rng/sampling/package-tree.html Thu Apr 20 11:33:45 2017 @@ -4,7 +4,7 @@ <head> <!-- Generated by javadoc --> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>org.apache.commons.rng.sampling Class Hierarchy (Apache Commons RNG Sampling 1.0 API)</title> +<title>org.apache.commons.rng.sampling Class Hierarchy (Apache Commons RNG Sampling 1.1-SNAPSHOT API)</title> <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../../../../script.js"></script> </head> @@ -12,7 +12,7 @@ <script type="text/javascript"><!-- try { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="org.apache.commons.rng.sampling Class Hierarchy (Apache Commons RNG Sampling 1.0 API)"; + parent.document.title="org.apache.commons.rng.sampling Class Hierarchy (Apache Commons RNG Sampling 1.1-SNAPSHOT API)"; } } catch(err) { @@ -137,6 +137,6 @@ <!-- --> </a></div> <!-- ======== END OF BOTTOM NAVBAR ======= --> -<p class="legalCopy"><small>Copyright © 2016 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> +<p class="legalCopy"><small>Copyright © 2016–2017 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> </body> </html>
Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/org/apache/commons/rng/sampling/package-use.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/org/apache/commons/rng/sampling/package-use.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/org/apache/commons/rng/sampling/package-use.html Thu Apr 20 11:33:45 2017 @@ -4,7 +4,7 @@ <head> <!-- Generated by javadoc --> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Uses of Package org.apache.commons.rng.sampling (Apache Commons RNG Sampling 1.0 API)</title> +<title>Uses of Package org.apache.commons.rng.sampling (Apache Commons RNG Sampling 1.1-SNAPSHOT API)</title> <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../../../../script.js"></script> </head> @@ -12,7 +12,7 @@ <script type="text/javascript"><!-- try { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="Uses of Package org.apache.commons.rng.sampling (Apache Commons RNG Sampling 1.0 API)"; + parent.document.title="Uses of Package org.apache.commons.rng.sampling (Apache Commons RNG Sampling 1.1-SNAPSHOT API)"; } } catch(err) { @@ -122,6 +122,6 @@ <!-- --> </a></div> <!-- ======== END OF BOTTOM NAVBAR ======= --> -<p class="legalCopy"><small>Copyright © 2016 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> +<p class="legalCopy"><small>Copyright © 2016–2017 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> </body> </html> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-frame.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-frame.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-frame.html Thu Apr 20 11:33:45 2017 @@ -4,7 +4,7 @@ <head> <!-- Generated by javadoc --> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Overview List (Apache Commons RNG Sampling 1.0 API)</title> +<title>Overview List (Apache Commons RNG Sampling 1.1-SNAPSHOT API)</title> <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style"> <script type="text/javascript" src="script.js"></script> </head> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-summary.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-summary.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-summary.html Thu Apr 20 11:33:45 2017 @@ -4,7 +4,7 @@ <head> <!-- Generated by javadoc --> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Overview (Apache Commons RNG Sampling 1.0 API)</title> +<title>Overview (Apache Commons RNG Sampling 1.1-SNAPSHOT API)</title> <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style"> <script type="text/javascript" src="script.js"></script> </head> @@ -12,7 +12,7 @@ <script type="text/javascript"><!-- try { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="Overview (Apache Commons RNG Sampling 1.0 API)"; + parent.document.title="Overview (Apache Commons RNG Sampling 1.1-SNAPSHOT API)"; } } catch(err) { @@ -71,7 +71,7 @@ </a></div> <!-- ========= END OF TOP NAVBAR ========= --> <div class="header"> -<h1 class="title">Apache Commons RNG Sampling 1.0 API</h1> +<h1 class="title">Apache Commons RNG Sampling 1.1-SNAPSHOT API</h1> </div> <div class="contentContainer"> <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Packages table, listing packages, and an explanation"> @@ -144,6 +144,6 @@ <!-- --> </a></div> <!-- ======== END OF BOTTOM NAVBAR ======= --> -<p class="legalCopy"><small>Copyright © 2016 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> +<p class="legalCopy"><small>Copyright © 2016–2017 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> </body> </html> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-tree.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-tree.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/overview-tree.html Thu Apr 20 11:33:45 2017 @@ -4,7 +4,7 @@ <head> <!-- Generated by javadoc --> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Class Hierarchy (Apache Commons RNG Sampling 1.0 API)</title> +<title>Class Hierarchy (Apache Commons RNG Sampling 1.1-SNAPSHOT API)</title> <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style"> <script type="text/javascript" src="script.js"></script> </head> @@ -12,7 +12,7 @@ <script type="text/javascript"><!-- try { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="Class Hierarchy (Apache Commons RNG Sampling 1.0 API)"; + parent.document.title="Class Hierarchy (Apache Commons RNG Sampling 1.1-SNAPSHOT API)"; } } catch(err) { @@ -84,6 +84,7 @@ <li type="circle">java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><span class="typeNameLink">Object</span></a> <ul> <li type="circle">org.apache.commons.rng.sampling.<a href="org/apache/commons/rng/sampling/CollectionSampler.html" title="class in org.apache.commons.rng.sampling"><span class="typeNameLink">CollectionSampler</span></a><T></li> +<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/GaussianSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">GaussianSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.<a href="org/apache/commons/rng/sampling/ListSampler.html" title="class in org.apache.commons.rng.sampling"><span class="typeNameLink">ListSampler</span></a></li> <li type="circle">org.apache.commons.rng.sampling.<a href="org/apache/commons/rng/sampling/PermutationSampler.html" title="class in org.apache.commons.rng.sampling"><span class="typeNameLink">PermutationSampler</span></a></li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/SamplerBase.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">SamplerBase</span></a> @@ -92,12 +93,15 @@ <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/AhrensDieterMarsagliaTsangGammaSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">AhrensDieterMarsagliaTsangGammaSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">BoxMullerGaussianSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">BoxMullerLogNormalSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> +<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">BoxMullerNormalizedGaussianSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">NormalizedGaussianSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ChengBetaSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">ChengBetaSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousUniformSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">ContinuousUniformSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteUniformSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">DiscreteUniformSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">DiscreteSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/InverseTransformContinuousSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">InverseTransformContinuousSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/InverseTransformDiscreteSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">InverseTransformDiscreteSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">DiscreteSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/InverseTransformParetoSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">InverseTransformParetoSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> +<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/MarsagliaLogNormalSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">MarsagliaLogNormalSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">ContinuousSampler</a>)</li> +<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">MarsagliaNormalizedGaussianSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">NormalizedGaussianSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/PoissonSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">PoissonSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">DiscreteSampler</a>)</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/RejectionInversionZipfSampler.html" title="class in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">RejectionInversionZipfSampler</span></a> (implements org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteSampler.html" title="interface in org.apache.commons.rng.sampling.distribution">DiscreteSampler</a>)</li> </ul> @@ -108,7 +112,11 @@ <h2 title="Interface Hierarchy">Interface Hierarchy</h2> <ul> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousInverseCumulativeProbabilityFunction.html" title="interface in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">ContinuousInverseCumulativeProbabilityFunction</span></a></li> -<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">ContinuousSampler</span></a></li> +<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/ContinuousSampler.html" title="interface in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">ContinuousSampler</span></a> +<ul> +<li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html" title="interface in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">NormalizedGaussianSampler</span></a></li> +</ul> +</li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteInverseCumulativeProbabilityFunction.html" title="interface in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">DiscreteInverseCumulativeProbabilityFunction</span></a></li> <li type="circle">org.apache.commons.rng.sampling.distribution.<a href="org/apache/commons/rng/sampling/distribution/DiscreteSampler.html" title="interface in org.apache.commons.rng.sampling.distribution"><span class="typeNameLink">DiscreteSampler</span></a></li> </ul> @@ -161,6 +169,6 @@ <!-- --> </a></div> <!-- ======== END OF BOTTOM NAVBAR ======= --> -<p class="legalCopy"><small>Copyright © 2016 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> +<p class="legalCopy"><small>Copyright © 2016–2017 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> </body> </html> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/CollectionSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/CollectionSampler.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/CollectionSampler.html Thu Apr 20 11:33:45 2017 @@ -50,11 +50,11 @@ <span class="sourceLineNo">042</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.42"></a> <span class="sourceLineNo">043</span> * @param collection Collection to be sampled.<a name="line.43"></a> <span class="sourceLineNo">044</span> * A (shallow) copy will be stored in the created instance.<a name="line.44"></a> -<span class="sourceLineNo">045</span> * @throws IllegalArgumentException if {@code collection.size() <= 0}.<a name="line.45"></a> +<span class="sourceLineNo">045</span> * @throws IllegalArgumentException if {@code collection} is empty.<a name="line.45"></a> <span class="sourceLineNo">046</span> */<a name="line.46"></a> <span class="sourceLineNo">047</span> public CollectionSampler(UniformRandomProvider rng,<a name="line.47"></a> <span class="sourceLineNo">048</span> Collection<T> collection) {<a name="line.48"></a> -<span class="sourceLineNo">049</span> if (collection.size() <= 0) {<a name="line.49"></a> +<span class="sourceLineNo">049</span> if (collection.isEmpty()) {<a name="line.49"></a> <span class="sourceLineNo">050</span> throw new IllegalArgumentException("Empty collection");<a name="line.50"></a> <span class="sourceLineNo">051</span> }<a name="line.51"></a> <span class="sourceLineNo">052</span><a name="line.52"></a> @@ -63,23 +63,16 @@ <span class="sourceLineNo">055</span> }<a name="line.55"></a> <span class="sourceLineNo">056</span><a name="line.56"></a> <span class="sourceLineNo">057</span> /**<a name="line.57"></a> -<span class="sourceLineNo">058</span> * Picks one of the items in the given {@code collection}.<a name="line.58"></a> -<span class="sourceLineNo">059</span> *<a name="line.59"></a> -<span class="sourceLineNo">060</span> * <p><a name="line.60"></a> -<span class="sourceLineNo">061</span> * Sampling is without replacement; but if the source collection<a name="line.61"></a> -<span class="sourceLineNo">062</span> * contains identical objects, the sample may include repeats.<a name="line.62"></a> -<span class="sourceLineNo">063</span> * </p><a name="line.63"></a> -<span class="sourceLineNo">064</span> * <p><a name="line.64"></a> -<span class="sourceLineNo">065</span> * There is no guarantee that the concrete type of the returned<a name="line.65"></a> -<span class="sourceLineNo">066</span> * collection is the same as the source collection.<a name="line.66"></a> -<span class="sourceLineNo">067</span> * </p><a name="line.67"></a> -<span class="sourceLineNo">068</span> *<a name="line.68"></a> -<span class="sourceLineNo">069</span> * @return a random sample.<a name="line.69"></a> -<span class="sourceLineNo">070</span> */<a name="line.70"></a> -<span class="sourceLineNo">071</span> public T sample() {<a name="line.71"></a> -<span class="sourceLineNo">072</span> return items.get(rng.nextInt(items.size()));<a name="line.72"></a> -<span class="sourceLineNo">073</span> }<a name="line.73"></a> -<span class="sourceLineNo">074</span>}<a name="line.74"></a> +<span class="sourceLineNo">058</span> * Picks one of the items from the<a name="line.58"></a> +<span class="sourceLineNo">059</span> * {@link #CollectionSampler(UniformRandomProvider,Collection)<a name="line.59"></a> +<span class="sourceLineNo">060</span> * collection passed to the constructor}.<a name="line.60"></a> +<span class="sourceLineNo">061</span> *<a name="line.61"></a> +<span class="sourceLineNo">062</span> * @return a random sample.<a name="line.62"></a> +<span class="sourceLineNo">063</span> */<a name="line.63"></a> +<span class="sourceLineNo">064</span> public T sample() {<a name="line.64"></a> +<span class="sourceLineNo">065</span> return items.get(rng.nextInt(items.size()));<a name="line.65"></a> +<span class="sourceLineNo">066</span> }<a name="line.66"></a> +<span class="sourceLineNo">067</span>}<a name="line.67"></a> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/AhrensDieterMarsagliaTsangGammaSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/AhrensDieterMarsagliaTsangGammaSampler.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/AhrensDieterMarsagliaTsangGammaSampler.html Thu Apr 20 11:33:45 2017 @@ -55,7 +55,7 @@ <span class="sourceLineNo">047</span> /** The alpha parameter. */<a name="line.47"></a> <span class="sourceLineNo">048</span> private final double alpha;<a name="line.48"></a> <span class="sourceLineNo">049</span> /** Gaussian sampling. */<a name="line.49"></a> -<span class="sourceLineNo">050</span> private final BoxMullerGaussianSampler gaussian;<a name="line.50"></a> +<span class="sourceLineNo">050</span> private final NormalizedGaussianSampler gaussian;<a name="line.50"></a> <span class="sourceLineNo">051</span><a name="line.51"></a> <span class="sourceLineNo">052</span> /**<a name="line.52"></a> <span class="sourceLineNo">053</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.53"></a> @@ -68,7 +68,7 @@ <span class="sourceLineNo">060</span> super(rng);<a name="line.60"></a> <span class="sourceLineNo">061</span> this.alpha = alpha;<a name="line.61"></a> <span class="sourceLineNo">062</span> this.theta = theta;<a name="line.62"></a> -<span class="sourceLineNo">063</span> gaussian = new BoxMullerGaussianSampler(rng, 0, 1);<a name="line.63"></a> +<span class="sourceLineNo">063</span> gaussian = new MarsagliaNormalizedGaussianSampler(rng);<a name="line.63"></a> <span class="sourceLineNo">064</span> }<a name="line.64"></a> <span class="sourceLineNo">065</span><a name="line.65"></a> <span class="sourceLineNo">066</span> /** {@inheritDoc} */<a name="line.66"></a> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.html Thu Apr 20 11:33:45 2017 @@ -29,65 +29,69 @@ <span class="sourceLineNo">021</span>/**<a name="line.21"></a> <span class="sourceLineNo">022</span> * <a href="https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform"><a name="line.22"></a> <span class="sourceLineNo">023</span> * Box-Muller algorithm</a> for sampling from a Gaussian distribution.<a name="line.23"></a> -<span class="sourceLineNo">024</span> */<a name="line.24"></a> -<span class="sourceLineNo">025</span>public class BoxMullerGaussianSampler<a name="line.25"></a> -<span class="sourceLineNo">026</span> extends SamplerBase<a name="line.26"></a> -<span class="sourceLineNo">027</span> implements ContinuousSampler {<a name="line.27"></a> -<span class="sourceLineNo">028</span> /** Next gaussian. */<a name="line.28"></a> -<span class="sourceLineNo">029</span> private double nextGaussian = Double.NaN;<a name="line.29"></a> -<span class="sourceLineNo">030</span> /** Mean. */<a name="line.30"></a> -<span class="sourceLineNo">031</span> private final double mean;<a name="line.31"></a> -<span class="sourceLineNo">032</span> /** standardDeviation. */<a name="line.32"></a> -<span class="sourceLineNo">033</span> private final double standardDeviation;<a name="line.33"></a> -<span class="sourceLineNo">034</span><a name="line.34"></a> -<span class="sourceLineNo">035</span> /**<a name="line.35"></a> -<span class="sourceLineNo">036</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.36"></a> -<span class="sourceLineNo">037</span> * @param mean Mean of the Gaussian distribution.<a name="line.37"></a> -<span class="sourceLineNo">038</span> * @param standardDeviation Standard deviation of the Gaussian distribution.<a name="line.38"></a> -<span class="sourceLineNo">039</span> */<a name="line.39"></a> -<span class="sourceLineNo">040</span> public BoxMullerGaussianSampler(UniformRandomProvider rng,<a name="line.40"></a> -<span class="sourceLineNo">041</span> double mean,<a name="line.41"></a> -<span class="sourceLineNo">042</span> double standardDeviation) {<a name="line.42"></a> -<span class="sourceLineNo">043</span> super(rng);<a name="line.43"></a> -<span class="sourceLineNo">044</span> this.mean = mean;<a name="line.44"></a> -<span class="sourceLineNo">045</span> this.standardDeviation = standardDeviation;<a name="line.45"></a> -<span class="sourceLineNo">046</span> }<a name="line.46"></a> -<span class="sourceLineNo">047</span><a name="line.47"></a> -<span class="sourceLineNo">048</span> /** {@inheritDoc} */<a name="line.48"></a> -<span class="sourceLineNo">049</span> @Override<a name="line.49"></a> -<span class="sourceLineNo">050</span> public double sample() {<a name="line.50"></a> -<span class="sourceLineNo">051</span> final double random;<a name="line.51"></a> -<span class="sourceLineNo">052</span> if (Double.isNaN(nextGaussian)) {<a name="line.52"></a> -<span class="sourceLineNo">053</span> // Generate a pair of Gaussian numbers.<a name="line.53"></a> -<span class="sourceLineNo">054</span><a name="line.54"></a> -<span class="sourceLineNo">055</span> final double x = nextDouble();<a name="line.55"></a> -<span class="sourceLineNo">056</span> final double y = nextDouble();<a name="line.56"></a> -<span class="sourceLineNo">057</span> final double alpha = 2 * Math.PI * x;<a name="line.57"></a> -<span class="sourceLineNo">058</span> final double r = Math.sqrt(-2 * Math.log(y));<a name="line.58"></a> -<span class="sourceLineNo">059</span><a name="line.59"></a> -<span class="sourceLineNo">060</span> // Return the first element of the generated pair.<a name="line.60"></a> -<span class="sourceLineNo">061</span> random = r * Math.cos(alpha);<a name="line.61"></a> -<span class="sourceLineNo">062</span><a name="line.62"></a> -<span class="sourceLineNo">063</span> // Keep second element of the pair for next invocation.<a name="line.63"></a> -<span class="sourceLineNo">064</span> nextGaussian = r * Math.sin(alpha);<a name="line.64"></a> -<span class="sourceLineNo">065</span> } else {<a name="line.65"></a> -<span class="sourceLineNo">066</span> // Use the second element of the pair (generated at the<a name="line.66"></a> -<span class="sourceLineNo">067</span> // previous invocation).<a name="line.67"></a> -<span class="sourceLineNo">068</span> random = nextGaussian;<a name="line.68"></a> -<span class="sourceLineNo">069</span><a name="line.69"></a> -<span class="sourceLineNo">070</span> // Both elements of the pair have been used.<a name="line.70"></a> -<span class="sourceLineNo">071</span> nextGaussian = Double.NaN;<a name="line.71"></a> -<span class="sourceLineNo">072</span> }<a name="line.72"></a> +<span class="sourceLineNo">024</span> *<a name="line.24"></a> +<span class="sourceLineNo">025</span> * @deprecated since v1.1. Please use {@link BoxMullerNormalizedGaussianSampler}<a name="line.25"></a> +<span class="sourceLineNo">026</span> * and {@link GaussianSampler} instead.<a name="line.26"></a> +<span class="sourceLineNo">027</span> */<a name="line.27"></a> +<span class="sourceLineNo">028</span>@Deprecated<a name="line.28"></a> +<span class="sourceLineNo">029</span>public class BoxMullerGaussianSampler<a name="line.29"></a> +<span class="sourceLineNo">030</span> extends SamplerBase<a name="line.30"></a> +<span class="sourceLineNo">031</span> implements ContinuousSampler {<a name="line.31"></a> +<span class="sourceLineNo">032</span> /** Next gaussian. */<a name="line.32"></a> +<span class="sourceLineNo">033</span> private double nextGaussian = Double.NaN;<a name="line.33"></a> +<span class="sourceLineNo">034</span> /** Mean. */<a name="line.34"></a> +<span class="sourceLineNo">035</span> private final double mean;<a name="line.35"></a> +<span class="sourceLineNo">036</span> /** standardDeviation. */<a name="line.36"></a> +<span class="sourceLineNo">037</span> private final double standardDeviation;<a name="line.37"></a> +<span class="sourceLineNo">038</span><a name="line.38"></a> +<span class="sourceLineNo">039</span> /**<a name="line.39"></a> +<span class="sourceLineNo">040</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.40"></a> +<span class="sourceLineNo">041</span> * @param mean Mean of the Gaussian distribution.<a name="line.41"></a> +<span class="sourceLineNo">042</span> * @param standardDeviation Standard deviation of the Gaussian distribution.<a name="line.42"></a> +<span class="sourceLineNo">043</span> */<a name="line.43"></a> +<span class="sourceLineNo">044</span> public BoxMullerGaussianSampler(UniformRandomProvider rng,<a name="line.44"></a> +<span class="sourceLineNo">045</span> double mean,<a name="line.45"></a> +<span class="sourceLineNo">046</span> double standardDeviation) {<a name="line.46"></a> +<span class="sourceLineNo">047</span> super(rng);<a name="line.47"></a> +<span class="sourceLineNo">048</span> this.mean = mean;<a name="line.48"></a> +<span class="sourceLineNo">049</span> this.standardDeviation = standardDeviation;<a name="line.49"></a> +<span class="sourceLineNo">050</span> }<a name="line.50"></a> +<span class="sourceLineNo">051</span><a name="line.51"></a> +<span class="sourceLineNo">052</span> /** {@inheritDoc} */<a name="line.52"></a> +<span class="sourceLineNo">053</span> @Override<a name="line.53"></a> +<span class="sourceLineNo">054</span> public double sample() {<a name="line.54"></a> +<span class="sourceLineNo">055</span> final double random;<a name="line.55"></a> +<span class="sourceLineNo">056</span> if (Double.isNaN(nextGaussian)) {<a name="line.56"></a> +<span class="sourceLineNo">057</span> // Generate a pair of Gaussian numbers.<a name="line.57"></a> +<span class="sourceLineNo">058</span><a name="line.58"></a> +<span class="sourceLineNo">059</span> final double x = nextDouble();<a name="line.59"></a> +<span class="sourceLineNo">060</span> final double y = nextDouble();<a name="line.60"></a> +<span class="sourceLineNo">061</span> final double alpha = 2 * Math.PI * x;<a name="line.61"></a> +<span class="sourceLineNo">062</span> final double r = Math.sqrt(-2 * Math.log(y));<a name="line.62"></a> +<span class="sourceLineNo">063</span><a name="line.63"></a> +<span class="sourceLineNo">064</span> // Return the first element of the generated pair.<a name="line.64"></a> +<span class="sourceLineNo">065</span> random = r * Math.cos(alpha);<a name="line.65"></a> +<span class="sourceLineNo">066</span><a name="line.66"></a> +<span class="sourceLineNo">067</span> // Keep second element of the pair for next invocation.<a name="line.67"></a> +<span class="sourceLineNo">068</span> nextGaussian = r * Math.sin(alpha);<a name="line.68"></a> +<span class="sourceLineNo">069</span> } else {<a name="line.69"></a> +<span class="sourceLineNo">070</span> // Use the second element of the pair (generated at the<a name="line.70"></a> +<span class="sourceLineNo">071</span> // previous invocation).<a name="line.71"></a> +<span class="sourceLineNo">072</span> random = nextGaussian;<a name="line.72"></a> <span class="sourceLineNo">073</span><a name="line.73"></a> -<span class="sourceLineNo">074</span> return standardDeviation * random + mean;<a name="line.74"></a> -<span class="sourceLineNo">075</span> }<a name="line.75"></a> -<span class="sourceLineNo">076</span><a name="line.76"></a> -<span class="sourceLineNo">077</span> /** {@inheritDoc} */<a name="line.77"></a> -<span class="sourceLineNo">078</span> @Override<a name="line.78"></a> -<span class="sourceLineNo">079</span> public String toString() {<a name="line.79"></a> -<span class="sourceLineNo">080</span> return "Box-Muller Gaussian deviate [" + super.toString() + "]";<a name="line.80"></a> -<span class="sourceLineNo">081</span> }<a name="line.81"></a> -<span class="sourceLineNo">082</span>}<a name="line.82"></a> +<span class="sourceLineNo">074</span> // Both elements of the pair have been used.<a name="line.74"></a> +<span class="sourceLineNo">075</span> nextGaussian = Double.NaN;<a name="line.75"></a> +<span class="sourceLineNo">076</span> }<a name="line.76"></a> +<span class="sourceLineNo">077</span><a name="line.77"></a> +<span class="sourceLineNo">078</span> return standardDeviation * random + mean;<a name="line.78"></a> +<span class="sourceLineNo">079</span> }<a name="line.79"></a> +<span class="sourceLineNo">080</span><a name="line.80"></a> +<span class="sourceLineNo">081</span> /** {@inheritDoc} */<a name="line.81"></a> +<span class="sourceLineNo">082</span> @Override<a name="line.82"></a> +<span class="sourceLineNo">083</span> public String toString() {<a name="line.83"></a> +<span class="sourceLineNo">084</span> return "Box-Muller Gaussian deviate [" + super.toString() + "]";<a name="line.84"></a> +<span class="sourceLineNo">085</span> }<a name="line.85"></a> +<span class="sourceLineNo">086</span>}<a name="line.86"></a> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.html Thu Apr 20 11:33:45 2017 @@ -38,7 +38,7 @@ <span class="sourceLineNo">030</span> /** Shape. */<a name="line.30"></a> <span class="sourceLineNo">031</span> private final double shape;<a name="line.31"></a> <span class="sourceLineNo">032</span> /** Gaussian sampling. */<a name="line.32"></a> -<span class="sourceLineNo">033</span> private final BoxMullerGaussianSampler gaussian;<a name="line.33"></a> +<span class="sourceLineNo">033</span> private final NormalizedGaussianSampler gaussian;<a name="line.33"></a> <span class="sourceLineNo">034</span><a name="line.34"></a> <span class="sourceLineNo">035</span> /**<a name="line.35"></a> <span class="sourceLineNo">036</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.36"></a> @@ -51,7 +51,7 @@ <span class="sourceLineNo">043</span> super(null); // Not used.<a name="line.43"></a> <span class="sourceLineNo">044</span> this.scale = scale;<a name="line.44"></a> <span class="sourceLineNo">045</span> this.shape = shape;<a name="line.45"></a> -<span class="sourceLineNo">046</span> gaussian = new BoxMullerGaussianSampler(rng, 0, 1);<a name="line.46"></a> +<span class="sourceLineNo">046</span> gaussian = new BoxMullerNormalizedGaussianSampler(rng);<a name="line.46"></a> <span class="sourceLineNo">047</span> }<a name="line.47"></a> <span class="sourceLineNo">048</span><a name="line.48"></a> <span class="sourceLineNo">049</span> /** {@inheritDoc} */<a name="line.49"></a> Added: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.html (added) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.html Thu Apr 20 11:33:45 2017 @@ -0,0 +1,147 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html lang="en"> +<head> +<title>Source code</title> +<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<div class="sourceContainer"> +<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a> +<span class="sourceLineNo">002</span> * Licensed to the Apache Software Foundation (ASF) under one or more<a name="line.2"></a> +<span class="sourceLineNo">003</span> * contributor license agreements. See the NOTICE file distributed with<a name="line.3"></a> +<span class="sourceLineNo">004</span> * this work for additional information regarding copyright ownership.<a name="line.4"></a> +<span class="sourceLineNo">005</span> * The ASF licenses this file to You under the Apache License, Version 2.0<a name="line.5"></a> +<span class="sourceLineNo">006</span> * (the "License"); you may not use this file except in compliance with<a name="line.6"></a> +<span class="sourceLineNo">007</span> * the License. You may obtain a copy of the License at<a name="line.7"></a> +<span class="sourceLineNo">008</span> *<a name="line.8"></a> +<span class="sourceLineNo">009</span> * http://www.apache.org/licenses/LICENSE-2.0<a name="line.9"></a> +<span class="sourceLineNo">010</span> *<a name="line.10"></a> +<span class="sourceLineNo">011</span> * Unless required by applicable law or agreed to in writing, software<a name="line.11"></a> +<span class="sourceLineNo">012</span> * distributed under the License is distributed on an "AS IS" BASIS,<a name="line.12"></a> +<span class="sourceLineNo">013</span> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<a name="line.13"></a> +<span class="sourceLineNo">014</span> * See the License for the specific language governing permissions and<a name="line.14"></a> +<span class="sourceLineNo">015</span> * limitations under the License.<a name="line.15"></a> +<span class="sourceLineNo">016</span> */<a name="line.16"></a> +<span class="sourceLineNo">017</span>package org.apache.commons.rng.sampling.distribution;<a name="line.17"></a> +<span class="sourceLineNo">018</span><a name="line.18"></a> +<span class="sourceLineNo">019</span>import org.apache.commons.rng.UniformRandomProvider;<a name="line.19"></a> +<span class="sourceLineNo">020</span><a name="line.20"></a> +<span class="sourceLineNo">021</span>/**<a name="line.21"></a> +<span class="sourceLineNo">022</span> * <a href="https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform"><a name="line.22"></a> +<span class="sourceLineNo">023</span> * Box-Muller algorithm</a> for sampling from Gaussian distribution with<a name="line.23"></a> +<span class="sourceLineNo">024</span> * mean 0 and standard deviation 1.<a name="line.24"></a> +<span class="sourceLineNo">025</span> *<a name="line.25"></a> +<span class="sourceLineNo">026</span> * @since 1.1<a name="line.26"></a> +<span class="sourceLineNo">027</span> */<a name="line.27"></a> +<span class="sourceLineNo">028</span>public class BoxMullerNormalizedGaussianSampler<a name="line.28"></a> +<span class="sourceLineNo">029</span> extends SamplerBase<a name="line.29"></a> +<span class="sourceLineNo">030</span> implements NormalizedGaussianSampler {<a name="line.30"></a> +<span class="sourceLineNo">031</span> /** Next gaussian. */<a name="line.31"></a> +<span class="sourceLineNo">032</span> private double nextGaussian = Double.NaN;<a name="line.32"></a> +<span class="sourceLineNo">033</span><a name="line.33"></a> +<span class="sourceLineNo">034</span> /**<a name="line.34"></a> +<span class="sourceLineNo">035</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.35"></a> +<span class="sourceLineNo">036</span> */<a name="line.36"></a> +<span class="sourceLineNo">037</span> public BoxMullerNormalizedGaussianSampler(UniformRandomProvider rng) {<a name="line.37"></a> +<span class="sourceLineNo">038</span> super(rng);<a name="line.38"></a> +<span class="sourceLineNo">039</span> }<a name="line.39"></a> +<span class="sourceLineNo">040</span><a name="line.40"></a> +<span class="sourceLineNo">041</span> /** {@inheritDoc} */<a name="line.41"></a> +<span class="sourceLineNo">042</span> @Override<a name="line.42"></a> +<span class="sourceLineNo">043</span> public double sample() {<a name="line.43"></a> +<span class="sourceLineNo">044</span> final double random;<a name="line.44"></a> +<span class="sourceLineNo">045</span> if (Double.isNaN(nextGaussian)) {<a name="line.45"></a> +<span class="sourceLineNo">046</span> // Generate a pair of Gaussian numbers.<a name="line.46"></a> +<span class="sourceLineNo">047</span><a name="line.47"></a> +<span class="sourceLineNo">048</span> final double x = nextDouble();<a name="line.48"></a> +<span class="sourceLineNo">049</span> final double y = nextDouble();<a name="line.49"></a> +<span class="sourceLineNo">050</span> final double alpha = 2 * Math.PI * x;<a name="line.50"></a> +<span class="sourceLineNo">051</span> final double r = Math.sqrt(-2 * Math.log(y));<a name="line.51"></a> +<span class="sourceLineNo">052</span><a name="line.52"></a> +<span class="sourceLineNo">053</span> // Return the first element of the generated pair.<a name="line.53"></a> +<span class="sourceLineNo">054</span> random = r * Math.cos(alpha);<a name="line.54"></a> +<span class="sourceLineNo">055</span><a name="line.55"></a> +<span class="sourceLineNo">056</span> // Keep second element of the pair for next invocation.<a name="line.56"></a> +<span class="sourceLineNo">057</span> nextGaussian = r * Math.sin(alpha);<a name="line.57"></a> +<span class="sourceLineNo">058</span> } else {<a name="line.58"></a> +<span class="sourceLineNo">059</span> // Use the second element of the pair (generated at the<a name="line.59"></a> +<span class="sourceLineNo">060</span> // previous invocation).<a name="line.60"></a> +<span class="sourceLineNo">061</span> random = nextGaussian;<a name="line.61"></a> +<span class="sourceLineNo">062</span><a name="line.62"></a> +<span class="sourceLineNo">063</span> // Both elements of the pair have been used.<a name="line.63"></a> +<span class="sourceLineNo">064</span> nextGaussian = Double.NaN;<a name="line.64"></a> +<span class="sourceLineNo">065</span> }<a name="line.65"></a> +<span class="sourceLineNo">066</span><a name="line.66"></a> +<span class="sourceLineNo">067</span> return random;<a name="line.67"></a> +<span class="sourceLineNo">068</span> }<a name="line.68"></a> +<span class="sourceLineNo">069</span><a name="line.69"></a> +<span class="sourceLineNo">070</span> /** {@inheritDoc} */<a name="line.70"></a> +<span class="sourceLineNo">071</span> @Override<a name="line.71"></a> +<span class="sourceLineNo">072</span> public String toString() {<a name="line.72"></a> +<span class="sourceLineNo">073</span> return "Box-Muller normalized Gaussian deviate [" + super.toString() + "]";<a name="line.73"></a> +<span class="sourceLineNo">074</span> }<a name="line.74"></a> +<span class="sourceLineNo">075</span>}<a name="line.75"></a> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +</pre> +</div> +</body> +</html> Propchange: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.html ------------------------------------------------------------------------------ svn:eol-style = native Added: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/GaussianSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/GaussianSampler.html (added) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/GaussianSampler.html Thu Apr 20 11:33:45 2017 @@ -0,0 +1,129 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html lang="en"> +<head> +<title>Source code</title> +<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<div class="sourceContainer"> +<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a> +<span class="sourceLineNo">002</span> * Licensed to the Apache Software Foundation (ASF) under one or more<a name="line.2"></a> +<span class="sourceLineNo">003</span> * contributor license agreements. See the NOTICE file distributed with<a name="line.3"></a> +<span class="sourceLineNo">004</span> * this work for additional information regarding copyright ownership.<a name="line.4"></a> +<span class="sourceLineNo">005</span> * The ASF licenses this file to You under the Apache License, Version 2.0<a name="line.5"></a> +<span class="sourceLineNo">006</span> * (the "License"); you may not use this file except in compliance with<a name="line.6"></a> +<span class="sourceLineNo">007</span> * the License. You may obtain a copy of the License at<a name="line.7"></a> +<span class="sourceLineNo">008</span> *<a name="line.8"></a> +<span class="sourceLineNo">009</span> * http://www.apache.org/licenses/LICENSE-2.0<a name="line.9"></a> +<span class="sourceLineNo">010</span> *<a name="line.10"></a> +<span class="sourceLineNo">011</span> * Unless required by applicable law or agreed to in writing, software<a name="line.11"></a> +<span class="sourceLineNo">012</span> * distributed under the License is distributed on an "AS IS" BASIS,<a name="line.12"></a> +<span class="sourceLineNo">013</span> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<a name="line.13"></a> +<span class="sourceLineNo">014</span> * See the License for the specific language governing permissions and<a name="line.14"></a> +<span class="sourceLineNo">015</span> * limitations under the License.<a name="line.15"></a> +<span class="sourceLineNo">016</span> */<a name="line.16"></a> +<span class="sourceLineNo">017</span>package org.apache.commons.rng.sampling.distribution;<a name="line.17"></a> +<span class="sourceLineNo">018</span><a name="line.18"></a> +<span class="sourceLineNo">019</span>/**<a name="line.19"></a> +<span class="sourceLineNo">020</span> * Sampling from a Gaussian distribution with given mean and<a name="line.20"></a> +<span class="sourceLineNo">021</span> * standard deviation.<a name="line.21"></a> +<span class="sourceLineNo">022</span> *<a name="line.22"></a> +<span class="sourceLineNo">023</span> * @since 1.1<a name="line.23"></a> +<span class="sourceLineNo">024</span> */<a name="line.24"></a> +<span class="sourceLineNo">025</span>public class GaussianSampler implements ContinuousSampler {<a name="line.25"></a> +<span class="sourceLineNo">026</span> /** Mean. */<a name="line.26"></a> +<span class="sourceLineNo">027</span> private final double mean;<a name="line.27"></a> +<span class="sourceLineNo">028</span> /** standardDeviation. */<a name="line.28"></a> +<span class="sourceLineNo">029</span> private final double standardDeviation;<a name="line.29"></a> +<span class="sourceLineNo">030</span> /** Normalized Gaussian sampler. */<a name="line.30"></a> +<span class="sourceLineNo">031</span> private final NormalizedGaussianSampler normalized;<a name="line.31"></a> +<span class="sourceLineNo">032</span><a name="line.32"></a> +<span class="sourceLineNo">033</span> /**<a name="line.33"></a> +<span class="sourceLineNo">034</span> * @param normalized Generator of N(0,1) Gaussian distributed random numbers.<a name="line.34"></a> +<span class="sourceLineNo">035</span> * @param mean Mean of the Gaussian distribution.<a name="line.35"></a> +<span class="sourceLineNo">036</span> * @param standardDeviation Standard deviation of the Gaussian distribution.<a name="line.36"></a> +<span class="sourceLineNo">037</span> */<a name="line.37"></a> +<span class="sourceLineNo">038</span> public GaussianSampler(NormalizedGaussianSampler normalized,<a name="line.38"></a> +<span class="sourceLineNo">039</span> double mean,<a name="line.39"></a> +<span class="sourceLineNo">040</span> double standardDeviation) {<a name="line.40"></a> +<span class="sourceLineNo">041</span> this.normalized = normalized;<a name="line.41"></a> +<span class="sourceLineNo">042</span> this.mean = mean;<a name="line.42"></a> +<span class="sourceLineNo">043</span> this.standardDeviation = standardDeviation;<a name="line.43"></a> +<span class="sourceLineNo">044</span> }<a name="line.44"></a> +<span class="sourceLineNo">045</span><a name="line.45"></a> +<span class="sourceLineNo">046</span> /** {@inheritDoc} */<a name="line.46"></a> +<span class="sourceLineNo">047</span> @Override<a name="line.47"></a> +<span class="sourceLineNo">048</span> public double sample() {<a name="line.48"></a> +<span class="sourceLineNo">049</span> return standardDeviation * normalized.sample() + mean;<a name="line.49"></a> +<span class="sourceLineNo">050</span> }<a name="line.50"></a> +<span class="sourceLineNo">051</span><a name="line.51"></a> +<span class="sourceLineNo">052</span> /** {@inheritDoc} */<a name="line.52"></a> +<span class="sourceLineNo">053</span> @Override<a name="line.53"></a> +<span class="sourceLineNo">054</span> public String toString() {<a name="line.54"></a> +<span class="sourceLineNo">055</span> return "Gaussian deviate [" + normalized.toString() + "]";<a name="line.55"></a> +<span class="sourceLineNo">056</span> }<a name="line.56"></a> +<span class="sourceLineNo">057</span>}<a name="line.57"></a> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +</pre> +</div> +</body> +</html> Propchange: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/GaussianSampler.html ------------------------------------------------------------------------------ svn:eol-style = native Added: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaLogNormalSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaLogNormalSampler.html (added) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaLogNormalSampler.html Thu Apr 20 11:33:45 2017 @@ -0,0 +1,134 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html lang="en"> +<head> +<title>Source code</title> +<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<div class="sourceContainer"> +<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a> +<span class="sourceLineNo">002</span> * Licensed to the Apache Software Foundation (ASF) under one or more<a name="line.2"></a> +<span class="sourceLineNo">003</span> * contributor license agreements. See the NOTICE file distributed with<a name="line.3"></a> +<span class="sourceLineNo">004</span> * this work for additional information regarding copyright ownership.<a name="line.4"></a> +<span class="sourceLineNo">005</span> * The ASF licenses this file to You under the Apache License, Version 2.0<a name="line.5"></a> +<span class="sourceLineNo">006</span> * (the "License"); you may not use this file except in compliance with<a name="line.6"></a> +<span class="sourceLineNo">007</span> * the License. You may obtain a copy of the License at<a name="line.7"></a> +<span class="sourceLineNo">008</span> *<a name="line.8"></a> +<span class="sourceLineNo">009</span> * http://www.apache.org/licenses/LICENSE-2.0<a name="line.9"></a> +<span class="sourceLineNo">010</span> *<a name="line.10"></a> +<span class="sourceLineNo">011</span> * Unless required by applicable law or agreed to in writing, software<a name="line.11"></a> +<span class="sourceLineNo">012</span> * distributed under the License is distributed on an "AS IS" BASIS,<a name="line.12"></a> +<span class="sourceLineNo">013</span> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<a name="line.13"></a> +<span class="sourceLineNo">014</span> * See the License for the specific language governing permissions and<a name="line.14"></a> +<span class="sourceLineNo">015</span> * limitations under the License.<a name="line.15"></a> +<span class="sourceLineNo">016</span> */<a name="line.16"></a> +<span class="sourceLineNo">017</span>package org.apache.commons.rng.sampling.distribution;<a name="line.17"></a> +<span class="sourceLineNo">018</span><a name="line.18"></a> +<span class="sourceLineNo">019</span>import org.apache.commons.rng.UniformRandomProvider;<a name="line.19"></a> +<span class="sourceLineNo">020</span><a name="line.20"></a> +<span class="sourceLineNo">021</span>/**<a name="line.21"></a> +<span class="sourceLineNo">022</span> * <a href="https://en.wikipedia.org/wiki/Marsaglia_polar_method"><a name="line.22"></a> +<span class="sourceLineNo">023</span> * polar method</a> for sampling from a Log normal distribution.<a name="line.23"></a> +<span class="sourceLineNo">024</span> *<a name="line.24"></a> +<span class="sourceLineNo">025</span> * @since 1.1<a name="line.25"></a> +<span class="sourceLineNo">026</span> */<a name="line.26"></a> +<span class="sourceLineNo">027</span>public class MarsagliaLogNormalSampler<a name="line.27"></a> +<span class="sourceLineNo">028</span> extends SamplerBase<a name="line.28"></a> +<span class="sourceLineNo">029</span> implements ContinuousSampler {<a name="line.29"></a> +<span class="sourceLineNo">030</span> /** Scale. */<a name="line.30"></a> +<span class="sourceLineNo">031</span> private final double scale;<a name="line.31"></a> +<span class="sourceLineNo">032</span> /** Shape. */<a name="line.32"></a> +<span class="sourceLineNo">033</span> private final double shape;<a name="line.33"></a> +<span class="sourceLineNo">034</span> /** Gaussian sampling. */<a name="line.34"></a> +<span class="sourceLineNo">035</span> private final NormalizedGaussianSampler gaussian;<a name="line.35"></a> +<span class="sourceLineNo">036</span><a name="line.36"></a> +<span class="sourceLineNo">037</span> /**<a name="line.37"></a> +<span class="sourceLineNo">038</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.38"></a> +<span class="sourceLineNo">039</span> * @param scale Scale of the Log normal distribution.<a name="line.39"></a> +<span class="sourceLineNo">040</span> * @param shape Shape of the Log normal distribution.<a name="line.40"></a> +<span class="sourceLineNo">041</span> */<a name="line.41"></a> +<span class="sourceLineNo">042</span> public MarsagliaLogNormalSampler(UniformRandomProvider rng,<a name="line.42"></a> +<span class="sourceLineNo">043</span> double scale,<a name="line.43"></a> +<span class="sourceLineNo">044</span> double shape) {<a name="line.44"></a> +<span class="sourceLineNo">045</span> super(null); // Not used.<a name="line.45"></a> +<span class="sourceLineNo">046</span> this.scale = scale;<a name="line.46"></a> +<span class="sourceLineNo">047</span> this.shape = shape;<a name="line.47"></a> +<span class="sourceLineNo">048</span> gaussian = new MarsagliaNormalizedGaussianSampler(rng);<a name="line.48"></a> +<span class="sourceLineNo">049</span> }<a name="line.49"></a> +<span class="sourceLineNo">050</span><a name="line.50"></a> +<span class="sourceLineNo">051</span> /** {@inheritDoc} */<a name="line.51"></a> +<span class="sourceLineNo">052</span> @Override<a name="line.52"></a> +<span class="sourceLineNo">053</span> public double sample() {<a name="line.53"></a> +<span class="sourceLineNo">054</span> return Math.exp(scale + shape * gaussian.sample());<a name="line.54"></a> +<span class="sourceLineNo">055</span> }<a name="line.55"></a> +<span class="sourceLineNo">056</span><a name="line.56"></a> +<span class="sourceLineNo">057</span> /** {@inheritDoc} */<a name="line.57"></a> +<span class="sourceLineNo">058</span> @Override<a name="line.58"></a> +<span class="sourceLineNo">059</span> public String toString() {<a name="line.59"></a> +<span class="sourceLineNo">060</span> return "Marsaglia Log Normal [" + gaussian.toString() + "]";<a name="line.60"></a> +<span class="sourceLineNo">061</span> }<a name="line.61"></a> +<span class="sourceLineNo">062</span>}<a name="line.62"></a> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +</pre> +</div> +</body> +</html> Propchange: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaLogNormalSampler.html ------------------------------------------------------------------------------ svn:eol-style = native Added: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.html (added) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.html Thu Apr 20 11:33:45 2017 @@ -0,0 +1,157 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html lang="en"> +<head> +<title>Source code</title> +<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<div class="sourceContainer"> +<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a> +<span class="sourceLineNo">002</span> * Licensed to the Apache Software Foundation (ASF) under one or more<a name="line.2"></a> +<span class="sourceLineNo">003</span> * contributor license agreements. See the NOTICE file distributed with<a name="line.3"></a> +<span class="sourceLineNo">004</span> * this work for additional information regarding copyright ownership.<a name="line.4"></a> +<span class="sourceLineNo">005</span> * The ASF licenses this file to You under the Apache License, Version 2.0<a name="line.5"></a> +<span class="sourceLineNo">006</span> * (the "License"); you may not use this file except in compliance with<a name="line.6"></a> +<span class="sourceLineNo">007</span> * the License. You may obtain a copy of the License at<a name="line.7"></a> +<span class="sourceLineNo">008</span> *<a name="line.8"></a> +<span class="sourceLineNo">009</span> * http://www.apache.org/licenses/LICENSE-2.0<a name="line.9"></a> +<span class="sourceLineNo">010</span> *<a name="line.10"></a> +<span class="sourceLineNo">011</span> * Unless required by applicable law or agreed to in writing, software<a name="line.11"></a> +<span class="sourceLineNo">012</span> * distributed under the License is distributed on an "AS IS" BASIS,<a name="line.12"></a> +<span class="sourceLineNo">013</span> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<a name="line.13"></a> +<span class="sourceLineNo">014</span> * See the License for the specific language governing permissions and<a name="line.14"></a> +<span class="sourceLineNo">015</span> * limitations under the License.<a name="line.15"></a> +<span class="sourceLineNo">016</span> */<a name="line.16"></a> +<span class="sourceLineNo">017</span>package org.apache.commons.rng.sampling.distribution;<a name="line.17"></a> +<span class="sourceLineNo">018</span><a name="line.18"></a> +<span class="sourceLineNo">019</span>import org.apache.commons.rng.UniformRandomProvider;<a name="line.19"></a> +<span class="sourceLineNo">020</span><a name="line.20"></a> +<span class="sourceLineNo">021</span>/**<a name="line.21"></a> +<span class="sourceLineNo">022</span> * <a href="https://en.wikipedia.org/wiki/Marsaglia_polar_method"><a name="line.22"></a> +<span class="sourceLineNo">023</span> * Marsaglia polar method</a> for sampling from a Gaussian distribution<a name="line.23"></a> +<span class="sourceLineNo">024</span> * with mean 0 and standard deviation 1.<a name="line.24"></a> +<span class="sourceLineNo">025</span> * This is a variation of the algorithm implemented in<a name="line.25"></a> +<span class="sourceLineNo">026</span> * {@link BoxMullerNormalizedGaussianSampler}.<a name="line.26"></a> +<span class="sourceLineNo">027</span> *<a name="line.27"></a> +<span class="sourceLineNo">028</span> * @since 1.1<a name="line.28"></a> +<span class="sourceLineNo">029</span> */<a name="line.29"></a> +<span class="sourceLineNo">030</span>public class MarsagliaNormalizedGaussianSampler<a name="line.30"></a> +<span class="sourceLineNo">031</span> extends SamplerBase<a name="line.31"></a> +<span class="sourceLineNo">032</span> implements NormalizedGaussianSampler {<a name="line.32"></a> +<span class="sourceLineNo">033</span> /** Next gaussian. */<a name="line.33"></a> +<span class="sourceLineNo">034</span> private double nextGaussian = Double.NaN;<a name="line.34"></a> +<span class="sourceLineNo">035</span><a name="line.35"></a> +<span class="sourceLineNo">036</span> /**<a name="line.36"></a> +<span class="sourceLineNo">037</span> * @param rng Generator of uniformly distributed random numbers.<a name="line.37"></a> +<span class="sourceLineNo">038</span> */<a name="line.38"></a> +<span class="sourceLineNo">039</span> public MarsagliaNormalizedGaussianSampler(UniformRandomProvider rng) {<a name="line.39"></a> +<span class="sourceLineNo">040</span> super(rng);<a name="line.40"></a> +<span class="sourceLineNo">041</span> }<a name="line.41"></a> +<span class="sourceLineNo">042</span><a name="line.42"></a> +<span class="sourceLineNo">043</span> /** {@inheritDoc} */<a name="line.43"></a> +<span class="sourceLineNo">044</span> @Override<a name="line.44"></a> +<span class="sourceLineNo">045</span> public double sample() {<a name="line.45"></a> +<span class="sourceLineNo">046</span> if (Double.isNaN(nextGaussian)) {<a name="line.46"></a> +<span class="sourceLineNo">047</span> // Rejection scheme for selecting a pair that lies within the unit circle.<a name="line.47"></a> +<span class="sourceLineNo">048</span> SAMPLE: while (true) {<a name="line.48"></a> +<span class="sourceLineNo">049</span> // Generate a pair of numbers within [-1 , 1).<a name="line.49"></a> +<span class="sourceLineNo">050</span> final double x = 2 * nextDouble() - 1;<a name="line.50"></a> +<span class="sourceLineNo">051</span> final double y = 2 * nextDouble() - 1;<a name="line.51"></a> +<span class="sourceLineNo">052</span> final double r2 = x * x + y * y;<a name="line.52"></a> +<span class="sourceLineNo">053</span><a name="line.53"></a> +<span class="sourceLineNo">054</span> if (r2 > 1 || r2 == 0) {<a name="line.54"></a> +<span class="sourceLineNo">055</span> // Pair is not within the unit circle: Generate another one.<a name="line.55"></a> +<span class="sourceLineNo">056</span> continue SAMPLE;<a name="line.56"></a> +<span class="sourceLineNo">057</span> }<a name="line.57"></a> +<span class="sourceLineNo">058</span><a name="line.58"></a> +<span class="sourceLineNo">059</span> // Pair (x, y) is within unit circle.<a name="line.59"></a> +<span class="sourceLineNo">060</span> final double alpha = Math.sqrt(-2 * Math.log(r2) / r2);<a name="line.60"></a> +<span class="sourceLineNo">061</span><a name="line.61"></a> +<span class="sourceLineNo">062</span> // Keep second element of the pair for next invocation.<a name="line.62"></a> +<span class="sourceLineNo">063</span> nextGaussian = alpha * y;<a name="line.63"></a> +<span class="sourceLineNo">064</span><a name="line.64"></a> +<span class="sourceLineNo">065</span> // Return the first element of the generated pair.<a name="line.65"></a> +<span class="sourceLineNo">066</span> return alpha * x;<a name="line.66"></a> +<span class="sourceLineNo">067</span> }<a name="line.67"></a> +<span class="sourceLineNo">068</span> } else {<a name="line.68"></a> +<span class="sourceLineNo">069</span> // Use the second element of the pair (generated at the<a name="line.69"></a> +<span class="sourceLineNo">070</span> // previous invocation).<a name="line.70"></a> +<span class="sourceLineNo">071</span> final double r = nextGaussian;<a name="line.71"></a> +<span class="sourceLineNo">072</span><a name="line.72"></a> +<span class="sourceLineNo">073</span> // Both elements of the pair have been used.<a name="line.73"></a> +<span class="sourceLineNo">074</span> nextGaussian = Double.NaN;<a name="line.74"></a> +<span class="sourceLineNo">075</span><a name="line.75"></a> +<span class="sourceLineNo">076</span> return r;<a name="line.76"></a> +<span class="sourceLineNo">077</span> }<a name="line.77"></a> +<span class="sourceLineNo">078</span> }<a name="line.78"></a> +<span class="sourceLineNo">079</span><a name="line.79"></a> +<span class="sourceLineNo">080</span> /** {@inheritDoc} */<a name="line.80"></a> +<span class="sourceLineNo">081</span> @Override<a name="line.81"></a> +<span class="sourceLineNo">082</span> public String toString() {<a name="line.82"></a> +<span class="sourceLineNo">083</span> return "Box-Muller (with rejection) normalized Gaussian deviate [" + super.toString() + "]";<a name="line.83"></a> +<span class="sourceLineNo">084</span> }<a name="line.84"></a> +<span class="sourceLineNo">085</span>}<a name="line.85"></a> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +</pre> +</div> +</body> +</html> Propchange: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.html ------------------------------------------------------------------------------ svn:eol-style = native Added: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html (added) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html Thu Apr 20 11:33:45 2017 @@ -0,0 +1,96 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html lang="en"> +<head> +<title>Source code</title> +<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<div class="sourceContainer"> +<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a> +<span class="sourceLineNo">002</span> * Licensed to the Apache Software Foundation (ASF) under one or more<a name="line.2"></a> +<span class="sourceLineNo">003</span> * contributor license agreements. See the NOTICE file distributed with<a name="line.3"></a> +<span class="sourceLineNo">004</span> * this work for additional information regarding copyright ownership.<a name="line.4"></a> +<span class="sourceLineNo">005</span> * The ASF licenses this file to You under the Apache License, Version 2.0<a name="line.5"></a> +<span class="sourceLineNo">006</span> * (the "License"); you may not use this file except in compliance with<a name="line.6"></a> +<span class="sourceLineNo">007</span> * the License. You may obtain a copy of the License at<a name="line.7"></a> +<span class="sourceLineNo">008</span> *<a name="line.8"></a> +<span class="sourceLineNo">009</span> * http://www.apache.org/licenses/LICENSE-2.0<a name="line.9"></a> +<span class="sourceLineNo">010</span> *<a name="line.10"></a> +<span class="sourceLineNo">011</span> * Unless required by applicable law or agreed to in writing, software<a name="line.11"></a> +<span class="sourceLineNo">012</span> * distributed under the License is distributed on an "AS IS" BASIS,<a name="line.12"></a> +<span class="sourceLineNo">013</span> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<a name="line.13"></a> +<span class="sourceLineNo">014</span> * See the License for the specific language governing permissions and<a name="line.14"></a> +<span class="sourceLineNo">015</span> * limitations under the License.<a name="line.15"></a> +<span class="sourceLineNo">016</span> */<a name="line.16"></a> +<span class="sourceLineNo">017</span>package org.apache.commons.rng.sampling.distribution;<a name="line.17"></a> +<span class="sourceLineNo">018</span><a name="line.18"></a> +<span class="sourceLineNo">019</span>/**<a name="line.19"></a> +<span class="sourceLineNo">020</span> * Marker interface for a sampler that generates values from an N(0,1)<a name="line.20"></a> +<span class="sourceLineNo">021</span> * <a href="https://en.wikipedia.org/wiki/Normal_distribution"><a name="line.21"></a> +<span class="sourceLineNo">022</span> * Gaussian distribution</a>.<a name="line.22"></a> +<span class="sourceLineNo">023</span> */<a name="line.23"></a> +<span class="sourceLineNo">024</span>public interface NormalizedGaussianSampler extends ContinuousSampler {}<a name="line.24"></a> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +</pre> +</div> +</body> +</html> Propchange: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/NormalizedGaussianSampler.html ------------------------------------------------------------------------------ svn:eol-style = native Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/PoissonSampler.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/PoissonSampler.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/apidocs/src-html/org/apache/commons/rng/sampling/distribution/PoissonSampler.html Thu Apr 20 11:33:45 2017 @@ -54,7 +54,7 @@ <span class="sourceLineNo">046</span> /** Exponential. */<a name="line.46"></a> <span class="sourceLineNo">047</span> private final ContinuousSampler exponential;<a name="line.47"></a> <span class="sourceLineNo">048</span> /** Gaussian. */<a name="line.48"></a> -<span class="sourceLineNo">049</span> private final ContinuousSampler gaussian;<a name="line.49"></a> +<span class="sourceLineNo">049</span> private final NormalizedGaussianSampler gaussian;<a name="line.49"></a> <span class="sourceLineNo">050</span> /** {@code log(n!)}. */<a name="line.50"></a> <span class="sourceLineNo">051</span> private final InternalUtils.FactorialLog factorialLog;<a name="line.51"></a> <span class="sourceLineNo">052</span><a name="line.52"></a> @@ -72,7 +72,7 @@ <span class="sourceLineNo">064</span><a name="line.64"></a> <span class="sourceLineNo">065</span> this.mean = mean;<a name="line.65"></a> <span class="sourceLineNo">066</span><a name="line.66"></a> -<span class="sourceLineNo">067</span> gaussian = new BoxMullerGaussianSampler(rng, 0, 1);<a name="line.67"></a> +<span class="sourceLineNo">067</span> gaussian = new MarsagliaNormalizedGaussianSampler(rng);<a name="line.67"></a> <span class="sourceLineNo">068</span> exponential = new AhrensDieterExponentialSampler(rng, 1);<a name="line.68"></a> <span class="sourceLineNo">069</span> factorialLog = mean < PIVOT ?<a name="line.69"></a> <span class="sourceLineNo">070</span> null : // Not used.<a name="line.70"></a> @@ -126,13 +126,13 @@ <span class="sourceLineNo">118</span> final double p2 = a2 / aSum;<a name="line.118"></a> <span class="sourceLineNo">119</span> final double c1 = 1 / (8 * lambda);<a name="line.119"></a> <span class="sourceLineNo">120</span><a name="line.120"></a> -<span class="sourceLineNo">121</span> double x = 0;<a name="line.121"></a> -<span class="sourceLineNo">122</span> double y = 0;<a name="line.122"></a> -<span class="sourceLineNo">123</span> double v = 0;<a name="line.123"></a> -<span class="sourceLineNo">124</span> int a = 0;<a name="line.124"></a> -<span class="sourceLineNo">125</span> double t = 0;<a name="line.125"></a> -<span class="sourceLineNo">126</span> double qr = 0;<a name="line.126"></a> -<span class="sourceLineNo">127</span> double qa = 0;<a name="line.127"></a> +<span class="sourceLineNo">121</span> double x;<a name="line.121"></a> +<span class="sourceLineNo">122</span> double y;<a name="line.122"></a> +<span class="sourceLineNo">123</span> double v;<a name="line.123"></a> +<span class="sourceLineNo">124</span> int a;<a name="line.124"></a> +<span class="sourceLineNo">125</span> double t;<a name="line.125"></a> +<span class="sourceLineNo">126</span> double qr;<a name="line.126"></a> +<span class="sourceLineNo">127</span> double qa;<a name="line.127"></a> <span class="sourceLineNo">128</span> while (true) {<a name="line.128"></a> <span class="sourceLineNo">129</span> final double u = nextDouble();<a name="line.129"></a> <span class="sourceLineNo">130</span> if (u <= p1) {<a name="line.130"></a> Modified: websites/production/commons/content/proper/commons-rng/commons-rng-sampling/checkstyle.html ============================================================================== --- websites/production/commons/content/proper/commons-rng/commons-rng-sampling/checkstyle.html (original) +++ websites/production/commons/content/proper/commons-rng/commons-rng-sampling/checkstyle.html Thu Apr 20 11:33:45 2017 @@ -1,13 +1,13 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 12 December 2016 + | Generated by Apache Maven Doxia at 20 April 2017 | Rendered using Apache Maven Fluido Skin 1.3.0 --> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="Date-Revision-yyyymmdd" content="20161212" /> + <meta name="Date-Revision-yyyymmdd" content="20170420" /> <meta http-equiv="Content-Language" content="en" /> <title>RNG – Checkstyle Results</title> @@ -40,8 +40,8 @@ <a class="brand" href="http://commons.apache.org/proper/commons-rng/commons-rng-sampling/">Apache Commons RNG Sampling ™</a> <ul class="nav"> - <li id="publishDate">Last Published: 12 December 2016</li> - <li class="divider">|</li> <li id="projectVersion">Version: 1.0</li> + <li id="publishDate">Last Published: 20 April 2017</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.1-SNAPSHOT</li> </ul> <div class="pull-right"> <ul class="nav"> <li> @@ -88,7 +88,7 @@ <a href="project-info.html" title="Project Information"> Project Information</a> </li> - <li class="expanded"> + <li class="expanded"> <a href="project-reports.html" title="Project Reports"> Project Reports</a> <ul> @@ -133,6 +133,10 @@ Checkstyle</a> </li> <li class="none"> + <a href="clirr-report.html" title="Clirr"> + Clirr</a> + </li> + <li class="none"> <a href="pmd.html" title="PMD"> PMD</a> </li> @@ -251,7 +255,7 @@ <th><img src="images/icon_warning_sml.gif" alt="" /> Warnings</th> <th><img src="images/icon_error_sml.gif" alt="" /> Errors</th></tr> <tr class="b"> -<td>24</td> +<td>29</td> <td>0</td> <td>0</td> <td>0</td></tr></table></div> @@ -271,7 +275,7 @@ </div> <div class="footer"> - <p>Copyright © 2016 + <p>Copyright © 2016-2017 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.</p>