The fourth minor release of the superspreading package contains new functionality, a new vignette and various minor improvements to documentation.
With this release the development status of the package has been updated from experimental to stable.
The probability_emergence() function has been added to calculate the probability that a pathogen introduced to humans can evolve and emerge to cause a sustained human-to-human outbreak, implementing and extending the framework of Antia et al. (2003) (#124, #133).
A new vignette, emergence.Rmd, has been added that covers the functionality of probability_emergence() and reproduces the two figures from Antia et al. (2003) as well as a figure using the multiple introductions extension (#124, #133).
Alt-text has been added to all plots across all vignettes (#129).
percent_transmission argument in proportion_transmission() has been renamed to prop_transmission (#130).An .aspell/ folder is added to the package including defaults.R and superspreading.rds to supply a wordlist to the CRAN spell checking to avoid quoting names in the DESCRIPTION (#127).
Package and function documentation has been updated. Vignette changes include minor reworking of text, updating any information or links that were outdated; function documentation is styled more consistently and follows the Tidyverse style guide (#131, #134).
Internal code style has been updated to adhere to current best practice (#125).
The package lifecycle badge has been updated from experimental to stable. CRAN status, CRAN downloads, repo status and Zenodo DOI badges have been added to the README (#119, #132).
The {pkgdown} development: mode has been set to auto now the package is hosted on CRAN (#118).
The third minor release of the superspreading package contains enhancements to several functions and a new vignette.
We are also pleased to welcome Dillon Adam (@dcadam) as a new package author for his contributions towards this version.
proportion_transmission() function has been expanded to incorporate a new method. The new method calculates the proportion of transmission from X% the most infectious individuals, corresponding to the Lloyd-Smith et al. (2005) calculation. The proportion_transmission() has a new method argument to toggle between the two calculations (@dcadam, #99).proportion_transmission() function (#101).bpmodels::chain_sim(), is added to the {superspreading} package (#103). @sbfnk is added as copyright holder and @jamesmbaazam as a contributor.probability_contain() is enhanced to enable to probability of containment within a certain amount of time since the outbreak started. This adds outbreak_time and generation_time arguments to probability_contain(). This addition is backwards compatible as by default the time is unlimited, outbreak_time = Inf, and no generation time is required.stochastic argument in probability_contain() has been renamed simulate to be consistent with other functions (#103).proportion_*() functions are now formatted to significant figures rather than rounding to prevent small values being rounded to zero (#102).rmarkdown::html_vignette instead of bookdown::html_vignette2 and as_is: true has been removed due to changes to {pkgdown} in v2.1.0. {bookdown} has been removed as a suggested package and code folding is removed from vignettes. KaTeX headers have been added to _pkgdown.yml for correct math rendering (#104 & #109).get_epidist_params() internal function has been renamed get_epiparameter_params() since {epiparameter} renamed the <epidist> class to <epiparameter> (#100).R and k) or provides an <epiparameter> object is now in .check_input_params() (#111).Second minor release of superspreading. This release enhances functions added in v0.1.0 and adds two new exported functions, and two new vignettes.
calc_network_R()) to estimate the reproduction number for heterogeneous networks and a vignette outlining use cases for the function from existing epidemiological literature is added (#71).probability_epidemic() and probability_extinct() now have individual-level and population-level control in a joint framework (#70).proportion_*() functions can now return proportion columns of the output <data.frame> as numeric when the new argument format_prop is set to FALSE (#72).ic_tbl()) to improve model comparison tables (#65).probability_*() functions now accept dynamic dots ({rlang} is added as a dependency) (#82).ind_control and pop_control arguments replace control and control_type arguments in probability_contain(); and the argument default for num_init_infect is removed (#70).epidist argument to offspring_dist to follow Epiverse style (affects several functions) (#64).proportion_transmission() has been renamed from sim to simulate (#81).optim() by default (#82).Initial release of superspreading, an R package to estimate individual-level variation in disease transmission and provide summary metrics for superspreading events.