NEWS

---

epiR 2.0.78 (2024-12-10)

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.insthaz edited to remove instantaneous hazard estimates when there are now event. Documentation improved in relation to plotting smoothed instantaneous estimates. [Suggested by Rutu Galea]

epiR 2.0.77 (2024-11-19)

SIGNIFICANT USER-VISIBLE CHANGES

• Interpretive statements in epi.2by2 improved. [Spotted by Annette O'Connor]

epiR 2.0.76 (2024-09-15)

SIGNIFICANT USER-VISIBLE CHANGES

• Error in data preparation for function epi.2by2 where outcome = "as.rows" with multiple strata corrected. [Spotted by Jose G Conde Santiago]

epiR 2.0.75 (2024-06-17)

SIGNIFICANT USER-VISIBLE CHANGES

• Descriptive epidemiology vignette changed to remove use of ESRI shape files which are now unsupported by the spData package. [Suggested by Mark Stevenson]

epiR 2.0.74 (2024-04-27)

SIGNIFICANT USER-VISIBLE CHANGES

• Arguments for epi.betabuster changed to make the function more user friendly. Results of epi.betabuster include a statement of the input arguments for the function. [Suggested by Mark Stevenson]

epiR 2.0.73 (2024-04-10)

SIGNIFICANT USER-VISIBLE CHANGES

• Example for function epi.edr improved. Now includes ggplot2 code to superimpose a log2 transformed EDR over an epidemic curve. [Suggested by Mark Stevenson]

epiR 2.0.72

SIGNIFICANT USER-VISIBLE CHANGES

• Edits to the documentation for epi.2by2. [Spotted by Mark Stevenson]

epiR 2.0.71

SIGNIFICANT USER-VISIBLE CHANGES

• Further edits to improve the interpretative statements in epi.2by2. [Spotted by Mark Stevenson]

epiR 2.0.70 (2024-03-11)

SIGNIFICANT USER-VISIBLE CHANGES

• Improved the interpretative statements in epi.2by2. [Spotted by Mark Stevenson]

epiR 2.0.68 (2024-02-18)

SIGNIFICANT USER-VISIBLE CHANGES

• Documentation error in epi.interaction corrected. [Spotted by Edgar Ortiz Brizuela]

epiR 2.0.67 (2024-01-09)

SIGNIFICANT USER-VISIBLE CHANGES

• Updates and edits to the vignettes. [Suggested by Mark Stevenson]

epiR 2.0.65 (2023-09-28)

SIGNIFICANT USER-VISIBLE CHANGES

• Tidy up documentation of sample size functions. [Suggested by Mark Stevenson]

epiR 2.0.64

SIGNIFICANT USER-VISIBLE CHANGES

• Functions epi.ssequb and epi.ssequc modified to allow sample size and power to be be calculated for equivalence and equality trials. [Suggested by Hasanthi Abeykoon]

epiR 2.0.63 (2023-08-15)

SIGNIFICANT USER-VISIBLE CHANGES

• Bug in rsu.sssep.rb2st1rf and rsu.sssep.rb2st2rf corrected. [Spotted by Damian Collins]
• Documentation update for function epi.sscc. [Suggested by Silvia Jakubski]
• Bug in variance calculation for Mantel-Haenszel odds ratio in epi.mh corrected. [Spotted by Remy Dumas]

epiR 2.0.62 (2023-07-01)

SIGNIFICANT USER-VISIBLE CHANGES

• Output 'Odds ratio' changed to 'Incidence odds ratio' when method == cohort.count. Output 'Odds ratio' changed to 'Prevalence odds ratio' when method == cross.sectional. [Suggested by Annette O'Connor and Victoria Brookes]
• Code edited to make calculations consistent for functions epi.ssclus2estc, epi.ssclus1estc and epi.sssimpleestc. [Suggested by Mark Stevenson]
• Example 3 for rsu.dxtests shows how to calculate diagnostic sensitivity and specificity when you have three dependent tests that are interpreted in parallel. [Suggested by Cathy Kneipp]

epiR 2.0.61 (2023-05-18)

SIGNIFICANT USER-VISIBLE CHANGES

• Function rsu.dxtest modified to include the option to calculate sensitivity and specificity for series and parallel interpretation for three diagnostic tests (including the situation where there is dependence between all three tests). [Suggested by Cathy Kneipp]

epiR 2.0.60 (2023-04-05)

SIGNIFICANT USER-VISIBLE CHANGES

• Simplified the point mapping code in the Descriptive Epidemiology vignette. [Suggested by Mark Stevenson]
• Removed dependence on package rgdal. [Suggested by Roger Bivand]

epiR 2.0.59 (2023-03-28)

SIGNIFICANT USER-VISIBLE CHANGES

• New function epi.realrisk. A function to return absolute risks from odds, incidence risk and hazard ratios. [Inpired by David Spiegelhalter at the Winton Centre for Risk and Evidence Communication, The University of Cambridge]

epiR 2.0.58 (2023-03-07)

SIGNIFICANT USER-VISIBLE CHANGES

• epi.kappa returns an error if any of the cell frequencies in the input data table are not integers. [Suggested by Morgane Pommier]

epiR 2.0.57 (2023-02-06)

SIGNIFICANT USER-VISIBLE CHANGES

• Documentation updates for function epi.directadj. [Suggested by Ayesha Siddiqua and Mark Stevenson]
• Function in epi.prcc lists variable names in the output table. [Suggested by Mark Stevenson]
• Bug in epi.kappa where pindex, bindex and results of McNemar not returned if number of rows and columns equal to two corrected. [Spotted by Shirley Regev]
• Bug in epi.2by2 relating to reporting of confidence intervals for incidence risk estimates for method = "cohort.count" corrected. [Spotted by Mollie Wood]
• digits argument in epi.2by2 sets the number of digits for incidence risk, incidence rate and odds estimates in ouput summary table. [Suggested by Mollie Wood]

epiR 2.0.56 (2023-01-15)

SIGNIFICANT USER-VISIBLE CHANGES

• Finite population correction adjustments added to each of the sample size calculation functions. [Suggested by Mark Stevenson]

epiR 2.0.55

SIGNIFICANT USER-VISIBLE CHANGES

• Consistent approach for crude and stratified table preparation using the tidyverse package now provided in the documentation for function epi.2by2. [Suggested by Prabal Chowdhury]

epiR 2.0.54 (2022-12-12)

SIGNIFICANT USER-VISIBLE CHANGES

• Odds, incidence risks and incidence rates in print(epi.2by2) includes confidence intervals. [Suggested by Prabal Chowdhury]

epiR 2.0.53 (2022-10-31)

SIGNIFICANT USER-VISIBLE CHANGES

• Number at risk and number of events listed in the output from function epi.insthaz. [Suggested by Prabal Chowdhury]
• Inconsistency in the documentation for epi.sscompb corrected. [Suggested by Jose Canevari]
• Function rsu.dxtest now includes the option to calculate sensitivity and specificity for series and parallel interpretation for three diagnostic tests (including the situation where there is dependence between two of the three tests). [Suggested by Cathy Kneipp]

epiR 2.0.52 (2022-09-25)

SIGNIFICANT USER-VISIBLE CHANGES

• Labelling inconsistency in epi.2by2 corrected. [Suggested by Mark Stevenson]

epiR 2.0.51

SIGNIFICANT USER-VISIBLE CHANGES

• Documentation in relation to NNTB and NNTH in epi.2by2 updated. [Suggested by Margaret MacDougall]
• Bug in calculation of score confidence intervals for risk ratio corrected. [Spotted by Ki Heun Chung]

epiR 2.0.50 (2022-07-01)

SIGNIFICANT USER-VISIBLE CHANGES

• Function summary(epi.tests) now returns a data frame of diagnostic test outcome measures (instead of a list). [Suggested by question asked on Stack Overflow]
• Numerous tidy ups to documentation. [Suggested by Mark Stevenson]

epiR 2.0.49

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.herdtest now calculates and reports HSe and HSp using the binomial and hypergeometric distributions. [Suggested by Mark Stevenson]

epiR 2.0.48 (2022-05-25)

SIGNIFICANT USER-VISIBLE CHANGES

• Bug in function epi.kappa corrected. [Spotted by Valeria Rolle]

epiR 2.0.47

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.prev further updated to return the expected number of test positives, true positives, false positives, test negatives, true negatives and false negatives in addition to apparent and true prevalence. [Suggested by Mark Stevenson]

epiR 2.0.46 (2022-03-31)

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.prev updated to return the expected number of false positive test results in addition to apparent and true prevalence. [Suggested by Mark Stevenson]

epiR 2.0.43 (2022-02-16)

SIGNIFICANT USER-VISIBLE CHANGES

• Measures of association vignette updated with code to compute measures of association for a series of candidate risk factors. [Suggested by Bruno Avila]

epiR 2.0.42

SIGNIFICANT USER-VISIBLE CHANGES

• Function for epi.interaction now handles models of class geeglm (from the geepack package) and glmerMod (from lme4). [Suggested by Diana Garofalo]

epiR 2.0.41 (2022-01-07)

SIGNIFICANT USER-VISIBLE CHANGES

• Function for epi.interaction reports RERI, APAB, S and multiplicative interaction as a list. [Suggested by Mark Stevenson]
• Numerous tidy ups to documentation. [Suggested by Mark Stevenson]

epiR 2.0.40 (2021-12-16)

SIGNIFICANT USER-VISIBLE CHANGES

• Error in documentation for epi.interaction corrected. [Spotted by Colleen Reynolds]
• Function epi.kappa updated to include option to calculate Cohen's kappa. [Suggested by Victoria Mussemann]
• Descriptive epidemiology vignette updated to include code to add the cumulative number of cases of disease as a function of time to an epidemic curve. [Suggested by Ahmad Rabiee]

epiR 2.0.39 (2021-11-10)

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.2by2 and epi.tests updated to include option to change the precision of measures of association using the print option. [Suggested by Shikha Chugh]
• Function epi.tests updated to include option to calculate exact, Wilson, Agresti, Clopper-Pearson and Jeffreys confidence limits for true prevalence, apparent prevalence, diagnostic sensitivity, diagnostic specificity, positive predictive value and negative predictive value. [Suggested by Shikha Chugh]
• Function epi.2by2 now reports variable phi.coef (phi coefficient) for each of the uncorrected chi-square tests. This value can be used as an input for function epi.sscc. [Suggested by Mark Stevenson]
• Argument rho.cc in function epi.sscc changed to phi.coef so consistent with the literature and function epi.2by2. [Suggested by Mark Stevenson]
• epi.sscompb methodology revised to return results consistent with Woodward (2014). [Spotted by Ajith Ramayyan]
• Help for functions epi.sscompb, epi.sscompc, epi.ssxsectn and epi.sscohortc updated to cite the 2014 edition of Woodward (Epidemiology Study Design and Analysis). [Suggested by Ajith Ramayyan]
• epi.tests now returns the proportion of true outcome negative subjects that test positive (false T+ proportion for D-), the proportion of true outcome positive subjects that test negative (false T- proportion for D+), the proportion of test positive subjects that are outcome negative (false T+ proportion for T+) and the proportion of test negative subjects that are outcome positive (false T- proportion for T-). [Suggested by Ahmad Rabiee]
• epi.betabuster returns a warning if the shape1 parameter for the beta distribution equals max.shape1. [Suggested by Alex Hou]

epiR 2.0.38 (2021-10-11)

SIGNIFICANT USER-VISIBLE CHANGES

• rsu.sep corrected to return results consistent with rsu.pstar. [Suggested by Mark Stevenson]

epiR 2.0.37

SIGNIFICANT USER-VISIBLE CHANGES

• epi.2by2 returns NA for Fisher exact test when total number of observations greater than 2E09, removing numeric overflow errors. [Suggested by Stuart Reece]

epiR 2.0.36 (2021-09-26)

SIGNIFICANT USER-VISIBLE CHANGES

• Argument p1 (prevalence of exposure among cases) added to epi.sscc, allowing Fleiss correction to be applied. [Suggested by Mark Stevenson]

epiR 2.0.35 (2021-09-16)

SIGNIFICANT USER-VISIBLE CHANGES

• New function epi.ssdxsesp to compute a sample size to estimate the sensitivity or specificity of a diagnostic test. [Suggested by Anou Dreyfus]
• Additional example provided in the epi.2by2 documentation showing you how to construct an array suitable for a stratified contingency table analysis using count data. [Suggested by Cieran Harries]
• Error in power calculation for epi.ssninfb and epi.ssninfc corrected. [Spotted by Aniko Szabo]
• epi.ssninfb and epi.ssninfc now requires the user to specify the absolute value of delta (instead of assigning a negative sign to delta, which was prone to user misinterpretation). [Suggested by Aniko Szabo]
• Documentation for epi.sssupb, epi.sssupb, epi.ssequb, epi.ssequc, epi.ssninfb and epi.ssninfc revised and improved. [Suggested by Aniko Szabo]

epiR 2.0.33 (2021-07-30)

SIGNIFICANT USER-VISIBLE CHANGES

• epi.bohning now handles missing values. [Suggested by Mark Stevenson]
• epi.descriptives now reports level frequencies if input data is a factor. [Suggested by Mark Stevenson]

epiR 2.0.32

SIGNIFICANT USER-VISIBLE CHANGES

• All sample size functions now allow user to express error in either relative or absolute terms. [Suggested by Mark Stevenson]

epiR 2.0.30

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.2by2 and epi.tests data entry formats simplified. Both functions now accept tables generated from tidyverse. [Suggested by Mark Stevenson]
• Documentation for all functions reviewed. Objects consistently named. [Suggested by Mark Stevenson]

epiR 2.0.29

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.2by2 returns NAs for point estimates of incidence rate ratio when number of events equals zero. [Suggested by Mark Stevenson]

epiR 2.0.28

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.directadj now returns zero for the directly adjusted incidence rate estimate when the number of observations in a strata equals zero and the time at risk in the same strata equals zero. [Suggested by Mark Stevenson]

epiR 2.0.26 (2021-06-01)

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.2by2 now provides interpretive statements of the number needed to treat and the number needed to harm (with confidence intervals) following the approach described by Altman (1998). [Suggested by Lucas Huggins]
• Documentation for epi.directadj updated.

epiR 2.0.24

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.kappa now handles n by n tables. [Suggested by Anita Tolpinrud]
• Inconsistency in calculation of test of significance of SMRs using Byar's method corrected. [Spotted by Zhou Weilong]

epiR 2.0.23

SIGNIFICANT USER-VISIBLE CHANGES

• New function epi.blcm.paras to return the number of unknown parameters to be inferred and the number of informative priors likely to be needed for an identifiable Bayesian latent class model to estimate diagnostic sensitivity and specificity in the absence of a gold standard. [Contributed by Simon Firestone, Allison Cheung and Nagendra Singanallur]
• Inconsistency in calculation of test of significance of SMRs using Byar's method corrected. [Spotted by Zhou Weilong]

epiR 2.0.21

SIGNIFICANT USER-VISIBLE CHANGES

• Major tidy up for epi.2by2. Function includes argument 'interpret' to return interpretive statements for each of the computed measures of association. epi.2by2 object now includes massoc.summary, massoc.interp and massoc.detail objects. [Suggested by Caitlin Pfeiffer and Petra Mullner]
• print(epi.2by2) now returns Yates corrected chi2 test if any of the cell frequencies are less than 5. [Suggested by Simon Firestone]

epiR 2.0.20

SIGNIFICANT USER-VISIBLE CHANGES

• rsu.dxtest code modified to check that appropriate values for test covariance have been used. Error returned when inappropriate values entered. The function now returns diagnostic sensitivity and specificity assuming tests are independent as well dependent. Documentation for rsu.dxtest updated with details on how to calculate argument covar. [Suggested by Barbara Moloney]

epiR 2.0.19 (2021-01-12)

SIGNIFICANT USER-VISIBLE CHANGES

• rsu.spp.rs code modified.
• Documentation for rsu.spp.rs, epi.psi and rsu.sssep.rs updated.

epiR 2.0.18

SIGNIFICANT USER-VISIBLE CHANGES

• Vignette on sample size calculations added.

epiR 2.0.17 (2020-12-04)

SIGNIFICANT USER-VISIBLE CHANGES

• epi.2by2 code modified to allow it handle the Haldane-Anscombe correction (i.e. addition of 0.5 to each cell of the 2 by 2 table when at least one of the cell frequencies is zero). [Suggested by Mark Stevenson]
• Error in confidence interval calculation for epi.smr where method = "byar" corrected. [Spotted by Sarah Haile]
• Vignette for surveillance functions updated.
• epi.2by2 calculates maximum likelihood confidence intervals for the odds ratio when the total number of events is less than 2E09, removing numeric overflow errors. [Suggested by Stuart Reece]
• New function epi.psi: Proportional similarity index to compare non-parametric frequency distributions.
• epi.prcc now includes confidence intervals. Example provided in the documentation for epi.prcc improved.
• Function epi.ssdetect returns sample size estimates using the binomial and hypergeometric distribution. [Suggested by Manuel Sanchez Vazquez]

epiR 2.0.1

SIGNIFICANT USER-VISIBLE CHANGES

• New function epi.ssdxtest: Sample size to validate a diagnostic test in the absence of a gold standard.
• Function epi.sssimpleestb modified to adjust the required sample size to account for imperfect diagnostic sensitivity and specificity.

epiR 2.0.0

SIGNIFICANT USER-VISIBLE CHANGES

• Major upgrade with amalgamation of epiR with Evan Sergeant's RSurveillance package.
• Function epi.insthaz now returns Kaplan-Meier survival estimates as well as instantaneous hazard.
• Argument nfractional added to each of the sample size functions.
• Inconsistency in reporting of results of epi.nomogram corrected. [Spotted by Pietro Ravani]

epiR 1.0-16

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.ssxsectn updated to calculate minimum detectable odds ratio for a cross-sectional study. Function epi.sscohortc updated to calculate minimum detectable odds ratio for a cohort study. [Suggested by Alex Hou]

epiR 1.0-15 (2020-06-14)

SIGNIFICANT USER-VISIBLE CHANGES

• Function epi.insthaz now handles stratified data. Examples in function documentation updated to reflect these changes.
• Argument rho in function epi.sscc changed to rho.cc to avoid confusion with rho used to represent the intracluster correlation coefficient. [Suggested by Xiaoqing Liu]
• Amibguity in documentation for epi.sscomps corrected. [Spotted by Marco Barbara]
• Function epi.2by2 now includes Taylor series confidence intervals for the incidence risk and prevalence ratio.

epiR 1.0-14 (2020-03-13)

SIGNIFICANT USER-VISIBLE CHANGES

• Long overdue vignette included.

epiR 1.0-13 (2020-02-27)

SIGNIFICANT USER-VISIBLE CHANGES

• epi.2by2 calculates Cornfield confidence intervals for the odds ratio when the total number of events is less than 500. This reduces computation time when cell frequencies are large. [Suggested by Jeff Canar]
• epi.ssdetect now uses the hypergeometric distribution to calculate sample size, removing the need to apply a finite correction factor. [Suggested by Manuel Sanchez Vazquez]
• epi.ssninfb Inconsistency in function documentation. [Spotted by Winston Mason] Fixed.

epiR 1.0-12

SIGNIFICANT USER-VISIBLE CHANGES

• New function epi.smr: Computes confidence intervals and tests of significance of the standardised mortality [morbidity] ratio.

epiR 1.0-11 (2020-01-23)

SIGNIFICANT USER-VISIBLE CHANGES

• epi.2by2 Inconsistency in variables returned from print(epi.2by2) and summary(epi.2by2) corrected. [Spotted by Jose G Conde Santiago]

epiR 1.0-10 (2019-11-24)

SIGNIFICANT USER-VISIBLE CHANGES

• epi.interaction Function now includes option to use either product or dummy parameterisation of interaction terms. Documentation updated. [Suggested by Francois M Carrier]
• New function epi.sscohortc: Sample size, power or minimum detectable incidence risk ratio for a cohort study using individual count data.
• New function epi.sscohortt: Sample size, power or minimum detectable incidence rate ratio for a cohort study using individual time data.
• New function epi.ssxsectn: Sample size, power or minimum detectable preva;ence ratio for a cross-sectional study.

epiR 1.0-06

SIGNIFICANT USER-VISIBLE CHANGES

• Functions to calculate sample size. Major revision of the naming of functions to calculate sample size.
• New function epi.ssclus1estb: Sample size to estimate a binary outcome using one-stage cluster sampling.

epiR 1.0-04

SIGNIFICANT USER-VISIBLE CHANGES

• epi.conf Error in incidence rate confidence interval calculation. [Spotted by Kazuki Yoshida] Fixed.
• epi.detectsize Inconsistency in function documentation. [Spotted by Jamie Madden] Fixed.
• epi.kappa Function returns an error if the number of rows and number of columns in the data table presented for analysis does not equal two. [Spotted by Maia Dolgopoloff] Fixed.

BUG FIXES

• epi.2by Anomalies in calculation of test of homogeneity in strata odds ratios and risk ratios corrected. Argument "homogeneity" removed from function. Woolf test of homogeneity reported by default for print(x, ...). Test statistics, degrees of freedom and p-values for Breslow Day and Woolf tests of homogeneity returned using summary(x, ...). [Spotted by Antonio A Lopes] Fixed.

epiR 1.0-01

SIGNIFICANT USER-VISIBLE CHANGES

• epi.2by Argument "homogeneity" removed from epi.2by2. Mantel-Haenszel (Woolf) test of homogeneity now reported by default for print(x, ...). Test statistics, degrees of freedom and p-values for Breslow Day and Woolf tests of homogeneity returned using summary(x, ...).

BUG FIXES

• epi.2by Anomalies in calculation of test of homogeneity in strata odds ratios and risk ratios corrected. Argument "homogeneity" removed from function. Woolf test of homogeneity reported by default for print(x, ...). Test statistics, degrees of freedom and p-values for Breslow Day and Woolf tests of homogeneity returned using summary(x, ...). [Spotted by Antonio A Lopes] Fixed.

epiR 0.9-98

SIGNIFICANT USER-VISIBLE CHANGES

• epi.prev Function does not truncate true prevalence estimates to values between 0 and 1. Warning issued when apparent prevalence is less than (1 - specificity). Additional references added to docuementation.

epiR 0.9-97 (2018-08-22)

BUG FIXES

• epi.prev Error in formatting of confidence intervals when method = "sterne" and method = "blaker". [Spotted by Salome Duerr] Fixed.
• epi.noninfb Study power estimation when r argument for epi.noninfb was not equal to 1 returned incorrect results. [Spotted by Aline Guttmann] Fixed.
• epi.interaction Error returned when model = coxph. [Spotted by Eirik Degerud] Fixed.
• epi.directadj Inconsistency in documentation. [Spotted by Jose G Conde Santiago] Fixed.