Maintainer is changing to @adamkucharski (#143).

Major changes

• The output column names severity_mean and ascertainment_mean have been corrected to severity_estimate and ascertainment_estimate. This may break any workflows that rely on the previous column names (#146).

• This version of cfr includes changes to the severity estimation algorithms used in calculating a static severity measure, and may lead to small changes to some CFR values calculated using v0.1.0 (#129).

Functions

1. cfr_static():

   • Has more informative checks on intermediate values passed to .estimate_severity().

   • Prints a message when CFR value cannot be determined or are unreliable.

2. cfr_rolling():

   • Prints a message explaining that this is a convenience function.

   • Has improved input checking.

   • Uses new .estimate_severity() functionality based on outbreak size and initial expectation of CFR (#129).

   • Prints a message when some rolling CFR values cannot be determined or are unreliable.

3. .estimate_severity():

   • Renamed with . prefix to indicate internal function.

   • Added parameter p_mid for initial severity estimate, which is used to determine the likelihood approximation method.

   • Selects from among Binomial, Poisson, and Normal approximation of the likelihood depending on the outbreak size and p_mid using the function .select_fun_likelihood(); prints a message with the selected method (#129).

   • Lowest possible severity estimate is reduced to $10^{-4}$.

   • Severity estimates and confidence intervals stored as named vectors rather than a <data.frame>.

4. .select_func_likelihood(): Internal function added that chooses likelihood approximation function based on outbreak size and p_mid.

   • Binomial approximation used for small outbreaks with cumulative cases lower than the Poisson threshold.

   • Poisson approximation used for outbreaks above the Poisson threshold and with p_mid < 0.05.

   • Normal approximation used for outbreaks above the Poisson threshold and with p_mid > 0.05.

5. test_fn_req_args() is updated to use Reduce(f = "+") and Map() rather than sum(mapply()).

Documentation

1. Added package level documentation.

2. Updated Readme with lifecycle (stable) and RepoStatus (Active) badges (#113), added DPG badge (#127), and updated the related projects section; corrected figure labelling (#114).

3. Updated _pkgdown.yaml with a manual Bootstrap version (#136) reference sections, added a software permissions vignette (#125), and enabled development mode (#143).

4. Updated WORDLIST.

5. Updated all function documentation files (#134).

6. Added section in distributions vignette on when it is acceptable to use continuous rather than discrete distributions.

7. Corrected explanation of estimate_outcomes() in static severity vignette and added explanations of profile likelihood generation methods used in all severity vignettes (#143).

8. Corrected equations in vignettes (#133) and removed .estimate_severity() from vignettes (#132).

Tests

1. All snapshots are updated with severity values from new likelihood functions (#129).

2. Added session global state checker script and setup options script (#119).

3. All tests are updated to reflect that functions will sometimes throw informative messages.

4. Tests using incidence2 suppress warnings on missing values (added in incidence2 v2.3.0) as filling missing values is the subject of the test for prepare_data.incidence2() (#143).

Package

1. Added or updated GitHub Actions workflows for dependency changes, linting, updating the citation file, and updating the license year (#119, #137, #142).

2. Updated other GHA workflows and infrastructure files to match the latest versions on epiverse-trace/packagetemplate (#119).

3. Normalised DESCRIPTION file.

4. Added tools/check.env from epiverse-trace/packagetemplate to suppress specific checks on package size, Rd cross references, GNU Make requirement, and non-ASCII strings (#142).