<?xml version="1.0"?>
<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-->

<!--
This file is used by the maven-changes-plugin to generate the release notes.
Useful ways of finding items to add to this file are:

1.  Add items when you fix a bug or add a feature (this makes the
release process easy :-).

2.  Do a JIRA search for tickets closed since the previous release.

3.  Use the report generated by the maven-changelog-plugin to see all
SVN commits.

To generate the file RELEASE-NOTES.txt from this file:

mvn changes:announcement-generate -Prelease-notes [-Dchanges.version]

The <action> type attribute can be add,update,fix,remove.
-->

<!-- NOTE:
The description attribute entries below are specially formatted
so as to improve the layout of the generated text release notes.

The parsing process removes all line feeds, replacing them with a single space.
The Velocity template in src/changes/release-notes.vm has been enhanced to replace pairs of adjacent spaces
with a new-line in the release notes. (These spaces are ignored when displaying HTML).
If the output is not quite correct, check for invisible trailing spaces!
-->

<document xmlns="http://maven.apache.org/changes/2.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/changes/2.0.0 https://maven.apache.org/xsd/changes-2.0.0.xsd">
  <properties>
    <title>Apache Commons Statistics Release Notes</title>
  </properties>
  <body>
    <release version="1.3" date="2026-05-01" description="Adds new features (requires Java 8).">
      <action dev="aherbert" type="add" issue="STATISTICS-94">
        "Median/Quantile": Support median and quantile for long datatype.
      </action>
      <action dev="aherbert" type="update" issue="STATISTICS-93">
        "TruncatedNormalDistribution": Add methods to expose construction
        parameters.
      </action>
      <action dev="aherbert" due-to="kevinmilner" type="fix" issue="STATISTICS-92">
        "TruncatedNormalDistribution": Fix the cases where the sampler would:
        (1) generate a biased distribution if the truncated bounds are fully-positive
        or fully-negative;
        (2) infinite loop if the truncated bounds are positive and fully below the
        parent distribution positive mean value, or are negative and fully above the
        parent distribution negative mean value.
      </action>
    </release>

    <release version="1.2" date="2025-09-17" description="
Adds interval module (requires Java 8).
">
      <action dev="aherbert" type="add" issue="STATISTICS-91">
        "NormalConfidenceInterval": Support confidence intervals for a normally
        distributed population.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-6">
        Add a commons-statistics-interval module for statistical intervals. This ports
        and updates functionality in org.apache.commons.math4.stat.interval.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-90">
        Support creation of descriptive statistics from an array range defined
        using [from, to) indices.
      </action>
    </release>

    <release version="1.1" date="2024-08-20" description="
Adds ranking, inference, descriptive and bom modules (requires Java 8).
">
      <action dev="aherbert" type="add" issue="STATISTICS-88">
        "LogUniformDistribution": Add a log uniform distribution.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-87">
        "FoldedNormalDistribution": Add a folded normal distribution implementation with
        specialized support for a half-normal distribution.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-85">
        Add a quantile and median implementation.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-81">
        Add descriptive statistics for integer types. These allow improved accuracy and
        performance for int and long data using an array or streams over using the
        equivalent double implementation via primitive conversion.
      </action>
      <action dev="aherbert" due-to="Anirudh Joshi, Alex Herbert"  type="add" issue="STATISTICS-71">
        Add commons-statistics-descriptive module for implementations of univariate
        statistics. Contains base interfaces for statistics and implementations for
        individual statistics (e.g. Min, Max, Sum, Mean, Variance) and combinations of
        statistics.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-69">
        "UncoditionedExactTest": Add an unconditioned exact test for 2x2 contingency
        tables.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-70">
        "HypergeometricDistribution": Improve the summation used for the cumulative
        probability functions.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-66">
        Add a Bill of Materials (BOM) to aid in dependency management when referencing
        multiple Apache Commons Statistics artifacts. The BOM should be used to ensure
        all imported artifacts are compatible.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-64">
        "FisherExactTest": Add Fisher's exact test for 2x2 contingency tables.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-62">
        Add a commons-statistics-inference module for hypothesis testing. This ports and
        updates functionality in org.apache.commons.math4.stat.inference including new
        support for one-sided hypothesis testing.
      </action>
      <action dev="aherbert" type="add" issue="STATISTICS-63">
        Add a commons-statistics-ranking module for rank transformations. This ports and
        updates functionality in org.apache.commons.math4.stat.ranking.
      </action>
    </release>

    <release version="1.0" date="2022-12-05" description="
This is the first release of Apache Commons Statistics.

Contains the following modules:
  commons-statistics-distribution.

Requires Java 8.
">
    </release>

  </body>
</document>
