This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-statistics.git
commit f022dfcf5166060661c723afb91afc5d9794893b
Author: Alex Herbert <aherb...@apache.org>
AuthorDate: Wed Mar 19 15:51:46 2025 +0000
STATISTICS-90: Add since tag
---
.../org/apache/commons/statistics/descriptive/DoubleStatistics.java | 2 ++
.../java/org/apache/commons/statistics/descriptive/FirstMoment.java | 1 +
.../java/org/apache/commons/statistics/descriptive/GeometricMean.java | 3 +++
.../main/java/org/apache/commons/statistics/descriptive/IntMax.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/IntMean.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/IntMin.java | 1 +
.../apache/commons/statistics/descriptive/IntStandardDeviation.java | 1 +
.../java/org/apache/commons/statistics/descriptive/IntStatistics.java | 2 ++
.../main/java/org/apache/commons/statistics/descriptive/IntSum.java | 1 +
.../org/apache/commons/statistics/descriptive/IntSumOfSquares.java | 1 +
.../java/org/apache/commons/statistics/descriptive/IntVariance.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/Kurtosis.java | 3 +++
.../main/java/org/apache/commons/statistics/descriptive/LongMax.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/LongMean.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/LongMin.java | 1 +
.../apache/commons/statistics/descriptive/LongStandardDeviation.java | 1 +
.../java/org/apache/commons/statistics/descriptive/LongStatistics.java | 2 ++
.../main/java/org/apache/commons/statistics/descriptive/LongSum.java | 1 +
.../org/apache/commons/statistics/descriptive/LongSumOfSquares.java | 1 +
.../java/org/apache/commons/statistics/descriptive/LongVariance.java | 1 +
.../src/main/java/org/apache/commons/statistics/descriptive/Max.java | 1 +
.../src/main/java/org/apache/commons/statistics/descriptive/Mean.java | 1 +
.../src/main/java/org/apache/commons/statistics/descriptive/Min.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/Product.java | 3 +++
.../main/java/org/apache/commons/statistics/descriptive/Skewness.java | 3 +++
.../org/apache/commons/statistics/descriptive/StandardDeviation.java | 1 +
.../src/main/java/org/apache/commons/statistics/descriptive/Sum.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/SumOfLogs.java | 3 +++
.../java/org/apache/commons/statistics/descriptive/SumOfSquares.java | 1 +
.../main/java/org/apache/commons/statistics/descriptive/Variance.java | 1 +
30 files changed, 43 insertions(+)
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/DoubleStatistics.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/DoubleStatistics.java
index 5824123..d6f790d 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/DoubleStatistics.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/DoubleStatistics.java
@@ -210,6 +210,7 @@ public final class DoubleStatistics implements
DoubleConsumer {
* @param to Exclusive end of the range.
* @return {@code DoubleStatistics} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public DoubleStatistics build(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -397,6 +398,7 @@ public final class DoubleStatistics implements
DoubleConsumer {
* @return the instance
* @throws IllegalArgumentException if there are no {@code statistics} to
compute.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static DoubleStatistics ofRange(Set<Statistic> statistics, double[]
values, int from, int to) {
if (statistics.isEmpty()) {
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/FirstMoment.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/FirstMoment.java
index 9531b13..63cef8a 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/FirstMoment.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/FirstMoment.java
@@ -169,6 +169,7 @@ class FirstMoment implements DoubleConsumer {
* @param to Exclusive end of the range.
* @return {@code FirstMoment} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
static FirstMoment ofRange(double[] values, int from, int to) {
if (from == to) {
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/GeometricMean.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/GeometricMean.java
index 38fabae..b65ac0a 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/GeometricMean.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/GeometricMean.java
@@ -121,6 +121,7 @@ public final class GeometricMean implements
DoubleStatistic, StatisticAccumulato
* @param to Exclusive end of the range.
* @return {@code GeometricMean} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static GeometricMean ofRange(double[] values, int from, int to) {
// Range checks performed by the sum-of-logs
@@ -149,6 +150,7 @@ public final class GeometricMean implements
DoubleStatistic, StatisticAccumulato
* @param to Exclusive end of the range.
* @return {@code GeometricMean} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static GeometricMean ofRange(int[] values, int from, int to) {
// Range checks performed by the sum-of-logs
@@ -177,6 +179,7 @@ public final class GeometricMean implements
DoubleStatistic, StatisticAccumulato
* @param to Exclusive end of the range.
* @return {@code GeometricMean} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static GeometricMean ofRange(long[] values, int from, int to) {
// Range checks performed by the sum-of-logs
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMax.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMax.java
index 09062ac..73dc71c 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMax.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMax.java
@@ -92,6 +92,7 @@ public final class IntMax implements IntStatistic,
StatisticAccumulator<IntMax>
* @param to Exclusive end of the range.
* @return {@code IntMax} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntMax ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMean.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMean.java
index 7ee1e6d..5987571 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMean.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMean.java
@@ -113,6 +113,7 @@ public final class IntMean implements IntStatistic,
StatisticAccumulator<IntMean
* @param to Exclusive end of the range.
* @return {@code IntMean} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntMean ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMin.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMin.java
index a4ca8b1..2cdc679 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMin.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntMin.java
@@ -92,6 +92,7 @@ public final class IntMin implements IntStatistic,
StatisticAccumulator<IntMin>
* @param to Exclusive end of the range.
* @return {@code IntMin} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntMin ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStandardDeviation.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStandardDeviation.java
index 1c5a461..ea72c89 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStandardDeviation.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStandardDeviation.java
@@ -128,6 +128,7 @@ public final class IntStandardDeviation implements
IntStatistic, StatisticAccumu
* @param to Exclusive end of the range.
* @return {@code IntStandardDeviation} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntStandardDeviation ofRange(int[] values, int from, int to)
{
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStatistics.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStatistics.java
index ff7bc79..dd9f709 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStatistics.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntStatistics.java
@@ -207,6 +207,7 @@ public final class IntStatistics implements IntConsumer {
* @param to Exclusive end of the range.
* @return {@code IntStatistics} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public IntStatistics build(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -367,6 +368,7 @@ public final class IntStatistics implements IntConsumer {
* @return the instance
* @throws IllegalArgumentException if there are no {@code statistics} to
compute.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntStatistics ofRange(Set<Statistic> statistics, int[]
values, int from, int to) {
if (statistics.isEmpty()) {
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSum.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSum.java
index 16b8b4b..03e6a93 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSum.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSum.java
@@ -118,6 +118,7 @@ public final class IntSum implements IntStatistic,
StatisticAccumulator<IntSum>
* @param to Exclusive end of the range.
* @return {@code IntSum} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntSum ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSumOfSquares.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSumOfSquares.java
index e0e139a..518e622 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSumOfSquares.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntSumOfSquares.java
@@ -112,6 +112,7 @@ public final class IntSumOfSquares implements IntStatistic,
StatisticAccumulator
* @param to Exclusive end of the range.
* @return {@code IntSumOfSquares} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntSumOfSquares ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntVariance.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntVariance.java
index 34afb4d..9b89372 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntVariance.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/IntVariance.java
@@ -130,6 +130,7 @@ public final class IntVariance implements IntStatistic,
StatisticAccumulator<Int
* @param to Exclusive end of the range.
* @return {@code IntVariance} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static IntVariance ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Kurtosis.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Kurtosis.java
index db7c211..a93c90b 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Kurtosis.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Kurtosis.java
@@ -159,6 +159,7 @@ public final class Kurtosis implements DoubleStatistic,
StatisticAccumulator<Kur
* @param to Exclusive end of the range.
* @return {@code Kurtosis} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Kurtosis ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -189,6 +190,7 @@ public final class Kurtosis implements DoubleStatistic,
StatisticAccumulator<Kur
* @param to Exclusive end of the range.
* @return {@code Kurtosis} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Kurtosis ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -219,6 +221,7 @@ public final class Kurtosis implements DoubleStatistic,
StatisticAccumulator<Kur
* @param to Exclusive end of the range.
* @return {@code Kurtosis} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Kurtosis ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMax.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMax.java
index 4039d19..de73efc 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMax.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMax.java
@@ -92,6 +92,7 @@ public final class LongMax implements LongStatistic,
StatisticAccumulator<LongMa
* @param to Exclusive end of the range.
* @return {@code LongMax} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongMax ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMean.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMean.java
index d3df3a4..492ed78 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMean.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMean.java
@@ -110,6 +110,7 @@ public final class LongMean implements LongStatistic,
StatisticAccumulator<LongM
* @param to Exclusive end of the range.
* @return {@code LongMean} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongMean ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMin.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMin.java
index 783dfae..d04afa1 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMin.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongMin.java
@@ -92,6 +92,7 @@ public final class LongMin implements LongStatistic,
StatisticAccumulator<LongMi
* @param to Exclusive end of the range.
* @return {@code LongMin} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongMin ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStandardDeviation.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStandardDeviation.java
index 6e3f05a..3d89f7e 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStandardDeviation.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStandardDeviation.java
@@ -128,6 +128,7 @@ public final class LongStandardDeviation implements
LongStatistic, StatisticAccu
* @param to Exclusive end of the range.
* @return {@code LongStandardDeviation} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongStandardDeviation ofRange(long[] values, int from, int
to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStatistics.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStatistics.java
index 95458d9..f4fb8e2 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStatistics.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongStatistics.java
@@ -207,6 +207,7 @@ public final class LongStatistics implements LongConsumer {
* @param to Exclusive end of the range.
* @return {@code LongStatistics} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public LongStatistics build(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -367,6 +368,7 @@ public final class LongStatistics implements LongConsumer {
* @return the instance
* @throws IllegalArgumentException if there are no {@code statistics} to
compute.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongStatistics ofRange(Set<Statistic> statistics, long[]
values, int from, int to) {
if (statistics.isEmpty()) {
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSum.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSum.java
index f6ff691..525d5b5 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSum.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSum.java
@@ -108,6 +108,7 @@ public final class LongSum implements LongStatistic,
StatisticAccumulator<LongSu
* @param to Exclusive end of the range.
* @return {@code LongSum} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongSum ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSumOfSquares.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSumOfSquares.java
index 3511dd8..65e1403 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSumOfSquares.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongSumOfSquares.java
@@ -113,6 +113,7 @@ public final class LongSumOfSquares implements
LongStatistic, StatisticAccumulat
* @param to Exclusive end of the range.
* @return {@code LongSumOfSquares} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongSumOfSquares ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongVariance.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongVariance.java
index 2daf72c..b685b24 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongVariance.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/LongVariance.java
@@ -127,6 +127,7 @@ public final class LongVariance implements LongStatistic,
StatisticAccumulator<L
* @param to Exclusive end of the range.
* @return {@code LongVariance} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static LongVariance ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Max.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Max.java
index 50d9ab5..dc879bf 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Max.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Max.java
@@ -96,6 +96,7 @@ public final class Max implements DoubleStatistic,
StatisticAccumulator<Max> {
* @param to Exclusive end of the range.
* @return {@code Max} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Max ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Mean.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Mean.java
index 7d2639e..b4b036f 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Mean.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Mean.java
@@ -137,6 +137,7 @@ public final class Mean implements DoubleStatistic,
StatisticAccumulator<Mean> {
* @param to Exclusive end of the range.
* @return {@code Mean} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Mean ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Min.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Min.java
index aac2ced..999fd49 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Min.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Min.java
@@ -96,6 +96,7 @@ public final class Min implements DoubleStatistic,
StatisticAccumulator<Min> {
* @param to Exclusive end of the range.
* @return {@code Min} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Min ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Product.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Product.java
index ff053eb..53b6c02 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Product.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Product.java
@@ -93,6 +93,7 @@ public final class Product implements DoubleStatistic,
StatisticAccumulator<Prod
* @param to Exclusive end of the range.
* @return {@code Product} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Product ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -135,6 +136,7 @@ public final class Product implements DoubleStatistic,
StatisticAccumulator<Prod
* @param to Exclusive end of the range.
* @return {@code Product} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Product ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -177,6 +179,7 @@ public final class Product implements DoubleStatistic,
StatisticAccumulator<Prod
* @param to Exclusive end of the range.
* @return {@code Product} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Product ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Skewness.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Skewness.java
index 81d87d5..06faad0 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Skewness.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Skewness.java
@@ -161,6 +161,7 @@ public final class Skewness implements DoubleStatistic,
StatisticAccumulator<Ske
* @param to Exclusive end of the range.
* @return {@code Skewness} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Skewness ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -191,6 +192,7 @@ public final class Skewness implements DoubleStatistic,
StatisticAccumulator<Ske
* @param to Exclusive end of the range.
* @return {@code Skewness} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Skewness ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -221,6 +223,7 @@ public final class Skewness implements DoubleStatistic,
StatisticAccumulator<Ske
* @param to Exclusive end of the range.
* @return {@code Skewness} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Skewness ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/StandardDeviation.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/StandardDeviation.java
index 6a46e05..ccf582f 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/StandardDeviation.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/StandardDeviation.java
@@ -154,6 +154,7 @@ public final class StandardDeviation implements
DoubleStatistic, StatisticAccumu
* @param to Exclusive end of the range.
* @return {@code StandardDeviation} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static StandardDeviation ofRange(double[] values, int from, int to)
{
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Sum.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Sum.java
index 4e11054..871aeba 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Sum.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Sum.java
@@ -108,6 +108,7 @@ public final class Sum implements DoubleStatistic,
StatisticAccumulator<Sum> {
* @param from Inclusive start of the range.
* @param to Exclusive end of the range.
* @return {@code Sum} instance.
+ * @since 1.2
*/
public static Sum ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfLogs.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfLogs.java
index 1b72fe4..650b681 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfLogs.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfLogs.java
@@ -108,6 +108,7 @@ public final class SumOfLogs implements DoubleStatistic,
StatisticAccumulator<Su
* @param to Exclusive end of the range.
* @return {@code SumOfLogs} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static SumOfLogs ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -154,6 +155,7 @@ public final class SumOfLogs implements DoubleStatistic,
StatisticAccumulator<Su
* @param to Exclusive end of the range.
* @return {@code SumOfLogs} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static SumOfLogs ofRange(int[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
@@ -200,6 +202,7 @@ public final class SumOfLogs implements DoubleStatistic,
StatisticAccumulator<Su
* @param to Exclusive end of the range.
* @return {@code SumOfLogs} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static SumOfLogs ofRange(long[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfSquares.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfSquares.java
index 829b700..4ac67f4 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfSquares.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/SumOfSquares.java
@@ -97,6 +97,7 @@ public final class SumOfSquares implements DoubleStatistic,
StatisticAccumulator
* @param to Exclusive end of the range.
* @return {@code SumOfSquares} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static SumOfSquares ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
diff --git
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Variance.java
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Variance.java
index 7ceba94..3f4fd6b 100644
---
a/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Variance.java
+++
b/commons-statistics-descriptive/src/main/java/org/apache/commons/statistics/descriptive/Variance.java
@@ -150,6 +150,7 @@ public final class Variance implements DoubleStatistic,
StatisticAccumulator<Var
* @param to Exclusive end of the range.
* @return {@code Variance} instance.
* @throws IndexOutOfBoundsException if the sub-range is out of bounds
+ * @since 1.2
*/
public static Variance ofRange(double[] values, int from, int to) {
Statistics.checkFromToIndex(from, to, values.length);
