mirror of
https://github.com/msberends/AMR.git
synced 2026-11-16 03:40:48 +01:00
Merge remote-tracking branch 'origin/main' into breakpoints
This commit is contained in:
commit
d904ea5afb
23 files changed
+288
-83
No files matched your search
+29
-6
@@ -156,6 +156,10 @@
|
||||
#'
|
||||
#' **Prior distributions:** Pathogen incidence uses a non-informative \eqn{Dirichlet(1, 1, \ldots, 1)} prior. Susceptibility proportions use the Jeffreys prior, \eqn{\beta(0.5, 0.5)}, except for pathogen-drug combinations with known intrinsic resistance, which use a strongly informative \eqn{\beta(1, 9999)} prior that forces near-zero susceptibility regardless of observed data. Intrinsic resistance is determined using the [intrinsic_resistant] data set, which is based on `r format_eucast_version_nr(names(EUCAST_VERSION_EXPECTED_PHENOTYPES[1]))`.
|
||||
#'
|
||||
#' **Pathogens included in the model:** For each regimen (and group), only pathogens that occur in the data and have at least one test result for the regimen are included. Pathogens without any test result for a regimen do not contribute to its coverage, nor to its `n_total` in `long_numeric`. Use [retrieve_wisca_parameters()] to get the parameters that were used.
|
||||
#'
|
||||
#' **Rare pathogens and small groups:** Since every pathogen receives a prior weight of 1 in the Dirichlet distribution, the prior weighs heavily when there are few isolates relative to the number of pathogens, i.e., with pathogens found only once or a few times, or in small groups. This pulls the incidence towards a uniform distribution, and the very uncertain susceptibility of rare pathogens can then strongly lower the estimated coverage, without reflecting the clinical expectation. A warning is therefore given when this prior weight accounts for more than 5% of the pathogen incidence in any regimen (or group). Consider limiting the analysis to the most common pathogens using [top_n_microorganisms()], or using fewer and larger groups.
|
||||
#'
|
||||
#' **Interpreting the output:** Overlapping credible intervals between regimens indicate no significant difference in coverage; if a narrower-spectrum regimen overlaps with a broader one, the narrower-spectrum option may be preferred on stewardship grounds. Non-overlapping intervals indicate a clinically meaningful difference. For small sample sizes, consider pooling data from multiple sites to improve precision, provided pathogen distributions are sufficiently similar (Bielicki *et al.*, 2016).
|
||||
#'
|
||||
#' For the full mathematical derivation and worked examples, see the [WISCA vignette](https://amr-for-r.org/articles/WISCA.html).
|
||||
@@ -182,12 +186,13 @@
|
||||
#'
|
||||
#' # basic WISCA: empirical coverage per regimen, weighted by pathogen
|
||||
#' # incidence, with 95% credible intervals
|
||||
#' wisca(example_isolates,
|
||||
#' # (10 most common species, since rare species can distort coverage estimates)
|
||||
#' wisca(top_n_microorganisms(example_isolates, n = 10),
|
||||
#' antimicrobials = c("AMC", "AMC+CIP", "AMC+GEN")
|
||||
#' )
|
||||
#'
|
||||
#' # equivalent using antibiogram():
|
||||
#' antibiogram(example_isolates,
|
||||
#' antibiogram(top_n_microorganisms(example_isolates, n = 10),
|
||||
#' antimicrobials = c("AMC", "AMC+CIP", "AMC+GEN"),
|
||||
#' wisca = TRUE
|
||||
#' )
|
||||
@@ -272,7 +277,7 @@
|
||||
#'
|
||||
#' # Print the output for R Markdown / Quarto -----------------------------
|
||||
#'
|
||||
#' ureido <- wisca(example_isolates,
|
||||
#' ureido <- wisca(top_n_microorganisms(example_isolates, n = 10),
|
||||
#' antimicrobials = ureidopenicillins(),
|
||||
#' syndromic_group = "ward"
|
||||
#' )
|
||||
@@ -290,7 +295,7 @@
|
||||
#' antimicrobials = c("AMC", "CIP", "TZP", "TZP+TOB"),
|
||||
#' mo_transform = "gramstain"
|
||||
#' )
|
||||
#' ab2 <- wisca(example_isolates,
|
||||
#' ab2 <- wisca(top_n_microorganisms(example_isolates, n = 10),
|
||||
#' antimicrobials = c("AMC", "CIP", "TZP", "TZP+TOB"),
|
||||
#' syndromic_group = "ward"
|
||||
#' )
|
||||
@@ -744,7 +749,8 @@ antibiogram.default <- function(x,
|
||||
coverage = NA_real_,
|
||||
lower_ci = NA_real_,
|
||||
upper_ci = NA_real_,
|
||||
n_total = sum(n_total, na.rm = TRUE),
|
||||
# only pathogens with test results for the regimen enter the WISCA model, see below
|
||||
n_total = sum(n_total[which(n_tested > 0)]),
|
||||
n_tested = sum(n_tested, na.rm = TRUE),
|
||||
n_susceptible = sum(n_susceptible, na.rm = TRUE)
|
||||
)
|
||||
@@ -761,7 +767,24 @@ antibiogram.default <- function(x,
|
||||
out_wisca$group <- out_wisca$ab
|
||||
}
|
||||
|
||||
wisca_parameters <- out
|
||||
# only pathogens that occur in the group (n_total > 0) and have at least one test result for the regimen (n_tested > 0) may contribute to WISCA; otherwise, absent or untested pathogens would enter with prior-only parameters and bias the coverage downwards (#337)
|
||||
wisca_parameters <- out[which(out$n_total > 0 & out$n_tested > 0), , drop = FALSE]
|
||||
|
||||
# the Dirichlet prior of 1 per pathogen (Bielicki et al., 2016) weighs heavily when many pathogens are rare
|
||||
prior_share <- vapply(
|
||||
split(wisca_parameters$n_total, as.character(wisca_parameters$group)),
|
||||
function(n) length(n) / (length(n) + sum(n)),
|
||||
FUN.VALUE = numeric(1)
|
||||
)
|
||||
if (any(prior_share > 0.05)) {
|
||||
warning_(
|
||||
"In ", sum(prior_share > 0.05), " of ", length(prior_share), " WISCA regimen(s) or group(s), the prior weight of 1 per pathogen accounts for more than 5% of the pathogen incidence (up to ", round(max(prior_share) * 100, 1), "%), since there are few isolates relative to the number of pathogens, i.e., rare pathogens or a small group. ",
|
||||
"Because WISCA gives every pathogen a prior weight of 1 (Bielicki et al., 2016), this can strongly lower the estimated coverage without reflecting the clinical expectation. ",
|
||||
"Consider limiting the analysis to the most common pathogens with {.help [{.fun top_n_microorganisms}](AMR::top_n_microorganisms)}, or using fewer and larger groups.",
|
||||
call = FALSE
|
||||
)
|
||||
}
|
||||
|
||||
wisca_draws <- list()
|
||||
wisca_components <- list()
|
||||
|
||||
|
||||
@@ -1144,7 +1144,10 @@ print.mo_renamed <- function(x, extra_txt = "", n = 25, ...) {
|
||||
rows <- seq_len(min(NROW(x), n))
|
||||
|
||||
message_("The following microorganism", ifelse(NROW(x) > 1, "s were", " was"), " taxonomically renamed", extra_txt, ":")
|
||||
old_format <- format(paste0(font_italic(x$old[rows], collapse = NULL), x$ref_old[rows])) # format() will set trailing spaces for textual alignment
|
||||
old_format <- paste0(font_italic(x$old[rows], collapse = NULL), x$ref_old[rows])
|
||||
# pad based on the visible width, since format() counts ANSI codes as characters
|
||||
visible_width <- nchar(font_stripstyle(old_format), type = "width")
|
||||
old_format <- paste0(old_format, strrep(" ", max(visible_width) - visible_width))
|
||||
old_format <- gsub(" ", "\u00a0", old_format, fixed = TRUE)
|
||||
for (old_tax in rows) {
|
||||
message_("\u00a0\u00a0", AMR_env$bullet_icon, " ", old_format[old_tax], " -> ", font_italic(x$new[old_tax]), x$ref_new[old_tax], as_note = FALSE)
|
||||
|
||||
Reference in new issue
Block a user