diff --git a/src/main/java/org/apache/commons/math4/stat/inference/KolmogorovSmirnovTest.java b/src/main/java/org/apache/commons/math4/stat/inference/KolmogorovSmirnovTest.java index 9569caefb..312acc067 100644 --- a/src/main/java/org/apache/commons/math4/stat/inference/KolmogorovSmirnovTest.java +++ b/src/main/java/org/apache/commons/math4/stat/inference/KolmogorovSmirnovTest.java @@ -80,7 +80,12 @@ import org.apache.commons.math4.util.MathUtils; *
+ * If the product of the sample sizes is less than {@value #LARGE_SAMPLE_PRODUCT} and the sample + * data contains ties, random jitter is added to the sample data to break ties before applying + * the algorithm above. Alternatively, the {@link #bootstrap(double[], double[], int, boolean)} + * method, modeled after ks.boot + * in the R Matching package [3], can be used if ties are known to be present in the data. *
** In the two-sample case, \(D_{n,m}\) has a discrete distribution. This makes the p-value @@ -107,6 +112,9 @@ import org.apache.commons.math4.util.MathUtils; * George Marsaglia, Wai Wan Tsang, and Jingbo Wang *
+ * If {@code x.length * y.length} < {@value #LARGE_SAMPLE_PRODUCT} and the combined set of values in + * {@code x} and {@code y} contains ties, random jitter is added to {@code x} and {@code y} to + * break ties before computing \(D_{n,m}\) and the p-value. The jitter is uniformly distributed + * on (-minDelta / 2, minDelta / 2) where minDelta is the smallest pairwise difference between + * values in the combined sample.
+ *+ * If ties are known to be present in the data, {@link #bootstrap(double[], double[], int, boolean)} + * may be used as an alternative method for estimating the p-value.
* * @param x first sample dataset * @param y second sample dataset @@ -244,6 +260,7 @@ public class KolmogorovSmirnovTest { * @throws InsufficientDataException if either {@code x} or {@code y} does not have length at * least 2 * @throws NullArgumentException if either {@code x} or {@code y} is null + * @see #bootstrap(double[], double[], int, boolean) */ public double kolmogorovSmirnovTest(double[] x, double[] y, boolean strict) { final long lengthProduct = (long) x.length * y.length; @@ -397,9 +414,9 @@ public class KolmogorovSmirnovTest { * probability distribution. This method estimates the p-value by repeatedly sampling sets of size * {@code x.length} and {@code y.length} from the empirical distribution of the combined sample. * When {@code strict} is true, this is equivalent to the algorithm implemented in the R function - * ks.boot, described in- * Jasjeet S. Sekhon. 2011. `Multivariate and Propensity Score Matching - * Software with Automated Balance Optimization: The Matching package for R.` + * {@code ks.boot}, described in+ * Jasjeet S. Sekhon. 2011. 'Multivariate and Propensity Score Matching + * Software with Automated Balance Optimization: The Matching package for R.' * Journal of Statistical Software, 42(7): 1-52. ** @param x first sample @@ -1250,7 +1267,7 @@ public class KolmogorovSmirnovTest { */ private static void jitter(double[] data, RealDistribution dist) { for (int i = 0; i < data.length; i++) { - data[i] = data[i] + dist.sample(); + data[i] += dist.sample(); } } }