From 68a9a35ed659e90674d77e30b8010cb9ef0ce53a Mon Sep 17 00:00:00 2001 From: "Matthijs S. Berends" Date: Thu, 21 Feb 2019 18:55:52 +0100 Subject: [PATCH] algorithm update --- DESCRIPTION | 2 +- R/amr.R | 67 +++ R/atc_online.R | 1 + R/availability.R | 1 + R/data.R | 1 + R/mo.R | 275 ++++------- R/mo_property.R | 2 +- R/zzz.R | 291 +---------- _pkgdown.yml | 1 - docs/articles/AMR.html | 461 +++++++++--------- .../AMR_files/figure-html/plot 1-1.png | Bin 33861 -> 33765 bytes .../AMR_files/figure-html/plot 3-1.png | Bin 21118 -> 21104 bytes .../AMR_files/figure-html/plot 4-1.png | Bin 69619 -> 69613 bytes .../AMR_files/figure-html/plot 5-1.png | Bin 51369 -> 51365 bytes docs/articles/EUCAST.html | 2 +- docs/articles/G_test.html | 2 +- docs/articles/SPSS.html | 2 +- docs/articles/WHONET.html | 2 +- docs/articles/atc_property.html | 2 +- docs/articles/benchmarks.html | 117 ++--- .../figure-html/unnamed-chunk-5-1.png | Bin 0 -> 32533 bytes .../figure-html/unnamed-chunk-5-2.png | Bin 0 -> 33108 bytes docs/articles/freq.html | 2 +- docs/articles/mo_property.html | 2 +- docs/articles/resistance_predict.html | 2 +- docs/index.html | 4 +- docs/reference/AMR-deprecated.html | 3 +- docs/reference/AMR.html | 11 +- docs/reference/WHOCC.html | 3 +- docs/reference/WHONET.html | 3 +- docs/reference/abname.html | 3 +- docs/reference/age.html | 3 +- docs/reference/age_groups.html | 3 +- docs/reference/antibiotics.html | 3 +- docs/reference/as.atc.html | 3 +- docs/reference/as.mic.html | 3 +- docs/reference/as.mo.html | 3 +- docs/reference/as.rsi.html | 3 +- docs/reference/atc_online.html | 7 + docs/reference/atc_property.html | 3 +- docs/reference/availability.html | 7 + docs/reference/catalogue_of_life.html | 3 +- docs/reference/catalogue_of_life_version.html | 7 + docs/reference/count.html | 3 +- docs/reference/eucast_rules.html | 3 +- docs/reference/first_isolate.html | 3 +- docs/reference/freq.html | 3 +- docs/reference/g.test.html | 3 +- docs/reference/get_locale.html | 3 +- docs/reference/ggplot_rsi.html | 3 +- docs/reference/guess_ab_col.html | 3 +- docs/reference/join.html | 3 +- docs/reference/key_antibiotics.html | 3 +- docs/reference/kurtosis.html | 3 +- docs/reference/like.html | 3 +- docs/reference/mdro.html | 3 +- docs/reference/microorganisms.codes.html | 3 +- docs/reference/microorganisms.html | 3 +- docs/reference/microorganisms.old.html | 3 +- docs/reference/mo_property.html | 5 +- docs/reference/mo_source.html | 3 +- docs/reference/p.symbol.html | 3 +- docs/reference/portion.html | 3 +- docs/reference/read.4D.html | 3 +- docs/reference/resistance_predict.html | 3 +- docs/reference/septic_patients.html | 3 +- docs/reference/skewness.html | 3 +- index.md | 4 +- man/AMR-deprecated.Rd | 1 - man/AMR.Rd | 11 +- man/WHOCC.Rd | 1 - man/WHONET.Rd | 1 - man/abname.Rd | 1 - man/age.Rd | 1 - man/age_groups.Rd | 1 - man/antibiotics.Rd | 1 - man/as.atc.Rd | 1 - man/as.mic.Rd | 1 - man/as.mo.Rd | 1 - man/as.rsi.Rd | 1 - man/atc_online.Rd | 5 + man/atc_property.Rd | 1 - man/availability.Rd | 5 + man/catalogue_of_life.Rd | 1 - man/catalogue_of_life_version.Rd | 5 + man/count.Rd | 1 - man/eucast_rules.Rd | 1 - man/first_isolate.Rd | 1 - man/freq.Rd | 1 - man/g.test.Rd | 1 - man/get_locale.Rd | 1 - man/ggplot_rsi.Rd | 1 - man/guess_ab_col.Rd | 1 - man/join.Rd | 1 - man/key_antibiotics.Rd | 1 - man/kurtosis.Rd | 1 - man/like.Rd | 1 - man/mdro.Rd | 1 - man/microorganisms.Rd | 1 - man/microorganisms.codes.Rd | 1 - man/microorganisms.old.Rd | 1 - man/mo_property.Rd | 3 +- man/mo_source.Rd | 1 - man/p.symbol.Rd | 1 - man/portion.Rd | 1 - man/read.4D.Rd | 1 - man/resistance_predict.Rd | 1 - man/septic_patients.Rd | 1 - man/skewness.Rd | 1 - tests/testthat/test-data.R | 5 + vignettes/SPSS.Rmd | 2 +- vignettes/benchmarks.Rmd | 12 +- 112 files changed, 586 insertions(+), 886 deletions(-) create mode 100644 R/amr.R create mode 100644 docs/articles/benchmarks_files/figure-html/unnamed-chunk-5-1.png create mode 100644 docs/articles/benchmarks_files/figure-html/unnamed-chunk-5-2.png diff --git a/DESCRIPTION b/DESCRIPTION index d82496bb..1bda40fc 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: AMR Version: 0.5.0.9018 -Date: 2019-02-20 +Date: 2019-02-21 Title: Antimicrobial Resistance Analysis Authors@R: c( person( diff --git a/R/amr.R b/R/amr.R new file mode 100644 index 00000000..bdbc9b5a --- /dev/null +++ b/R/amr.R @@ -0,0 +1,67 @@ +# ==================================================================== # +# TITLE # +# Antimicrobial Resistance (AMR) Analysis # +# # +# SOURCE # +# https://gitlab.com/msberends/AMR # +# # +# LICENCE # +# (c) 2019 Berends MS (m.s.berends@umcg.nl), Luz CF (c.f.luz@umcg.nl) # +# # +# This R package is free software; you can freely use and distribute # +# it for both personal and commercial purposes under the terms of the # +# GNU General Public License version 2.0 (GNU GPL-2), as published by # +# the Free Software Foundation. # +# # +# This R package was created for academic research and was publicly # +# released in the hope that it will be useful, but it comes WITHOUT # +# ANY WARRANTY OR LIABILITY. # +# Visit our website for more info: https://msberends.gitab.io/AMR. # +# ==================================================================== # + +#' The \code{AMR} Package +#' +#' Welcome to the \code{AMR} package. +#' @details +#' \code{AMR} is a free and open-source R package to simplify the analysis and prediction of Antimicrobial Resistance (AMR) and to work with microbial and antimicrobial properties by using evidence-based methods. It supports any table format, including WHONET/EARS-Net data. +#' +#' We created this package for both academic research and routine analysis at the Faculty of Medical Sciences of the University of Groningen and the Medical Microbiology & Infection Prevention (MMBI) department of the University Medical Center Groningen (UMCG). This R package is actively maintained and free software; you can freely use and distribute it for both personal and commercial (but not patent) purposes under the terms of the GNU General Public License version 2.0 (GPL-2), as published by the Free Software Foundation. +#' +#' This package can be used for: +#' \itemize{ +#' \item{Reference for microorganisms, since it contains almost all 60,000 microbial (sub)species from the Catalogue of Life} +#' \item{Calculating antimicrobial resistance} +#' \item{Calculating empirical susceptibility of both mono therapy and combination therapy} +#' \item{Predicting future antimicrobial resistance using regression models} +#' \item{Getting properties for any microorganism (like Gram stain, species, genus or family)} +#' \item{Getting properties for any antibiotic (like name, ATC code, defined daily dose or trade name)} +#' \item{Plotting antimicrobial resistance} +#' \item{Determining first isolates to be used for AMR analysis} +#' \item{Applying EUCAST expert rules (not the translation from MIC to RSI values)} +#' \item{Determining multi-drug resistant organisms (MDRO)} +#' \item{Descriptive statistics: frequency tables, kurtosis and skewness} +#' } +#' @section Authors: +#' Matthijs S. Berends[1,2] Christian F. Luz[1], Erwin E.A. Hassing[2], Corinna Glasner[1], Alex W. Friedrich[1], Bhanu N.M. Sinha[1] \cr +#' +#' [1] Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - \url{rug.nl} \url{umcg.nl} \cr +#' [2] Certe Medical Diagnostics & Advice, Groningen, the Netherlands - \url{certe.nl} + +#' @section Read more on our website!: +#' On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. + +#' @section Contact us: +#' For suggestions, comments or questions, please contact us at: +#' +#' Matthijs S. Berends \cr +#' m.s.berends [at] umcg [dot] nl \cr +#' Department of Medical Microbiology, University of Groningen \cr +#' University Medical Center Groningen \cr +#' Post Office Box 30001 \cr +#' 9700 RB Groningen +#' +#' If you have found a bug, please file a new issue at: \cr +#' \url{https://gitlab.com/msberends/AMR/issues} +#' @name AMR +#' @rdname AMR +NULL diff --git a/R/atc_online.R b/R/atc_online.R index 77bbad0e..c201b51a 100644 --- a/R/atc_online.R +++ b/R/atc_online.R @@ -56,6 +56,7 @@ #' @export #' @rdname atc_online #' @importFrom dplyr %>% progress_estimated +#' @inheritSection AMR Read more on our website! #' @source \url{https://www.whocc.no/atc_ddd_alterations__cumulative/ddd_alterations/abbrevations/} #' @examples #' \donttest{ diff --git a/R/availability.R b/R/availability.R index a120430d..d3fc71b1 100644 --- a/R/availability.R +++ b/R/availability.R @@ -24,6 +24,7 @@ #' Easy check for availability of columns in a data set. This makes it easy to get an idea of which antibiotic combination can be used for calculation with e.g. \code{\link{portion_IR}}. #' @param tbl a \code{data.frame} or \code{list} #' @return \code{data.frame} with column names of \code{tbl} as row names and columns: \code{percent_IR}, \code{count}, \code{percent}, \code{visual_availability}. +#' @inheritSection AMR Read more on our website! #' @export #' @examples #' availability(septic_patients) diff --git a/R/data.R b/R/data.R index 85e4c27d..6e8d1840 100755 --- a/R/data.R +++ b/R/data.R @@ -170,6 +170,7 @@ catalogue_of_life <- list( #' Version info of included Catalogue of Life #' @seealso \code{\link{microorganisms}} #' @inheritSection catalogue_of_life Catalogue of Life +#' @inheritSection AMR Read more on our website! #' @export catalogue_of_life_version <- function() { list(version = catalogue_of_life$version, diff --git a/R/mo.R b/R/mo.R index e2550ed8..cd495022 100755 --- a/R/mo.R +++ b/R/mo.R @@ -304,11 +304,13 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE, # add start en stop regex x <- paste0('^', x, '$') x_withspaces_start_only <- paste0('^', x_withspaces) + x_withspaces_end_only <- paste0(x_withspaces, '$') x_withspaces_start_end <- paste0('^', x_withspaces, '$') # cat(paste0('x "', x, '"\n')) # cat(paste0('x_species "', x_species, '"\n')) # cat(paste0('x_withspaces_start_only "', x_withspaces_start_only, '"\n')) + # cat(paste0('x_withspaces_end_only "', x_withspaces_end_only, '"\n')) # cat(paste0('x_withspaces_start_end "', x_withspaces_start_end, '"\n')) # cat(paste0('x_backup "', x_backup, '"\n')) # cat(paste0('x_trimmed "', x_trimmed, '"\n')) @@ -494,194 +496,113 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE, } } - # FIRST TRY SUPERPREVALENT IN HUMAN INFECTIONS ---- - found <- microorganisms.superprevDT[tolower(fullname) %in% tolower(c(x_backup[i], x_trimmed[i])), ..property][[1]] - # most probable: is exact match in fullname - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.superprevDT[mo == toupper(x_backup[i]), ..property][[1]] - # is a valid mo - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.superprevDT[tolower(fullname) == tolower(x_trimmed_without_group[i]), ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } + check_per_prevalence <- function(data_to_check, + a.x_backup, + b.x_trimmed, + c.x_trimmed_without_group, + d.x_withspaces_start_end, + e.x_withspaces_start_only, + f.x_withspaces_end_only) { - # try any match keeping spaces ---- - found <- microorganisms.superprevDT[fullname %like% x_withspaces_start_end[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - - # try any match keeping spaces, not ending with $ ---- - found <- microorganisms.superprevDT[fullname %like% x_withspaces_start_only[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - - # try any match diregarding spaces ---- - found <- microorganisms.superprevDT[fullname %like% x[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - - # try splitting of characters in the middle and then find ID ---- - # only when text length is 6 or lower - # like esco = E. coli, klpn = K. pneumoniae, stau = S. aureus, staaur = S. aureus - if (nchar(x_trimmed[i]) <= 6) { - x_length <- nchar(x_trimmed[i]) - x[i] <- paste0(x_trimmed[i] %>% substr(1, x_length / 2), - '.* ', - x_trimmed[i] %>% substr((x_length / 2) + 1, x_length)) - found <- microorganisms.superprevDT[fullname %like% paste0('^', x[i]), ..property][[1]] + found <- data_to_check[tolower(fullname) %in% tolower(c(a.x_backup, b.x_trimmed)), ..property][[1]] + # most probable: is exact match in fullname if (length(found) > 0) { - x[i] <- found[1L] - next + return(found[1L]) } - } - # try fullname without start and stop regex, to also find subspecies ---- - # like "K. pneu rhino" >> "Klebsiella pneumoniae (rhinoscleromatis)" = KLEPNERH - found <- microorganisms.superprevDT[fullname %like% x_withspaces_start_only[i], ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } - - # TRY PREVALENT IN HUMAN INFECTIONS ---- - found <- microorganisms.prevDT[tolower(fullname) %in% tolower(c(x_backup[i], x_trimmed[i])), ..property][[1]] - # most probable: is exact match in fullname - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.prevDT[mo == toupper(x_backup[i]), ..property][[1]] - # is a valid mo - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.prevDT[tolower(fullname) == tolower(x_trimmed_without_group[i]), ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } - - # try any match keeping spaces ---- - found <- microorganisms.prevDT[fullname %like% x_withspaces_start_end[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - - # try any match keeping spaces, not ending with $ ---- - found <- microorganisms.prevDT[fullname %like% x_withspaces_start_only[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - - # try any match diregarding spaces ---- - found <- microorganisms.prevDT[fullname %like% x[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - - # try splitting of characters in the middle and then find ID ---- - # only when text length is 6 or lower - # like esco = E. coli, klpn = K. pneumoniae, stau = S. aureus, staaur = S. aureus - if (nchar(x_trimmed[i]) <= 6) { - x_length <- nchar(x_trimmed[i]) - x[i] <- paste0(x_trimmed[i] %>% substr(1, x_length / 2), - '.* ', - x_trimmed[i] %>% substr((x_length / 2) + 1, x_length)) - found <- microorganisms.prevDT[fullname %like% paste0('^', x[i]), ..property][[1]] + found <- data_to_check[mo == toupper(a.x_backup), ..property][[1]] + # is a valid mo if (length(found) > 0) { - x[i] <- found[1L] - next + return(found[1L]) } + found <- data_to_check[tolower(fullname) == tolower(c.x_trimmed_without_group), ..property][[1]] + if (length(found) > 0) { + return(found[1L]) + } + + # try any match keeping spaces ---- + found <- data_to_check[fullname %like% d.x_withspaces_start_end, ..property][[1]] + if (length(found) > 0 & nchar(b.x_trimmed) >= 6) { + return(found[1L]) + } + + # try any match keeping spaces, not ending with $ ---- + found <- data_to_check[fullname %like% paste0(trimws(e.x_withspaces_start_only), " "), ..property][[1]] + if (length(found) > 0) { + return(found[1L]) + } + found <- data_to_check[fullname %like% e.x_withspaces_start_only, ..property][[1]] + if (length(found) > 0 & nchar(b.x_trimmed) >= 6) { + return(found[1L]) + } + + # try any match keeping spaces, not start with ^ ---- + found <- data_to_check[fullname %like% paste0(" ", trimws(f.x_withspaces_end_only)), ..property][[1]] + if (length(found) > 0) { + return(found[1L]) + } + found <- data_to_check[fullname %like% f.x_withspaces_end_only, ..property][[1]] + if (length(found) > 0 & nchar(b.x_trimmed) >= 6) { + return(found[1L]) + } + + # try splitting of characters in the middle and then find ID ---- + # only when text length is 6 or lower + # like esco = E. coli, klpn = K. pneumoniae, stau = S. aureus, staaur = S. aureus + if (nchar(b.x_trimmed) <= 6) { + x_length <- nchar(b.x_trimmed) + x_split <- paste0("^", + b.x_trimmed %>% substr(1, x_length / 2), + '.* ', + b.x_trimmed %>% substr((x_length / 2) + 1, x_length)) + found <- data_to_check[fullname %like% x_split, ..property][[1]] + if (length(found) > 0) { + return(found[1L]) + } + } + + # try fullname without start and without nchar limit of >= 6 ---- + # like "K. pneu rhino" >> "Klebsiella pneumoniae (rhinoscleromatis)" = KLEPNERH + found <- data_to_check[fullname %like% e.x_withspaces_start_only, ..property][[1]] + if (length(found) > 0) { + return(found[1L]) + } + + # didn't found any + return(NA_character_) } - # try fullname without start and stop regex, to also find subspecies ---- - # like "K. pneu rhino" >> "Klebsiella pneumoniae (rhinoscleromatis)" = KLEPNERH - found <- microorganisms.prevDT[fullname %like% x_withspaces_start_only[i], ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] + # FIRST TRY VERY PREVALENT IN HUMAN INFECTIONS ---- + x[i] <- check_per_prevalence(data_to_check = microorganismsDT[prevalence == 1], + a.x_backup = x_backup[i], + b.x_trimmed = x_trimmed[i], + c.x_trimmed_without_group = x_trimmed_without_group[i], + d.x_withspaces_start_end = x_withspaces_start_end[i], + e.x_withspaces_start_only = x_withspaces_start_only[i], + f.x_withspaces_end_only = x_withspaces_end_only[i]) + if (!is.na(x[i])) { + next + } + # THEN TRY PREVALENT IN HUMAN INFECTIONS ---- + x[i] <- check_per_prevalence(data_to_check = microorganismsDT[prevalence == 2], + a.x_backup = x_backup[i], + b.x_trimmed = x_trimmed[i], + c.x_trimmed_without_group = x_trimmed_without_group[i], + d.x_withspaces_start_end = x_withspaces_start_end[i], + e.x_withspaces_start_only = x_withspaces_start_only[i], + f.x_withspaces_end_only = x_withspaces_end_only[i]) + if (!is.na(x[i])) { next } - # THEN UNPREVALENT IN HUMAN INFECTIONS ---- - found <- microorganisms.unprevDT[tolower(fullname) == tolower(x_backup[i]), ..property][[1]] - # most probable: is exact match in fullname - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.unprevDT[tolower(fullname) == tolower(x_trimmed[i]), ..property][[1]] - # most probable: is exact match in fullname - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.unprevDT[mo == toupper(x_backup[i]), ..property][[1]] - # is a valid mo - if (length(found) > 0) { - x[i] <- found[1L] - next - } - found <- microorganisms.unprevDT[tolower(fullname) == tolower(x_trimmed_without_group[i]), ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } - # try any match keeping spaces ---- - found <- microorganisms.unprevDT[fullname %like% x_withspaces_start_end[i], ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } - # try any match keeping spaces, not ending with $ ---- - found <- microorganisms.unprevDT[fullname %like% x_withspaces_start_only[i], ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } - # try any match diregarding spaces ---- - found <- microorganisms.unprevDT[fullname %like% x[i], ..property][[1]] - if (length(found) > 0 & nchar(x_trimmed[i]) >= 6) { - x[i] <- found[1L] - next - } - # try splitting of characters in the middle and then find ID ---- - # only when text length is 6 or lower - # like esco = E. coli, klpn = K. pneumoniae, stau = S. aureus, staaur = S. aureus - if (nchar(x_trimmed[i]) <= 6) { - x_length <- nchar(x_trimmed[i]) - x[i] <- paste0(x_trimmed[i] %>% substr(1, x_length / 2), - '.* ', - x_trimmed[i] %>% substr((x_length / 2) + 1, x_length)) - found <- microorganisms.unprevDT[fullname %like% paste0('^', x[i]), ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] - next - } - } - - # try fullname without start and stop regex, to also find subspecies ---- - # like "K. pneu rhino" >> "Klebsiella pneumoniae (rhinoscleromatis)" = KLEPNERH - found <- microorganisms.unprevDT[fullname %like% x_withspaces_start_only[i], ..property][[1]] - if (length(found) > 0) { - x[i] <- found[1L] + x[i] <- check_per_prevalence(data_to_check = microorganismsDT[prevalence == 3], + a.x_backup = x_backup[i], + b.x_trimmed = x_trimmed[i], + c.x_trimmed_without_group = x_trimmed_without_group[i], + d.x_withspaces_start_end = x_withspaces_start_end[i], + e.x_withspaces_start_only = x_withspaces_start_only[i], + f.x_withspaces_end_only = x_withspaces_end_only[i]) + if (!is.na(x[i])) { next } diff --git a/R/mo_property.R b/R/mo_property.R index 82b409c3..cc938e1f 100755 --- a/R/mo_property.R +++ b/R/mo_property.R @@ -125,7 +125,7 @@ #' language = "nl") # "Streptococcus groep A" #' #' -#' # Get a list with the complete taxonomy (subkingdom to subspecies) +#' # Get a list with the complete taxonomy (kingdom to subspecies) #' mo_taxonomy("E. coli") mo_fullname <- function(x, language = get_locale(), ...) { x <- mo_validate(x = x, property = "fullname", ...) diff --git a/R/zzz.R b/R/zzz.R index 4e3c2bef..349055cb 100755 --- a/R/zzz.R +++ b/R/zzz.R @@ -19,53 +19,7 @@ # Visit our website for more info: https://msberends.gitab.io/AMR. # # ==================================================================== # -#' The \code{AMR} Package -#' -#' Welcome to the \code{AMR} package. -#' @details -#' \code{AMR} is a free and open-source R package to simplify the analysis and prediction of Antimicrobial Resistance (AMR) and to work with microbial and antimicrobial properties by using evidence-based methods. It supports any table format, including WHONET/EARS-Net data. -#' -#' We created this package for both academic research and routine analysis at the Faculty of Medical Sciences of the University of Groningen and the Medical Microbiology & Infection Prevention (MMBI) department of the University Medical Center Groningen (UMCG). This R package is actively maintained and free software; you can freely use and distribute it for both personal and commercial (but not patent) purposes under the terms of the GNU General Public License version 2.0 (GPL-2), as published by the Free Software Foundation. -#' -#' This package can be used for: -#' \itemize{ -#' \item{Calculating antimicrobial resistance} -#' \item{Predicting antimicrobial resistance using regression models} -#' \item{Getting properties for any microorganism (like Gram stain, species, genus or family)} -#' \item{Getting properties for any antibiotic (like name, ATC code, defined daily dose or trade name)} -#' \item{Plotting antimicrobial resistance} -#' \item{Determining first isolates to be used for AMR analysis} -#' \item{Applying EUCAST rules} -#' \item{Determining multi-drug resistance organisms (MDRO)} -#' \item{Descriptive statistics: frequency tables, kurtosis and skewness} -#' } -#' @section Authors: -#' Matthijs S. Berends[1,2] Christian F. Luz[1], Erwin E.A. Hassing[2], Corinna Glasner[1], Alex W. Friedrich[1], Bhanu N.M. Sinha[1] \cr -#' -#' [1] Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - \url{rug.nl} \url{umcg.nl} \cr -#' [2] Certe Medical Diagnostics & Advice, Groningen, the Netherlands - \url{certe.nl} - -#' @section Read more on our website!: -#' \if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} -#' On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. - -#' @section Contact us: -#' For suggestions, comments or questions, please contact us at: -#' -#' Matthijs S. Berends \cr -#' m.s.berends [at] umcg [dot] nl \cr -#' Department of Medical Microbiology, University of Groningen \cr -#' University Medical Center Groningen \cr -#' Post Office Box 30001 \cr -#' 9700 RB Groningen -#' -#' If you have found a bug, please file a new issue at: \cr -#' \url{https://gitlab.com/msberends/AMR/issues} -#' @name AMR -#' @rdname AMR -NULL - -#' @importFrom dplyr mutate +#' @importFrom dplyr mutate case_when #' @importFrom data.table as.data.table setkey .onLoad <- function(libname, pkgname) { # get new functions not available in older versions of R @@ -80,31 +34,27 @@ NULL # packageStartupMessage("Loading taxonomic database...", appendLF = FALSE) microorganismsDT <- AMR::microorganisms %>% - mutate(prevalent = ifelse(phylum %in% c("Proteobacteria", - "Firmicutes", - "Actinobacteria", - "Bacteroidetes") - | genus %in% c("Candida", - "Aspergillus", - "Trichophyton", - "Giardia", - "Dientamoeba", - "Entamoeba"), - 0, - 1), - superprevalent = ifelse( - # most important Gram negatives - class == "Gammaproteobacteria" - # Streptococci and Staphylococci - | order %in% c("Lactobacillales", - "Bacillales"), - 0, - 1)) %>% + mutate(prevalence = case_when( + # most important Gram negatives # Streptococci and Staphylococci + class == "Gammaproteobacteria" + | order %in% c("Lactobacillales", "Bacillales") + ~ 1, + phylum %in% c("Proteobacteria", + "Firmicutes", + "Actinobacteria", + "Bacteroidetes") + | genus %in% c("Candida", + "Aspergillus", + "Trichophyton", + "Giardia", + "Dientamoeba", + "Entamoeba") + ~ 2, + TRUE ~ 3 + )) %>% as.data.table() - setkey(microorganismsDT, kingdom, superprevalent, prevalent, fullname) - microorganisms.superprevDT <- microorganismsDT[superprevalent == 0,] - microorganisms.prevDT <- microorganismsDT[superprevalent == 1 & prevalent == 0,] - microorganisms.unprevDT <- microorganismsDT[superprevalent == 1 & prevalent == 1,] + setkey(microorganismsDT, kingdom, prevalence, fullname) + microorganisms.oldDT <- as.data.table(AMR::microorganisms.old) setkey(microorganisms.oldDT, col_id, fullname) @@ -112,209 +62,12 @@ NULL value = microorganismsDT, envir = asNamespace("AMR")) - assign(x = "microorganisms.superprevDT", - value = microorganisms.superprevDT, - envir = asNamespace("AMR")) - - assign(x = "microorganisms.prevDT", - value = microorganisms.prevDT, - envir = asNamespace("AMR")) - - assign(x = "microorganisms.unprevDT", - value = microorganisms.unprevDT, - envir = asNamespace("AMR")) - assign(x = "microorganisms.oldDT", value = microorganisms.oldDT, envir = asNamespace("AMR")) # conversion of old MO codes from v0.5.0 (ITIS) to later versions (Catalogue of Life) - mo_codes_v0.5.0 <- c(B_ACHRMB = "B_ACHRM", B_ANNMA = "B_ACTNS", B_ACLLS = "B_ALCYC", - B_AHNGM = "B_ARCHN", B_ARMTM = "B_ARMTMN", B_ARTHRS = "B_ARTHR", - B_APHLS = "B_AZRHZP", B_BRCHA = "B_BRCHY", B_BCTRM = "B_BRVBCT", - B_CLRBCT = "B_CLRBC", B_CTRDM = "B_CLSTR", B_CPRMM = "B_CYLND", - B_DLCLN = "B_DPLCL", B_DMCLM = "B_DSLFT", B_DSLFVB = "B_DSLFV", - B_FCTRM = "B_FSBCT", B_GNRLA = "B_GRDNR", B_HNRBM = "B_HLNRB", - B_HPHGA = "B_HNPHGA", B_HCCCS = "B_HYDRC", B_MCRCLS = "B_MCRCL", - B_MTHYLS = "B_MLSMA", B_MARCLS = "B_MRCLS", B_MGCLS = "B_MSTGC", - B_MCLLA = "B_MTHYLC", B_MYCPLS = "B_MYCPL", B_NBCTR = "B_NTRBC", - B_OCLLS = "B_OCNBC", B_PTHRX = "B_PLNKT", B_PCCCS = "B_PRCHL", - B_PSPHN = "B_PRPHY", B_PDMNS = "B_PSDMN", B_SCCHRP = "B_SCCHR", - B_SRBCTR = "B_SHRBCTR", B_STRPTC = "B_STRPT", B_SHMNS = "B_SYNTR", - B_TRBCTR = "B_THRMN", P_ALBMN = "C_ABMNA", F_ACHLY = "C_ACHLY", - P_ACINT = "C_ACINT", P_ARTCL = "C_ACLNA", P_ACRVL = "C_ACRVL", - P_ADRCT = "C_ADRCT", P_AMPHS = "C_AHSRS", F_ALBUG = "C_ALBUG", - P_ALCNT = "C_ALCNT", P_ALFRD = "C_ALFRD", P_ALLGR = "C_ALLGR", - P_AMPHL = "C_ALPTS", F_ALTHR = "C_ALTHR", P_AMLLA = "C_AMLLA", - P_ANMLN = "C_AMLNA", P_AMMBC = "C_AMMBC", P_AMMDS = "C_AMMDS", - P_AMMLG = "C_AMMLG", P_AMMMR = "C_AMMMR", P_AMMMS = "C_AMMMS", - P_AMMON = "C_AMMON", P_AMMSC = "C_AMMSC", P_AMMSP = "C_AMMSP", - P_AMMST = "C_AMMST", P_AMMTM = "C_AMMTM", F_AMYCS = "C_AMYCS", - P_ANARM = "C_ANARM", P_ANGLD = "C_ANGLD", P_ANGLG = "C_ANGLG", - P_ANNLC = "C_ANNLC", F_ANSLP = "C_ANSLP", F_APDCH = "C_APDCH", - F_APHND = "C_APHND", F_APLNC = "C_APLNC", F_AQLND = "C_AQLND", - P_ARCHS = "C_ARCHAS", P_ASTRN = "C_ARNNN", P_ARNPR = "C_ARNPR", - F_ARSPR = "C_ARSPR", P_ARTST = "C_ARTSTR", P_AMPHC = "C_ARYNA", - P_ASCHM = "C_ASCHM", P_ASPDS = "C_ASPDS", P_ASTCL = "C_ASTCL", - P_ASTRG = "C_ASTRGR", P_ASTRM = "C_ASTRMM", P_ASTRR = "C_ASTRR", - P_ASTRT = "C_ASTRTR", F_ATKNS = "C_ATKNS", F_AYLLA = "C_AYLLA", - P_BAGGN = "C_BAGGN", P_BCCLL = "C_BCCLL", P_BDLLD = "C_BDLLD", - P_BGNRN = "C_BGNRN", P_BLCLN = "C_BLCLN", P_BLMND = "C_BLMND", - P_BLMNL = "C_BLMNL", P_BLPHR = "C_BLPHR", P_BLVNT = "C_BLVNT", - P_BOLVN = "C_BOLVN", P_BORLS = "C_BORLS", P_BRNNM = "C_BRNNM", - P_BRSLN = "C_BRSLN", P_BRSRD = "C_BRSRD", F_BRVLG = "C_BRVLG", - F_BNLLA = "C_BRVLGN", P_BSCCM = "C_BSCCM", F_BSDPH = "C_BSDPH", - P_BTHYS = "C_BTHYS", P_BTLLN = "C_BTLLN", P_BULMN = "C_BULMN", - P_CCLDM = "C_CCLDM", P_CDNLL = "C_CDNLL", P_CLPSS = "C_CDNLLP", - P_CHLDN = "C_CHLDNL", P_CHLST = "C_CHLST", P_CHNLM = "C_CHNLM", - P_CHRYS = "C_CHRYSL", P_CHTSP = "C_CHTSP", P_CBCDS = "C_CIBCDS", - P_CLCRN = "C_CLCRN", P_CLMNA = "C_CLMNA", P_CLPDM = "C_CLPDM", - P_CLPHR = "C_CLPHRY", P_CLVLN = "C_CLVLN", P_CMPNL = "C_CMPNL", - P_CNCRS = "C_CNCRS", P_CNTCH = "C_CNTCH", F_CNTRM = "C_CNTRMY", - P_COLPD = "C_COLPD", P_COLPS = "C_COLPS", P_CPRDS = "C_CPRDS", - P_CRNSP = "C_CPRMA", P_CRBNL = "C_CRBNL", P_CRBRB = "C_CRBRB", - P_CRBRG = "C_CRBRG", P_CRBRS = "C_CRBRS", P_CRCHS = "C_CRCHS", - P_CRCLC = "C_CRCLC", P_CRNLC = "C_CRNLC", P_CRNTH = "C_CRNTH", - P_CRPNT = "C_CRPNT", P_CRSTG = "C_CRSTG", P_CRTHN = "C_CRTHN", - P_CRTRN = "C_CRTRN", P_CYMBL = "C_CRTTA", P_CRYPT = "C_CRYPT", - P_CSHMN = "C_CSHMNL", P_CSSDL = "C_CSSDL", P_CLNDS = "C_CSSDLN", - P_CHRNA = "C_CTHRN", P_CTPSS = "C_CTPSS", P_CUNLN = "C_CUNLN", - P_CYLND = "C_CVLNA", P_CYCLC = "C_CYCLCB", P_CDNTA = "C_CYCLD", - P_CYCLG = "C_CYCLG", P_CYCLM = "C_CYCLM", P_CYRTL = "C_CYRTL", - P_CYSTM = "C_CYSTM", P_DCHLM = "C_DCHLM", P_DCRBS = "C_DCRBS", - P_DCTYC = "C_DCTYC", P_DIDNM = "C_DIDNM", P_DLPTS = "C_DLPTS", - P_DNTLN = "C_DNTLN", P_DNTST = "C_DNTST", P_DORTH = "C_DORTH", - P_DCTYP = "C_DPHMS", F_DPLCY = "C_DPLCY", P_DNDRT = "C_DRTNA", - P_DSCMM = "C_DSCMM", P_DSCRB = "C_DSCRB", P_DSCRN = "C_DSCRN", - P_DSCSP = "C_DSCSP", P_DSNBR = "C_DSNBR", P_DYCBC = "C_DYCBC", - F_DCTYC = "C_DYCHS", F_ECTRG = "C_ECTRG", B_EDWRD = "C_EDWRD", - P_EGGRL = "C_EGGRL", P_EHLYS = "C_EHLYS", P_EHRNB = "C_EHRNB", - P_ELPHD = "C_ELPHD", P_ENCHL = "C_ELYDM", P_EPHDM = "C_EPHDM", - P_EPLTS = "C_EPLTS", P_EPLXL = "C_EPLXL", P_EPNDL = "C_EPNDL", - P_EPNDS = "C_EPNDS", P_ENLLA = "C_EPSTM", P_EPSTY = "C_EPSTY", - F_ERYCH = "C_ERYCH", F_ESMDM = "C_ESMDM", P_ESSYR = "C_ESSYR", - P_FSCHR = "C_FHRNA", P_FLRLS = "C_FLRLS", P_FLNTN = "C_FNTNA", - P_FRNDC = "C_FRNDC", P_FRNTN = "C_FRNTN", P_FRSNK = "C_FRSNK", - P_FNLLA = "C_FSCHRN", P_FSSRN = "C_FSSRN", P_FVCSS = "C_FVCSS", - P_GDRYN = "C_GDRYN", F_GELGN = "C_GELGN", P_GERDA = "C_GERDA", - P_GLACM = "C_GLACM", P_GLBBL = "C_GLBBL", P_GLBGR = "C_GLBGR", - P_GLBLN = "C_GLBLN", P_GRTLA = "C_GLBRT", P_GLBTX = "C_GLBTX", - P_GLLNA = "C_GLLNA", P_GLMSP = "C_GLMSP", P_GLNDL = "C_GLNDL", - F_GNMCH = "C_GNMCH", P_GOSLL = "C_GOSLL", P_GRNDS = "C_GRNDS", - P_GRNTA = "C_GRNTA", P_GLBRT = "C_GTLLA", P_GTTLN = "C_GTTLN", - P_GVLNP = "C_GVLNP", P_GYPSN = "C_GYPSN", P_GYRDN = "C_GYRDN", - P_HALTR = "C_HALTR", P_HANZW = "C_HANZW", P_HAURN = "C_HAURN", - P_HELNN = "C_HELNN", P_HLPHR = "C_HHRYA", P_HLNTA = "C_HLNTA", - F_HLPHT = "C_HLPHT", P_HLSTC = "C_HLSTC", P_HMSPH = "C_HMSPH", - P_HMTRM = "C_HMTRM", P_HPKNS = "C_HPKNS", P_HPLPH = "C_HPLPH", - P_HPPCR = "C_HPPCR", P_HNLLA = "C_HPPCRP", P_HRMSN = "C_HRMSN", - P_HRNLL = "C_HRNLL", F_HRPCH = "C_HRPCH", P_HSTGR = "C_HSTGR", - P_HSTTL = "C_HSTTL", P_HTRST = "C_HTGNA", P_HTRLL = "C_HTRLL", - P_HTRPH = "C_HTRPH", F_HYPHC = "C_HYPHC", P_HYPRM = "C_HYPRM", - P_INTRN = "C_INTRN", P_IRIDI = "C_IRIDI", P_ISLND = "C_ISLND", - P_JCLLL = "C_JCLLL", P_KHLLL = "C_KHLLL", P_KRNPS = "C_KRNPS", - P_KRRRL = "C_KRRRL", P_LABOE = "C_LABOE", P_LAGEN = "C_LAGEN", - P_LBSLL = "C_LBSLL", F_LTHLA = "C_LBYRN", P_LCRYM = "C_LCRYM", - P_LEMBS = "C_LEMBS", F_LGNDM = "C_LGNDM", P_LGNMM = "C_LGNMM", - P_LGNPH = "C_LGNPHR", F_LGNSM = "C_LGNSM", P_LGYNP = "C_LGYNP", - P_LITTB = "C_LITTB", P_LITUL = "C_LITUL", P_LMBDN = "C_LMBDN", - P_LMRCK = "C_LMRCK", F_LBYRN = "C_LMYXA", P_LNGLN = "C_LNGLN", - P_LNTCL = "C_LNTCL", P_LOXDS = "C_LOXDS", F_LPTLG = "C_LPTLG", - F_LNLLA = "C_LPTLGN", F_LPTMT = "C_LPTMT", P_LRYNG = "C_LRYNG", - P_LTCRN = "C_LTCRN", P_LTHPL = "C_LTHPL", P_LTNTS = "C_LTNTS", - F_LTRST = "C_LTRST", P_LXPHY = "C_LXPHY", P_MCRTH = "C_MCRTH", - P_MELNS = "C_MELNS", P_MSDNM = "C_MESDNM", P_METPS = "C_METPS", - P_MIMSN = "C_MIMSN", P_MINCN = "C_MINCN", P_MLLNL = "C_MLLNL", - P_MLMMN = "C_MLMMN", F_MNDNL = "C_MNDNL", P_MNLYS = "C_MNLYS", - P_MNPSS = "C_MNPSS", P_MRGNL = "C_MRGNL", P_MRGNP = "C_MRGNP", - P_MRSPL = "C_MRSPL", P_MRTNT = "C_MRTNT", P_MSSLN = "C_MSSLN", - P_MSSSS = "C_MSSSS", P_MTCNT = "C_MTCNT", P_MYCHS = "C_MYCHS", - P_MYSCH = "C_MYSCH", F_MYZCY = "C_MYZCY", P_NASSL = "C_NASSL", - P_NBCLN = "C_NBCLN", P_NBCLR = "C_NBCLR", P_NCNRB = "C_NCNRB", - P_NDBCL = "C_NDBCL", P_NRLLA = "C_NDBCLR", P_NMMLC = "C_NMMLC", - F_NMTPH = "C_NMTPH", P_NNNLL = "C_NNNLL", P_NODSR = "C_NODSR", - P_NONIN = "C_NONIN", P_NOURI = "C_NOURI", P_OCLNA = "C_OCLNA", - P_OGLNA = "C_OGLNA", P_OPHTH = "C_OLMDM", F_OLPDP = "C_OLPDP", - P_ONYCH = "C_OMPSS", P_OOLIN = "C_OOLIN", P_OPRCL = "C_OPRCL", - P_ORBLN = "C_ORBLN", F_ORCAD = "C_ORCAD", P_ORDRS = "C_ORDRS", - P_OPHRY = "C_ORYDM", P_OSNGL = "C_OSNGL", P_OXYTR = "C_OXYTR", - P_PARRN = "C_PARRN", P_PATRS = "C_PATRS", P_PAVNN = "C_PAVNN", - P_PTYCH = "C_PCYLS", P_PDPHR = "C_PDPHR", P_PELSN = "C_PELSN", - F_PHGMY = "C_PHGMY", F_PSDSP = "C_PHRTA", P_PHRYG = "C_PHRYG", - P_PHYSL = "C_PHYSL", F_PHYTP = "C_PHYTP", P_PLACS = "C_PLACS", - P_PLCPS = "C_PLCPS", P_PLCPSL = "C_PLCPSL", P_PLCTN = "C_PLCTN", - P_PLGPH = "C_PLGPH", B_PLGTH = "C_PLGTH", P_PLMRN = "C_PLMRN", - P_PLNCT = "C_PLNCT", P_PLNDSC = "C_PLNDSC", P_PLNGY = "C_PLNGY", - P_PLNRBL = "C_PLNLLA", P_PLNLN = "C_PLNLN", P_PLNLR = "C_PLNLR", - P_PLNRB = "C_PLNRB", P_PLNSP = "C_PLNSPR", P_PLRNM = "C_PLRNM", - P_PLRST = "C_PLRST", P_PLRTR = "C_PLRTR", F_PLSMD = "C_PLSMD", - P_PLTYC = "C_PLTYC", P_PSDBL = "C_PLVNA", P_PLYMR = "C_PLYMR", - P_PLTYN = "C_PNMTM", P_PNRPL = "C_PNRPL", F_PNTSM = "C_PNTSM", - P_PRCNT = "C_PRCNT", P_PRFSS = "C_PRFSS", P_PRMCM = "C_PRMCUM", - F_PRNSP = "C_PRNSP", P_PRPND = "C_PRPND", P_PRPYX = "C_PRPYX", - P_PRRDN = "C_PRRDN", P_PSDDF = "C_PSDDF", P_PSDMC = "C_PSDMC", - P_PSDND = "C_PSDND", P_PSDNN = "C_PSDNN", P_PSDPL = "C_PSDPLY", - P_PSMMS = "C_PSMMS", P_PTLLN = "C_PTLLN", P_PTLLND = "C_PTLLND", - F_PTRSN = "C_PTRSN", P_PULLN = "C_PULLN", P_PUTLN = "C_PUTLN", - P_PRTTR = "C_PYMNA", P_PYRGL = "C_PYRGL", P_PYRGO = "C_PYRGO", - P_PYRLN = "C_PYRLN", F_PYTHM = "C_PYTHIM", F_PYTHL = "C_PYTHL", - P_PYXCL = "C_PYXCL", P_QNQLC = "C_QNQLC", P_RAMLN = "C_RAMLN", - P_RBRTN = "C_RBRTN", P_RCRVD = "C_RCRVD", P_RCTBL = "C_RCTBL", - P_RCTCB = "C_RCTCB", P_RCTGL = "C_RCTGL", P_RCTVG = "C_RCTVG", - P_RDGDR = "C_RDGDR", P_REMNC = "C_REMNC", P_REPHX = "C_REPHX", - P_RHBDM = "C_RHBDMM", F_RHBDS = "C_RHBDSP", P_RHPDD = "C_RHPDD", - F_RHPDM = "C_RHPDM", F_RHZDMY = "C_RHZDM", P_RHZMM = "C_RHZMM", - P_RIVRN = "C_RIVRN", P_ROSLN = "C_ROSLN", P_ROTAL = "C_ROTAL", - P_RPHDP = "C_RPHDP", P_RPRTN = "C_RPRTN", P_RSSLL = "C_RSSLL", - P_RTLMM = "C_RTLMM", P_RTYLA = "C_RTYLA", P_RUGID = "C_RUGID", - F_RZLLP = "C_RZLLP", P_SAGRN = "C_SAGRN", P_SCCMM = "C_SCCMM", - P_SCCRH = "C_SCCRH", P_SCHLM = "C_SCHLM", F_SCLRS = "C_SCLRS", - P_SCTLR = "C_SCTLR", P_SEBRK = "C_SEBRK", P_SGMLN = "C_SGMLN", - P_SGMLP = "C_SGMLP", P_SGMMR = "C_SGMMR", P_SGMVR = "C_SGMVR", - F_SMMRS = "C_SMMRS", P_SNNDS = "C_SNNDS", P_SORTS = "C_SORTS", - P_SPHGN = "C_SPHGN", P_SPHNN = "C_SPHNN", P_SNLLA = "C_SPHNNL", - P_SPHTR = "C_SPHTR", P_SPHTX = "C_SPHTX", P_SPHVG = "C_SPHVG", - P_SPRDT = "C_SPRDT", P_SPRLC = "C_SPRLC", F_SPRLG = "C_SPRLG", - P_SPRLL = "C_SPRLL", F_SPRMY = "C_SPRMY", P_SPRPL = "C_SPRPL", - P_SPRSG = "C_SPRSG", P_SPRST = "C_SPRST", P_SPHNP = "C_SPRTA", - P_SPRZN = "C_SPRZN", P_SPHRG = "C_SPSNA", P_STHDM = "C_SPTHD", - P_SRCNR = "C_SRCNR", F_SRLPD = "C_SRLPD", F_SPNGS = "C_SSPRA", - F_STEIN = "C_STEIN", P_SPTHD = "C_STHDDS", P_STHRP = "C_STHRP", - P_STNFR = "C_STNFR", P_STNSM = "C_STNSM", P_STNTR = "C_STNTR", - P_STRBL = "C_STRBL", P_STRMB = "C_STRMB", P_STTSN = "C_STTSN", - P_STYLN = "C_SYCHA", F_SCHZC = "C_SYTRM", P_TBNLL = "C_TBNLL", - P_TRCHL = "C_TCHLS", P_TCHNT = "C_TCHNT", P_THRCL = "C_THRCL", - P_THRMM = "C_THRMM", P_TIARN = "C_TIARN", P_TKPHR = "C_TKPHR", - P_TLNMA = "C_TLNMA", P_TLYPM = "C_TLYPM", P_TMNDS = "C_TMNDS", - P_TMNTA = "C_TMNTA", P_TNTNN = "C_TNNDM", P_TTNNS = "C_TNTNN", - P_TNPSS = "C_TNTNNP", P_TONTN = "C_TONTN", P_TOSAI = "C_TOSAI", - P_TPHTR = "C_TPHTR", P_TRCHH = "C_TRCHH", P_TRPHS = "C_TRCHLR", - P_TMMNA = "C_TRCHM", P_TRCHS = "C_TRCHSP", P_TRFRN = "C_TRFRN", - P_TRLCL = "C_TRLCL", P_TRTXL = "C_TRTXL", P_TRTXS = "C_TRTXS", - P_TTRHY = "C_TTRHY", F_TTRMY = "C_TTRMY", P_TXTLR = "C_TXTLR", - F_THRST = "C_TYTRM", P_URLPT = "C_ULPTS", P_UNGLT = "C_UNGLT", - P_URCNT = "C_URCNT", P_URONM = "C_URONM", P_UROSM = "C_UROSM", - P_URTRC = "C_URTRC", P_URSTY = "C_UTYLA", P_UVGRN = "C_UVGRN", - P_VLVLN = "C_VALVLN", P_VGNLN = "C_VGNLN", P_VGNLNP = "C_VGNLNP", - P_VLNRA = "C_VLVLN", P_VGNCL = "C_VNCLA", P_VRGLN = "C_VRGLN", - P_VRGLNP = "C_VRGLNP", P_VRTCL = "C_VRTCL", P_WBBNL = "C_WBBNL", - P_WEBBN = "C_WEBBN", P_WSNRL = "C_WSNRL", P_ZTHMN = "C_ZHMNM", - B_ZOOGL = "C_ZOOGL", F_DDSCS = "F_DPDSC", F_SCCHR = "F_SMYCS", - P_AMTRN = "P_ACNTH", F_AMBDM = "P_AMBDM", F_ARCYR = "P_ARCYR", - F_BADHM = "P_BADHM", F_BDHMP = "P_BDHMP", F_BRBYL = "P_BRBYL", - F_BRFLD = "P_BRFLD", F_CLMYX = "P_CLMYX", F_CLSTD = "P_CLSTD", - F_CMTRC = "P_CMTRC", F_CRBRR = "P_CRBRR", F_CRTMY = "P_CRTMY", - F_CRTRM = "P_CRTRM", F_DCTYD = "P_DCTYD", F_DDYMM = "P_DDYMM", - F_DIACH = "P_DIACH", F_DIANM = "P_DIANM", F_DIDRM = "P_DIDRM", - F_ELMYX = "P_ELMYX", F_ESTLM = "P_ESTLM", F_FULIG = "P_FULIG", - F_HMTRC = "P_HMTRC", F_LCRPS = "P_LCRPS", F_LICEA = "P_LICEA", - F_LMPRD = "P_LMPRD", F_LPTDR = "P_LPTDR", F_LSTRL = "P_LSTRL", - F_LYCGL = "P_LYCGL", F_MCBRD = "P_MCBRD", F_MNKTL = "P_MNKTL", - F_MTTRC = "P_MTTRC", F_MUCLG = "P_MUCLG", F_PHYSR = "P_PHYSR", - F_PRCHN = "P_PRCHN", F_PRMBD = "P_PRMBD", F_PRTPH = "P_PRTPH", - F_PSRNA = "P_PSRNA", F_PYSRM = "P_PYSRM", F_RTCLR = "P_RTCLR", - F_STMNT = "P_STMNT", F_SYMPH = "P_SYMPH", F_TRBRK = "P_TRBRK", - F_TRICH = "P_TRICH", F_TUBFR = "P_TUBFR") + mo_codes_v0.5.0 <- c(B_ACHRMB = "B_ACHRM", B_ANNMA = "B_ACTNS", B_ACLLS = "B_ALCYC", B_AHNGM = "B_ARCHN", B_ARMTM = "B_ARMTMN", B_ARTHRS = "B_ARTHR", B_APHLS = "B_AZRHZP", B_BRCHA = "B_BRCHY", B_BCTRM = "B_BRVBCT", B_CLRBCT = "B_CLRBC", B_CTRDM = "B_CLSTR", B_CPRMM = "B_CYLND", B_DLCLN = "B_DPLCL", B_DMCLM = "B_DSLFT", B_DSLFVB = "B_DSLFV", B_FCTRM = "B_FSBCT", B_GNRLA = "B_GRDNR", B_HNRBM = "B_HLNRB", B_HPHGA = "B_HNPHGA", B_HCCCS = "B_HYDRC", B_MCRCLS = "B_MCRCL", B_MTHYLS = "B_MLSMA", B_MARCLS = "B_MRCLS", B_MGCLS = "B_MSTGC", B_MCLLA = "B_MTHYLC", B_MYCPLS = "B_MYCPL", B_NBCTR = "B_NTRBC", B_OCLLS = "B_OCNBC", B_PTHRX = "B_PLNKT", B_PCCCS = "B_PRCHL", B_PSPHN = "B_PRPHY", B_PDMNS = "B_PSDMN", B_SCCHRP = "B_SCCHR", B_SRBCTR = "B_SHRBCTR", B_STRPTC = "B_STRPT", B_SHMNS = "B_SYNTR", B_TRBCTR = "B_THRMN", P_ALBMN = "C_ABMNA", F_ACHLY = "C_ACHLY", P_ACINT = "C_ACINT", P_ARTCL = "C_ACLNA", P_ACRVL = "C_ACRVL", P_ADRCT = "C_ADRCT", P_AMPHS = "C_AHSRS", F_ALBUG = "C_ALBUG", P_ALCNT = "C_ALCNT", P_ALFRD = "C_ALFRD", P_ALLGR = "C_ALLGR", P_AMPHL = "C_ALPTS", F_ALTHR = "C_ALTHR", P_AMLLA = "C_AMLLA", P_ANMLN = "C_AMLNA", P_AMMBC = "C_AMMBC", P_AMMDS = "C_AMMDS", P_AMMLG = "C_AMMLG", P_AMMMR = "C_AMMMR", P_AMMMS = "C_AMMMS", P_AMMON = "C_AMMON", P_AMMSC = "C_AMMSC", P_AMMSP = "C_AMMSP", P_AMMST = "C_AMMST", P_AMMTM = "C_AMMTM", F_AMYCS = "C_AMYCS", P_ANARM = "C_ANARM", P_ANGLD = "C_ANGLD", P_ANGLG = "C_ANGLG", P_ANNLC = "C_ANNLC", F_ANSLP = "C_ANSLP", F_APDCH = "C_APDCH", F_APHND = "C_APHND", F_APLNC = "C_APLNC", F_AQLND = "C_AQLND", P_ARCHS = "C_ARCHAS", P_ASTRN = "C_ARNNN", P_ARNPR = "C_ARNPR", F_ARSPR = "C_ARSPR", P_ARTST = "C_ARTSTR", P_AMPHC = "C_ARYNA", P_ASCHM = "C_ASCHM", P_ASPDS = "C_ASPDS", P_ASTCL = "C_ASTCL", P_ASTRG = "C_ASTRGR", P_ASTRM = "C_ASTRMM", P_ASTRR = "C_ASTRR", P_ASTRT = "C_ASTRTR", F_ATKNS = "C_ATKNS", F_AYLLA = "C_AYLLA", P_BAGGN = "C_BAGGN", P_BCCLL = "C_BCCLL", P_BDLLD = "C_BDLLD", P_BGNRN = "C_BGNRN", P_BLCLN = "C_BLCLN", P_BLMND = "C_BLMND", P_BLMNL = "C_BLMNL", P_BLPHR = "C_BLPHR", P_BLVNT = "C_BLVNT", P_BOLVN = "C_BOLVN", P_BORLS = "C_BORLS", P_BRNNM = "C_BRNNM", P_BRSLN = "C_BRSLN", P_BRSRD = "C_BRSRD", F_BRVLG = "C_BRVLG", F_BNLLA = "C_BRVLGN", P_BSCCM = "C_BSCCM", F_BSDPH = "C_BSDPH", P_BTHYS = "C_BTHYS", P_BTLLN = "C_BTLLN", P_BULMN = "C_BULMN", P_CCLDM = "C_CCLDM", P_CDNLL = "C_CDNLL", P_CLPSS = "C_CDNLLP", P_CHLDN = "C_CHLDNL", P_CHLST = "C_CHLST", P_CHNLM = "C_CHNLM", P_CHRYS = "C_CHRYSL", P_CHTSP = "C_CHTSP", P_CBCDS = "C_CIBCDS", P_CLCRN = "C_CLCRN", P_CLMNA = "C_CLMNA", P_CLPDM = "C_CLPDM", P_CLPHR = "C_CLPHRY", P_CLVLN = "C_CLVLN", P_CMPNL = "C_CMPNL", P_CNCRS = "C_CNCRS", P_CNTCH = "C_CNTCH", F_CNTRM = "C_CNTRMY", P_COLPD = "C_COLPD", P_COLPS = "C_COLPS", P_CPRDS = "C_CPRDS", P_CRNSP = "C_CPRMA", P_CRBNL = "C_CRBNL", P_CRBRB = "C_CRBRB", P_CRBRG = "C_CRBRG", P_CRBRS = "C_CRBRS", P_CRCHS = "C_CRCHS", P_CRCLC = "C_CRCLC", P_CRNLC = "C_CRNLC", P_CRNTH = "C_CRNTH", P_CRPNT = "C_CRPNT", P_CRSTG = "C_CRSTG", P_CRTHN = "C_CRTHN", P_CRTRN = "C_CRTRN", P_CYMBL = "C_CRTTA", P_CRYPT = "C_CRYPT", P_CSHMN = "C_CSHMNL", P_CSSDL = "C_CSSDL", P_CLNDS = "C_CSSDLN", P_CHRNA = "C_CTHRN", P_CTPSS = "C_CTPSS", P_CUNLN = "C_CUNLN", P_CYLND = "C_CVLNA", P_CYCLC = "C_CYCLCB", P_CDNTA = "C_CYCLD", P_CYCLG = "C_CYCLG", P_CYCLM = "C_CYCLM", P_CYRTL = "C_CYRTL", P_CYSTM = "C_CYSTM", P_DCHLM = "C_DCHLM", P_DCRBS = "C_DCRBS", P_DCTYC = "C_DCTYC", P_DIDNM = "C_DIDNM", P_DLPTS = "C_DLPTS", P_DNTLN = "C_DNTLN", P_DNTST = "C_DNTST", P_DORTH = "C_DORTH", P_DCTYP = "C_DPHMS", F_DPLCY = "C_DPLCY", P_DNDRT = "C_DRTNA", P_DSCMM = "C_DSCMM", P_DSCRB = "C_DSCRB", P_DSCRN = "C_DSCRN", P_DSCSP = "C_DSCSP", P_DSNBR = "C_DSNBR", P_DYCBC = "C_DYCBC", F_DCTYC = "C_DYCHS", F_ECTRG = "C_ECTRG", B_EDWRD = "C_EDWRD", P_EGGRL = "C_EGGRL", P_EHLYS = "C_EHLYS", P_EHRNB = "C_EHRNB", P_ELPHD = "C_ELPHD", P_ENCHL = "C_ELYDM", P_EPHDM = "C_EPHDM", P_EPLTS = "C_EPLTS", P_EPLXL = "C_EPLXL", P_EPNDL = "C_EPNDL", P_EPNDS = "C_EPNDS", P_ENLLA = "C_EPSTM", P_EPSTY = "C_EPSTY", F_ERYCH = "C_ERYCH", F_ESMDM = "C_ESMDM", P_ESSYR = "C_ESSYR", P_FSCHR = "C_FHRNA", P_FLRLS = "C_FLRLS", P_FLNTN = "C_FNTNA", P_FRNDC = "C_FRNDC", P_FRNTN = "C_FRNTN", P_FRSNK = "C_FRSNK", P_FNLLA = "C_FSCHRN", P_FSSRN = "C_FSSRN", P_FVCSS = "C_FVCSS", P_GDRYN = "C_GDRYN", F_GELGN = "C_GELGN", P_GERDA = "C_GERDA", P_GLACM = "C_GLACM", P_GLBBL = "C_GLBBL", P_GLBGR = "C_GLBGR", P_GLBLN = "C_GLBLN", P_GRTLA = "C_GLBRT", P_GLBTX = "C_GLBTX", P_GLLNA = "C_GLLNA", P_GLMSP = "C_GLMSP", P_GLNDL = "C_GLNDL", F_GNMCH = "C_GNMCH", P_GOSLL = "C_GOSLL", P_GRNDS = "C_GRNDS", P_GRNTA = "C_GRNTA", P_GLBRT = "C_GTLLA", P_GTTLN = "C_GTTLN", P_GVLNP = "C_GVLNP", P_GYPSN = "C_GYPSN", P_GYRDN = "C_GYRDN", P_HALTR = "C_HALTR", P_HANZW = "C_HANZW", P_HAURN = "C_HAURN", P_HELNN = "C_HELNN", P_HLPHR = "C_HHRYA", P_HLNTA = "C_HLNTA", F_HLPHT = "C_HLPHT", P_HLSTC = "C_HLSTC", P_HMSPH = "C_HMSPH", P_HMTRM = "C_HMTRM", P_HPKNS = "C_HPKNS", P_HPLPH = "C_HPLPH", P_HPPCR = "C_HPPCR", P_HNLLA = "C_HPPCRP", P_HRMSN = "C_HRMSN", P_HRNLL = "C_HRNLL", F_HRPCH = "C_HRPCH", P_HSTGR = "C_HSTGR", P_HSTTL = "C_HSTTL", P_HTRST = "C_HTGNA", P_HTRLL = "C_HTRLL", P_HTRPH = "C_HTRPH", F_HYPHC = "C_HYPHC", P_HYPRM = "C_HYPRM", P_INTRN = "C_INTRN", P_IRIDI = "C_IRIDI", P_ISLND = "C_ISLND", P_JCLLL = "C_JCLLL", P_KHLLL = "C_KHLLL", P_KRNPS = "C_KRNPS", P_KRRRL = "C_KRRRL", P_LABOE = "C_LABOE", P_LAGEN = "C_LAGEN", P_LBSLL = "C_LBSLL", F_LTHLA = "C_LBYRN", P_LCRYM = "C_LCRYM", P_LEMBS = "C_LEMBS", F_LGNDM = "C_LGNDM", P_LGNMM = "C_LGNMM", P_LGNPH = "C_LGNPHR", F_LGNSM = "C_LGNSM", P_LGYNP = "C_LGYNP", P_LITTB = "C_LITTB", P_LITUL = "C_LITUL", P_LMBDN = "C_LMBDN", P_LMRCK = "C_LMRCK", F_LBYRN = "C_LMYXA", P_LNGLN = "C_LNGLN", P_LNTCL = "C_LNTCL", P_LOXDS = "C_LOXDS", F_LPTLG = "C_LPTLG", F_LNLLA = "C_LPTLGN", F_LPTMT = "C_LPTMT", P_LRYNG = "C_LRYNG", P_LTCRN = "C_LTCRN", P_LTHPL = "C_LTHPL", P_LTNTS = "C_LTNTS", F_LTRST = "C_LTRST", P_LXPHY = "C_LXPHY", P_MCRTH = "C_MCRTH", P_MELNS = "C_MELNS", P_MSDNM = "C_MESDNM", P_METPS = "C_METPS", P_MIMSN = "C_MIMSN", P_MINCN = "C_MINCN", P_MLLNL = "C_MLLNL", P_MLMMN = "C_MLMMN", F_MNDNL = "C_MNDNL", P_MNLYS = "C_MNLYS", P_MNPSS = "C_MNPSS", P_MRGNL = "C_MRGNL", P_MRGNP = "C_MRGNP", P_MRSPL = "C_MRSPL", P_MRTNT = "C_MRTNT", P_MSSLN = "C_MSSLN", P_MSSSS = "C_MSSSS", P_MTCNT = "C_MTCNT", P_MYCHS = "C_MYCHS", P_MYSCH = "C_MYSCH", F_MYZCY = "C_MYZCY", P_NASSL = "C_NASSL", P_NBCLN = "C_NBCLN", P_NBCLR = "C_NBCLR", P_NCNRB = "C_NCNRB", P_NDBCL = "C_NDBCL", P_NRLLA = "C_NDBCLR", P_NMMLC = "C_NMMLC", F_NMTPH = "C_NMTPH", P_NNNLL = "C_NNNLL", P_NODSR = "C_NODSR", P_NONIN = "C_NONIN", P_NOURI = "C_NOURI", P_OCLNA = "C_OCLNA", P_OGLNA = "C_OGLNA", P_OPHTH = "C_OLMDM", F_OLPDP = "C_OLPDP", P_ONYCH = "C_OMPSS", P_OOLIN = "C_OOLIN", P_OPRCL = "C_OPRCL", P_ORBLN = "C_ORBLN", F_ORCAD = "C_ORCAD", P_ORDRS = "C_ORDRS", P_OPHRY = "C_ORYDM", P_OSNGL = "C_OSNGL", P_OXYTR = "C_OXYTR", P_PARRN = "C_PARRN", P_PATRS = "C_PATRS", P_PAVNN = "C_PAVNN", P_PTYCH = "C_PCYLS", P_PDPHR = "C_PDPHR", P_PELSN = "C_PELSN", F_PHGMY = "C_PHGMY", F_PSDSP = "C_PHRTA", P_PHRYG = "C_PHRYG", P_PHYSL = "C_PHYSL", F_PHYTP = "C_PHYTP", P_PLACS = "C_PLACS", P_PLCPS = "C_PLCPS", P_PLCPSL = "C_PLCPSL", P_PLCTN = "C_PLCTN", P_PLGPH = "C_PLGPH", B_PLGTH = "C_PLGTH", P_PLMRN = "C_PLMRN", P_PLNCT = "C_PLNCT", P_PLNDSC = "C_PLNDSC", P_PLNGY = "C_PLNGY", P_PLNRBL = "C_PLNLLA", P_PLNLN = "C_PLNLN", P_PLNLR = "C_PLNLR", P_PLNRB = "C_PLNRB", P_PLNSP = "C_PLNSPR", P_PLRNM = "C_PLRNM", P_PLRST = "C_PLRST", P_PLRTR = "C_PLRTR", F_PLSMD = "C_PLSMD", P_PLTYC = "C_PLTYC", P_PSDBL = "C_PLVNA", P_PLYMR = "C_PLYMR", P_PLTYN = "C_PNMTM", P_PNRPL = "C_PNRPL", F_PNTSM = "C_PNTSM", P_PRCNT = "C_PRCNT", P_PRFSS = "C_PRFSS", P_PRMCM = "C_PRMCUM", F_PRNSP = "C_PRNSP", P_PRPND = "C_PRPND", P_PRPYX = "C_PRPYX", P_PRRDN = "C_PRRDN", P_PSDDF = "C_PSDDF", P_PSDMC = "C_PSDMC", P_PSDND = "C_PSDND", P_PSDNN = "C_PSDNN", P_PSDPL = "C_PSDPLY", P_PSMMS = "C_PSMMS", P_PTLLN = "C_PTLLN", P_PTLLND = "C_PTLLND", F_PTRSN = "C_PTRSN", P_PULLN = "C_PULLN", P_PUTLN = "C_PUTLN", P_PRTTR = "C_PYMNA", P_PYRGL = "C_PYRGL", P_PYRGO = "C_PYRGO", P_PYRLN = "C_PYRLN", F_PYTHM = "C_PYTHIM", F_PYTHL = "C_PYTHL", P_PYXCL = "C_PYXCL", P_QNQLC = "C_QNQLC", P_RAMLN = "C_RAMLN", P_RBRTN = "C_RBRTN", P_RCRVD = "C_RCRVD", P_RCTBL = "C_RCTBL", P_RCTCB = "C_RCTCB", P_RCTGL = "C_RCTGL", P_RCTVG = "C_RCTVG", P_RDGDR = "C_RDGDR", P_REMNC = "C_REMNC", P_REPHX = "C_REPHX", P_RHBDM = "C_RHBDMM", F_RHBDS = "C_RHBDSP", P_RHPDD = "C_RHPDD", F_RHPDM = "C_RHPDM", F_RHZDMY = "C_RHZDM", P_RHZMM = "C_RHZMM", P_RIVRN = "C_RIVRN", P_ROSLN = "C_ROSLN", P_ROTAL = "C_ROTAL", P_RPHDP = "C_RPHDP", P_RPRTN = "C_RPRTN", P_RSSLL = "C_RSSLL", P_RTLMM = "C_RTLMM", P_RTYLA = "C_RTYLA", P_RUGID = "C_RUGID", F_RZLLP = "C_RZLLP", P_SAGRN = "C_SAGRN", P_SCCMM = "C_SCCMM", P_SCCRH = "C_SCCRH", P_SCHLM = "C_SCHLM", F_SCLRS = "C_SCLRS", P_SCTLR = "C_SCTLR", P_SEBRK = "C_SEBRK", P_SGMLN = "C_SGMLN", P_SGMLP = "C_SGMLP", P_SGMMR = "C_SGMMR", P_SGMVR = "C_SGMVR", F_SMMRS = "C_SMMRS", P_SNNDS = "C_SNNDS", P_SORTS = "C_SORTS", P_SPHGN = "C_SPHGN", P_SPHNN = "C_SPHNN", P_SNLLA = "C_SPHNNL", P_SPHTR = "C_SPHTR", P_SPHTX = "C_SPHTX", P_SPHVG = "C_SPHVG", P_SPRDT = "C_SPRDT", P_SPRLC = "C_SPRLC", F_SPRLG = "C_SPRLG", P_SPRLL = "C_SPRLL", F_SPRMY = "C_SPRMY", P_SPRPL = "C_SPRPL", P_SPRSG = "C_SPRSG", P_SPRST = "C_SPRST", P_SPHNP = "C_SPRTA", P_SPRZN = "C_SPRZN", P_SPHRG = "C_SPSNA", P_STHDM = "C_SPTHD", P_SRCNR = "C_SRCNR", F_SRLPD = "C_SRLPD", F_SPNGS = "C_SSPRA", F_STEIN = "C_STEIN", P_SPTHD = "C_STHDDS", P_STHRP = "C_STHRP", P_STNFR = "C_STNFR", P_STNSM = "C_STNSM", P_STNTR = "C_STNTR", P_STRBL = "C_STRBL", P_STRMB = "C_STRMB", P_STTSN = "C_STTSN", P_STYLN = "C_SYCHA", F_SCHZC = "C_SYTRM", P_TBNLL = "C_TBNLL", P_TRCHL = "C_TCHLS", P_TCHNT = "C_TCHNT", P_THRCL = "C_THRCL", P_THRMM = "C_THRMM", P_TIARN = "C_TIARN", P_TKPHR = "C_TKPHR", P_TLNMA = "C_TLNMA", P_TLYPM = "C_TLYPM", P_TMNDS = "C_TMNDS", P_TMNTA = "C_TMNTA", P_TNTNN = "C_TNNDM", P_TTNNS = "C_TNTNN", P_TNPSS = "C_TNTNNP", P_TONTN = "C_TONTN", P_TOSAI = "C_TOSAI", P_TPHTR = "C_TPHTR", P_TRCHH = "C_TRCHH", P_TRPHS = "C_TRCHLR", P_TMMNA = "C_TRCHM", P_TRCHS = "C_TRCHSP", P_TRFRN = "C_TRFRN", P_TRLCL = "C_TRLCL", P_TRTXL = "C_TRTXL", P_TRTXS = "C_TRTXS", P_TTRHY = "C_TTRHY", F_TTRMY = "C_TTRMY", P_TXTLR = "C_TXTLR", F_THRST = "C_TYTRM", P_URLPT = "C_ULPTS", P_UNGLT = "C_UNGLT", P_URCNT = "C_URCNT", P_URONM = "C_URONM", P_UROSM = "C_UROSM", P_URTRC = "C_URTRC", P_URSTY = "C_UTYLA", P_UVGRN = "C_UVGRN", P_VLVLN = "C_VALVLN", P_VGNLN = "C_VGNLN", P_VGNLNP = "C_VGNLNP", P_VLNRA = "C_VLVLN", P_VGNCL = "C_VNCLA", P_VRGLN = "C_VRGLN", P_VRGLNP = "C_VRGLNP", P_VRTCL = "C_VRTCL", P_WBBNL = "C_WBBNL", P_WEBBN = "C_WEBBN", P_WSNRL = "C_WSNRL", P_ZTHMN = "C_ZHMNM", B_ZOOGL = "C_ZOOGL", F_DDSCS = "F_DPDSC", F_SCCHR = "F_SMYCS", P_AMTRN = "P_ACNTH", F_AMBDM = "P_AMBDM", F_ARCYR = "P_ARCYR", F_BADHM = "P_BADHM", F_BDHMP = "P_BDHMP", F_BRBYL = "P_BRBYL", F_BRFLD = "P_BRFLD", F_CLMYX = "P_CLMYX", F_CLSTD = "P_CLSTD", F_CMTRC = "P_CMTRC", F_CRBRR = "P_CRBRR", F_CRTMY = "P_CRTMY", F_CRTRM = "P_CRTRM", F_DCTYD = "P_DCTYD", F_DDYMM = "P_DDYMM", F_DIACH = "P_DIACH", F_DIANM = "P_DIANM", F_DIDRM = "P_DIDRM", F_ELMYX = "P_ELMYX", F_ESTLM = "P_ESTLM", F_FULIG = "P_FULIG", F_HMTRC = "P_HMTRC", F_LCRPS = "P_LCRPS", F_LICEA = "P_LICEA", F_LMPRD = "P_LMPRD", F_LPTDR = "P_LPTDR", F_LSTRL = "P_LSTRL", F_LYCGL = "P_LYCGL", F_MCBRD = "P_MCBRD", F_MNKTL = "P_MNKTL", F_MTTRC = "P_MTTRC", F_MUCLG = "P_MUCLG", F_PHYSR = "P_PHYSR", F_PRCHN = "P_PRCHN", F_PRMBD = "P_PRMBD", F_PRTPH = "P_PRTPH", F_PSRNA = "P_PSRNA", F_PYSRM = "P_PYSRM", F_RTCLR = "P_RTCLR", F_STMNT = "P_STMNT", F_SYMPH = "P_SYMPH", F_TRBRK = "P_TRBRK", F_TRICH = "P_TRICH", F_TUBFR = "P_TUBFR") assign(x = "mo_codes_v0.5.0", value = mo_codes_v0.5.0, diff --git a/_pkgdown.yml b/_pkgdown.yml index f701779f..fad292db 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -156,7 +156,6 @@ reference: - '`like`' - '`ab_property`' - authors: Matthijs S. Berends: href: https://www.rug.nl/staff/m.s.berends/ diff --git a/docs/articles/AMR.html b/docs/articles/AMR.html index 96360d80..17046f02 100644 --- a/docs/articles/AMR.html +++ b/docs/articles/AMR.html @@ -192,7 +192,7 @@

How to conduct AMR analysis

Matthijs S. Berends

-

20 February 2019

+

21 February 2019

@@ -201,7 +201,7 @@ -

Note: values on this page will change with every website update since they are based on randomly created values and the page was written in RMarkdown. However, the methodology remains unchanged. This page was generated on 20 February 2019.

+

Note: values on this page will change with every website update since they are based on randomly created values and the page was written in RMarkdown. However, the methodology remains unchanged. This page was generated on 21 February 2019.

Introduction

@@ -217,21 +217,21 @@ -2019-02-20 +2019-02-21 abcd Escherichia coli S S -2019-02-20 +2019-02-21 abcd Escherichia coli S R -2019-02-20 +2019-02-21 efgh Escherichia coli R @@ -327,67 +327,67 @@ -2010-03-15 -U2 +2012-08-08 +P2 Hospital B Streptococcus pneumoniae S S -R +S S F -2010-08-09 -Q7 -Hospital B +2011-03-05 +D8 +Hospital A +Escherichia coli +S +S +S +S +M + + +2012-04-03 +D4 +Hospital C Staphylococcus aureus R S +R S -S -F +M - -2012-03-04 -P2 + +2012-10-25 +I1 Hospital B Klebsiella pneumoniae S S S S -F - - -2013-10-19 -K5 -Hospital C -Staphylococcus aureus -R -S -S -S M -2017-10-05 -I7 -Hospital D -Staphylococcus aureus +2017-04-18 +X3 +Hospital B +Streptococcus pneumoniae +S +I +S R -S -S -S -M +F -2017-09-27 -H7 -Hospital C -Staphylococcus aureus -S +2013-03-18 +C4 +Hospital A +Streptococcus pneumoniae S +I S S M @@ -411,8 +411,8 @@ #> #> Item Count Percent Cum. Count Cum. Percent #> --- ----- ------- -------- ----------- ------------- -#> 1 M 10,384 51.9% 10,384 51.9% -#> 2 F 9,616 48.1% 20,000 100.0% +#> 1 M 10,458 52.3% 10,458 52.3% +#> 2 F 9,542 47.7% 20,000 100.0%

So, we can draw at least two conclusions immediately. From a data scientist perspective, the data looks clean: only values M and F. From a researcher perspective: there are slightly more men. Nothing we didn’t already know.

The data is already quite clean, but we still need to transform some variables. The bacteria column now consists of text, and we want to add more variables based on microbial IDs later on. So, we will transform this column to valid IDs. The mutate() function of the dplyr package makes this really easy:

+#> -> changed 4,103 test results (0 to S; 0 to I; 4,103 to R)

@@ -489,7 +489,7 @@ #> NOTE: Using column `bacteria` as input for `col_mo`. #> NOTE: Using column `date` as input for `col_date`. #> NOTE: Using column `patient_id` as input for `col_patient_id`. -#> => Found 5,689 first isolates (28.4% of total)

+#> => Found 5,674 first isolates (28.4% of total)

So only 28.4% is suitable for resistance analysis! We can now filter on it with the filter() function, also from the dplyr package:

data_1st <- data %>% 
   filter(first == TRUE)
@@ -516,8 +516,8 @@ 1 -2010-01-09 -V4 +2010-01-23 +A4 B_ESCHR_COL S S @@ -527,8 +527,8 @@ 2 -2010-04-24 -V4 +2010-03-13 +A4 B_ESCHR_COL S S @@ -538,32 +538,32 @@ 3 -2010-05-30 -V4 +2010-04-19 +A4 B_ESCHR_COL S -R +S S S FALSE 4 -2010-06-10 -V4 +2010-06-11 +A4 B_ESCHR_COL +S +S R S -S -S FALSE 5 -2010-06-17 -V4 +2010-07-04 +A4 B_ESCHR_COL -S +R S S S @@ -571,8 +571,8 @@ 6 -2010-07-30 -V4 +2010-07-05 +A4 B_ESCHR_COL S S @@ -582,47 +582,47 @@ 7 -2010-09-20 -V4 +2011-03-21 +A4 B_ESCHR_COL +S +S R S -S -S -FALSE +TRUE 8 -2010-10-21 -V4 +2011-04-02 +A4 B_ESCHR_COL R S -S +R S FALSE 9 -2010-11-06 -V4 +2011-04-05 +A4 B_ESCHR_COL +S +S +S R -S -S -S FALSE 10 -2011-05-21 -V4 +2011-04-13 +A4 B_ESCHR_COL -R S S S -TRUE +S +FALSE @@ -637,7 +637,7 @@ #> NOTE: Using column `patient_id` as input for `col_patient_id`. #> NOTE: Using column `keyab` as input for `col_keyantibiotics`. Use col_keyantibiotics = FALSE to prevent this. #> [Criterion] Inclusion based on key antibiotics, ignoring I. -#> => Found 15,871 first weighted isolates (79.4% of total) +#> => Found 15,801 first weighted isolates (79.0% of total) @@ -654,8 +654,8 @@ - - + + @@ -666,8 +666,8 @@ - - + + @@ -678,34 +678,34 @@ - - + + - + - + - - + + + + - - - - + + - + @@ -714,71 +714,71 @@ - - + + - + - - + + + + - - - + - - + + - + - + - - + + + + + - - - - + - - + + - - + +
isolate
12010-01-09V42010-01-23A4 B_ESCHR_COL S S
22010-04-24V42010-03-13A4 B_ESCHR_COL S S
32010-05-30V42010-04-19A4 B_ESCHR_COL SRS S S FALSETRUEFALSE
42010-06-10V42010-06-11A4 B_ESCHR_COLSS R SSS FALSE TRUE
52010-06-17V42010-07-04A4 B_ESCHR_COLSR S S S
62010-07-30V42010-07-05A4 B_ESCHR_COL S S S S FALSEFALSETRUE
72010-09-20V42011-03-21A4 B_ESCHR_COLSS R SSSFALSETRUE TRUE
82010-10-21V42011-04-02A4 B_ESCHR_COL R SSR S FALSEFALSETRUE
92010-11-06V42011-04-05A4 B_ESCHR_COLSSS RSSSFALSE FALSETRUE
102011-05-21V42011-04-13A4 B_ESCHR_COLR S S STRUESFALSE TRUE
-

Instead of 2, now 6 isolates are flagged. In total, 79.4% of all isolates are marked ‘first weighted’ - 50.9% more than when using the CLSI guideline. In real life, this novel algorithm will yield 5-10% more isolates than the classic CLSI guideline.

+

Instead of 2, now 8 isolates are flagged. In total, 79% of all isolates are marked ‘first weighted’ - 50.6% more than when using the CLSI guideline. In real life, this novel algorithm will yield 5-10% more isolates than the classic CLSI guideline.

As with filter_first_isolate(), there’s a shortcut for this new algorithm too:

data_1st <- data %>% 
   filter_first_weighted_isolate()
-

So we end up with 15,871 isolates for analysis.

+

So we end up with 15,801 isolates for analysis.

We can remove unneeded columns:

data_1st <- data_1st %>% 
   select(-c(first, keyab))
@@ -786,7 +786,6 @@ 
head(data_1st)
- @@ -803,14 +802,13 @@ - - - + + - + @@ -819,74 +817,9 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + @@ -898,6 +831,66 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
date patient_id hospital
12010-03-15U22012-08-08P2 Hospital B B_STRPT_PNE S SRS R F Gram positiveTRUE
22010-08-09Q7Hospital BB_STPHY_AURRSSSFGram positiveStaphylococcusaureusTRUE
42013-10-19K5Hospital CB_STPHY_AURRSSSMGram positiveStaphylococcusaureusTRUE
52017-10-05I7Hospital DB_STPHY_AURRSSSMGram positiveStaphylococcusaureusTRUE
62017-09-27H7Hospital CB_STPHY_AURSSSSMGram positiveStaphylococcusaureusTRUE
72016-09-06L9Hospital B2011-03-05D8Hospital A B_ESCHR_COL S Scoli TRUE
2012-04-03D4Hospital CB_STPHY_AURRSRSMGram positiveStaphylococcusaureusTRUE
2012-10-25I1Hospital BB_KLBSL_PNERSSSMGram negativeKlebsiellapneumoniaeTRUE
2017-04-18X3Hospital BB_STRPT_PNESISRFGram positiveStreptococcuspneumoniaeTRUE
2013-03-18C4Hospital AB_STRPT_PNESISRMGram positiveStreptococcuspneumoniaeTRUE

Time for the analysis!

@@ -915,9 +908,9 @@ 
freq(paste(data_1st$genus, data_1st$species))

Or can be used like the dplyr way, which is easier readable:

data_1st %>% freq(genus, species)
-

Frequency table of genus and species from a data.frame (15,871 x 13)

+

Frequency table of genus and species from a data.frame (15,801 x 13)

Columns: 2
-Length: 15,871 (of which NA: 0 = 0.00%)
+Length: 15,801 (of which NA: 0 = 0.00%)
Unique: 4

Shortest: 16
Longest: 24

@@ -934,33 +927,33 @@ Longest: 24

1 Escherichia coli -7,903 -49.8% -7,903 -49.8% +7,850 +49.7% +7,850 +49.7% 2 Staphylococcus aureus -3,987 -25.1% -11,890 -74.9% +3,918 +24.8% +11,768 +74.5% 3 Streptococcus pneumoniae -2,426 -15.3% -14,316 -90.2% +2,446 +15.5% +14,214 +90.0% 4 Klebsiella pneumoniae -1,555 -9.8% -15,871 +1,587 +10.0% +15,801 100.0% @@ -971,7 +964,7 @@ Longest: 24

Resistance percentages

The functions portion_R, portion_RI, portion_I, portion_IS and portion_S can be used to determine the portion of a specific antimicrobial outcome. They can be used on their own:

data_1st %>% portion_IR(amox)
-#> [1] 0.4737572
+#> [1] 0.4747801

Or can be used in conjuction with group_by() and summarise(), both from the dplyr package:

data_1st %>% 
   group_by(hospital) %>% 
@@ -984,19 +977,19 @@ Longest: 24

 
 
 Hospital A
-0.4684758
+0.4696939
 
 
 Hospital B
-0.4675514
+0.4782930
 
 
 Hospital C
-0.4904459
+0.4683438
 
 
 Hospital D
-0.4804110
+0.4815051
 
 
 
@@ -1014,23 +1007,23 @@ Longest: 24

 
 
 Hospital A
-0.4684758
-4901
+0.4696939
+4867
 
 
 Hospital B
-0.4675514
-5501
+0.4782930
+5413
 
 
 Hospital C
-0.4904459
-2355
+0.4683438
+2385
 
 
 Hospital D
-0.4804110
-3114
+0.4815051
+3136
 
 
 
@@ -1050,27 +1043,27 @@ Longest: 24

 
 
 Escherichia
-0.7295964
-0.8977603
-0.9743136
+0.7278981
+0.8996178
+0.9742675
 
 
 Klebsiella
-0.7299035
-0.8958199
-0.9774920
+0.7303088
+0.9004411
+0.9716446
 
 
 Staphylococcus
-0.7281164
-0.9260095
-0.9806872
+0.7304747
+0.9157734
+0.9757529
 
 
 Streptococcus
-0.7353669
+0.7485691
 0.0000000
-0.7353669
+0.7485691
 
 
 
diff --git a/docs/articles/AMR_files/figure-html/plot 1-1.png b/docs/articles/AMR_files/figure-html/plot 1-1.png
index b139b98b4232869c3e9147be10bff65ebe372d52..e304aff891d1f35d205b4bc8d830d3677db977ce 100644
GIT binary patch
literal 33765
zcmeFa2UwNowk?br1JMYmK_XJJR79x}M0yca1Vnmo5v40l=}jYwh)AT0il9_MKmp0diFfeRTJ#tWofnjYT1H+o9OsnyoqkXD0eEGrUi18T)2CiW8&#Lg=acc&KUl>#m
z9?Vl&c_daFROH)=KON?s1_xPUB$o=L_
zi_qQ=2Zq8g%+yl~5`SctWM^Yr#kS}23hVZtScR_G{qlC_PVcec+5Hj{KTvj3-dwAh
zw6`58X#8fg=1oFDb;s7Uw)bRjuT%Ldw!6_mvgT-{{ug`XM^0iT>>H^BHZB;Q@hh+JVu&%d3kXW
zrKP2pxYySkxVcSiRN>sHv|CWHCHI7iG7F^s4f=k`7
zZU1mPmFn1-9k@`Jz+4dDkZGte-xFC>ROCA|j0?cu(k^e@VN&3rzgR`q=ER5eHP;L+
z{im<1aNoDyG1>R-*8bBbvfR#}A6a{N%;5j_zmG4m`*?4UZt6)Jn@_2t_^A&^_6?p(
zvaXKtUzm~_ebRkRVP&qsvGIMJSihEO(-YTj|Jhdd@JbQt(nRNrU_L%R=hkBPiJmvO
z4BgbDaiZ30VFKiFg{dU9T{!Xe!(Go7*UD%^3#s3pp4)%Axjyk?oS1D)RMgZ^qjS&e
z>u=t?p#%Rp@kCFrhlaEy?1d$~VtWm%ai
zbc;}iG4?G(qPBh2s>+4wq4n$6pU5?;xg%E{KZvzqqDV*-+C*aqojaVOJ@!mnJt1Jh
zp6TxCFOT2d6c_N!I8k|x5>z9<_#ioX=bk+SS^}{Jwl#Ocwn-Qa%gM;d@TTkuEY*l`
z-m0NEV5ysH^j1h?vzCuKA1`lFiv4Pp
zo`r;STj^buRqm;^JTj}&!%~+nSFJ2BzF4)QDK8`>v#nwnZyXVmiIEPig^luLSyTHtyHj=QOxE<3q}RAqg2
z-eV6cG2vmQ$T)H8^gb%~7?Jj#=(*DC?d=`?`0$Q;{JoLjmhejdYP;1Dk&&BMsc36o
zH@&$l5$7i)Flqg|bu*)_Up~Az-(2LLog1+NqWz(477=0{W`XcMZ
zGeBz0;=|;1+iLqbzXebYg*`J{^+DC)A4T|&%`tT_C|aiH^gk;V<$V6
zj68mHafiyaqiSkC{qdeQ?`}pn#hn`ZloiRRDJ&>Rjy$%TqZ$3}Wv#}&O7B*>C?*81
z%xg%rMoG3&18L>{i&#~Y$EV_U7k#}KdWnU{!est#F!xOvPp4R6^VDPUCXcVPTl$T!
zERKa&b|aKH)TO?|;|>iC6%!NV)4X##KHfaLQaQt{0Ac9W(q|n5oOZlt*SMF3g@tnX
zS_c6ssrk!0t}#)5+OlP|DL3hE@R|bs;x}JMTT4!hs%`$``t|EgxuOaR?Yok+ugArG
z{-Df|k)lmKl#-mB+#&+9%gC9z0a{`2soHb5;MK8^iN~oO3{ugk>K1>DEhZ1bJ`7kjkW*I&Et8*;Fxtx0sJZl`kQtCgk
z``Ik#xITX5>>E`O5v*Y{vEPob@fiHZ62aK|b;AM#T`3dp<>@@#9e^ZTY7EdxIp+j0%QCTMKoW7C>z-jjVAxAqHhhZmmu
zEGi@83vdbyWu9;MF=~&lsF+x0`Tjk7?gK(a-)YXX)nw{yIuV}b#SgqLB$Q=#+`+*i
z>=FwWw?6nVm&>V^C*$RdqoI}Ev6cbz-#TAJMn)DowGxEV($WHS3tXBqSpB8IQQ}PB
z+bg}*u_DyvnJ@urGjlDx;8}U-w2M5i`q0B=jFoTW#MIT)04pWjdS3VR
z^sp)+EeFh3TLOXf_Vo!{mY3SRd!L}75cDBUGht@rOJlDKxx4Rcz1CcN{``50dh8|E
zOUzs*k4ya*X8^5OD1s*W>EFK_Z7vuZDQst^-1hE^bKiRupP1Mw-ln4WDaX>%$mr+L
z3ZI!_<59gFi?S`kW;br#GQD8a?$sTJx3E2Va;Hwj6@v#xu5}s`y}i8!0Pny!%9nl|
zXw0$PAWh=xphouwN%`feI##7Gk5AtccQhE)tGvdg%#`3iW2~yGs#AMcNXff5+E9rJ
zKc}jC-)}U*Z$h=}H}Y!K2Txp%17PzVyKUs!|1l_D#xvWZtk`PawUWy-QFzY5A;Yv`
z|G$R1e+`!vR=F<^07wq(WpKYYzVdzfzrnGUZKKWC1YTMrn-CEl
zE$%b*75l0P_yi!hJ>R}ARHS^aD^x_-_)!l~6Ky~<(8T^0ZK+=&r);MAO7CQUjdNY9
z#&qT3$VR=f;8bZ5=8XFRL$?M?CDT(EvYay}9ae8r_^?_ln8W#LZXj)iRVgL(7d3X>
zpMLs@Q|IY*qwF
zZTs5J?a00N2w}PFKA!B$1IPi>+XRJ$1D2;7m6_V--+N{RHe6)4n0qT$bE>s?nuj*0
zlCnz0#-{J#@fZ9Aj1Qw8Sm65D!_^V6oA#YS&yyPJqn6rzdz}V2F1OBvzG(DXzTCby
z<&N)B4GoP_&WHE|@OHT$TodB8qa;%R#=8&4b~N7}1xE<0mJc)9iV*fwUHQ-ZKH
zl^05EP$7LObk>;j7&sU8G
zzoz*P$kVFa)azb8NpVb!U<^r0U7@`uyKMC}Io}z*1qJWmIMd=?1fz$|is!~lyRW14
z^!FPsB?P}*NmAi*ucwUsdecij1*;rAI;4H^pvW{&E`f**^*9Fq0bb8&Hwg$>d1PJv
zoFbpFN$GNBHz4fH3o}e(s;mXQalI70HUqY3M%2u7JQ<0q@h*Yc>FJ5dd@f3-b#8J0xdE#2w>S3Cq@s1p6mseYDIltbILE+mLusGt3
zg}cTjvxyf+#CJHiGF9W&7NwshU4Bauu^{M)SQJX6)d<-9@(pI*L*~sDy
zo^H#Rpo1Sd9lHLzW_cZFW4M&wl+NY+fuoU9XFp+w}3NH&s;}zy9`=
zH`dJU$hM2SVw`WgJpUmiOkJSizHVA(cJbf^7WuiJNX^I2?G{ExUN1p$;3m@IJ(};Q
z-QftW82pXY{ZBhdSY}m1{R}$6`-20@V=hGWl(bjjJPH9za~UGe4H*sC(3duBGl-)Bw-Z;GmpTZJWk&4N%zOw
zFW^1>)*An{(DWa;#J`wu`sXL&IsSLxACZ*1j2})G(9u1sJ}J5hQtz9NZqQTMKDprF
z@H|0NH{Jv&-~2wUhL5+Gwlddx?@%bpZlBSzA6(Se=(Df
zk%<-{Hb|{5j!8&p|DY@>$oy;0+XZeFbD5TQk;1b{y)oIVX3w1H!XZ;$&+A2;(MMa$*sO23OSctQ|^BFwQCB6>qjmvjpEqn%${#7}t
z3xk88G?sFt*oQuJ2W^T`Hg!mbq4d4
zcVCkk^!~AZ?v;dv???gb^ANr}O-&|_r&_gH=p6CJ$k^CfWac2&S68>@Syf!A2xaf@
z>1px!a#~e&y7&kU+=?W!CWozKSeDG-c{=T|-3I7&?b@}JAQC|{GPBoF{FcTm3HInX
ze&7O~|2X*e1&acw($~*<{m4|Jz=>OgOo9Rx@^$XJ<%q|D(3|g1XwN-S39=Y)!qVfj
zwSd8c-KI3aziSm%?B-{+yQ)Kli+3Bm0%qOZ+u*%XRhB!j=eo*!$?mJnT+;g-KRp0a
zQCJxd2fVY)?K@z)xY$k$7)Xib_MiGlI76Tf+^<)wdn0x^IHY2ZrAnSazoD!`W=_dp
zL1T)G7q}07;seAB4_xZTYTr*z?opgfSw$z#@0~=(94ni(U^@Qx#$HMgm~903i>!Sh
zhCwD~v<#_w
zfK@`1op^QC8+`xcQ=fITv`Feu0PsT{!T+W8z(`x!;?iUdkM!BENWfs3yOGLAT8hq0
z4>kbaEiN=tEu1E=H?zodhil&4HvlU7);{~%FV58E3UrI0+GGOF57%YL
z@!>-U{ef#wbX;J$#0nZR=SkOJ8w!FROCwfhwyEG|48X%FQ{hy(sxgrA@P-7j~%xKkYh#$$F8}Z=Y=wHc*x-1D7gkOEok>
zfZ8yLwkIe*#6(4}gofgFW@N@n^YQ~m7z4ZUS3W~oi?d_k=zBLvw0vthQzL{NKi*Y=
zB;Jv(owRAl+AipnDD)lHtynJtN0gXszW7lf}xpf#g1@Uo#xh#XBTRu
zhaQ}%kt|0o!RlAM(oR72Jfd`IJ~
znv$JC&EfL|6W1lI{G{~tQ`Q%Ck+QS6+L${W`|Lh6<(`Bz9qP1ewg!{OXqN=A?ax(1@x4B(WF1=1GX;+|uXnt&czm8^oVNk_%SNdaZK
zwZ@-$FV+1jY&`{!WCD*|&TfZiyT2zBMO@q+XSvrvbL#8IZcpl>In&)IPv+Wu$Fd^#
z@@={B(kl0Jo^7m#gj#`fd)xMFuT+WZ#JV*k{vd&S&(^X>2~iONHc2V5nTB0r#Z{TR
zZoUEv7iS9Mg><`#)yvBp!J)EMgZ5_XOo_F~D83l3up%iTAwh?0*muQN7f~XYqULR|
z&ybdCp3>gY5VII=6fuCC53zF50Xh1r-Zt+lOWI*;;=xJ4Ci09MU9{x&?0w&#+
z95k->WujgjD`4EhD2RKozV?s2_>Y
zW@3@|EWxd6PsjySBqM#doU;$C-}ejsL7pf?0DbwM1NS@kj3vM&(E&>^i*1KxzZn^M
zrdp`5Ui7XV$jGkWpfZR%9-kTh4B;VrZhJH%kKeDZE}%^GTa}<99K&gXqD4hjObP~k
zr%K-oM+u0YTS>D2_8A9-x#8hq1hlgGzFWvqme3>E?;i}Mr!tNb6eFm8gIEt=<1{{0
zfWlH;xM*k4LzKX4*KetRREOlm$NcGmv2NZLvd)ey-GNDndeyBqcr@Km}}QdRwZbsngJ7$(p&wkdevpQdG=ZzOc{IkuDbdQ
zI3P-a>M|=iiOZ
z^7(hp#}efIU;jbDk(yf^qf&o+_WKW;cil#Q!HVwLvjvU+R!C6
z5)S>~qiSJ7QJgt*Ca0+H<|A7ah5TP|DD0B
zk>A@A8Co&Pp!mcgcZ(I&c$*rqxx_$znRxgk-+}e2BQGa8oz?uRB(agQTgc(0AiRHm)FAz|g{PyrRK54Xj^{?BrV{xL<*LP>%w&7CJO!
zU}KPzfX5WLI8xX+(s3fU>2zW141&uF7@V=Xv>Mc(*Kgl$fw+xyiQ0071nZfm6PfKC
z)4L4b#j>19pO~27=*fFG*GkK#9UJ=eK7^KOb^KFFe*^8vAkh@EjOIeq#D)TQx;s{_
zwdDRZ(^?xAV_N+E&B0~PmfElzro|47#VITa|6Zth@nr;q1bCi2i4T6EL0mqHzWMLEqcBNXdY?&R~^moZfQ_8Kw|dE$|k3
zd3i(q&pABVDfGo;j)fuMw)-dJwA*e~64d#3;7r@x8_nIntZdel%>{pm-QCyU534~n
zASd#PZmWmujis4FYF5p9#}@M-uY+q*5xuZpnj0tX2EaogjvLX@`u!t7_(81MAPnXG
z7f^gGjW`EpP6}UMN59MK`9OQvr$Rx$f_?m$q!Jw1&&9^&-E%$H=u~f2G>-TasJV|G
zJrWfa{hoyz7a+pN|G<*EGMJe&3XFALO|IVD|EITC?MDu&Jj(lF0yS7U}V{Bn`w#1X{4Y1r<#5RUU?Z2jAE{m+xG#o
zO5n<50vt5Ao_xcHS?1YjAdRyW(_YVwca!1=5{YesKPe?}zwfbXQL(WS?t}ICzDa-q
zquYxO5@!C>4e$mWLbii~KoSq@a}eN2s%LKa$okQ%nS(XkoJ(_&tLy9QwUZ9>s%=uO
zM5?IzezW!TP~#W@wD<^Rrh$Qh*_Jb!s6sOIGuN$K2P&Hm(T=F8-NeCw2ME}jigkW@
zk*sc)@eN#3zVGa4$aCFx)&CB;zRjPW`=8;9nxY?~}en4<()l=k#G$S^;y7}*$wxF{eU5~y9be`CHStV1D?R*ejP#P{RZyV9o0Chz8>iCl
zJ$qD#ZM6+IndV%LDY(aBnA^W!&MOBhBt-tYbthxkD=mK3!mrYFBlJlp*=ij8~Xnp7WHj_iBKWVtnE14NM=P0(XK?p@rxeYAThr7y~FG{rgO`^uag{-70Ebj^WfMo;N
zyTl4Io%T_MNB`p?5bXd)Sznm^bh9mqyU2QE{GVoYCg*oMXrm%!4G6E{t
z41Z#0H~d(E3xuXw4EGRtfmy(WVGvWuf8^wXgYuv6jdd5lzDp4NtBVU_Xu!l9K7`;|
zR5mas!7sIO$6>veuLU~TqzQ7q9w}+r)Rl$2_tKe8B?R<5fFlis=bC7EuNJko9eq&!
zv#gg3iY;b6+qrL@go=VHLC!I%=_Rd_bRumcM)=@rWI-XJzy)K4^v8pM4Z14tWi}5a
z;ocj2PjrpXnR~W2pl*KDNQz@1{7+pKp(HjFPDzny&t1UJgvUH~>^+{I;RB=V&?mjV
zb%43jU$|saWk0;CvebK$=s)3=pk?CX$yY$G0Uvp#CQYx{+8)ZDb*wqK#9002_veKl7{56$ABlSC=#5|RURkxzBuu*F
zAF^qRf7y!Q>)s}7X4pz_<@5uHIeSqefVaZI4C9m%#We|^nWCQDJi1Q;^*&7GKN>+^`z>0xV+Dj%4qDt-{05mRSg
zjXZ#{YU$N9hyOsf_UQk};TfBdKtu3PvPuI!$$FBvrvcW$HbTF@9TLdAA8@d5x}iQu
zAt6<|AXPf2ScjINIlvN$n+&nNC$-bbK5<=`L`PH68CxdGjvYx|_g|`;!m&rpi3?7h
zYSz})Vcc>H5Yw4IPB%{>$dmF>Jw~vIwz5b}x}VBR;M!g44_vYR)BS1h7;JiA
z+0(d@qvuQ}W1qg5)4<{CQirF@EjPp)?iZzGemd7an-O@qSMg5~0m}0Ui1C!5s3^6=
zM#ZA{5)%^#1Gl}GUmSj9$$jSS-tNlqF(cyW@P=)luob0;iAm0m6*q81Lt_I4
zRH?qKzLC)l$@I^g3J4`hD0q}#gjcRTm-MRD{p$xp|FTt+TO4gQz0ld9)7`rNaWnlg
z8E+U){)c)+lzbehT`eF@x>S+sJ^4D&=^LB&?5fJ=7uVaqy)ll;52zIR)f|;0icY5u
z&8o6LM|im<--dj9k{zpBBZ%_^R3U8DAPPOk+RVvSZ8pkp
z{3XFuPV#B#cG_5P=So0P$~GbBCQlN!iIFcUj=z8r*yu9cT2fd`Gm&}QQY%jBIF~M&
ze=Z3D`kKrrQk~R5awOqGMo-CdQxW(_OUBA;BM?btftLG$-4GO6+zSq+9gA0D0*VLE
zDiABUbN_d8gXu{bc`xizHnGQOykl`BC*kRFcROk>6(`mcDLYv;lHXiQ!n!Kz(ZJ#R
zpd(Ui#hLYofW%BpV7;~kXH=vsV3_?Qg|LxYUylA8^}9it{(hYvcB?8gbILiC>_7q^
zVmH?t)w8f@Be?$MIAK)lbv1=7O1)~6RY48^NRgfExPVYApIi>sUZxm(x!;
zZEC~%dqHjx9!gu%?n5GS6ZD9DNC!w>L`!G6Ujkvh9ApX!punSWzTUZgyA;gFn@B$P
zEnD!!%1+5{R3ctmgiLAo!Lx9X>{NrBeer8j_#Kpe5CR;K%9xJhgp;rcUXzP1t0Ue!
zv>=2imSI!uS$W69;lcnVZp{pHgDchsFhYrGd0{%!i$C`p1*MeP71#GrC_I|&bC6AL
zIhT8{^n`7S7f%jD@eAkjrufQ1`Z(gS{W^U^^XX?;Xk=o~G@iOl^m~xy2QtGTWPqTuRtHll4v>H>#&wN6^Fa+55|m3#=4h%g>}Y75e!A-E
z0o>O|JV)eC1oASoc`)po7*WAxd+B5AGTlY!IlSXLn13?_goT}EUfF}QXl=hK(vf&w
zCO`NI$TU_ZFGxvM(IO`KyIr*gW;pR&*HgTzuzC!VN125>Akmd$MJ~Lhh)5-fzicom5P-@C?Smv&E568QXW=RR7kX*t%H`eN$F>K
zKd%%+-Wi^PTu=ZEE;l%vxjBi?8fw@R@KCUH$fF!Wr8W$^(dLri)Z}D6zj4s$h}I$O
zF9U{5+cP3Jl1qy^V<#Y~qpNHC{x-p2tfU+w(6ZJu=_qukx$f{BuQx;!F*D;-ntShA
zt~>ORxF7VoKCA}12Bexo0J*kREEStSBm$*?MuPk@J9X|*MHLi8x(Lxpq@uIFBru}3nZq-lEuaPI^xd3(b-m5TncJ_9+YN5cn7d&WN
zP+~%=9r;q&j>7v-wihJ<3Z~nUk(2RberZm-&iqC`5tl+vHn>Ti(eexz1lZ}(R;ZdK
zZNjHc(RuxjhfUPLKs?mSux+y_*NAB!ML8Dj7J5-&A_73E4Ck@D^@@-Hw1pfRJV4wy
z7({f#SwaKIDZCg*FG0qW@TVpAb*UHEvwvzZ51ECLOu&coAq0-vGBVRgv|5KK!r3*AA
zGnZ$mrHSS5ixevtUH@`1$_IQsRjfT2p)ULb1%SIz@EnmX0bALWo*++ErEIg_z%A>A
z)X}>R%n^<&SsfVp!5pH2!rZlj4Y@_oa0JL4kPH941SSVu3kud&yc)FHI7{H1GD4Ys
z0lGkp1RrC2us+ALKSA3MyX3)(U_PL>+JkO4FFuQ^Tl3U`3D8_9+}BJ$fp|{zY5@U(
z9Xn1y@B;>SyZ0PAa8CKcAR&+;SOej)$W3V#ZQ*Yf*vB1SgT^7k4_Jjq0J$@7745-c
zfeFf%joskPLRc7`h^^18wH$*U>fkaD9HW5z&kDhEGxNZ6#$Skzn^W_437^)#>`J>tzURa(;-a(jLQe(>a0uBuWS!Sy`E-*4z{q*b*8&*
z1XK+;cye}6Lv4U6OWug^?#PbB&xw6Sq)yx^)Y=P#FGU22?VTPaqh296H{dZ;xlBsz=Hy
z_*JZY-xH=%ispf>zl+}tr4netHWa)-EU2p%-tZ*|nm&Gj3KErpsvlGD(y*;U$;!eI
zA!T8%U0Pa#uA2{qIQ5njhqyyM_^4JG6ZoodD1KIYg6Bd&bA=zyAa1_K*2V_lH4n~(
z0Fc5^s*_Oep)$6yu`%fH&hWvGpp!!jdDxhQUZez>Iu)gKZMrmgWamZzM!Don0wJER
zVSzj16!JGYqnj_ne?VPm$jJu2fn~J~H`^;b&{{GJ&R9J*4z~$MTTtAZIHwb&?)ABPuc~u73==G`AA`_*CFkWCp`56MZeMKj12E%0a6bgd0`D
z+rY$#0+OYE8ies?^S={e13zPp&!8CQf)>um7o(?%8Eh$1fKc*_usu_Ewr?dkY`&x1q{mjZaP*4pjd6~r9Jda
z8`syLU72fCef^YmSKN224*hiU!|zOX+O7w)HcN(DnHCu2unlEdR7xk>6?}47mNE;j
z%}hU{&nX;pZ~LLd^xyO^T|W0?mFz{uBdg!cD@Yc4_a-R**m<&Pd^sTMLEdb$W5T3d
zUH@>IN7^y$rE>7lAko#DK`k)L3_nDC0Y0$vY=nKyUZ~1PV0DVU)fSIqfiUb>afPkdx%uI7<@r|=j0WH|Y;X`uPUU#*
z#Iavb;RLB1&FSFnOI;K{N+-Drs;jGIK!by{0I@Qr8o5gxo`WiL6i$?&Z|@}9qwK*=
zB4FBgjiD6(5m0$5E99pW5O+hIS4udK$Hh!Ah9D0F=|mgs~GdV-uZ+)|Xc#9#8oitR9xY78Cm@r%`)H&?gjc=vT6^CtS72D1oufQAKP
zk?J9d*cl%0&$rsX-@x&clF{Q+#`9N`R)^#aA-${nNe}~oL=wL8x1#;gGW@z-kZ{5dZukS!m_ViLe`TjF3cCIfNx=
zeGd1|tlLoU$f((^mkozExgNDA^lYU3rHM_8GN5ibnhdz;5=CM$pbh~dc)J52jna)|8Pc~P?1Frs0gP*es)QB*LQiz{B94`zIA=i`^7ZAG
za_a#oh6xAkQH$kL7dyhVu(0s47Q&kXG!dE9+F+m|v#~eUlAB=8IbOMMtS+}t72*^t#B-0D^%5-
zHntGlvJLwL`);WcMLf!REUGO|8RN)kn=7w1G5in5X)b0W4qpF6dJbBIi2_)(70cQ4&HN5=5K&{vT
zroPRyrpJ#Te^r0N(Usv#z)}F5K@P4A-^w`uT6^>c2VXoJ2ETCVOuwH<`_y$p={`Sn
zMfzL-1|6Lx>0{=69e73h5K0`LMW9Q_!XJzCglj50B|1PB{UaMtS|NXP5hXd&77XZ{Ti9517&#N9o&>>;d(ZS^leH=+ScI+fL3M{21R8;J54jf#h
zP-uiFkZgI^o53p#lQr-$VL!^cpoSxmflpN1Z+OBW%f!7w-;ktPF|j=LSYd+kQ7>BE
zhI`I8?jmX+M8#v^ypTUpL_-@@T3UH5wV*
zKuT-4g$W^rA`p7o6XZRh_7ZgPyc8vvlz^xC$$k=ngpK#QiXH>xgG1B>Jt8CTRz^v$
z92dk$+HyOs40{5$2O?+y)=Gi2M44w2&@3q!U_aj)w_3KiB3U^YxA3Y
zH&I=4V{Z~J7UGBjoD3+*wg?)1y9FQ)c}&1K5!VLo!PvmSfTITcR9}l4pFYUavO&Gcu3A?EILS{fH>5%bU~?gbqBpOv
z?+65(L)H@pL&3+_kG21S0yDv8C>}=ze+7-Y_r$B6%ne0QgI+CtA-*t&W=r~xYZyY+
z7E)ma?i#004i%Cz6VU~+UrQzYN#Zgp^>Q^aX(s*_JJp?Bh-d;_N25MLQVZtx*}Zq$
zk;8{yq3^5`OaOKX`%gciL{3GsOvEO-~=HfkHd0J#1`P8nbew>*Exto782(s
zAvmE85LbY&+R!s;o;?w2xpZ%eiU=@(N5|9&M_u*n*SqaC)zxvHUMP_{B5L_N%kz0q
zt%b~NVniG;wvE?+r1%`ftT@zlC^)xK;FAcT%tS)Js-VsZ)ST3dtfYGsfhX1p<360@
z%9tpnD9pf8g6KBGT#Bj|Y-aY0tW}zfzVE~vqwMF$!vi^$jvOu47N9GtmNe*7+hjq
zX{Rj)S~q)2-KgD^b|tDt)Z_CUB2h3aWcQUiw>tp~1Mp0=2bkJKUtpF_KdO#2pmbj*
zt4};VYXj)8Z^~dqYOxPd6-^J+*&>1wpG1RA>fDee4g2d8u}VWRPx&HJGW>{ORpQ!*
zGh!B*LexR%XII3n@grEL?cGniq)nGpeqGyIrvV3<9Vez-Az_
zYK6eGzCct)Y6ZS>c6{wpi^E7$)C;Al6
zfPx<)CPP|eGp7HLRItWNq1&c}JN~@SPK%hsCHKdRL~C|-n-ooq)DbEE
zdJpeGs6}>U4v;-j(b3aHVM1hm!*P^19`~CzC=tgl>KSgOC+Ir@({=N~xZW#phhp%^A%x$-4e|0d
z3c@G?H<6lIb!t9{eRH5ON)YBAX+mtDlH~xufh(Lsv7u9Nd}rTwp}>tXgTK(9vkA)V
zZg@(gg<{keYf<
z3`vLvRJiaEEk;qks&Kj<1YCec3H|hqUz|#W_BI@0`;kXpHpm6?54Yd9XGC>DAR{$f
zS$l!`pOlUeX%~t`7==zQ-}8qu#7ZDwA{mghMXYPEd%e+S@!jca_KJ{mK|5075qROQ
zX~T<#a;O%)&tgA9q0y9|KM5Nj^4?dd#b}am!UH3y6IZ8x^(2lP!6@*c%lVu|o>$LV
z#13#DZSe*SCT$g;y!ew4Ik6jxP{7YZ%meu=%g1Mnc~m&TM>ywo`lJQX&_PT#lCE6{
znk4NZ;aCCvBkz}C{gCdcDviJIAv+cHff<&>AlqynRMrWgK?HQo=j9`654PlV=uq*R
zy9T3Q9t4lxpAXw*I2uM3YHwP|6RVOqTwN^h9P3;<@XkP7A)?3U+k?UQW5%kD#%jgu
z1|8)XdCi0O3|tw>PR`T>=7PPHu3sS$KIqI67|5`1$T-&GjII!>AEj&y1_6ll+7Ig*5Wuab?8OYh+iR8G3kl
zg%A<9!5jiM9maX!oe~pHQ+GS9FXWXB5zbf_;*|t&`+{tPz9?8$96*m_KoUR|F6l8Rw{Onw~9s*ggYKrYDPI5ptm;E?%AYQT-b
z@nv00&#dxM!$vrdFYbdLT+W8k*!2jzL_5NB<{68|o@1LJYj^Ka82FN*Znx$h=2z)%sEHv!A
zuda5)Jb-hn){sn#I#svsqhV5;|FS_`i=vDKU#)Jj`(4FwT#5RZF-@$4jK
zBorg?2aq-=)Srash85$1*EEm=C>6|_z~_Dp=5#xPvKjJQl7jDb4bR-NMx
z$Fc?HsWjv%<6{&H((BH+01OJC4nSKTwd42on{1;nXljDGGDO8Sp$URur13$ZDnb^J
zp(ZbwWdvQd4kNC@!{q^}e~C3!GvN+qzpU{EGt8h@SiH>z=2l{-qy%AvTfx~yXar&?
z6IjXG=((~WY5-n{w9BK+WK}}shD#=5zZrfwai+diR}Y|0=U=AF^raG)0_N{PNq3MV
zR$?CH3BkZ20u{G8Jpq5Pfyl1FNV%2VUjXhiPGfWzL;6;Ci4LP8H*2Q5pjH5yt(_c@
zVVRD@n2h_~v&YwuwF-KQ5)hM>GmFACR20XM>Fq)ngeq^a|bb4;(eol#j
z<*b0Q!^(>4TLJVkzJ86h8x8m=CogKB*7@SajAFWdTG(<{ojG;)?%hpE=T3l;283uX
z_xDA@C&ZIzAvEpeDJpzM1bemO(txo`L8f612`H(WEy8FIs0Fdk3Y|flJ-oLz4;pAq
z-a7i&q^RBD+;Rp762Rvik^qeTTg7?Jb4~nOJiW8`wP%*g>z_|fFNwU0U3`%~5@02j
z44~ohJ$v~e)JLcmq@Nx6d8JQ+y64Q?tI^xoQpmDbE4#_G%icngF6xtueZN!L4)rhE
z42P0K3AVtjC5i(y65NZ)!`}{oup-R|RXnrkT6X(zfDshGqi3ucYUVm%SQ9dnZ1>*x
z95DuezwW0_GXfJ-CB511l;j~nWUav>VclB&#N^ChNHb>81o|05uUv8P8Ul&Uxqr2`
zw&$8_5XpmBVZpkckYKs%^^vy<#rRYMw@V*!Q>1qdv;jfQuuYUyd&}|v(WHibEbQD0
z34#nADfh>c!j9*ge>XXukw@I2Hz0FW$>*HcR7->Z#dTo#`XDU5i
zg{#oimIB*>a|rGbUW4kEec;?!m4KuL>NHi0KLX_=XSsm3Za-11g0d$sU6536{!*vLe4_lG144~7I096!`PmL_XNY>QFv08yWM(`
zyfctAs}c^)tlbjcP%-R&327Qe_X0Tcd6G*AJ=qCr~yo;B)9STrU;4R2JEoOrzh
zX0(VUIheQ@BJPg9e}->jEy#QW!k=L2Nn;44CxaXdb3MI!kYc3uIX2lhTbnZ
zSU-U7ZBP>+lTTw+8JRh~VCvDgx%VL=?--%v4C!p{ave;RDVW~CBDa?`)sV&h8l#H)B=NJ3jt*O&tCwTESxfcc7L3KMe9|Onl6!$;CT9t1Wx&T#}WF&6;E#tUi#;5GUM
zh~pXH7zvUJTDqbBMVm7T_vy#omzl2NJFO7Akm#D>Lj){^p-cw-iReXh0(sQ%@$awp
zc9-sejpj4vl57pH3})e3A>0+}2SWG&F~CD4ihT8o3mr>
zG?LUw2gd&c{YSQN&jersKj!bIBmG0kLmjk9NfHQFy>JXP7Dfs%QAlT<>hSR~33@wB
z3`zh{zsV0D{<@lmxburDc
z0&HWm14}|!jHVo(2Ma#zpL2Lpef((kjpms-i_wDOfwX;g-vW84#3Ean$FEhZxRzWN
zz_iw&Tw*>7tCu{$o@_x(zV*t{7}EakCQ(;<8#$mf1LAo~JRa2je?!Q`E$Ucz-M}&-
zLs5r-GQhncGKYOaf^Ex|T`TExVaLOLnik(RY}`uqeegI~OQ?(Q-GdQ|UTD8a&dA1k
zZ#8KXgjG7rwydllu3lWOQ>(aa0G#?Vgc2gAQq=?_FBu_89-L-joG}1-)U{j)=X?(zpz&J~Iv;o5r!P?>;1+3#_ge%G
zUbk-W+4WlrOr-6w!iw@8%hqW{RMy)&b_)v|)Yh*FY3yfxj_@44Z(8w9Q4QF^5?PNM
z(nsj;)Jvb&x5V+)jzlktY{3Bd5tj}SxQ7?4H14sWQg|zVU
z{=3Zvy$%&FX*34|575f{UK_9NhQ|n_QV1`L?H6O=g$8}X7{Z@m+{-;Q0e^Dz{Xa4!)TI~?->zNb-m!lGLPD^OL
z{1Ybpu@4158U#ZW9DD`;_zve8yZV5tt|bOs_xAS(vu?V$L2*+Bx{gkVuX6Z|QIo}R
z^nz>A#C(*;m8*RnVGTp;#|8=~C>G3*I6_Vgzz>WjUT>Xs8Z_Y5&n!`7H
zj6S3cK`&#Zlc8SV*grlFqv)t0`ArX}&@2ky7gQ-+6m|(pXh=pIl`w>79=wm)mlx;D
z3UHMugLVadK)@nR5|4w|_&Q?rC>j}ANYhpl&OA=)L`pyVOu&w{64p27#6|1tUS2aQ>=i{8MJx
z=+*De{nGKvKrQ`GRblLk*(P^TS!3YzkTVCL8Kg54@tw4&g;r$4WUhNmD&=u--uesy
z{zrLvD1Y%A2DTBF;q=FQhu}zu&4yjXLKcUcJYMv_^R6fJmvPKTF&9_FJ!fBo3^
z7%MYDwP_TC`jswWN-09)E;8aG1mm>iWMUV(z{rw4vT@|*;FTb-MIc@j;Bbe$KrHEK
zJ@^1$m(uGuZ{{Jg;rB1xjOdcp9sHqzSy2b3)`%V4;R>*1z_8%(A@LcCQ7_Ef`!sX;
z@?(^bFc9v6G6Ega30JP_i`zweyqRscSo-Qe-yod}S(8w9#Jz*WzlSO!PtaJ1*fzE$0p!5qHi8%W=-8b^L_x*@IVE8S-GfUrGVeE~`$Hee1DCrw~CoV^oP7w#QZ)n!RiX3|^Kp9w5
z3>JgSM0e$7It;1)XiA0ojtoN)XsX1sCKrUi#;yjzMH-nfgEy}5YLHqv2VdEXF>^r$
zaM6=BEEGb`;-sfY5Qi#_938+I5u~b!S8CgZ~dvc&S42{%&)F--I{YK#)iUC
zB^G*!;yGk`PJ}i8d{6V@Grgl(yAE|#KZS@3k4E03NBl-^;9ZHk7+$C%>}^=MV2a=O
zu^iMV-%3-RO0sB$L6@&(9fA)r&VxB3W7wB&m(b@;c4AmY#&3+E`MqG5ArrN>gt`wm
z?d9dQCWDY;gcf0IM<{6kyBWbNFz;}Cih1^{d7@~>lG(NNod&*2^Mzx{)SiH`BlV}t
za!eDMH@Rr7CpVUbdF2>uLL7o`7=OpEA-`~F#dQpfJ!z%~-j@bxh0EoY{~hj44P4a8
ztW9K^6%HU7O81h5nG6TOIgvq^Xq~1)8S+#LI~k=8M_%A`rX}FFSdbPRm1N3H4dy!X
ztb7ZGZefKGyr*>p=0Y$}WHKtqPFe17(xUL^({e`B6s&3iWNVa%30jompz*+ywSYAu
z?x=O2QWn7Tll~QuSx&XdZ$N0fLzFOdtB}ijMH(EjZpAn#=oG|AcXW-8VG~j@KL~k|
zUn-y^LNmLJ=V(Q}gU-~*7YS@&7}Q8E1xjN^Yy<{17yg_CnO4r{E#^YvhR}<4U_OV}
zcj2;LYLl8?pZEwi1je7d?|Bnh{T(MTP47s+hcK>7Rts{@f
zsIa%@-f(ZL$IK(ZD>D(9XrQnLmq|t@^mJEXPm@+E*5{Za=7HJOQKhyL4)tI86z1Om
zBb(ZkzzOmcRxN$E`d-r4j*e9?S$UWtBCLrXKTD-y+|u&nFHY)yPkx|)og`*1?6?*X
z)I>NCZS?>tiRn`sI5WyjnEw>3AfR8V68b{jDRBOAr?xW5p48Gp33$9*~)|
zb9=?cwyS|fU4ac>nF*7#oYgi(B1;etCoF`-)3&t2$-hiLG*jfz%$QxvCWj`ja13(v
zpx2wMbHzgT4=UZ)*B`jn@yixFiJ|oy;qemmZuVa#QI9s)N^YC
z5!%fd%)3LvD@9%=zvXHEu8e|0AVO5<;(JY1ztcl7)xcb&Ra^#V465)O2wRA*KG=Cd
zYE+VC^{4T3bKDlI(Q8`0&#M5o9<_yKh_*NP~F*EHX|V
z^Ey5u0+RIuLk$M|w}G1N|D&}l|A%tz!%oYgU9_iVYDkhKM6xt_lP!^ueL0<&n1f`>
z*g7c{qbNC@2}#PnM6z{Ml7kc3_nj=+MwaaFb?fu~0q^I1=NG?>XP)P|@B6!4-|KsQ
z;hon|T!4}XH4t9;qlX`cWKrA@-Vf;*Z9XfQ3?j%qAUZRSF%)SfA4O+N7nmv3v1HI
zV`2A(W5=&IG!6XzBmqGARda0@IZT1l57R4r0^w7IK@>4p=atdRC$3$U{fl^#vSudGipy0PE_
zp9Uq7PUj(PEIgV#;u$noQ}h{bWe_g&%igM2xG180!D8yPz+%!%yWAp+s?4AM)4-H@
z(`lg6G{^IGL-dLzLX`o;?7CEF8fYSaIn**@|P_XRwuDIb_`Y&t8D~XFm0D3Cy
z=p+#kLmZ818sUL~+&A}2MAD5OQO=H3$@Oj7n&>s2R?mDfh27Bn
zG;7wXdjDxZEh!BLgy+X_bri(M(SQ6yatW!IFhfJgClhfPm63?pjN&78rg7j6c|b&k
z3#uBCTC8%WZ>(KyavNDoI8U^G&6X$(;ic*37aK-w(Oj)8k%F^;b@egZreXH(KhO7*
zuy4T-I5*Fnn7r2v+t$`aTF2#pT_^_K22j7S`!
zf@(-S1afl4zsO5X`{;@6G&QWI-Q8FZW-LgM%-y=Lm4~yI(*3-zXYJy)v4C~m_9D`W
zM&hy{^nro!ivwXZf|^hIJ`gB`#VZ{jTlp&IgYeHdaQay(&@e&USNvb>mul#?b-@;d
zMwZNh14CFrhx}AKgNQ9~Pe$l*$m;T%pYS@)hgxC$cl+TV2YwM<<{bI}!~ft-%Rx>h
z&QxXs|ci;(-
zfjtlVLe!~|#WG+2vOd-c7M3sx3k!M($q``Z3JQr0gp2hToQ%Fof=Ds4F3{ia01Ch~
znrEGU1~@^)R-oU_he#Kaa(_^lpv8QV#mcA47yJwz%HWt<0`*gf0ul7JNUNv;&Jo!g
zBv#N0uXM1~n$HT^3lzOAK{f-w4kXoKRU2Uo_Wfq7u9l?&7RLxnCTIYvQay-ZJSO8h
z4F)oW%nD=2n_`}aG%i2!lp)y1Bw>`i+{u>+b*G82l*DgtNc{wScaaWTG|+>GhQJ(_
z9|-6sOU?BAWi$w*4xqe}m4E>ak(18KL0}6(;!c#zA7lOyQY738O3>SAkUbXEC~Y(-
z+*8xM<~iBB02*-)qzO&0<6~4*6d2m^fLDKM_lIpH0+6i5U6jXnz%|5#BqSEA
z(CAW2g6H&%&A312Q3+xCl(3Z2_$GFQ{N(oh2^ucm;ZChL0+?;1*nXN2G@#xX_d3oVrieao$u9*QJ
zGOgR!u3dv38oT+~k!#SJyVb
z+u|FALLsW1wVqI1XP>wnW9u(0isWwmv6c2bYv<#q@NIO`|}X6M#^Q1pDx4x*CYeP>tK63h_EJQq18^JQ>w
z4(TV!KOG&DQ&TJKWv8d62+9D^0Pv1YcXQVZuFruhA$j0_ZC|_AN|u8!biOvSwzfud
z57F9y4$Lqo-aHRd$H0`p$>K_rrg$I|(-t1G-e6HgNvd7O{bz2xM%`#{N%
zd`H^H-*#pJsx?nyy1Is;Ax}>)=tShBzB{Dux!%S4SS0T^Sy@@uHa57d
z8q3&(d^9yR$*2n7+sGQwf0PT0XnVKtm)HdI*$*8lw^3WDR(!gR*}sPlT>`&9QZeL!
zMPhvXQTOkT;2mH^nv&Fe#-=hd-lr
z8*rH1-E$r@RMpg=T_Oxv+0ya}?g|A-2=WC{IfCHxk0TOZL8+vV5$2HPyG6kocrf5P
zDNq$mPfy3z0v5z#u}n%m00X5NC!B~>*VN=Fd(D0R{23%U%-qA92Dq_%*DigrV8sJP
z)+vCy-dReX40;e2_7|r5O)3Qr4i2Js3^zDF?#il0dDQVJ*(2xi8Z6G7xzBG66qXmd
zrtCw~TePvNT3Y^}e6>9>zy&^6g%7HZ(DP_*AIZ(-@95}288`giJx6#Ybsid;_6z&hL|pAF`6unDd?d5&}vDJ#PaIq
zX3w_wODP|KUE0ruEAQX`DJwN8NvC8d)b((59TJ5E1u;5|^9fbbYBe-(C+x|}&PLeN
zLAwQm(p(XjjK<16hlw^zTbq@FA(;N(4==2HZO_N2aObb&cZ!PsedN2Xt!)N+2KlXF
z{mUI-VT!J^PehKrjEIPk)d8F)?2|k{8Az;@NxBxF6T$)Hq}XiRAhrNp&s73Ds`c%U
zyKZRMclg)RFpunm)xKIH6;0vo@FCTqBax!j@PVKThSM_*&z?P7R#paj-MeJO@!;&1
zl$H*GmC8ahXeY-2Z(DK$dMMw%J173oNfDsugRSrkH@b$XRBGcy&<+0gH8m4}vW|qJ
zEt7>pPGVx>!b5LZw{8h9FGkjDtDnVH=8eb}S_((|urVV~dox^4hnu^*d*=xglLqQ~
z+3Fs~wvkH*t8d=C$vAviO3E40ADhiyym+y3!ZVuf7`+(jEo^>TQVm{}
zwre2$l`*5Ts_NVhMRYPLCX54oE@A@~uPAwsrxaR-ccoH?7Hc1V4-XI0SJ*r)QJiI@uhZyXG&5P{34Bw4URGc)zBqDgoydcj;;n
ztrvq0jvC9wH|DuO$@=^4y}ahb!ot8Sg`E?ZluS-aDz%jK57o1<2oDZ^g*?E=#|KP8
zz&dgY3e3xwanD40kH*JjPK=JaD6GKFccd;@lS`K`D>}8S+S}U$@jmrpYxdX|0O|y0
zNlTNad>HMmD9~<9vGLW2aznHaJFbU;-R9*iPFRC9Bj$WMYDWD!T`ccWIozjTIk!-
zjnSW-oo$!Z&But2hfo|tXI4#hHGW}qd|V?4+0yz=n}|pk!eUibRjrdZl$4aPmMG4u
z1qfw2w*3x)PveAU(4$F{w9UtrU%4m~7{pZ>C#0vOlvzq{Vt+(c4)ZO4=H(@l>i`$V
z#>d0%Eo_~e(t}Rtv4zxs`z`79>(}|#1Un!SEin>=p>qF*He^f!5W&&{M)vfXlY!zh
zhn#q^-?%G(zOE7F?7Sts{_EHjB0hwH78Wf50jmuSYxeFXVs{fiktk%{5DM+E7U+iq
zD&vmQ91H(TXAlkgP~Bk_Aza
zOeum0s3eee0C>{xf&J`M>|p%$;ZE`=8;tx3O)i>V4m{&)#dVwf4bVLrsZ&
z>AIyXEG+EGhxQ+3VOjK$g=OIzwqNi!N4_aD@NJ3Bp<|a=ST=Z(|1a?E9I{|x`GZAy
z|2}QUu)anoSDng7;sbUocW&PwMfq*((w;?&R>xQfa;2(ONKt=Ldl*>Prtvj+T(>{o
zO(gg*Ydr6^Izz9DD_101jI>ieJUp~-^eQFUBsmo4$oS@TBje&N8kKZbwh#<#s4OC<2k
zPDp0`auS-2$8u6Zoqe4el
zSNGt-gKUo;K75#-o}TQbc<1El)8gY4k9Emc{_d+0Xu);=dv8M{T*UBof_`$_6JNRM
z?@xTIl1%B=&AGUtCYQk+*80yqmGP18)7{zG*^OBar%#`r7;L8H-&pb7AT`bf>&^1V
z+D&$EhNgRyN`HK6hWn
z>7t2AQ{Yyus3Z4}_7>x9_6{HFk(Id4v0=KzbbdH4K5^al<9mCno?Cs*`*?rX;lqb#
z#(Kpsc6_L)sGulh+4sATzlwYo9o^O0DPo$NT@{3d_vrAeSfI3F_3G6k#+kc4w_pDL
zWw^7yK5ej>PGdXKns+TVemOpAQ&1GQO@d)sVob~yu3KY$wXgDGO>&&CQHF?@WXp#SA0#>hwG`Myb4HI&4I`9=kGK4gSCo^N=dNDD*iR5u0uas-<1f;&;EFK>D$NdvS%d~
zv05eK!-y;SA8!^8IcDR+pBtt%rJU7LR#vvRAIAq>x_D7=)KMcSJ|r?S@?)e(XR1~8
zHhzA79^bC6F7a{whlxkEw2-ydD{K)Itjl$CG3R9Mi8~kY6_2p?WZ>pMgoK2W%`Nur
z`&0Gcla12SS;<~36^D+}4?IgrNy!spDGt$YVoy;~^y28p1tB^DLPFA*)WdG{QLJ#Nm>P8lp-CTe9tH0#`
zt`)1#9H|;XqODl=xBo?;1)u)!NvZ$0zcBmM9a&N@rLtYz%{d<>=Jt)ansY8-iCOjE
z`T>1f=fa}Fx1mXvp6sQeXFBebi`Zmg`En8kf8C!SfdP6#l(g|T|MA-Y_pETJ*f>jQ
z0t$VBSu*f}@+RhHu{pH6a;D8Av`4R5d+^pm%Q#avt(>II4^2Bv^89;cyKf`Oo%$4djWXU>i(FDx^X}0>gVdX|
zjHNBjo*wNQTZM&h7q%ng`+sQ4afui7nT-sY$q)^d(+b`EJ}~OU(`V0+67%x%+S=Mk
z_TAXx5%Yq%)&7%^(%LzC2S7RyYI`W`-wzkw=cf5VHyFAjd&0El_$>tsV=}5Qnw>|{k
zpZUFr$L3?Wv_oCWSyVual3+8$bIQZrxw8_>gq`v_kx3U<68;zW~at3^kHAWr-8kL=sJZn)rpOzK&GRkqd?i6B_Y*`wJ4j{DATx6V6$oN
zZFupQL;m6|D9i?#m(Q}D`2OWlXGuLU1D(d8|%mu_~S>8Iq~KOJ$5_ua2}
z(K^#%xyLUrG-d+2=?hl@UN4Qt<4!&P_6k1AVE4?o2i61iX`-m?e*W68%?fTBUdZ4F
z(gLV#%(Pp-^W-61sO8rcRBq!$WBSw&EMI=
z^(cG1&Wh?uRlL62N_Q-WHr*ZVeHAza7|8bRl|@+DNC{iB&TyqwSkq)&NpUB@f8Ts&
zOS6_%W8CZ5rZub;+VtrtXH#wst+}2DJ#Gi|gt-oL@3yK+==n7Ls_jg3;
zvp`7n?2|?QtUQh_O7hd1LFeb&c^T;gnZ1G`r4PiD?0T!jc-O0%XoYjCj^#=`jGC?#
z|EH`SzvR&DH7*b5!0ZKuOw_Ei?aCIzBbxg9jv5P;%%%>e;aS`D>Q41Zc7c>d_Ore%H8Grs)wK&k9R0|IY;euA#I)&@-?=lVSf1blZR&s#OEP;GMmrdS~G
zVq>8UBhBJ3#R9M_zhnXMrOM&M>s=%&4s|Mh`?CYru4Gng(zY*Xsr^91T7^TZsY|y@8a`i{ot_%_niA*qo>TIbXuEN>
z?!@jPR~5$mTzo_IlXc!E`}^=f?xrBZzSpH%IXgSc@R+7r>Ri(j(o0-U9mPt1d%pU&
z--H3PxjRO-Qav4Ia#3F?3SJx=IC>QD;)icHS-9^wEom;L_eDx1(o7
zLr?Z{Rl+e~WU40+{*efojF^}hmx+PZE4^x8o%UTXKHwug5c4vYxm`a?wBMeStsMTU
z#M=mve`}3s6F~Iiljui%<>x2S2rIBHWaUU0E)XK0wDVAt>On;|fa|%pobEvFoFDJ)
zXs1o4DA)r{>xXd1k}Rx9}WKuVWUotz1Rm+9RcbJsio2R?L$ZwqNcero_BHM
z{{AmPE9A$nQkNNudT=2wEsIb!J%(tssh*D%z3jWoI*}QQN=oXpoi5?IEnfb+P4}}9
zo{EEyygSzy^3q(*+RFqtICc0T>5j4Ty8b{CyHNl7Iqn&KBogJvv(e%9J+aa6&61td
zNr%|-<ax=^lZfZ~1TMiT>w>|My^#
zzaBP
z+Cz)mn?teT7L;}vI2Y(%zW!OYb1HVxd!9UMa^y_0<#*ePG{rf$`(?@{fr*PoB=6rZ
zOFgbqt#InpDZ;9zFTH@E;LXBz_GarnoLDt^O=I==
zB~w4f$gl>@H0pBM&SzHSilQ!y+$&4H8!^w2dkvU?&S3FCV_@Qj1+4q8sU9Q@*?*WX
z{devIjrB=6;|9W9;Cle!giYn#rbqWrHP4TyWv1ER*lpvmn}v|Idq)F#eg_C`hz=uJV7Lda~DN@gFUC(T#hv
zv$I_hF55h}pZa)jwUDl`LCO|!@d?z0L&|5r9GFJtltn@Hf5m)F%Zk-_pf~QzxjCOW
zae}S2Cq5~6x+h+dEz)(kDBEddos<5T7-mDXV&ns#uP4QMyw3?0?KZdMOJK5AQ_knw
zv3XXi-#&-Cyj`^Ba!?5$sOe-fX9iXLHjI*W=H(6b>Evql)iH~Jd_S6Zl
z4fc6U1dM2NV*ulE8qaeVGl~Qv8vrs<$3X5XA3iMI_u`!zKo;-(4=+4z6(ExNfslin
zn9s%^7(8d9$%X2kwl*V)%|Dcr+qRy{Y2r|;qMZ3cwL;~N+Oik#|-T(f%h
z`G)kNp+erl>ZE2Zby*!<5w2U$qN0LjfB55TnqFxW13E0L<;t@6x7UumUvGV`DLdoE
z3!Ay=G1_c9ugh4EPHxshfQafvYm5k+dw1LkMw43{qt_tB=yBN40goF94106r1LxbXFO
zV-)w5mD3Z0rbb3a!TV&!DzpkZKZc6MUss%)Dy7ZmEfZb7c4tRybc8|1#m*~>mR-o5
z`UWf~>oR_OomkKFw5B*^zGu&#tpPB^W8+nr^kv|GQ;`gSouUWUxd0yyrz|Xj0s|Y!
z9~-O)zJ2j(_ARH(>CI;<5++oUO1L(1GM48EqM_D4ycnp+bQbB$?J~Gs&@Mb=CusbwO-+S
z)$@8R#>J023IoH}?LPAbC}d=01Q%v9;S=M)EdTr8m#fPgYiLju4)uwIQf?I-^yS&0
zpr7mN)Ycs|*IoOn%bGS*zx00IC-LS6JRXXInU{}qV0gGJnw_PM;VuIiSi@!11fz`M
zv1(KK<9rhhm(xt
zOQPiru$SFsCY7&0u(Je$We`V#$Q!e<*!khkJ+V~JwYyIJwt97c(ly{X-D3c*Gn72A
z&b^n?siTlWiieSWp$>Ra;!LeqDv+(QiuLMZ_PCb{0P7pQ_0jmC|Fn{?qA0Kdl&W)w
zK{T>Eck{XcGZS1#AZ+6C^WS3aW4I;WX0p|5FiEY}WE1PTeve%AaQScjlz5I6MxAlovvv`Zum{uxeZjEE93kMDuyptNM*-!+o8CjUkkzoIGH5vh-
zBngw(E6PTMZgCkrw}>$AnRZr_)lYU*e)#-ZjoWp8s%s`*%U&>9@aZ0e2a*r3_&akx!pKf@8+(aa@
z7m*ptUlkyro;bTP$cx8$i>(cGD!pcfkZs03D2$cydZaf-6;j6E2x>cGi=~~f=TeYB
znD@#}hJ}UgySiA!B-^nm+X*7X$i|>ELpP8o_P%_u!yNG91lx&@4}O)}hn1BxM#~N>
zvRPFphRf63H%Rw4WL#=Hj=nP0suk5PleF6B(uS((^J8yWdC}bU)sEaoO*+me-t2mb
zDVbs~LB!cgv&5@b38*cnK8=cMa%{gdwsSJSIK)v#&Mg0iVDp0qk&$#{sjHR&*Qq4R
z4%vJ2b3%XeGu3_~yg*r|?C2V3mZe2SOQ=V}rR=az2k8uV6Y|xBq^A3hD|hIQ^^r(9
zw-0xzgejOAq|4LhXP2znY-ICx5mGEZe+EfhJ3wqRcE9w<$6bnSBVDC~kO#?1KRX<<
z%_#jxV%EU)d+}U9$HAg-ho;&mO1{o(XR$K{j@+Xtke#6{5Po^&lQ?<8gIFU&>zpwp
z#i?SUq`tCehd;?LSm)1Vr~T_t!gUk$0W(k(r0sgN-8vD_m(jTesLMGa7e=XtJJ+1>
zs?2Og0WzI!TO*F=g4*v?siPMZWO}iPANO%m)!^Rlvt^KkB9XQhE#nFlE&cd03_JME
zp9`(Z4heI)e7k>o8!iXJq@1YeAQG+!Z4WUElQe^%oq+YgOAn-iM69
z^a7kNl^)E7#}9-Di?rx0A^{=Kd_$7KS_`>H};nc)wRQ#p-I$9iW+N(Zsc)zsA98R_>9Y}`-s
zf*Pb$n*S3
z>jE1F(rrLLuU)$q{I*5owYk3OwZ4VmW#$?O-P2H4ySuxQ1lR36`2k$wEBr-|sLaD+
zy&$*EV0zx(SiyJk;>Df2cB!MoX`UN!K=xy;bo8eX?u4RDn;(g6ADR?L!o+f+*XSgv
z5%<)L!ZlYJiL{B_V(Qcxgu=OI%^FdIl<(5bQ=gIh^%C^I!c+o)kz!dXC@VWhARboR
z0T?2LK8`i&1=R0PYo3SWWP@FWCSimD(`jSzrepo}4ro%mr5IzT3_BpAB!ko*;Mi?h
zHem5WjO~wUYJL?-Yq(f-?6l4$=`4pqImYaW((T_#=X0InJTVX+5s`c5>toQ`o%r0C
za)DGDh`9lL;-ykqyhj%D4~ie7LqLA&tFQaz8=2BinZdfh41u~%;ZQ>3hoT~|xtH?h
z*VuYe+|gr@o&^k<4(iCheQzy7jCGBSTuVgK2s%%A^%?Sm)??SUd~d2JGQHhkQ;tP7
zfNv1iR1V#vZjwn33PBd`d2hCs6%rMf5@dvm+Dik)+iva+{eZM+%nP7c!B4fe+^GpO=j5$
zx*^=TtY!_W2dL8MsHkml`#cLVQTdIBHakSx1w}S&y!v!o)QVkrL&KCaLwFVJIeM3*
zu}_Y4hyfx_4LH!(-zr$y2}qPXKi%sqJ6@CNs$2OT*&PM$)ytPF<<;(OKY@M=nopn4
z&+Wf=bd#>-@(ofc=j`4AW7lA>lRg~vTgT)gP+u@(hk!sdsyDMUJ$dqEU{Lh4XW{6<
zsh*^Z^!CrEkE_eijqZ24kK*wSEtzoq-5*zZXIl_hpG!-5f)mMu4
zVuQkDRa)-YCu{c+j|mfBz=F)B{N4+IWnWXhG(~@g)knk}Y#|#I(tG0KiAd`O!|Dpz3`c9UaC_mA-mtMt9xVbk(vVO4@@;RXkzYyR&zcR$dfOzi
z8L18sV;j{Ip;h(tqO4R)j?xWgNZnADi9D*IargfHwL+)SwoyHS&GX&4#`u#DAnmzo
zPE}wviUk9mzCZGcpv_P1KT0yG&JFpv%Rn~QD8=;4!B_cPkaqr1kppEjHPYopL2i=L
zEyD{bd6BqW=e`}uSKk*02?<52{5B4CAmJqPk$B@}Ew&S&1)wvT0(PNKqrKU-vXm}t
zlAWIWe%6`^o%aTIeESA=2kUSlu6Ve!1h5^OqPXeLqYlVe4hn46$lfr&>E*hT+*AEF
z0${`2AKVzYk#pEB2;22ymKEl{vcW+?V_=9n(N!ho-U8@H0R!I322>vt>!XP?Nk#v>
zMu%qNZi@twP+8$!*zR4Zj`q`dd|TykrhWhPb89!D+1?$&&O6S0c?cxT=V=2HBI($x
z&6??WPxOD#B3$QsO?jm*pLzVF%Fx;veJl8kK?EN~0e1>mh~5#o0W7|e>Kar7ZZwiI
zJoN96Zxz!6ED$F!-H4B@fTBM8zHNACg2=Qw3qrNvO%*VfJ0_(=?Weoybg(Ctivrk4sJ%{-m>C5rv8`s;`6fb$C7Y=6>cSfe2P
zWT4*$^_R(E&M=j->q#N?AFapJ05t-A7)S0{sLzx
zB6n|qU0-rx)$Fw=^f`!lGxg27rUGCEJxU``1T6t4IuEZLl!`qEf1%jmGnlo~n%!N@
zHmF!Y{{~1p78H%EG@hCY6igFVMN7rhEoX-X>uZ~Vr)rx|??mZGpQ63XA&
ziuVh~r{f#HZorRd`1((*2!dz}|0ebxAul9Q&XceSJ32cnU&LaG8ZMTIfNwzD5u)fW
zRT1^p;rn0iWOy;R_e3wWxy`$F!P2P~E_IDUFa(lTVBkVgg{jeU^;N7;up3dRz{P>K
zlecZlAC~s5%FF_OB!w(Uno#|n;i|FTKof+wZ_S-QFIMUM!EMgPGA~kHD<>6-_Smyl
z`N)^_BXAZ9M0kIDc&}`)7z9s{RsWBiec14)oL!Gtvt0N0YS@ighS;aH`7WAnE_hof
zo!9m;tM|Buj6K(sOIzHMYgrhmW-t)X^|9+@mA3V#z(f;1_rXdAfAHMdI7aL*V~^(-
z`rv^P`4J@p1|p_?|RM%xpHOx8)0f#Vk{AN2Ub
zhK2@cpvW8vC|saeuryz`aBORV-a3UWam>KL8R-E`-pjmNM;XG#H`5q%7W`H3}@9LXm=kf-2k<7rg6$yGPLup09n`IY?u;9DAeLJ0NA>Cjr8}
zxD(O`$wvi0dbT*F-FcpTaH?V58~1^DCq>^Uxf^;0OK|T*;wUXbC1`9KV|MouZp+N
zTl9&mq!r*bE<5-HByaB^4s-}^c&nAyK=btgeS*+{p_5%CeB+u@A~^6r4|sN?u#REzY?$oa$!7_jJO8<&Uzzr|3jP+}
zlNCA08y
zZfN)$e=f*#PYTM|PN(4xRDNVtJ^j-=5NWpU?+N8#!B3o{nqQ+A4&@Ks?2C?mj6Pd%_=HKE1n6JGL
z_XF`7m4tXvcJADXs42ELmP2K>2JX+ijO_m9IP3%K%+2cc1R|?;WoNU@^A)Tw
zdLNAZ%DpM$>M{vzU7|Rl0ZLMsf^}&XtImbeWaMy)!t-5M5d1JVj(AkQhv@-*`Y=C6
z4c39Cg@u6QfCCcC-eHM!S&7{Fu_P}Fa)$SC$qwX;NL({T0p;)nOZDR=#0)P{YT|s*M(Vv()wq8Rca0(715WNr3BRSQ7rsM&Tt`xmN`lMr`e8jvR)6$}A1DEBeFv(W{
zAXHDt7`eDpi@}4WQ9|J8P5CSFy6qk+t|Yj?jz@&t(Q2ehHfk7dhVX;;c9?TOSKF_Q
zPBBV7avlt1%EeB&Ho@izc-lac)6S4(!i>fZ4Sa%2h%*PAFTR#7U5a>sdXP&G1rrcS
zn|Io9o&2QD@zf;}#VB)8x$nsn(Xe8jBlIo!TV{9gFNR_Ks!>Drg?uTEr|(|Sg^po+58M3Rtz72dlYqz2-Xw0u)UwVL`y
zJVXuy4W!%19D)v5e<7>ifj(ml>l7PRRyGIE8XN3W3Hc&~G?FtO2LWHzrJwqmLAR&D
zE`*jp4fV+@Gs!Xxod=@-b5YUR7s~?fFey#$m1t?KAbg_Ko4E9+;`aJcox#iyF!bRA
zl4Lg+#on?>^!($d;3N=5BuxUZ+7C9(LBF&{>BMe8<0?6rJ+cSBH(2eaGebHipddSg
zfo2TxGQJ*Pvw1z!%ObG}EY)jZY{YtS5SHf@Xah{U$j=Y?5=9t*Dg}9zOQadF6eb%r
z^xI-qRmA)sDFx+q8{p_N(QGW!HC$zUuPkK)Q|+=jL|z8f=^I@4>{PT5727;&uru)F
z(Rl(+3q4)m3E=7os(tlRfH<&jpTQBps}Gfjmw13cS&#-xTN>FBEfW4LKiP5>%?KJ)
z%(g@z4(T(EgYcG>#C4*hGD}9Qf1R?JgZuZHkfHzq0l@?e$do-*Mu=cSfl#<+%lwJN
z&f`0nR0v>Z6SF)xr9KwLy&m7q_9MRbPtBb1`iY4T{u(G`h-
zP*ba10wH{#1!<2uQHn*OJy4Pk=nmrDJPEOVgy9aqE2;MVfPYMT*P1$Z`1|0;(JYUJ8C*fk&7m>}+ZV7Il>ItY{eWBSa
z-{9&KAE`J%T2{MORq@7AC`LRE4Yq({&2S)~ssQXdV~?)k;xe(T)LAcnA;E|dYLz$z
z@8rnvF!rE5?1-KeB)``v>ie&O!|eL@ZS(7{*#c2_zZp?%2b0HnXbY0T2q6KwqxS{Z
z0`*uuM8vQPq$n660Xfg5|1L7EvSE*9rA=&-{{MdZR>ZR(U_|514shL
z_`8B5?pLUK5F8_zpa)nRW|f9PLLQZY49>lHu^kL@vZ*p)BVZc`=6Hb85HbBpy+J~H
zn=^?+0_m;s<&G4f3Nl=W#+g%MGPBuz;RrKtvp;?Kumu#Ly3Cg$&{7ZW?`#_PJp&Hs
z+AtbZxCKx*4b!%5*>Z?m9$FGmHA>y|5`i#{);wbI0A*d$n?yHxGz-KVuQ3eL>e5hK
zfw!u-CG37@FvW)zYlKk{Ia`KDR9JX9H5;9BkdP@7VENG5LkG7ZGfMjrf$SI
zBiSK(NJnR4eo_xJpPW1S9^SaJ+<>w`M9?S3?w8Y==Y*SeZ--P!uKB+Pl(u`Fs0v#_PIV
zOGhPLlEOos(KI9?gmDorSsVjDtvMiz2zjUHn!?Y2aw0x}$w&3PKrVUpS;`7`rv!Q#
zMuDRl@5J-yrw2&q6*~^)89Sqpfl^QlNw>%lo0C_8)O~e0IF1UvSG;RYpL?x6^T>9
zPBF=#I3qQ+&&N)O6K)ftnfm>m&y)i;2Mxp_gHSzD>Y}t=5Eak?+i2>cyUzkY^IPAE
z{vA@vZQ4k4JKN#ZK-oi^Bqb#S?`=wT1#*_}O?X8pl2?&)eMG+_?8ff1sFA3k!3#Mg
zFkAYtPtc{_jQ`+Eq!fw*2o|B86|!}ujY;m`T96+eS`umx;GYbDl3<)bbLO#-qb9Ox
zG5fmT6!bGLTGZZt!abDKo7QM=cuo`bv9Gh{
zj^{0j*-1KFQ^Gl}%J4q-^a$idRX6`6lRzA_0u
zz4{BwsI%SbG-o7nq4X+L<;cK5Y)M|C8_vjIKia;8N_Zn}7gvKXs9C}1&<@@EP
zZ=x3nvy$(qR%Kkeb<0!!npn}eeBzSBaDpcV1HFtVymK*qzYz3GOgC+`v~#sDAwj&nWEhM-XE&%M
zB1sd;fhcCE2cRe*LTr=^I_Nt88LLg~KK#|Bg(r~)trkRG3L1Vd?u$^94N<32!W7to
z*{kx#)$p^nx8l0g$%wrm*`E#vWGVa+Z!;w_EaKcu-58d*cO0J!m>
zfownyLdg(K4H)q}N}+1#ZtUxJ?D4G2-4|;uLUKT+L0`yjyD6lS=pPXwhwB7h0a%`5
zU$>jMXHbkQke8vJ5E+Mb44nseVtG+*a!u*(h{UNv`S~5NBZ9fRMnV5Yd|r(}4XAb|
zXw8U|q3&$-CnO2&2f;9AcCAV}N98nIjw&pjsTPJ>jTV8+$FzS-6a54x#Q2x^5d3y8k$Vho~q{h{S
zHB;@JFiYW29)q3Chxrd1laJRcCp=+`3vz2m-OY>xfAs={Z_ioGdN-`E+SXEB{Ng?$vxV`_FOCl|LH4RRhg^UE+%uKSD&KDqC10
z(swJp*(cKV8|fbYVHf|;4+nS{2jj>X-1Ou@L0?02MOslHaa0^z;A8K)e82>3B7Bj3
zw0}(bu?*@E0j8jI4cY5g67fYt2O&R#>DqC^l$dv8iOELB950y&6hg5dzPIJl@fyq?4zMjnujn@i`3cyG->f3_1M!JKc_%WOnCx9PrV^l`LuNXNRtPZ{{hK?nwDm(YcLD-bWJ8Ia
z!+)4~#Q^VdjY1?Xm@Ghg=U|`A$ad6Oz}81JIrJ`;&VQ`S&|m`+Bj5)IwGU~K
zHhl~QWcC3A8uP*1zpt1NcL=NmibQaLb(}?Gv<|cb>>UVM87LsY*zecCnKwm-q84(>
zY==_~8W^Z|g<3T*0z1I_;UadUxq>z@Os4w&SOYXSd@A0#@AsQ!zG
z6=nqv-#}G}W`2JRm)+@;CyCt;9<;3>DNUf3*g}m!Nu+bp|Yd!!_kzd_Rffct0)hSop5qmX-K0*MS&7()L&
z$xAToL`Y)b3{8Y78IY5AcYSj34z3a>D>$O0$O7c?R~x@NrHY{%0*4`+AuVR$rlH8@
zlFA3yEJ<ouq5?fq?>ea}IWgZ6-V1cdEI&&!ZQ(3~$6h>HI)Eo(>PR55|Z*;}!Be
zdEC}bv#6mYSE1?Av~LCF3k!n@EJx^$fn<@M^)P4-Y>q=0CLmG;8M}i?#KjUzGSpo^
zNbx9Q&9mRc#T#rChkn5tuT_|Y
zm9Y`aJ=gt%#+aZfvJIJwLnV#gas;^JwJjU>+l9fG>l&vqOF$^Q-Q8N|bh?(#0gNCrf-Hl=Oo
zi|M#pln6&G#%9&f-%QD|7p536f?h<3CwXbZCB%mfR7_kHs12XMW?>Pq0?>>ZIHTgI
zeJf-y+>s$nc;BJSh@Y$3ZrzlP%|d2;;KjnA;TGwPA~dSxunL%=cfchhBt%>=>{J=}
zJ`V>Ady8(zKEaMG;H=C*@V}p{C-x`7I#Z@Lrqf%gXQ~S7O-=0rOr`)YYZM%Z3f7Re
zey)3j7p7)lLk#s&*MUm63Ge{34sfx%f
z@!cY^g4iOKZDiT@JCLgZN$b&T`oa3p;|OBa*M0N}w1kcB9tYW4!NJQQV&P04GS-}9
zD)8FRu@^DgZBtsEdhL!?~0l4Y3f`?VlmZl{HTZ-e?(Qd~@+%r)==lS|1v`8=NI^vA
z7Q1qoC)O!!k>1c}S8c2p*9imy?n|!w;GLg|JoPi68(5VDgH%CraR*eItE`+6J1vSm
z7AyoVH_G6^a!7)mppe#Fv*BJugnR3?HPy+|8x%Mio@#ZweO
zKo*a$jnv!-aqMI}=rf0wKUo1I86S&_rJ#~2`EVb5J9kr^ajXn?r^v>bYi1b7x%pn*
zy45}IP_3}J?;X$zoK##>Pqc*$_BeVRG*cCV2>&y&!N}UzS2`Gs#p`LU2YuS&wOLX!
zgT|OgMuD@c6k8GgalhhEM~Ge24tosCAq{|f_%*Q_5v)qa)ZiV$H0Phss$gN!tQ`t0
z=ebqT#yEBQv=@bVaqKq@S&t1Zx|s?#LOoJ$NTUTxa^j>rngu!lHoqabyYPU3fZ$**
z`Bzc;h^^v5L7v^eMJgOUTKj%7^*B;&Iw&^T@!)^}t+-B?!IYlApidnj-?r2CuJFT}kf8Fmb@CzC>QI~SCeG2zKw4f!Sfh1`&olHVOJvyW$
zNv{7qgNC6wPO6dHSmm?2(>RdDU2llR%=ZC+pXnspnp^z^;9LaLmx=u}GT4FaTt@wk
zi%Zw65ep9^D>Nc}#2yQb%L;qGC|q_;+rV}49aP!CoUKjz!xy(Bd8`$))Mh&Y9J+Av
za#Ce!vxT%xHrrP--50b-m!m4U=_R6_MkmtBP_kAwbv6BL;dFtsnblh1J8U5Qy1e2S
zj8Mg}-K+b_>uxQS1caaDF|63zC
za^{~JLCenTD
z5d8SK9OOn6eFkyUfxLzD>-}IR;IaQQc_>t5Xa)HfM>aXXS-?sNRt)Y~fx<%k2&N*+2$8Vo_<;F*!g;5ZDKpjD6mjQpVQAlGo>QwX85fKTBnuE&WPuxc_jCmv(Ie&DY#)wTI5%lO_Ped{Xi0qYdsS7R%A9y=8+hcDabAATZjI1Kp;;|6m
zAu=ck{-79A7=2y0+HDBNXg_E}%nwfy*WQ^dEC{&w&kx2CQ2jwOa7@w83e
zV_!0Kq{CnOC#D8o=C7!9=1|Gx(kkn$H&oUOhk*%h94`t%%^1x7WT^Mg+C$ounE^XT
zi}&G6H#wF6=)ojgI+NaSN6R^x0(
zTVbwVSc@PYnUp^{{PR$@ihTqz0y_~Q0z4_|uo!v+)JtrLtk&!6*CDn2v!6y0cSXIj
zbpEZfko)gH04~HE#^0EJq%$;_(f_hv#gS8?p$5!;^^K;^uVF#Kqj$6A84lC=Cx4^n@=~jtBQ^%YWMfrr7QJHPWZ!D?$
z;NZObRbI9QN;W5E}{q;GjAjQV&LWH7IeXVvel<>7lD_j;uyB2A0}xIhWnUb
zV%9kvG4bj;e^5WJB609VOg>Lrc4|CW>*xLd=gZYFMBU?QncxNj5N$8MyuyiQ)h!mBk3K*wAh;gIAft(Tx>jYp6i5Hl9UC;&-dD%L>
z^}4Kmx@Bb?)P~^m@@W5s97XE$i{s~2Hyhk(u&#XLuH%Ce->1hP(^Z#{I1uW;&6Hhk
zz(pqT-k^?NWZYhbiY59ks@Hyl>G{pu8a0Ol=TVgBeMf>CZW}dI>
zv!HKe2<_LAH~C3wKa8;2#c#YsC37X(sy6u+2vzZLDut#cJ{2lF!ADt*NW4M!=^Ii>
z9I8&m_PH5(H3Ua9!CqW&YYiISDdNnXwB-c{NEjE;ujBSbK_ps1%v;o>ArE`-!0_$!
zO&S{}V>J0D48>|n+z-spy^P}(Gsb>~+XjH}sJMv!i$6TSfabb6sugwtz^N6lB!eDu?0j6eNXlWJP~c`j
z&SZ+&gZn?Et`4o)l86adwuuy0KVYwpM5$n5UY@K{F&~BR$W8+l1xoxVyVM;IRrn2M{Z!
zvOBPij2m8}IYD@Sj+CbZ-N6`v^m0J5p2*gN8C?-T!SFE1HoZh=MocA0sLPo&Dg0T=
zvpA`dg~eOLMPMyEmGohRC;`Hjb)TJtRgd67q;Vl(VJKFe7|k}aYz4E8Y#bP7e;Mp9
z?q(VF9H=N{V2c@E;6Kox?X*I(aS^w+JX$D+M)F(R(i7=BB;H<+(%zr72Q
zNE{Q8{x8(Lcm%c%hZ+z+jnGcbGegG&GBPq;!mNqSzJLZBTx+!aTsP7>nCNg!{^6is
ze7Yis@32^P}3+t9Y
zx$zW#3guArK$W8yUF?3_$*z$2_elm#ylwgn+#19>Na|;1V4MABHAC6
zc_Th+11FNdt-!UZaz0Y2Nh;PXOAVfj`*qCdL1m>edd~Q_g*l+T#ZtQu#WNd+U%7So
zVbMDH+K_(mb*KjRZ+tgZ+dHRE?^O?v(qo;m_GeG6M38cOGWKYd1wDK!^axcH7>MeL
z?GIVdvMJL)G3?Z*jWqgOPEU^~abUru4m`UEqL}nUdG2$^D=V`;xX*2`Y@LZt9566$
zOxhniKNCGU0z=CqrRbFnXZK1TAtzn@Pyh0dIu>1^1yA$8U7RyX|9{xg@Bh(zOfpgB
zY?;A93X{+(KfsU;11d@zIC?nwAEPknXmZZbCGi{|hE|UAN#LmSi@nd&U`~sMj|U|b
zb%PA|vx_&pKyi%weu5!Rm=tZg!3LWI98Q8`V=#IB&Wn?Vv)v+~coEYADl`tl#2GJM
zE1TZUTNCF*%!*X0f6*C4KYi*+fhavhtgYB==s{3l51;$%1sw#G
z&neM@OJD3sA(MK)j=x|$Ai}?;3UE!Zs40dYV7(!7>``$5Lm|%_dzVKrCj-1_HUw^q>UD5+OPW97Mx{+aa#=Dnc2!4jaO2F_J8iGQ$jnSD
zJ3IQyXVZg`&SUem89m$jcIg$LLW0v
zjsy^^9L
z%*rHmw`x#bWbSN;xn^no<||ZRN*>TIEa!*$mkll1hf&~=Fr%hTu`?Bl&%~?IijirJ
zb2G5TjSTm^@p~Z8hDA7{qOz3g_#tK?>@sZ&lr%N{{G&K-(B-_yVeEms?e-33l%kt(
zk+HvL0G3x%(_eH8fE{8CMF)DJwH_WSzx@8m?tsqhs%$~X%ys!$_>G-x;$5p*6NrzK!H`Z`DhFmX-cVH0Vv!=DTZ!ahXs
zB_<%X6TRGw(_L{IQDWzWNCEbjUsxFTtpcLSm7D)L7X;b>P?Dm6egVVtR%9(mv$N{Y
zLHsI(?2L*95J`MY?^&ZtervgL6Rm93D8*xGY)-)K_u<%uutyPn5;8HwWO8~LjCjP4
zw>q->bfj|);}aq2DwAIGzFlGL({h8NWTO!xapkJi`xV?3JMb49m2CEESM*3S4`mco
zAYPOIAJjwwZytWLIDNW$l=8=kn>TNQDs7`xjOzcf0Kc*UOLo;iDiQYSqEDaLsrk#+
zd;ChahM4T)m=j<$-h&}Wrj-CA5X!TxkN6WgH%RUFw1K1~3*UyAEO(75l+1B-cxx2U
zrLQOHp#0sRb9V4Xlh~npf(Ag+i;wbJs1Yr3fFS+9>z9jk?M!A)AmU65BxEvyDkjTS
zV~TbJj=%$KkI+xSMX9gK$vR$*tE6K>f;snsU8qMcAQdJL$QIWq=z+gNA`0c<*c-mF
z1s{)7F}Dih+y7n+{}{&Q+kTepLIrtQ_u3I`JQ-Goo>Eu6dg5$MP}9=X@_CtuOGJm~
z)*h*~tL)*_U7a%PbjH5^DrAQFQpT*hoeyiALH0N3D6j3lPKd!4iOmiYLADL!YLMKB2UTJPhb^Uj2g0Zz?lD35l>g|x5zh2q0x
zWhQhlVxS7;`OFiO7=!Xl#-#1-?b)dO{Lj!#BKx7!#b&O>$-z>4SNb-PxwT=BT-DUEX>iswU(3!$z({(SCQK0=5b)r*@82n%y1$DHuUq(>>G
zoQ@M(iG0Zm9t8lFa4h&`B~rLSs0<2h$BrE%?nBr?0s_KMt892wx8M-l0@l4|ID^T-C^(L%jcAGBK!z}oa1K5la;g9*&>XlTKyjv6H@mmI`4h*z8bF^r
zJeC0p3eCF(5-UkHnF
zw9v6Qst*Ykc4k-zGI0a~f-Vfwr8}(agkivWDRCEKEYe%4^+h+7vn1V_|X;TJP;QH2H8*>$w(VH
zN-I{0zEM3fr}Bp!dla{&7!~$dUWGGAtwn<_E~BWK#Fa5bCo@NF$ciI=AA`^2_ImL|*b7h~tR-jeJ$NvK3n~Sq0igN$
zi&)VA3y%e_(0i-b?&&a@a|=T=CLpV+o}eIiA^tixlZ#~F^uYBvT>{#yQG@nC#ES++2a{m9{4((^j8T0~>n5{Z}vn2?*qW-A3SeD?Gyreb0tc9UX6%p;g%
z!I5}iP5E>6VPYP1pU8q`0{juA`EACTCoL?WCt{LmZv6=olnNwF>#38f?eo&A=wd=)x#_{54-BlasEsjG~
z#yCBy=eE;DV1&crHwP4LLY~A$VJED#mjC|nY8$Pum+z>bnb3Gn(pl`O0T@qEkKwe?
zwg21*5nA4poI)7<>MEWqaa&=yHXNuHlouwUKpQ;=>LzE!AeA7FZiOVY#M|acH$*%9
zc{678lH}u+`u(;R&AF@Q{bzFcG}G*IFZ>CBvyXiez8?Y@fM=TF(JJ6&Lxv#s=HbE|
zc!Yc4#kMMYN}OPL{A(C&5di_az!bNo-jsy}hWrG!Rhzs-HVy(ITM_7|6z39vj0`k7
z2LuG0Is?adRpOqB6Xh$E5}dm-Lnr5WMPRs$%m$oHBZpZ?*tEbg)(GGR77_{IFRO*Q
z9#aG;M%skt_q+rHM}z@bEq0yyC;_-%ax5e+024PL?hy$%Kju3u7?PMu6HIT*)oq8>
zf!GO6usY1fog`i|(?U)bgG+lgFWva9K=nLllqF-f&mu4fn{^yKVzVXg-_=yGT$@s#6Sl?a?<3pO!d
zz5&1JEFgerLYOMECFY2n36t0hI1_FZzXu@-Ab{!#1Fh_Qg7#{~#wXCpNt4GSDeM9?c%}t#S
zF{afXZV5P|kQ#L^Hp0e>X+Tb%?7|Z30?16n!9n#T?#}{mWmE{_JH`frW#v7M#kqGR%_k;E7IGkw>&Z
zWW!wa1xNdtqa5$Lo1r8WRk}0BK=34J$xpp|@j>$@Pp_rAG
z#0~ntYP<4ysMoixT_;7MEX8jsOJwUfW#
zOb^w`y7BTuh-3*_%Ndit<(a-vV>iNWe!3(%h8PqRjSG%3
zF{%RS)x|!B4*S@1N_67X`g_R!VpM#7)q+-(D9PS2e7}nro3wmGOP(PHnJc)WGgwZ*
zI1!2urdc$4*3q!hOqHl23#9sRsI@ptHZbzGyXRWvfI`&;N)iN89Wa(5BZAJh`8AF)
z-Ucwi-@*n$LGh%BRL(~R?UGkj{nl;$ToBYVkt2AfYLN34gG&X5^XtpME9vXgK~6>G
znCuc@wOOyJ!Q$rXYKNSYEMivQOx6w~3GhyzmW_wQ)e<4+ud@_^(Ot6Av(uAX0y00y+qBMR$DTMPLy9b@n8q$S
zx)C%2G6%40ju;gui`df=_Gfa8d_prq_irP+MxsxSiE01?6e!G4_5tVcHvPPZ8pN8N
zSR!P-%U-Mg9&*`6>{1x8pmO#CLk+T65D5PS%^#F%42RL=P%Q{rrVjhGLBM5@-4GB1
z1*5{D63OvDa+YzW_-~ya9w996;DK2F?h8te)cJNx*v^|lM@IZ87Prx%01p1WK+Y-8
zqk>FUf$;C3NbX@d#r)5jA!)!(Zxl3UaL!)>Y3b5@!s^7R;b-WwJ9)EjRI;8f96IdY
zHcurz;B}8)##^pi4$kR+HkMHT^326^SJs~e;`#{N6(n*{<6NP0KrSbm93p*(nHXeo
z3n^8`RaM3p)>=<>)e@^_Fv{iz@0K)G>qj!>z;g}g*bkLe!oYD+)?!q|gOJ7(Sre?+
zxJY+L@%|!)y1!q_d9g(E(LQ$4D@
z)3m(C5iT~z2qtrIf%u6xID&XioNefr4h0>yrqtJAS+u)o-(NrxWqo}$Wg
zxl12mH;>-#a|@_xOD~%K>%E%osjVBVw`F4{gu@ZNSat-_ANZz;!hoQo%0E_~LF^&s
z`rQ@qg?HMu43uR{dGEqzf$Ie}KaE})63rpAUo!Ls+l>hE@GNey;~1}TOqV$$YOGFt
zl<``k4Odya)(Qf2v~%wK>gZ=H&_UWXIPkAwYlGF3G#|+jcn;w#hGP6i_V(0p9HDx*
zOyU!Ng^argPXrn-f!wjsi|_2XF10$;*8Dd54PiN9!$%Q@XsDp2=NC_F&;*|
z#cpq2J<~x)ACMPGiVx%*RA&h1ir(Td>hr-RRAjHfHP!5=boRbXuWAjgJfP8pI9zA~
z>b?WlH&GydLYeXi`w-OwQRUa9ZM(mWtMkiTBS8&xe*Ow7gwLMi`%fi@{pTgd+(QXB
zW^mmr0#yLd*t#}yX<3UYW{_F`kk?q$$VtZiIc252DAqcY{l`9j$9;S#R~Avik!yGd
zC1MGjgI^df6g0};^D8FiwC@4y06S)}SLsfm;0Gt&AD4|5u5^vb9x2HxN^U8MGizPW
z6r}yxOT5cLTC?q|^hb#XYX(07BR%dBfc6)(c0de4Y*|`bNohakuabrBmb*~%
zoQq6>3?q_HEDpLWk`NfK;NqKbBYuQEcDSlhP!Fp>M##
zfdOPGAV3rMaz0W}-2nvaM|dK!#^#a41F>u-Ot|CZB6VfA+o)w2BBYSnL2wyvEy2AT
zxDn*>*ck_KU=b-MvAYFEh^+v$ojqOde2$w)`m%V-&9S)wQ6kdtat0F_FccU5O~!8J
ze8A+Hn6)y7fkupsUhfgcgm^KiD7N4-Ba9FZY^div_c-y7e^s~5>vaFq9lE2=0j%T?
z2v#DRnB5M8|Gk%k;nLzjh%tA0ztSS!0|vCWIYI#qz4UD
z4kW5PlTig+3wJ=OFnW18FO3{u*=~`BF9q%?SpmfiFcwDZH}Kg&m{(rEeu`MA0}O=o
zCzW=fv8Rn_4Bn$>b*v=((;Gk)>5Mi{X0y1V*jYsQ4Gc`SD^fYiX{s=((qCNupfc9o
z%&$l^%~iBUZHO8Q7Qn=$6SFlee{WBZDjav!q*YB$cZEMoKEk@y
zw&-o4p?qY-h;G{JPmftw>D(2c!u_xcU`%Nn7__{5=cz5@>f%!GO-Nf*Q`2i#XJlXF
z!dPgivs>&JSE?vvT(
z%|Ssy)4<)PrlzQ3EU~w-oyH>TKXzQHN!qjiQ$ViG(#S~un>V(iqM{2HM59F_Dk5_B
z+_|vO(7E&G`8MXk6eXgvLH>D2Ert()K|#_Y^E2v*8A*G4d+|g}%Xqco;J4p>&#tw?
z1L5I4gM%M(U&*Mkv>=H>ZON&w_Bwp{jfZB+Rz-RFG~gRtIz=w|nQGCW(oX#`Z|HC%
zjPNR-JlUpb=kA_1wS0@EC739DXd5(K3i5!@kSAWO85%C}*`(O-z2Z^X`a7L#Mp>#I
zMeND`<>kibe>AjhT__|pV~Byk#3ZqhQSvv@k%URuPG{!{gjXPR&sdvTjh%9jL9MW3
zkZXg=4fkxkf@*|LG26QJWncs7BVQL26+nRn;DP?Bit9VGx>*c#IaAC87a816s_kI$a(i=<*HSmUR_B}Ny)4`aJzUl{&#fa
zUJ24Q6;hVlbehmqgoLWsvZVx8DBPAuJx3@Px^}XN=RXrLu{OT(7;SeMM)je~b9ngM{kXT<20JBm*
zc)h0Pn?AGqO;>Sy7n+Xwsi=);G#Us-H`CKsYiZT>HmnWQbM^7babwB%YhB)|crmM_
zWE$;KWCCAb--l`V)#ZLf29@Z$ckfztbsL*a$PUPAGE!1Hnwqxu_V%zOO-WIs0c+70*SFnO14(#|!!qY5qrctng@=2!`tMy}<
z8s)JyPTU)4D=W*&vJ%cm5<}e=S1m0Qr)Xqkq^H;1_e7EO*TBruV36tX>(?Ox6K(FN
z@mv^3oQ{t#L-zte7I5>Bt}By^0F0Jg{53xSM*t&yv`v?{LUE6mbH8WvHADJCHrrnK
z!WHtRKVyqkH8+oXvG<-=1h(wt6FJP#yl^4)GAgOPfY`+S-oH7Z4Y1>|zvO$Z{=WOV
z%E||@IlA60-i7Ui_KPxuDCEs8EY$8qGZ^7ec!=91U%O^_w0A3o@z^w4O=SM5meZ$C
z=jpYhx_!hWM<^IJc0$)Z1_lPula!#sd-P);f85T_PECJuVxn7Q^}2O0>gwwHIQR!u
z_~MKDw{Q0x)5bN}0qIw+e1IfJkx_s)rfbP>TS`ky1G+GPUL`G^f8-AwsmM8GO;5)8
zt}g=fjX7uboH=Tz;-jLXAkJAx0jpiD)f`h#g90YACZOs3c`@dl?>~M>P#b5ao+m*1
zr{S*7(1GA&YWzF8pJ+da^>8F*ld+@nJjwZ;*FP|DNfxoXuvMzY)I5V%yZy*O^B*-f
z<2xj_ELpOID$Lx@Zpr0vIJg;{!f<1eD;d$c>+kQMgy5SPSbf{3ibaqjk;3EC%YEM&
zsc2Yn;xHL$nF{Ib>KZ!sf-2n6)pZn2tmfus7&@RSqNlIFhyqlVn3g6lAwhF;(owU=
zWNylngb)cISRn;;Y4~wI4-Tfj=^7YN+k~IIotejb8r*+A?M%M5wsv4~;nJl`QNUO0U3E8I&|lz3m(ji42P5(VYSy|ZfbgpI}3^NQOiU>BInS)j{-ot5$s#5tS%|`s
z%8_XZonQcIGv(!L;`!)gBx(B)X^dj#?(QBIHo+L!*w@#G26Ij=piOd1BODVVB1*Vg
znAYQHK6C_QR%LwMC7fVPpN>x5z}ns|AMGz;eoD+Ig%NtZ98
zh>3{_QYeC(@vYKQG~th8!o}n9Zrr$mhDT6fAVx+xckcq-#{VPc=jVr?*ti^WNssL$
zuW)+5ehmjI`4x8YNqM{diI)+EDmL4;Nm7YZO=T5ol5AQwD3$$ai6R-`E9p#eaq)KR
z3+Njf;!aBVc%lFEbb&Y;HdEk5rXHU-$h)4(DJ!tjVz+!CvN{3B|o4&Y58MSU?1u4&suAR3^i-kEYbjj
z8DVJX*iG8!fdN;nKw4TPs$#$=Jzd=_ZXfENQuyd&xbR?QnODtnwsS7mTUJ)~XIO-z
zW5e)pUUamDt?e5$U(mIZ)X-pAt;4Xs+|N>64mYWnr~Vij2|IS|@~d7Vog-8J!2rB!
zO?#5pJzjHaYI>9-?+sStzm*${hmd2noz=jksVs<&$ttnAbLQ;XuR}wlJRXqY;o#uZ
zq;L4n!=mKAWD_3ddQQ&HMTp>tbtpp`D=IqhYxJS7CH*(tLPddBD&-4a(}@Uz8X8Yw
zU15jt?p|9{Q{naN|5~^1OR6JS>?i24+cX$R&sAW9gWzF@%uXh3f{FoDiM
zWyPU1Zk-1h;=#!mutf>dC>4yA|KGp|KJWh$#f-|oe=}!!ipCE&@-tSOZOracJx=}`
DXN&2q

diff --git a/docs/articles/AMR_files/figure-html/plot 3-1.png b/docs/articles/AMR_files/figure-html/plot 3-1.png
index 0632ad8626a6473140167a5e84310cfc087ae010..026008e8015316470a1a25c23cadc22025f8c786 100644
GIT binary patch
literal 21104
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

literal 21118
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
yPW9dAYhQn;v
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

diff --git a/docs/articles/AMR_files/figure-html/plot 5-1.png b/docs/articles/AMR_files/figure-html/plot 5-1.png
index c6eeabef1107695a13d84d2c549d9317fd981211..abb1373892841af865879721ceb89f9316fb522f 100644
GIT binary patch
delta 39937
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
$sNtD%9ANL-mwyCiB0*)m?
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%0AeMA5aYAGWorS!kYnS4$Eqr@y9eNCH
zW}5s-jLilAZZq3dK9Rkv7FG~x9@O!j**ma2m>F_S?`z+zos4;?dr
z4EhntEA#Myua61hyjW!${FcZeainx|cGl3;
zgbXhPZ=^9!%s!qiKO6x4Ns%8@_)S!8p)Z#`;e0FCw5Ly>qW26l6)ozR!Gd5=QBe`i
zpna9d)|~pgD_xjId)$}k6VQ0=*4J-=9E5h$zS521ct*2@**{qg;(%|ud2kW^ag#8?
z4FlH^PS%1@`1@aH^O;wDBdHflM9CdOFMvuhiKqBIh|FmPqLHhX%n&(xU_d|;&FJRh
zFvBC7zfr&%?RQ_L_%p<`22Bm8@NQ-1SW}MVo&+})YG~U_&jZZ6ee0H|GAf>!+~pEa
zWlox`awnP?f4q--`Xo(pfv+*GSyZpmy~2;zeHGsaF$qI=RP&FgX`bc&hs?;6U$CG$
z2J4K~_cPF}7(QL3br0*O=F>FEaT1+?hkK77D5@*dDrw_4SgMogU+6$ua=anO`olL+qUofdvY>+J(a8zM=EV6P6AUi5g38W)zv8yY+KTrp{By$@6zA$m
zM~<}%F#d|(VygTyTiaTmeO`2Ard{J#p=p7rH?0@*=u@i#dw>lmB_+9Q9t7ys53m%1
zo$_ZoGCjKWK=S9TcI6!}bN{pTQd`J*v{fCm#@DIuBN+#u3rU6$)l*rlTsXM}hdiU1
zGq0g3RQ{Wvd$doAjX3+wOE-ZZU-LIHBB6ve9-Fl9&-lZU$~G)ZFWqjak^6`-CA?gW
z9?EAat{L1(a4}t0^?hE=BFmg>cke-OQiJq#wn79_KAkh6YD?|J$cK3Pllw{cLV7h;
zS_@6~Iptg`vI*W)I4g#33k8W7X@_Vt?pL8hhcV~!uB@|O{Yu}=%#0i-?F#HdpiAkg
zdux-lHosq3KHP_H$z2%(=z@dOcJ33VDaz}yd9qj)z^bCcy)ZX`NFLBecFB>10akw(
zDd5=*9pTK6x0=G-p^7OD*sb?*dDBrc4HFhJAx;B#ifk%$4)y1RH`I0T8(zAxco%z{
zOd8^O6`&h=6hd@XbXV-qX~o9Yo!h1Br_f;b>9KRS^>L)^nyNIh=J}?l5P-u7^;%jR
zkSDMrK$qhM5I^^)V(WcNOlHBFYHzjEd|#MgD1s%S{^s`IIsJ*4uG|{sv*BUuqrU$B
zBA>v*bS_?#j6RqF(Y
zTP~<>L@Q{RK@Sf(NN)7{AVMN{iVKYxyI!U)uyPqVY?woupSIHE9~aRhvOr1Iu3!I-
z3ccx_&^UN_x8cUyy0+(Zbljik8a|Qd!2d5=+RFQ{NxeJ0Y)V+(M%HA!voU3@LGY;G
my&WD5@m}^|6#sPY(yf!jWp$;NC4I$jnmOHg+6C#-o&N=y#)_!`

literal 51369
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
dQASSy(}`;R=*tjE1pOwdaytbA9j`f
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 to apply EUCAST rules
                         
Matthijs S. Berends

             
-            
20 February 2019

+            
21 February 2019

       
       
       
diff --git a/docs/articles/G_test.html b/docs/articles/G_test.html
index 304f848b..7298828d 100644
--- a/docs/articles/G_test.html
+++ b/docs/articles/G_test.html
@@ -192,7 +192,7 @@
       
How to use the G-test

                         
Matthijs S. Berends

             
-            
20 February 2019

+            
21 February 2019

       
       
       
diff --git a/docs/articles/SPSS.html b/docs/articles/SPSS.html
index 7d8a8546..09c41dc6 100644
--- a/docs/articles/SPSS.html
+++ b/docs/articles/SPSS.html
@@ -204,7 +204,7 @@
 

 

 SPSS / SAS / Stata

-
SPSS (Statistical Package for the Social Sciences) is probably the most well-known software package for statistical analysis. SPSS is easier to learn than R, because in SPSS you only have to click a menu to run parts of your analysis. Because of its user-friendlyness, it is taught at universities and particularly useful for students who are new to statistics. From my experience, I would guess that pretty much all (bio)medical students know it at the time they graduate. SAS and Stata are statistical packages popular in big industries.

+
SPSS (Statistical Package for the Social Sciences) is probably the most well-known software package for statistical analysis. SPSS is easier to learn than R, because in SPSS you only have to click a menu to run parts of your analysis. Because of its user-friendliness, it is taught at universities and particularly useful for students who are new to statistics. From my experience, I would guess that pretty much all (bio)medical students know it at the time they graduate. SAS and Stata are comparable statistical packages popular in big industries.

 

 

 

diff --git a/docs/articles/WHONET.html b/docs/articles/WHONET.html
index 52633355..eb202bad 100644
--- a/docs/articles/WHONET.html
+++ b/docs/articles/WHONET.html
@@ -192,7 +192,7 @@
       
How to work with WHONET data

                         
Matthijs S. Berends

             
-            
20 February 2019

+            
21 February 2019

       
       
       
diff --git a/docs/articles/atc_property.html b/docs/articles/atc_property.html
index f9bcbfe3..61e7491b 100644
--- a/docs/articles/atc_property.html
+++ b/docs/articles/atc_property.html
@@ -192,7 +192,7 @@
       
How to get properties of an antibiotic

                         
Matthijs S. Berends

             
-            
20 February 2019

+            
21 February 2019

       
       
       
diff --git a/docs/articles/benchmarks.html b/docs/articles/benchmarks.html
index 5878fed4..63ca9bff 100644
--- a/docs/articles/benchmarks.html
+++ b/docs/articles/benchmarks.html
@@ -192,7 +192,7 @@
       
Benchmarks

                         
Matthijs S. Berends

             
-            
20 February 2019

+            
21 February 2019

       
       
       
@@ -201,7 +201,7 @@
 
     
     
-
One of the most important features of this package is the complete microbial taxonomic database, supplied by the Catalogue of Life (http://catalogueoflife.org). We created a function as.mo() that transforms any user input value to a valid microbial ID by using AI (Artificial Intelligence) combined with the taxonomic tree of Catalogue of Life.

+
One of the most important features of this package is the complete microbial taxonomic database, supplied by the Catalogue of Life. We created a function as.mo() that transforms any user input value to a valid microbial ID by using AI (Artificial Intelligence) combined with the taxonomic tree of Catalogue of Life.

 
Using the microbenchmark package, we can review the calculation performance of this function. Its function microbenchmark() runs different input expressions independently of each other and measures their time-to-result.

 
library(microbenchmark)
 library(AMR)

@@ -216,27 +216,18 @@
                            as.mo("Staphylococcus aureus"),
                            as.mo("B_STPHY_AUR"),
                            times = 10)
-print(S.aureus, unit = "ms", signif = 3)
+print(S.aureus, unit = "ms", signif = 2)
 #> Unit: milliseconds
-#>                            expr    min     lq  mean median     uq     max
-#>                    as.mo("sau") 42.300 42.500 47.00 43.100 43.200  82.000
-#>                   as.mo("stau") 75.900 76.100 82.70 76.700 77.900 125.000
-#>                 as.mo("staaur") 42.400 43.300 53.60 44.600 49.000  98.200
-#>              as.mo("S. aureus") 18.400 18.600 20.60 18.700 19.200  34.100
-#>             as.mo("S.  aureus") 18.400 18.500 18.80 18.600 19.200  19.600
-#>                 as.mo("STAAUR") 42.300 42.700 43.30 43.000 43.800  45.700
-#>  as.mo("Staphylococcus aureus") 11.400 11.500 11.80 11.600 11.800  13.400
-#>            as.mo("B_STPHY_AUR")  0.261  0.418  0.44  0.434  0.493   0.542
-#>  neval
-#>     10
-#>     10
-#>     10
-#>     10
-#>     10
-#>     10
-#>     10
-#>     10
-

In the table above, all measurements are shown in milliseconds (thousands of seconds). A value of 10 milliseconds means it can determine 100 input values per second. It case of 50 milliseconds, this is only 20 input values per second. The more an input value resembles a full name, the faster the result will be found. In case of as.mo("B_STPHY_AUR"), the input is already a valid MO code, so it only almost takes no time at all (261 millionths of seconds).

+#> expr min lq mean median uq max neval +#> as.mo("sau") 42.00 43.00 47.00 43.00 44.0 81.00 10 +#> as.mo("stau") 86.00 87.00 93.00 88.00 89.0 130.00 10 +#> as.mo("staaur") 43.00 43.00 45.00 43.00 43.0 64.00 10 +#> as.mo("S. aureus") 23.00 23.00 27.00 23.00 24.0 60.00 10 +#> as.mo("S. aureus") 23.00 23.00 29.00 24.00 24.0 73.00 10 +#> as.mo("STAAUR") 43.00 43.00 43.00 43.00 44.0 46.00 10 +#> as.mo("Staphylococcus aureus") 14.00 15.00 19.00 15.00 16.0 53.00 10 +#> as.mo("B_STPHY_AUR") 0.34 0.42 0.47 0.49 0.5 0.58 10 +

In the table above, all measurements are shown in milliseconds (thousands of seconds). A value of 10 milliseconds means it can determine 100 input values per second. It case of 50 milliseconds, this is only 20 input values per second. The more an input value resembles a full name, the faster the result will be found. In case of as.mo("B_STPHY_AUR"), the input is already a valid MO code, so it only almost takes no time at all (494 millionths of a second).

To achieve this speed, the as.mo function also takes into account the prevalence of human pathogenic microorganisms. The downside is of course that less prevalent microorganisms will be determined less fast. See this example for the ID of Mycoplasma leonicaptivi (B_MYCPL_LEO), a bug probably never found before in humans:

-

That takes 5.9 times as much time on average! A value of 100 milliseconds means it can only determine ~10 different input values per second. We can conclude that looking up arbitrary codes of less prevalent microorganisms is the worst way to go, in terms of calculation performance:

+#> expr min lq mean median uq max +#> as.mo("myle") 140.00 140.00 150.0 140.00 140.00 180.00 +#> as.mo("mycleo") 470.00 480.00 500.0 510.00 520.00 560.00 +#> as.mo("M. leonicaptivi") 240.00 240.00 250.0 240.00 280.00 290.00 +#> as.mo("M. leonicaptivi") 240.00 240.00 250.0 240.00 280.00 280.00 +#> as.mo("MYCLEO") 470.00 510.00 510.0 520.00 520.00 540.00 +#> as.mo("Mycoplasma leonicaptivi") 150.00 150.00 170.0 180.00 190.00 200.00 +#> as.mo("B_MYCPL_LEO") 0.32 0.58 0.6 0.59 0.61 0.97 +#> neval +#> 10 +#> 10 +#> 10 +#> 10 +#> 10 +#> 10 +#> 10 +

That takes 6.9 times as much time on average! A value of 100 milliseconds means it can only determine ~10 different input values per second. We can conclude that looking up arbitrary codes of less prevalent microorganisms is the worst way to go, in terms of calculation performance:

par(mar = c(5, 16, 4, 2)) # set more space for left margin text (16)
 
 # highest value on y axis
@@ -272,10 +263,10 @@
 
 boxplot(S.aureus, horizontal = TRUE, las = 1, unit = "ms", log = FALSE, xlab = "", ylim = c(0, max_y_axis),
         main = expression(paste("Benchmark of ", italic("Staphylococcus aureus"))))
-

+

boxplot(M.leonicaptivi, horizontal = TRUE, las = 1, unit = "ms", log = FALSE, xlab = "", ylim = c(0, max_y_axis),
         main = expression(paste("Benchmark of ", italic("Mycoplasma leonicaptivi"))))
-

+

To relieve this pitfall and further improve performance, two important calculations take almost no time at all: repetitive results and already precalculated results.

-

So transforming 500,000 values (!) of 95 unique values only takes 0.47 seconds (469 ms). You only lose time on your unique input values.

+#> mo_fullname(x) 445 466 497 491 536 543 10 +

So transforming 500,000 values (!) of 95 unique values only takes 0.49 seconds (490 ms). You only lose time on your unique input values.

+#> expr min lq mean median uq max neval +#> A 38.70 39.100 40.200 40.000 40.100 45.300 10 +#> B 24.50 24.600 24.800 24.700 24.700 25.500 10 +#> C 0.26 0.392 0.434 0.447 0.516 0.561 10

So going from mo_fullname("Staphylococcus aureus") to "Staphylococcus aureus" takes 0.0004 seconds - it doesn’t even start calculating if the result would be the same as the expected resulting value. That goes for all helper functions:

+#> A 0.297 0.329 0.400 0.416 0.453 0.459 10 +#> B 0.277 0.304 0.349 0.363 0.382 0.407 10 +#> C 0.281 0.430 0.436 0.440 0.471 0.493 10 +#> D 0.249 0.277 0.310 0.316 0.337 0.347 10 +#> E 0.214 0.252 0.300 0.306 0.338 0.403 10 +#> F 0.237 0.270 0.300 0.311 0.326 0.335 10 +#> G 0.245 0.282 0.297 0.298 0.314 0.348 10 +#> H 0.241 0.282 0.308 0.312 0.328 0.373 10

Of course, when running mo_phylum("Firmicutes") the function has zero knowledge about the actual microorganism, namely S. aureus. But since the result would be "Firmicutes" too, there is no point in calculating the result. And because this package ‘knows’ all phyla of all known bacteria (according to the Catalogue of Life), it can just return the initial value immediately.

+#> en 10.85 10.89 11.10 11.03 11.23 11.83 10 +#> de 19.43 19.50 19.86 19.58 20.35 20.99 10 +#> nl 19.08 19.17 19.40 19.48 19.56 19.63 10 +#> es 19.35 19.44 26.07 19.48 20.06 52.36 10 +#> it 19.23 19.40 22.91 19.49 19.91 52.92 10 +#> fr 19.10 19.22 19.40 19.45 19.54 19.68 10 +#> pt 19.01 19.46 29.32 19.55 52.32 52.50 10

Currently supported are German, Dutch, Spanish, Italian, French and Portuguese.

diff --git a/docs/articles/benchmarks_files/figure-html/unnamed-chunk-5-1.png b/docs/articles/benchmarks_files/figure-html/unnamed-chunk-5-1.png new file mode 100644 index 0000000000000000000000000000000000000000..c65eb537bab8614b2d5eab6d7fba7c5aabf2e111 GIT binary patch literal 32533 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

>@%rG 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 literal 0 HcmV?d00001 diff --git a/docs/articles/freq.html b/docs/articles/freq.html index f605df37..6ed32991 100644 --- a/docs/articles/freq.html +++ b/docs/articles/freq.html @@ -192,7 +192,7 @@

How to create frequency tables

Matthijs S. Berends

-

20 February 2019

+

21 February 2019

diff --git a/docs/articles/mo_property.html b/docs/articles/mo_property.html index 8f5fb8cb..060e5ade 100644 --- a/docs/articles/mo_property.html +++ b/docs/articles/mo_property.html @@ -192,7 +192,7 @@

How to get properties of a microorganism

Matthijs S. Berends

-

20 February 2019

+

21 February 2019

diff --git a/docs/articles/resistance_predict.html b/docs/articles/resistance_predict.html index 5afd65c2..c551ac81 100644 --- a/docs/articles/resistance_predict.html +++ b/docs/articles/resistance_predict.html @@ -192,7 +192,7 @@

How to predict antimicrobial resistance

Matthijs S. Berends

-

20 February 2019

+

21 February 2019

diff --git a/docs/index.html b/docs/index.html index db24ab8f..a59d6d19 100644 --- a/docs/index.html +++ b/docs/index.html @@ -211,7 +211,7 @@
  • Getting properties for any antibiotic (like name, ATC code, defined daily dose or trade name)
  • Plotting antimicrobial resistance
  • Determining first isolates to be used for AMR analysis
    • -
  • Applying EUCAST rules
    • +
  • Applying EUCAST expert rules (not the translation from MIC to RSI values)
  • Determining multi-drug resistant organisms (MDRO)
  • Descriptive statistics: frequency tables, kurtosis and skewness
    • @@ -321,7 +321,7 @@

  • It enhances existing data and adds new data from data sets included in this package.

    diff --git a/docs/reference/atc_property.html b/docs/reference/atc_property.html index cf774c22..40034769 100644 --- a/docs/reference/atc_property.html +++ b/docs/reference/atc_property.html @@ -279,8 +279,7 @@

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    See also

    diff --git a/docs/reference/availability.html b/docs/reference/availability.html index 27692c60..affa0a25 100644 --- a/docs/reference/availability.html +++ b/docs/reference/availability.html @@ -256,6 +256,11 @@

    data.frame with column names of tbl as row names and columns: percent_IR, count, percent, visual_availability.

    +

    Read more on our website!

    + + +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    Examples

    # NOT RUN {
@@ -280,6 +285,8 @@
       
  • Arguments
    • 
       
       
  • Value
    • 
+
+      
  • Read more on our website!
    • 
       
       
  • Examples
    • 
     
diff --git a/docs/reference/catalogue_of_life.html b/docs/reference/catalogue_of_life.html
index 2a0455ad..f29870a8 100644
--- a/docs/reference/catalogue_of_life.html
+++ b/docs/reference/catalogue_of_life.html
@@ -260,8 +260,7 @@ This package contains the complete taxonomic tree of almost all microorganisms f
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/catalogue_of_life_version.html b/docs/reference/catalogue_of_life_version.html
index 526df903..b9589576 100644
--- a/docs/reference/catalogue_of_life_version.html
+++ b/docs/reference/catalogue_of_life_version.html
@@ -258,6 +258,11 @@ This package contains the complete taxonomic tree of almost all microorganisms f
     
    The Catalogue of Life (http://www.catalogueoflife.org) is the most comprehensive and authoritative global index of species currently available. It holds essential information on the names, relationships and distributions of over 1.6 million species. The Catalogue of Life is used to support the major biodiversity and conservation information services such as the Global Biodiversity Information Facility (GBIF), Encyclopedia of Life (EoL) and the International Union for Conservation of Nature Red List. It is recognised by the Convention on Biological Diversity as a significant component of the Global Taxonomy Initiative and a contribution to Target 1 of the Global Strategy for Plant Conservation.
    
 
    The syntax used to transform the original data to a cleansed R format, can be found here: https://gitlab.com/msberends/AMR/blob/master/reproduction_of_microorganisms.R.
    
     
+    
    Read more on our website!
    
+
+    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
     
    See also
    
 
     
    microorganisms
    
@@ -270,6 +275,8 @@ This package contains the complete taxonomic tree of almost all microorganisms f
       
       
  • Catalogue of Life
    • 
 
+      
  • Read more on our website!
    • 
+
       
  • See also
    • 
           
 
diff --git a/docs/reference/count.html b/docs/reference/count.html
index 914666f7..7e6895d6 100644
--- a/docs/reference/count.html
+++ b/docs/reference/count.html
@@ -302,8 +302,7 @@ count_R and count_IR can be used to count resistant isolates, count_S and count_
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/eucast_rules.html b/docs/reference/eucast_rules.html
index 00699728..0018acc8 100644
--- a/docs/reference/eucast_rules.html
+++ b/docs/reference/eucast_rules.html
@@ -400,8 +400,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/first_isolate.html b/docs/reference/first_isolate.html
index 1d8c76ee..462f6069 100644
--- a/docs/reference/first_isolate.html
+++ b/docs/reference/first_isolate.html
@@ -366,8 +366,7 @@ To conduct an analysis of antimicrobial resistance, you should only include the
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/freq.html b/docs/reference/freq.html
index 8ec16413..7c2c4748 100644
--- a/docs/reference/freq.html
+++ b/docs/reference/freq.html
@@ -380,8 +380,7 @@ top_freq can be used to get the top/bottom n items of a frequency table, with co
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/g.test.html b/docs/reference/g.test.html
index a599f7f5..f57baf1b 100644
--- a/docs/reference/g.test.html
+++ b/docs/reference/g.test.html
@@ -337,8 +337,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    References
    
 
diff --git a/docs/reference/get_locale.html b/docs/reference/get_locale.html
index 722d2934..7baea359 100644
--- a/docs/reference/get_locale.html
+++ b/docs/reference/get_locale.html
@@ -255,8 +255,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
   
diff --git a/docs/reference/ggplot_rsi.html b/docs/reference/ggplot_rsi.html
index 9b5f418f..fce27feb 100644
--- a/docs/reference/ggplot_rsi.html
+++ b/docs/reference/ggplot_rsi.html
@@ -338,8 +338,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/guess_ab_col.html b/docs/reference/guess_ab_col.html
index 834611b5..8fa8e4a6 100644
--- a/docs/reference/guess_ab_col.html
+++ b/docs/reference/guess_ab_col.html
@@ -263,8 +263,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/join.html b/docs/reference/join.html
index 7759b805..2a864423 100644
--- a/docs/reference/join.html
+++ b/docs/reference/join.html
@@ -281,8 +281,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/key_antibiotics.html b/docs/reference/key_antibiotics.html
index e1a67f1f..858be017 100644
--- a/docs/reference/key_antibiotics.html
+++ b/docs/reference/key_antibiotics.html
@@ -333,8 +333,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/kurtosis.html b/docs/reference/kurtosis.html
index 200d8ae2..3aa692ba 100644
--- a/docs/reference/kurtosis.html
+++ b/docs/reference/kurtosis.html
@@ -268,8 +268,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/like.html b/docs/reference/like.html
index 4204a218..f6135b1f 100644
--- a/docs/reference/like.html
+++ b/docs/reference/like.html
@@ -281,8 +281,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/mdro.html b/docs/reference/mdro.html
index 4788881b..89e04653 100644
--- a/docs/reference/mdro.html
+++ b/docs/reference/mdro.html
@@ -623,8 +623,7 @@
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
 
     
    Examples
    
diff --git a/docs/reference/microorganisms.codes.html b/docs/reference/microorganisms.codes.html
index 9e5421c3..8f1d5e9e 100644
--- a/docs/reference/microorganisms.codes.html
+++ b/docs/reference/microorganisms.codes.html
@@ -268,8 +268,7 @@ This package contains the complete taxonomic tree of almost all microorganisms f
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/microorganisms.html b/docs/reference/microorganisms.html
index dd1ba4a0..fdfd2c82 100644
--- a/docs/reference/microorganisms.html
+++ b/docs/reference/microorganisms.html
@@ -292,8 +292,7 @@ This package contains the complete taxonomic tree of almost all microorganisms f
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/microorganisms.old.html b/docs/reference/microorganisms.old.html
index 840e28b0..65fd7cf6 100644
--- a/docs/reference/microorganisms.old.html
+++ b/docs/reference/microorganisms.old.html
@@ -274,8 +274,7 @@ This package contains the complete taxonomic tree of almost all microorganisms f
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
diff --git a/docs/reference/mo_property.html b/docs/reference/mo_property.html
index 0025ab0e..6bf3ae40 100644
--- a/docs/reference/mo_property.html
+++ b/docs/reference/mo_property.html
@@ -348,8 +348,7 @@ This package contains the complete taxonomic tree of almost all microorganisms f
     
    Read more on our website!
    
 
     
-    
     
    
-On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
+    
    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.
    
     
     
    See also
    
 
@@ -433,7 +432,7 @@ On our website https://msberends.gitla
             language = "nl")              # "Streptococcus groep A"
 
 
-# Get a list with the complete taxonomy (subkingdom to subspecies)
+# Get a list with the complete taxonomy (kingdom to subspecies)
 mo_taxonomy("E. coli")
 # }
    diff --git a/docs/reference/mo_source.html b/docs/reference/mo_source.html index ddab3618..af0ac9cc 100644 --- a/docs/reference/mo_source.html +++ b/docs/reference/mo_source.html @@ -264,8 +264,7 @@

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    Examples

    diff --git a/docs/reference/p.symbol.html b/docs/reference/p.symbol.html index df30b5e0..4c2550f1 100644 --- a/docs/reference/p.symbol.html +++ b/docs/reference/p.symbol.html @@ -263,8 +263,7 @@

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    diff --git a/docs/reference/portion.html b/docs/reference/portion.html index 392ddc38..25f4214b 100644 --- a/docs/reference/portion.html +++ b/docs/reference/portion.html @@ -325,8 +325,7 @@ portion_R and portion_IR can be used to calculate resistance, portion_S and port

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    See also

    diff --git a/docs/reference/read.4D.html b/docs/reference/read.4D.html index d9be3749..5298404d 100644 --- a/docs/reference/read.4D.html +++ b/docs/reference/read.4D.html @@ -388,8 +388,7 @@

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    diff --git a/docs/reference/resistance_predict.html b/docs/reference/resistance_predict.html index 03ab934b..3e2d62ee 100644 --- a/docs/reference/resistance_predict.html +++ b/docs/reference/resistance_predict.html @@ -348,8 +348,7 @@

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    See also

    diff --git a/docs/reference/septic_patients.html b/docs/reference/septic_patients.html index 4c05279b..e2c10581 100644 --- a/docs/reference/septic_patients.html +++ b/docs/reference/septic_patients.html @@ -261,8 +261,7 @@

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    diff --git a/docs/reference/skewness.html b/docs/reference/skewness.html index 223d8b20..eb86b6e2 100644 --- a/docs/reference/skewness.html +++ b/docs/reference/skewness.html @@ -270,8 +270,7 @@ When negative: the left tail is longer; the mass of the distribution is concentr

    Read more on our website!

    -


    -On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    +

    On our website https://msberends.gitlab.io/AMR you can find a comprehensive tutorial about how to conduct AMR analysis, the complete documentation of all functions (which reads a lot easier than here in R) and an example analysis using WHONET data.

    See also

    diff --git a/index.md b/index.md index 6c51e461..f5a8bbc9 100644 --- a/index.md +++ b/index.md @@ -23,7 +23,7 @@ This package can be used for: * Getting properties for any antibiotic (like name, ATC code, defined daily dose or trade name) * Plotting antimicrobial resistance * Determining first isolates to be used for AMR analysis - * Applying EUCAST rules + * Applying EUCAST expert rules (not the translation from MIC to RSI values) * Determining multi-drug resistant organisms (MDRO) * Descriptive statistics: frequency tables, kurtosis and skewness @@ -137,7 +137,7 @@ The `AMR` package basically does four important things: 2. It **enhances existing data** and **adds new data** from data sets included in this package. - * Use `eucast_rules()` to apply [EUCAST expert rules to isolates](http://www.eucast.org/expert_rules_and_intrinsic_resistance/). + * Use `eucast_rules()` to apply [EUCAST expert rules to isolates](http://www.eucast.org/expert_rules_and_intrinsic_resistance/) (not the translation from MIC to RSI values). * Use `first_isolate()` to identify the first isolates of every patient [using guidelines from the CLSI](https://clsi.org/standards/products/microbiology/documents/m39/) (Clinical and Laboratory Standards Institute). * You can also identify first *weighted* isolates of every patient, an adjusted version of the CLSI guideline. This takes into account key antibiotics of every strain and compares them. * Use `mdro()` (abbreviation of Multi Drug Resistant Organisms) to check your isolates for exceptional resistance with country-specific guidelines or EUCAST rules. Currently, national guidelines for Germany and the Netherlands are supported. diff --git a/man/AMR-deprecated.Rd b/man/AMR-deprecated.Rd index 7b1d433b..5aa113d4 100644 --- a/man/AMR-deprecated.Rd +++ b/man/AMR-deprecated.Rd @@ -48,7 +48,6 @@ These functions are so-called '\link{Deprecated}'. They will be removed in a fut } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/AMR.Rd b/man/AMR.Rd index fefe4e95..21f07799 100644 --- a/man/AMR.Rd +++ b/man/AMR.Rd @@ -1,5 +1,5 @@ % Generated by roxygen2: do not edit by hand -% Please edit documentation in R/zzz.R +% Please edit documentation in R/amr.R \name{AMR} \alias{AMR} \title{The \code{AMR} Package} @@ -13,14 +13,16 @@ We created this package for both academic research and routine analysis at the F This package can be used for: \itemize{ + \item{Reference for microorganisms, since it contains almost all 60,000 microbial (sub)species from the Catalogue of Life} \item{Calculating antimicrobial resistance} - \item{Predicting antimicrobial resistance using regression models} + \item{Calculating empirical susceptibility of both mono therapy and combination therapy} + \item{Predicting future antimicrobial resistance using regression models} \item{Getting properties for any microorganism (like Gram stain, species, genus or family)} \item{Getting properties for any antibiotic (like name, ATC code, defined daily dose or trade name)} \item{Plotting antimicrobial resistance} \item{Determining first isolates to be used for AMR analysis} - \item{Applying EUCAST rules} - \item{Determining multi-drug resistance organisms (MDRO)} + \item{Applying EUCAST expert rules (not the translation from MIC to RSI values)} + \item{Determining multi-drug resistant organisms (MDRO)} \item{Descriptive statistics: frequency tables, kurtosis and skewness} } } @@ -34,7 +36,6 @@ Matthijs S. Berends[1,2] Christian F. Luz[1], Erwin E.A. Hassing[2], Corinna Gl \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/WHOCC.Rd b/man/WHOCC.Rd index 4be99fd9..8e4adc8f 100644 --- a/man/WHOCC.Rd +++ b/man/WHOCC.Rd @@ -18,7 +18,6 @@ The WHOCC is located in Oslo at the Norwegian Institute of Public Health and fun \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/WHONET.Rd b/man/WHONET.Rd index fb4ca120..e3e9f1d7 100644 --- a/man/WHONET.Rd +++ b/man/WHONET.Rd @@ -41,7 +41,6 @@ This example data set has the exact same structure as an export file from WHONET } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/abname.Rd b/man/abname.Rd index f2922eaa..5de0e51b 100644 --- a/man/abname.Rd +++ b/man/abname.Rd @@ -37,7 +37,6 @@ The WHOCC is located in Oslo at the Norwegian Institute of Public Health and fun \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/age.Rd b/man/age.Rd index e2918fd3..14dd6d0c 100644 --- a/man/age.Rd +++ b/man/age.Rd @@ -19,7 +19,6 @@ Calculates age in years based on a reference date, which is the sytem date at de } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/age_groups.Rd b/man/age_groups.Rd index 7497c0de..477df197 100644 --- a/man/age_groups.Rd +++ b/man/age_groups.Rd @@ -33,7 +33,6 @@ To split ages, the input can be: } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/antibiotics.Rd b/man/antibiotics.Rd index a41d4e70..ca42d689 100644 --- a/man/antibiotics.Rd +++ b/man/antibiotics.Rd @@ -51,7 +51,6 @@ The WHOCC is located in Oslo at the Norwegian Institute of Public Health and fun \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/as.atc.Rd b/man/as.atc.Rd index 040c6451..4c260377 100644 --- a/man/as.atc.Rd +++ b/man/as.atc.Rd @@ -37,7 +37,6 @@ The WHOCC is located in Oslo at the Norwegian Institute of Public Health and fun \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/as.mic.Rd b/man/as.mic.Rd index 39dc9680..d1f361e4 100755 --- a/man/as.mic.Rd +++ b/man/as.mic.Rd @@ -22,7 +22,6 @@ This transforms a vector to a new class \code{mic}, which is an ordered factor w } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/as.mo.Rd b/man/as.mo.Rd index 08896f4e..99e3005e 100644 --- a/man/as.mo.Rd +++ b/man/as.mo.Rd @@ -131,7 +131,6 @@ The syntax used to transform the original data to a cleansed R format, can be fo \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/as.rsi.Rd b/man/as.rsi.Rd index 0311e8c8..a3b7f536 100755 --- a/man/as.rsi.Rd +++ b/man/as.rsi.Rd @@ -28,7 +28,6 @@ The function \code{is.rsi.eligible} returns \code{TRUE} when a columns contains } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/atc_online.Rd b/man/atc_online.Rd index 72c39d5d..cf8c8e3b 100644 --- a/man/atc_online.Rd +++ b/man/atc_online.Rd @@ -57,6 +57,11 @@ Abbreviations of return values when using \code{property = "U"} (unit): \item{\code{"ml"}}{ = milliliter (e.g. eyedrops)} } } +\section{Read more on our website!}{ + +On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. +} + \examples{ \donttest{ # oral DDD (Defined Daily Dose) of amoxicillin diff --git a/man/atc_property.Rd b/man/atc_property.Rd index 2dd7bd76..4f30e135 100755 --- a/man/atc_property.Rd +++ b/man/atc_property.Rd @@ -39,7 +39,6 @@ Use these functions to return a specific property of an antibiotic from the \cod } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/availability.Rd b/man/availability.Rd index ac1b67ee..e6258aae 100644 --- a/man/availability.Rd +++ b/man/availability.Rd @@ -15,6 +15,11 @@ availability(tbl) \description{ Easy check for availability of columns in a data set. This makes it easy to get an idea of which antibiotic combination can be used for calculation with e.g. \code{\link{portion_IR}}. } +\section{Read more on our website!}{ + +On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. +} + \examples{ availability(septic_patients) diff --git a/man/catalogue_of_life.Rd b/man/catalogue_of_life.Rd index 44b46808..91b8fb96 100644 --- a/man/catalogue_of_life.Rd +++ b/man/catalogue_of_life.Rd @@ -27,7 +27,6 @@ The syntax used to transform the original data to a cleansed R format, can be fo \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/catalogue_of_life_version.Rd b/man/catalogue_of_life_version.Rd index 69291bc0..992798ed 100644 --- a/man/catalogue_of_life_version.Rd +++ b/man/catalogue_of_life_version.Rd @@ -28,6 +28,11 @@ The Catalogue of Life (\url{http://www.catalogueoflife.org}) is the most compreh The syntax used to transform the original data to a cleansed R format, can be found here: \url{https://gitlab.com/msberends/AMR/blob/master/reproduction_of_microorganisms.R}. } +\section{Read more on our website!}{ + +On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. +} + \seealso{ \code{\link{microorganisms}} } diff --git a/man/count.Rd b/man/count.Rd index 85e9e0ce..3ab59c1b 100644 --- a/man/count.Rd +++ b/man/count.Rd @@ -60,7 +60,6 @@ These functions are meant to count isolates. Use the \code{\link{portion}_*} fun } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/eucast_rules.Rd b/man/eucast_rules.Rd index e6c4bc34..4ed10b16 100644 --- a/man/eucast_rules.Rd +++ b/man/eucast_rules.Rd @@ -155,7 +155,6 @@ Abbrevations of the column containing antibiotics in the form: \strong{abbreviat \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/first_isolate.Rd b/man/first_isolate.Rd index 1b0072e8..84cdbd4b 100755 --- a/man/first_isolate.Rd +++ b/man/first_isolate.Rd @@ -98,7 +98,6 @@ The function \code{filter_first_weighted_isolate} is essentially equal to: \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/freq.Rd b/man/freq.Rd index 1bb44253..fca5000c 100755 --- a/man/freq.Rd +++ b/man/freq.Rd @@ -109,7 +109,6 @@ The function \code{top_freq} uses \code{\link[dplyr]{top_n}} internally and will } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/g.test.Rd b/man/g.test.Rd index 7fea4d71..ff51cfa3 100644 --- a/man/g.test.Rd +++ b/man/g.test.Rd @@ -102,7 +102,6 @@ If there are more than two categories and you want to find out which ones are si \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/get_locale.Rd b/man/get_locale.Rd index cd93c2f9..3f943dee 100644 --- a/man/get_locale.Rd +++ b/man/get_locale.Rd @@ -19,7 +19,6 @@ Supported languages are \code{"en"} (English), \code{"de"} (German), \code{"nl"} \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/ggplot_rsi.Rd b/man/ggplot_rsi.Rd index cb480b0f..709b2bc4 100644 --- a/man/ggplot_rsi.Rd +++ b/man/ggplot_rsi.Rd @@ -83,7 +83,6 @@ At default, the names of antibiotics will be shown on the plots using \code{\lin } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/guess_ab_col.Rd b/man/guess_ab_col.Rd index a4eb521f..831c67d3 100644 --- a/man/guess_ab_col.Rd +++ b/man/guess_ab_col.Rd @@ -18,7 +18,6 @@ This tries to find a column name in a data set based on information from the \co } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/join.Rd b/man/join.Rd index 18fa8a6d..71cfc374 100755 --- a/man/join.Rd +++ b/man/join.Rd @@ -40,7 +40,6 @@ Join the dataset \code{\link{microorganisms}} easily to an existing table or cha } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/key_antibiotics.Rd b/man/key_antibiotics.Rd index 4515cb26..f9584e64 100755 --- a/man/key_antibiotics.Rd +++ b/man/key_antibiotics.Rd @@ -76,7 +76,6 @@ The function \code{key_antibiotics} returns a character vector with 12 antibioti \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/kurtosis.Rd b/man/kurtosis.Rd index dd657b44..0707380a 100644 --- a/man/kurtosis.Rd +++ b/man/kurtosis.Rd @@ -25,7 +25,6 @@ Kurtosis is a measure of the "tailedness" of the probability distribution of a r } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/like.Rd b/man/like.Rd index 08c17cbb..2f8a5d47 100755 --- a/man/like.Rd +++ b/man/like.Rd @@ -36,7 +36,6 @@ Using RStudio? This function can also be inserted from the Addins menu and can h } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/mdro.Rd b/man/mdro.Rd index 48314bdc..69b0302f 100644 --- a/man/mdro.Rd +++ b/man/mdro.Rd @@ -257,7 +257,6 @@ Abbrevations of the column containing antibiotics in the form: \strong{abbreviat \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/microorganisms.Rd b/man/microorganisms.Rd index f5c6a51e..223f2795 100755 --- a/man/microorganisms.Rd +++ b/man/microorganisms.Rd @@ -59,7 +59,6 @@ The syntax used to transform the original data to a cleansed R format, can be fo \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/microorganisms.codes.Rd b/man/microorganisms.codes.Rd index 74b8ae4f..ff79772b 100644 --- a/man/microorganisms.codes.Rd +++ b/man/microorganisms.codes.Rd @@ -36,7 +36,6 @@ The syntax used to transform the original data to a cleansed R format, can be fo \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/microorganisms.old.Rd b/man/microorganisms.old.Rd index 5fa39b5a..9901406d 100644 --- a/man/microorganisms.old.Rd +++ b/man/microorganisms.old.Rd @@ -41,7 +41,6 @@ The syntax used to transform the original data to a cleansed R format, can be fo \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/mo_property.Rd b/man/mo_property.Rd index 9d94efce..db0e42de 100644 --- a/man/mo_property.Rd +++ b/man/mo_property.Rd @@ -123,7 +123,6 @@ The syntax used to transform the original data to a cleansed R format, can be fo \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } @@ -203,7 +202,7 @@ mo_fullname("S. pyogenes", language = "nl") # "Streptococcus groep A" -# Get a list with the complete taxonomy (subkingdom to subspecies) +# Get a list with the complete taxonomy (kingdom to subspecies) mo_taxonomy("E. coli") } \seealso{ diff --git a/man/mo_source.Rd b/man/mo_source.Rd index 38c7324b..103bc7d2 100644 --- a/man/mo_source.Rd +++ b/man/mo_source.Rd @@ -27,7 +27,6 @@ Reading an Excel file (\code{.xlsx}) with only one row has a size of 8-9 kB. The } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/p.symbol.Rd b/man/p.symbol.Rd index e2beb2e2..0fdcf71c 100644 --- a/man/p.symbol.Rd +++ b/man/p.symbol.Rd @@ -19,7 +19,6 @@ Return the symbol related to the p value: 0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0 } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/portion.Rd b/man/portion.Rd index 51a1bf90..1fbd5296 100644 --- a/man/portion.Rd +++ b/man/portion.Rd @@ -81,7 +81,6 @@ The old \code{\link{rsi}} function is still available for backwards compatibilit } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/read.4D.Rd b/man/read.4D.Rd index 456e297a..c2e0f183 100644 --- a/man/read.4D.Rd +++ b/man/read.4D.Rd @@ -124,7 +124,6 @@ Column names will be transformed, but the original column names are set as a "la } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/resistance_predict.Rd b/man/resistance_predict.Rd index 9459823f..dae9b797 100644 --- a/man/resistance_predict.Rd +++ b/man/resistance_predict.Rd @@ -82,7 +82,6 @@ Valid options for the statistical model are: } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/septic_patients.Rd b/man/septic_patients.Rd index feb248a8..2f91f974 100755 --- a/man/septic_patients.Rd +++ b/man/septic_patients.Rd @@ -25,7 +25,6 @@ An anonymised data set containing 2,000 microbial blood culture isolates with th } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/man/skewness.Rd b/man/skewness.Rd index 509a5631..4fff5668 100644 --- a/man/skewness.Rd +++ b/man/skewness.Rd @@ -27,7 +27,6 @@ When negative: the left tail is longer; the mass of the distribution is concentr } \section{Read more on our website!}{ -\if{html}{\figure{logo.png}{options: height=40px style=margin-bottom:5px} \cr} On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a comprehensive tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}. } diff --git a/tests/testthat/test-data.R b/tests/testthat/test-data.R index 53829a00..de9b2b7a 100644 --- a/tests/testthat/test-data.R +++ b/tests/testthat/test-data.R @@ -55,3 +55,8 @@ test_that("data sets are valid", { as.data.frame(stringsAsFactors = FALSE)) }) + +test_that("creation of data sets are valid", { + # run the code + .onLoad() +}) diff --git a/vignettes/SPSS.Rmd b/vignettes/SPSS.Rmd index 5eb2fa6a..01e1cd0a 100755 --- a/vignettes/SPSS.Rmd +++ b/vignettes/SPSS.Rmd @@ -24,7 +24,7 @@ Sys.setlocale(locale = "C") ## SPSS / SAS / Stata -SPSS (Statistical Package for the Social Sciences) is probably the most well-known software package for statistical analysis. SPSS is easier to learn than R, because in SPSS you only have to click a menu to run parts of your analysis. Because of its user-friendlyness, it is taught at universities and particularly useful for students who are new to statistics. From my experience, I would guess that pretty much all (bio)medical students know it at the time they graduate. SAS and Stata are statistical packages popular in big industries. +SPSS (Statistical Package for the Social Sciences) is probably the most well-known software package for statistical analysis. SPSS is easier to learn than R, because in SPSS you only have to click a menu to run parts of your analysis. Because of its user-friendliness, it is taught at universities and particularly useful for students who are new to statistics. From my experience, I would guess that pretty much all (bio)medical students know it at the time they graduate. SAS and Stata are comparable statistical packages popular in big industries. ## Compared to R diff --git a/vignettes/benchmarks.Rmd b/vignettes/benchmarks.Rmd index 2042eb9d..8dc398f8 100755 --- a/vignettes/benchmarks.Rmd +++ b/vignettes/benchmarks.Rmd @@ -23,10 +23,14 @@ knitr::opts_chunk$set( ) ``` -One of the most important features of this package is the complete microbial taxonomic database, supplied by the Catalogue of Life (http://catalogueoflife.org). We created a function `as.mo()` that transforms any user input value to a valid microbial ID by using AI (Artificial Intelligence) combined with the taxonomic tree of Catalogue of Life. +One of the most important features of this package is the complete microbial taxonomic database, supplied by the [Catalogue of Life](http://catalogueoflife.org). We created a function `as.mo()` that transforms any user input value to a valid microbial ID by using AI (Artificial Intelligence) combined with the taxonomic tree of Catalogue of Life. Using the `microbenchmark` package, we can review the calculation performance of this function. Its function `microbenchmark()` runs different input expressions independently of each other and measures their time-to-result. +```{r, message = FALSE, echo = FALSE} +library(dplyr) +``` + ```{r, message = FALSE} library(microbenchmark) library(AMR) @@ -46,10 +50,10 @@ S.aureus <- microbenchmark(as.mo("sau"), as.mo("Staphylococcus aureus"), as.mo("B_STPHY_AUR"), times = 10) -print(S.aureus, unit = "ms", signif = 3) +print(S.aureus, unit = "ms", signif = 2) ``` -In the table above, all measurements are shown in milliseconds (thousands of seconds). A value of 10 milliseconds means it can determine 100 input values per second. It case of 50 milliseconds, this is only 20 input values per second. The more an input value resembles a full name, the faster the result will be found. In case of `as.mo("B_STPHY_AUR")`, the input is already a valid MO code, so it only almost takes no time at all (`r as.integer(min(S.aureus$time, na.rm = TRUE) / 1000)` millionths of seconds). +In the table above, all measurements are shown in milliseconds (thousands of seconds). A value of 10 milliseconds means it can determine 100 input values per second. It case of 50 milliseconds, this is only 20 input values per second. The more an input value resembles a full name, the faster the result will be found. In case of `as.mo("B_STPHY_AUR")`, the input is already a valid MO code, so it only almost takes no time at all (`r as.integer(S.aureus %>% filter(expr == 'as.mo("B_STPHY_AUR")') %>% pull(time) %>% median(na.rm = TRUE) / 1000)` millionths of a second). To achieve this speed, the `as.mo` function also takes into account the prevalence of human pathogenic microorganisms. The downside is of course that less prevalent microorganisms will be determined less fast. See this example for the ID of *Mycoplasma leonicaptivi* (`B_MYCPL_LEO`), a bug probably never found before in humans: @@ -62,7 +66,7 @@ M.leonicaptivi <- microbenchmark(as.mo("myle"), as.mo("Mycoplasma leonicaptivi"), as.mo("B_MYCPL_LEO"), times = 10) -print(M.leonicaptivi, unit = "ms", signif = 4) +print(M.leonicaptivi, unit = "ms", signif = 2) ``` That takes `r round(mean(M.leonicaptivi$time, na.rm = TRUE) / mean(S.aureus$time, na.rm = TRUE), 1)` times as much time on average! A value of 100 milliseconds means it can only determine ~10 different input values per second. We can conclude that looking up arbitrary codes of less prevalent microorganisms is the worst way to go, in terms of calculation performance: