--------------------------------------------
lines 13-79 of file: xrst/release_notes.xrst
--------------------------------------------

{xrst_begin 2025}
{xrst_spell
   mm
   dd
   py
   pdf
   relrisk
}

Release Notes for 2025
######################


mm-dd
*****

01-15
=====
Start the 2025 stable versions of at_cascade; see the new
:ref:`at_cascade@Versions` table.
A release for 2025 has the stable version 2025.0.\ *number*
where *number* is the release number.
Only bug fixes, not new features, are added between release numbers.

This change has broken old web links to the at_cascade documentation.
An old link of the form

| |tab| ``https://at-cascade.readthedocs.io/``\ *html_file_name*

has the following form in the latest documentation:

| |tab| ``https://at-cascade.readthedocs.io/latest/``\ *html_file_name*

and the following for in the 2025 stable documentation:

| |tab| ``https://at-cascade.readthedocs.io/stable-2025/``\ *html_file_name*

01-13
=====
#. Add :ref:`csv.fit@Input Files@option_fit.csv@child_prior_std_factor_mulcov`
   to the option_fit csv file and
   :ref:`option_all_table@shift_prior_std_factor_mulcov`
   to the option_all table.

#. The computation of the standard deviation for the child priors
   was using one degree of freedom.
   This is not correct because we know the true mean of the samples; i.e.,
   the fit value (the number of degrees of freedom should be zero).
   This has been fixed and the child prior
   standard deviations that are a factor of :math:`\sqrt{(N-1)/N}`
   smaller where N is the number of samples.

#. There was a bug in :ref:`fit_one_process-name` . It sometimes
   returned on the main branch before all the other processes had finished.
   This has been fixed.
   It was found by repeated running of the `example/relrisk.py` test
   which uses a large value for :ref:`option_all_table@max_number_cpu` .

01-12
=====
The test/csv/fit.py and test/csv/sample_fail.py tests
were failing on some systems; see
`pull request 29 <https://github.com/bradbell/at_cascade/pull/29>`_ .
The failures have has been fixed by not expecting the plot_data.pdf file
to exist for (node, sex) pairs that have only one data point.

{xrst_end 2025}