From bd73988f15c510e676b1dcf7042014736716f65b Mon Sep 17 00:00:00 2001 From: "Matthijs S. Berends" Date: Sun, 2 Jun 2019 19:23:19 +0200 Subject: [PATCH] (v0.6.1.9053) prerelease fixes --- DESCRIPTION | 4 +- NEWS.md | 7 +- R/amr.R | 2 +- R/catalogue_of_life.R | 2 +- R/data.R | 15 +- R/freq.R | 13 +- R/mo.R | 29 +- docs/LICENSE-text.html | 2 +- docs/articles/AMR.html | 430 +++++++++--------- .../AMR_files/figure-html/plot 1-1.png | Bin 36044 -> 36024 bytes .../AMR_files/figure-html/plot 3-1.png | Bin 19255 -> 19261 bytes .../AMR_files/figure-html/plot 4-1.png | Bin 70007 -> 70005 bytes .../AMR_files/figure-html/plot 5-1.png | Bin 43343 -> 43343 bytes docs/articles/index.html | 2 +- docs/articles/resistance_predict.html | 6 +- docs/authors.html | 2 +- docs/extra.css | 6 +- docs/extra.js | 2 +- docs/index.html | 2 +- docs/news/index.html | 13 +- docs/reference/AMR.html | 4 +- docs/reference/catalogue_of_life.html | 4 +- docs/reference/eucast_rules.html | 2 +- docs/reference/index.html | 2 +- docs/reference/microorganisms.codes.html | 4 +- docs/reference/microorganisms.html | 21 +- git_premaster.sh | 2 +- git_release.sh | 32 ++ man/AMR.Rd | 2 +- man/catalogue_of_life.Rd | 2 +- man/microorganisms.Rd | 20 +- man/microorganisms.codes.Rd | 2 +- pkgdown/extra.css | 6 +- pkgdown/extra.js | 2 +- tests/testthat/test-freq.R | 6 +- tests/testthat/test-mo.R | 12 +- vignettes/AMR.Rmd | 2 +- vignettes/resistance_predict.Rmd | 2 +- 38 files changed, 337 insertions(+), 327 deletions(-) create mode 100755 git_release.sh diff --git a/DESCRIPTION b/DESCRIPTION index f73897f1..eca956d2 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: AMR -Version: 0.6.1.9052 -Date: 2019-06-01 +Version: 0.6.1.9053 +Date: 2019-06-02 Title: Antimicrobial Resistance Analysis Authors@R: c( person( diff --git a/NEWS.md b/NEWS.md index 2d98faf2..42c539dd 100755 --- a/NEWS.md +++ b/NEWS.md @@ -1,5 +1,4 @@ -# AMR 0.6.1.9052 -**Note: latest development version** +# AMR 0.6.1.9053 #### New * Support for translation of disk diffusion and MIC values to RSI values (i.e. antimicrobial interpretations). Supported guidelines are EUCAST (2011 to 2019) and CLSI (2011 to 2019). Use `as.rsi()` on an MIC value (created with `as.mic()`), a disk diffusion value (created with the new `as.disk()`) or on a complete date set containing columns with MIC or disk diffusion values. @@ -30,7 +29,8 @@ * Removed deprecated functions `guess_mo()`, `guess_atc()`, `EUCAST_rules()`, `interpretive_reading()`, `rsi()` * Frequency tables (`freq()`): * speed improvement for microbial IDs - * fixed level names in markdown + * fixed factor level names for R Markdown + * when all values are unique it now shows a message instead of a warning * support for boxplots: ```r septic_patients %>% @@ -51,6 +51,7 @@ * Fix for `first_isolate()` for when dates are missing * Improved speed of `guess_ab_col()` * Function `as.mo()` now gently interprets any number of whitespace characters (like tabs) as one space +* Function `as.mo()` now returns `UNKNOWN` for `"con"` (WHONET ID of 'contamination') and returns `NA` for `"xxx"`(WHONET ID of 'no growth') * Small algorithm fix for `as.mo()` * Removed viruses from data set `microorganisms.codes` and cleaned it up * Fix for `mo_shortname()` where species would not be determined correctly diff --git a/R/amr.R b/R/amr.R index ac76faa4..b04d3b40 100644 --- a/R/amr.R +++ b/R/amr.R @@ -45,7 +45,7 @@ #' @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 +#' [1] Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - \url{https://www.rug.nl} \url{https://www.umcg.nl} \cr #' [2] Certe Medical Diagnostics & Advice, Groningen, the Netherlands - \url{certe.nl} #' @section Read more on our website!: diff --git a/R/catalogue_of_life.R b/R/catalogue_of_life.R index e37da8f8..abd513d6 100755 --- a/R/catalogue_of_life.R +++ b/R/catalogue_of_life.R @@ -40,7 +40,7 @@ #' #' The Catalogue of Life (\url{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: \url{https://gitlab.com/msberends/AMR/blob/master/reproduction_of_microorganisms.R}. +#' 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/data-raw/reproduction_of_microorganisms.R}. #' @inheritSection AMR Read more on our website! #' @name catalogue_of_life #' @rdname catalogue_of_life diff --git a/R/data.R b/R/data.R index 2264ad45..c14da189 100755 --- a/R/data.R +++ b/R/data.R @@ -59,16 +59,9 @@ #' \describe{ #' \item{\code{mo}}{ID of microorganism as used by this package} #' \item{\code{col_id}}{Catalogue of Life ID} -#' \item{\code{fullname}}{Full name, like \code{"Echerichia coli"}} -#' \item{\code{kingdom}}{Taxonomic kingdom of the microorganism} -#' \item{\code{phylum}}{Taxonomic phylum of the microorganism} -#' \item{\code{class}}{Taxonomic class of the microorganism} -#' \item{\code{order}}{Taxonomic order of the microorganism} -#' \item{\code{family}}{Taxonomic family of the microorganism} -#' \item{\code{genus}}{Taxonomic genus of the microorganism} -#' \item{\code{species}}{Taxonomic species of the microorganism} -#' \item{\code{subspecies}}{Taxonomic subspecies of the microorganism} -#' \item{\code{rank}}{Taxonomic rank of the microorganism, like \code{"species"} or \code{"genus"}} +#' \item{\code{fullname}}{Full name, like \code{"Escherichia coli"}} +#' \item{\code{kingdom}, \code{phylum}, \code{class}, \code{order}, \code{family}, \code{genus}, \code{species}, \code{subspecies}}{Taxonomic rank of the microorganism} +#' \item{\code{rank}}{Text of the taxonomic rank of the microorganism, like \code{"species"} or \code{"genus"}} #' \item{\code{ref}}{Author(s) and year of concerning scientific publication} #' \item{\code{species_id}}{ID of the species as used by the Catalogue of Life} #' \item{\code{source}}{Either \code{"CoL"}, \code{"DSMZ"} (see source) or "manually added"} @@ -119,7 +112,7 @@ catalogue_of_life <- list( #' Translation table for microorganism codes #' #' A data set containing commonly used codes for microorganisms, from laboratory systems and WHONET. Define your own with \code{\link{set_mo_source}}. -#' @format A \code{\link{data.frame}} with 5,171 observations and 2 variables: +#' @format A \code{\link{data.frame}} with 4,969 observations and 2 variables: #' \describe{ #' \item{\code{certe}}{Commonly used code of a microorganism} #' \item{\code{mo}}{ID of the microorganism in the \code{\link{microorganisms}} data set} diff --git a/R/freq.R b/R/freq.R index a3e4aec5..07faa5bd 100755 --- a/R/freq.R +++ b/R/freq.R @@ -342,7 +342,7 @@ freq <- function(x, # mult.columns <- 2 } else { x.name <- deparse(substitute(x)) - if (x.name %like% "[$]") { + if (all(x.name %like% "[$]") & length(x.name) == 1) { cols <- unlist(strsplit(x.name, "$", fixed = TRUE))[2] x.name <- unlist(strsplit(x.name, "$", fixed = TRUE))[1] # try to find the object to determine dimensions @@ -710,7 +710,8 @@ format_header <- function(x, markdown = FALSE, decimal.mark = ".", big.mark = ", }) # numeric values - if (has_length == TRUE & any(x_class %in% c("double", "integer", "numeric", "raw", "single"))) { + if (has_length == TRUE & !is.null(header$sd)) { + # any(x_class %in% c("double", "integer", "numeric", "raw", "single"))) { header$sd <- paste0(header$sd, " (CV: ", header$cv, ", MAD: ", header$mad, ")") header$fivenum <- paste0(paste(trimws(header$fivenum), collapse = " | "), " (IQR: ", header$IQR, ", CQV: ", header$cqv, ")") header$outliers_total <- paste0(header$outliers_total, " (unique count: ", header$outliers_unique, ")") @@ -1018,9 +1019,11 @@ print.freq <- function(x, } else { opt$column_names <- opt$column_names[!opt$column_names == "Item"] } + + all_unique <- FALSE if ("count" %in% colnames(x)) { if (all(x$count == 1)) { - warning("All observations are unique.", call. = FALSE) + all_unique <- TRUE } x$count <- format(x$count, decimal.mark = opt$decimal.mark, big.mark = opt$big.mark) } else { @@ -1072,6 +1075,10 @@ print.freq <- function(x, cat("\n") } + if (all_unique == TRUE) { + message("NOTE: All observations are unique.") + } + # reset old kable setting options(knitr.kable.NA = opt.old) return(invisible()) diff --git a/R/mo.R b/R/mo.R index b5ff422b..ff249403 100755 --- a/R/mo.R +++ b/R/mo.R @@ -195,10 +195,11 @@ as.mo <- function(x, Becker = FALSE, Lancefield = FALSE, allow_uncertain = TRUE, # check onLoad() in R/zzz.R: data tables are created there. } - x[x == ""] <- NA_character_ + # WHONET: xxx = no growth + x[tolower(as.character(paste0(x, ""))) %in% c("", "xxx", "na", "nan")] <- NA_character_ uncertainty_level <- translate_allow_uncertain(allow_uncertain) - mo_hist <- get_mo_history(x, uncertainty_level, force = isTRUE(list(...)$force_mo_history)) + # mo_hist <- get_mo_history(x, uncertainty_level, force = isTRUE(list(...)$force_mo_history)) if (mo_source_isvalid(reference_df) & isFALSE(Becker) @@ -231,11 +232,11 @@ as.mo <- function(x, Becker = FALSE, Lancefield = FALSE, allow_uncertain = TRUE, & isFALSE(Lancefield)) { y <- x - } else if (!any(is.na(mo_hist)) - & isFALSE(Becker) - & isFALSE(Lancefield)) { - # check previously found results - y <- mo_hist + # } else if (!any(is.na(mo_hist)) + # & isFALSE(Becker) + # & isFALSE(Lancefield)) { + # # check previously found results + # y <- mo_hist } else if (all(tolower(x) %in% microorganismsDT$fullname_lower) & isFALSE(Becker) @@ -299,7 +300,8 @@ exec_as.mo <- function(x, # check onLoad() in R/zzz.R: data tables are created there. } - x[x == ""] <- NA_character_ + # WHONET: xxx = no growth + x[tolower(as.character(paste0(x, ""))) %in% c("", "xxx", "na", "nan")] <- NA_character_ if (initial_search == TRUE) { options(mo_failures = NULL) @@ -340,12 +342,11 @@ exec_as.mo <- function(x, # only check the uniques, which is way faster x <- unique(x) # remove empty values (to later fill them in again with NAs) - # ("xxx" is WHONET code for 'no growth' and "con" is WHONET code for 'contamination') + # ("xxx" is WHONET code for 'no growth') x <- x[!is.na(x) & !is.null(x) & !identical(x, "") - & !identical(x, "xxx") - & !identical(x, "con")] + & !identical(x, "xxx")] # conversion of old MO codes from v0.5.0 (ITIS) to later versions (Catalogue of Life) if (any(x %like% "^[BFP]_[A-Z]{3,7}") & !all(x %in% microorganisms$mo)) { @@ -560,7 +561,8 @@ exec_as.mo <- function(x, next } - if (any(tolower(x_backup_without_spp[i]) %in% c(NA, "", "xxx", "con", "na", "nan"))) { + # WHONET: xxx = no growth + if (tolower(as.character(paste0(x_backup_without_spp[i], ""))) %in% c("", "xxx", "na", "nan")) { x[i] <- NA_character_ next } @@ -1273,8 +1275,7 @@ exec_as.mo <- function(x, x_input_unique_nonempty <- unique(x_input[!is.na(x_input) & !is.null(x_input) & !identical(x_input, "") - & !identical(x_input, "xxx") - & !identical(x_input, "con")]) + & !identical(x_input, "xxx")]) # left join the found results to the original input values (x_input) df_found <- data.frame(input = as.character(x_input_unique_nonempty), diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html index 7727a996..c58cc60e 100644 --- a/docs/LICENSE-text.html +++ b/docs/LICENSE-text.html @@ -78,7 +78,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 diff --git a/docs/articles/AMR.html b/docs/articles/AMR.html index eeab616b..4256a340 100644 --- a/docs/articles/AMR.html +++ b/docs/articles/AMR.html @@ -40,7 +40,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 @@ -199,7 +199,7 @@

How to conduct AMR analysis

Matthijs S. Berends

-

01 June 2019

+

02 June 2019

@@ -208,7 +208,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 R Markdown. However, the methodology remains unchanged. This page was generated on 01 June 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 R Markdown. However, the methodology remains unchanged. This page was generated on 02 June 2019.

Introduction

@@ -224,21 +224,21 @@ -2019-06-01 +2019-06-02 abcd Escherichia coli S S -2019-06-01 +2019-06-02 abcd Escherichia coli S R -2019-06-01 +2019-06-02 efgh Escherichia coli R @@ -249,7 +249,7 @@

Needed R packages

-

As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the tidyverse packages dplyr and ggplot2 by Dr Hadley Wickham. The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R.

+

As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the tidyverse packages dplyr and ggplot2 by Dr Hadley Wickham. The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R.

Our AMR package depends on these packages and even extends their use and functions.

library(dplyr)
 library(ggplot2)
@@ -334,10 +334,10 @@
 
 
 
-2011-01-05
-W4
+2014-06-27
+V8
 Hospital B
-Escherichia coli
+Klebsiella pneumoniae
 S
 S
 S
@@ -345,19 +345,41 @@
 F
 
 
-2013-05-10
-W2
+2013-02-12
+L4
+Hospital A
+Streptococcus pneumoniae
+I
+S
+S
+S
+M
+
+
+2013-11-26
+T2
 Hospital A
 Staphylococcus aureus
 R
-S
+R
 S
 S
 F
 
+
+2013-12-27
+J10
+Hospital A
+Escherichia coli
+S
+S
+S
+S
+M
+
 
-2011-07-24
-L6
+2013-09-22
+I7
 Hospital C
 Staphylococcus aureus
 S
@@ -367,38 +389,16 @@
 M
 
 
-2017-12-18
-P2
-Hospital B
-Escherichia coli
-S
-S
+2014-01-26
+Q6
+Hospital A
+Klebsiella pneumoniae
 R
 S
+S
+S
 F
 
-
-2017-03-27
-I8
-Hospital D
-Klebsiella pneumoniae
-S
-S
-R
-S
-M
-
-
-2013-05-25
-L4
-Hospital A
-Staphylococcus aureus
-R
-S
-S
-S
-M
-
 
 
 
Now, let’s start the cleaning and the analysis!

@@ -418,8 +418,8 @@
 # 
 #      Item     Count   Percent   Cum. Count   Cum. Percent
 # ---  -----  -------  --------  -----------  -------------
-# 1    M       10,472     52.4%       10,472          52.4%
-# 2    F        9,528     47.6%       20,000         100.0%
+# 1 M 10,233 51.2% 10,233 51.2% +# 2 F 9,767 48.8% 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:

data <- data %>%
@@ -449,14 +449,14 @@
 # Pasteurella multocida (no new changes)
 # Staphylococcus (no new changes)
 # Streptococcus groups A, B, C, G (no new changes)
-# Streptococcus pneumoniae (1519 new changes)
+# Streptococcus pneumoniae (1509 new changes)
 # Viridans group streptococci (no new changes)
 # 
 # EUCAST Expert Rules, Intrinsic Resistance and Exceptional Phenotypes (v3.1, 2016)
-# Table 01: Intrinsic resistance in Enterobacteriaceae (1280 new changes)
+# Table 01: Intrinsic resistance in Enterobacteriaceae (1276 new changes)
 # Table 02: Intrinsic resistance in non-fermentative Gram-negative bacteria (no new changes)
 # Table 03: Intrinsic resistance in other Gram-negative bacteria (no new changes)
-# Table 04: Intrinsic resistance in Gram-positive bacteria (2810 new changes)
+# Table 04: Intrinsic resistance in Gram-positive bacteria (2758 new changes)
 # Table 08: Interpretive rules for B-lactam agents and Gram-positive cocci (no new changes)
 # Table 09: Interpretive rules for B-lactam agents and Gram-negative rods (no new changes)
 # Table 11: Interpretive rules for macrolides, lincosamides, and streptogramins (no new changes)
@@ -464,24 +464,24 @@
 # Table 13: Interpretive rules for quinolones (no new changes)
 # 
 # Other rules
-# Non-EUCAST: amoxicillin/clav acid = S where ampicillin = S (2266 new changes)
-# Non-EUCAST: ampicillin = R where amoxicillin/clav acid = R (95 new changes)
+# Non-EUCAST: amoxicillin/clav acid = S where ampicillin = S (2254 new changes)
+# Non-EUCAST: ampicillin = R where amoxicillin/clav acid = R (138 new changes)
 # Non-EUCAST: piperacillin = R where piperacillin/tazobactam = R (no new changes)
 # Non-EUCAST: piperacillin/tazobactam = S where piperacillin = S (no new changes)
 # Non-EUCAST: trimethoprim = R where trimethoprim/sulfa = R (no new changes)
 # Non-EUCAST: trimethoprim/sulfa = S where trimethoprim = S (no new changes)
 # 
 # --------------------------------------------------------------------------
-# EUCAST rules affected 6,560 out of 20,000 rows, making a total of 7,970 edits
+# EUCAST rules affected 6,564 out of 20,000 rows, making a total of 7,935 edits
 # => added 0 test results
 # 
-# => changed 7,970 test results
-#    - 118 test results changed from S to I
-#    - 4,807 test results changed from S to R
-#    - 1,119 test results changed from I to S
-#    - 318 test results changed from I to R
-#    - 1,590 test results changed from R to S
-#    - 18 test results changed from R to I
+# => changed 7,935 test results
+#    - 109 test results changed from S to I
+#    - 4,768 test results changed from S to R
+#    - 1,081 test results changed from I to S
+#    - 345 test results changed from I to R
+#    - 1,615 test results changed from R to S
+#    - 17 test results changed from R to I
 # --------------------------------------------------------------------------
 # 
 # Use verbose = TRUE to get a data.frame with all specified edits instead.
@@ -509,8 +509,8 @@ # 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,704 first isolates (28.5% of total)
-

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

+# => Found 5,664 first isolates (28.3% of total)
+

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

For future use, the above two syntaxes can be shortened with the filter_first_isolate() function:

@@ -536,8 +536,8 @@ 1 -2010-01-23 -H6 +2010-01-07 +K9 B_ESCHR_COL S S @@ -547,8 +547,8 @@ 2 -2010-03-03 -H6 +2010-02-14 +K9 B_ESCHR_COL R S @@ -558,10 +558,10 @@ 3 -2010-03-26 -H6 +2010-02-18 +K9 B_ESCHR_COL -S +R S R S @@ -569,19 +569,19 @@ 4 -2010-04-21 -H6 +2010-06-01 +K9 B_ESCHR_COL +S +S R S -S -S FALSE 5 -2010-07-15 -H6 +2010-08-14 +K9 B_ESCHR_COL S S @@ -591,32 +591,32 @@ 6 -2010-08-13 -H6 +2010-11-08 +K9 B_ESCHR_COL S S -S +R S FALSE 7 -2010-09-29 -H6 +2010-11-16 +K9 B_ESCHR_COL S S -R +S S FALSE 8 -2010-10-10 -H6 +2010-12-11 +K9 B_ESCHR_COL -R +S S S S @@ -624,29 +624,29 @@ 9 -2010-12-09 -H6 +2011-02-27 +K9 B_ESCHR_COL R -R S S -FALSE +S +TRUE 10 -2010-12-11 -H6 +2011-03-06 +K9 B_ESCHR_COL R -S +R S S FALSE -

Only 1 isolates are marked as ‘first’ according to CLSI guideline. But when reviewing the antibiogram, it is obvious that some isolates are absolutely different strains and should be included too. This is why we weigh isolates, based on their antibiogram. The key_antibiotics() function adds a vector with 18 key antibiotics: 6 broad spectrum ones, 6 small spectrum for Gram negatives and 6 small spectrum for Gram positives. These can be defined by the user.

+

Only 2 isolates are marked as ‘first’ according to CLSI guideline. But when reviewing the antibiogram, it is obvious that some isolates are absolutely different strains and should be included too. This is why we weigh isolates, based on their antibiogram. The key_antibiotics() function adds a vector with 18 key antibiotics: 6 broad spectrum ones, 6 small spectrum for Gram negatives and 6 small spectrum for Gram positives. These can be defined by the user.

If a column exists with a name like ‘key(…)ab’ the first_isolate() function will automatically use it and determine the first weighted isolates. Mind the NOTEs in below output:

+# => Found 15,014 first weighted isolates (75.1% of total)
@@ -674,8 +674,8 @@ - - + + @@ -686,8 +686,8 @@ - - + + @@ -698,10 +698,10 @@ - - + + - + @@ -710,20 +710,20 @@ - - + + + + - - - - + + @@ -734,20 +734,8 @@ - - - - - - - - - - - - - - + + @@ -756,37 +744,49 @@ + + + + + + + + + + + + - - + + - + - + - - + + - - + + - - + + - + @@ -794,11 +794,11 @@
isolate
12010-01-23H62010-01-07K9 B_ESCHR_COL S S
22010-03-03H62010-02-14K9 B_ESCHR_COL R S
32010-03-26H62010-02-18K9 B_ESCHR_COLSR S R S
42010-04-21H62010-06-01K9 B_ESCHR_COLSS R SSS FALSE TRUE
52010-07-15H62010-08-14K9 B_ESCHR_COL S S
62010-08-13H6B_ESCHR_COLSSSSFALSEFALSE
72010-09-29H62010-11-08K9 B_ESCHR_COL S SFALSE TRUE
72010-11-16K9B_ESCHR_COLSSSSFALSETRUE
82010-10-10H62010-12-11K9 B_ESCHR_COLRS S S S FALSETRUEFALSE
92010-12-09H62011-02-27K9 B_ESCHR_COL RR S SFALSESTRUE TRUE
102010-12-11H62011-03-06K9 B_ESCHR_COL RSR S S FALSE
-

Instead of 1, now 9 isolates are flagged. In total, 75.9% of all isolates are marked ‘first weighted’ - 47.4% 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 9 isolates are flagged. In total, 75.1% of all isolates are marked ‘first weighted’ - 46.8% 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,183 isolates for analysis.

+

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

We can remove unneeded columns:

data_1st <- data_1st %>% 
   select(-c(first, keyab))
@@ -824,28 +824,44 @@ 1 -2011-01-05 -W4 +2014-06-27 +V8 Hospital B -B_ESCHR_COL -S +B_KLBSL_PNE +R S S S F Gram negative -Escherichia -coli +Klebsiella +pneumoniae TRUE 2 -2013-05-10 -W2 +2013-02-12 +L4 +Hospital A +B_STRPT_PNE +I +I +S +R +M +Gram positive +Streptococcus +pneumoniae +TRUE + + +3 +2013-11-26 +T2 Hospital A B_STPHY_AUR R -S +R S S F @@ -854,29 +870,13 @@ aureus TRUE - -4 -2017-12-18 -P2 -Hospital B -B_ESCHR_COL -S -S -R -S -F -Gram negative -Escherichia -coli -TRUE - -6 -2013-05-25 -L4 -Hospital A +5 +2013-09-22 +I7 +Hospital C B_STPHY_AUR -R +S S S S @@ -888,28 +888,28 @@ 7 -2016-09-17 -F3 -Hospital D -B_KLBSL_PNE -R +2012-03-30 +L8 +Hospital B +B_STPHY_AUR +S S S S M -Gram negative -Klebsiella -pneumoniae +Gram positive +Staphylococcus +aureus TRUE 8 -2010-06-30 -L8 -Hospital B +2015-08-27 +L4 +Hospital A B_ESCHR_COL -S -S +R +R S S M @@ -935,9 +935,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,183 x 13)

+

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

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

Shortest: 16
Longest: 24

@@ -954,33 +954,33 @@ Longest: 24

1 Escherichia coli -7,416 -48.8% -7,416 -48.8% +7,496 +49.9% +7,496 +49.9% 2 Staphylococcus aureus -3,781 -24.9% -11,197 -73.7% +3,663 +24.4% +11,159 +74.3% 3 Streptococcus pneumoniae -2,391 -15.7% -13,588 -89.5% +2,303 +15.3% +13,462 +89.7% 4 Klebsiella pneumoniae -1,595 -10.5% -15,183 +1,552 +10.3% +15,014 100.0% @@ -991,7 +991,7 @@ Longest: 24

Resistance percentages

The functions portion_S(), portion_SI(), portion_I(), portion_IR() and portion_R() can be used to determine the portion of a specific antimicrobial outcome. As per the EUCAST guideline of 2019, we calculate resistance as the portion of R (portion_R()) and susceptibility as the portion of S and I (portion_SI()). These functions can be used on their own:

data_1st %>% portion_R(AMX)
-# [1] 0.4716459
+# [1] 0.4708938

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

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

 
 
 Hospital A
-0.4789879
+0.4625681
 
 
 Hospital B
-0.4752328
+0.4799232
 
 
 Hospital C
-0.4525453
+0.4727660
 
 
 Hospital D
-0.4688136
+0.4660767
 
 
 
@@ -1034,23 +1034,23 @@ Longest: 24

 
 
 Hospital A
-0.4789879
-4545
+0.4625681
+4408
 
 
 Hospital B
-0.4752328
-5370
+0.4799232
+5205
 
 
 Hospital C
-0.4525453
-2318
+0.4727660
+2350
 
 
 Hospital D
-0.4688136
-2950
+0.4660767
+3051
 
 
 
@@ -1070,27 +1070,27 @@ Longest: 24

 
 
 Escherichia
-0.9224649
-0.8938781
-0.9920442
+0.9252935
+0.8992796
+0.9945304
 
 
 Klebsiella
-0.8119122
-0.9072100
-0.9874608
+0.8150773
+0.9059278
+0.9864691
 
 
 Staphylococcus
-0.9185401
-0.9098122
-0.9920656
+0.9216489
+0.9211029
+0.9923560
 
 
 Streptococcus
-0.6056043
+0.6026921
 0.0000000
-0.6056043
+0.6026921
 
 
 
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 c5e55744be532c96a058750beef91cf0eb222277..a8e8cac52c5cc038464bca6fa2a65df85cfe7120 100644
GIT binary patch
literal 36024
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
tmvlP!KZ#SI+Z?%|hKjawrlQHs{{kaLxc>kE

literal 36044
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≷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

diff --git a/docs/articles/AMR_files/figure-html/plot 4-1.png b/docs/articles/AMR_files/figure-html/plot 4-1.png
index c520d721cf7bc35463665cf4f7b6c0e1cb400b95..22270b7339c4055c0a7d3b849d473cd1117ccd38 100644
GIT binary patch
literal 70005
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�hBQJQzyaBYJ4;Gt)v`J6
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
diff --git a/docs/articles/resistance_predict.html b/docs/articles/resistance_predict.html index 6c8bb0a9..014dc660 100644 --- a/docs/articles/resistance_predict.html +++ b/docs/articles/resistance_predict.html @@ -40,7 +40,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 @@ -199,7 +199,7 @@

How to predict antimicrobial resistance

Matthijs S. Berends

-

01 June 2019

+

02 June 2019

@@ -211,7 +211,7 @@

Needed R packages

-

As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the tidyverse packages dplyr and ggplot2 by Dr Hadley Wickham. The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R.

+

As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the tidyverse packages dplyr and ggplot2 by Dr Hadley Wickham. The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R.

Our AMR package depends on these packages and even extends their use and functions.

library(dplyr)
 library(ggplot2)
diff --git a/docs/authors.html b/docs/authors.html
index 84f55c48..673a0e9e 100644
--- a/docs/authors.html
+++ b/docs/authors.html
@@ -78,7 +78,7 @@
       
       
         AMR (for R)
-        0.6.1.9052
+        0.6.1.9053
diff --git a/docs/extra.css b/docs/extra.css index 7175fb98..634a7b0b 100644 --- a/docs/extra.css +++ b/docs/extra.css @@ -138,7 +138,7 @@ help { /* hide version label */ .version.label { - /* + /* display: none; */ } @@ -214,3 +214,7 @@ table a:not(.btn):hover, .table a:not(.btn):hover { #btn_collapseDisqus { white-space: normal; } + +#search-input { + max-width: 100px; +} diff --git a/docs/extra.js b/docs/extra.js index f0b6aada..9cf87b31 100644 --- a/docs/extra.js +++ b/docs/extra.js @@ -17,7 +17,7 @@ # 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. # +# Visit our website for more info: https://msberends.gitlab.io/AMR. # # ==================================================================== # */ diff --git a/docs/index.html b/docs/index.html index 610bb6c9..1e7cb2b7 100644 --- a/docs/index.html +++ b/docs/index.html @@ -42,7 +42,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053
diff --git a/docs/news/index.html b/docs/news/index.html index ee2f3c8d..a7652340 100644 --- a/docs/news/index.html +++ b/docs/news/index.html @@ -78,7 +78,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 @@ -239,11 +239,10 @@ -
+

-AMR 0.6.1.9052 Unreleased +AMR 0.6.1.9053 Unreleased

-

Note: latest development version

New

@@ -293,7 +292,8 @@ Please freq()):
  • speed improvement for microbial IDs
    • -
  • fixed level names in markdown
    • +
  • fixed factor level names for R Markdown
    • +
  • when all values are unique it now shows a message instead of a warning

  • support for boxplots:

    septic_patients %>% 
@@ -319,6 +319,7 @@ Please guess_ab_col()
  • Function as.mo() now gently interprets any number of whitespace characters (like tabs) as one space
    • +
  • Function as.mo() now returns UNKNOWN for "con" (WHONET ID of ‘contamination’) and returns NA for "xxx"(WHONET ID of ‘no growth’)
  • Small algorithm fix for as.mo()
  • Removed viruses from data set microorganisms.codes and cleaned it up
    • @@ -1065,7 +1066,7 @@ Using as.mo(..., allow_uncertain = 3)

    Contents

      -
    • 0.6.1.9052
      • +
    • 0.6.1.9053
    • 0.6.1
    • 0.6.0
    • 0.5.0
      • diff --git a/docs/reference/AMR.html b/docs/reference/AMR.html index 2fe74de7..72ce0ba1 100644 --- a/docs/reference/AMR.html +++ b/docs/reference/AMR.html @@ -80,7 +80,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053
@@ -272,7 +272,7 @@

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]

-

[1] Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - rug.nl umcg.nl
+

[1] Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - https://www.rug.nl https://www.umcg.nl
[2] Certe Medical Diagnostics & Advice, Groningen, the Netherlands - certe.nl

Read more on our website!

diff --git a/docs/reference/catalogue_of_life.html b/docs/reference/catalogue_of_life.html index 0e2a4d7d..db8136fb 100644 --- a/docs/reference/catalogue_of_life.html +++ b/docs/reference/catalogue_of_life.html @@ -80,7 +80,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053
@@ -268,7 +268,7 @@ This package contains the complete taxonomic tree of almost all microorganisms (

  • The responsible author(s) and year of scientific publication

    • 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.

    +

    The syntax used to transform the original data to a cleansed R format, can be found here: https://gitlab.com/msberends/AMR/blob/master/data-raw/reproduction_of_microorganisms.R.

    Read more on our website!

    diff --git a/docs/reference/eucast_rules.html b/docs/reference/eucast_rules.html index 43315abb..e5bba12d 100644 --- a/docs/reference/eucast_rules.html +++ b/docs/reference/eucast_rules.html @@ -80,7 +80,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053
    diff --git a/docs/reference/index.html b/docs/reference/index.html index 0d47c72c..5c143db8 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -78,7 +78,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 diff --git a/docs/reference/microorganisms.codes.html b/docs/reference/microorganisms.codes.html index 4c9e52e0..174da981 100644 --- a/docs/reference/microorganisms.codes.html +++ b/docs/reference/microorganisms.codes.html @@ -80,7 +80,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 @@ -252,7 +252,7 @@

    Format

    -

    A data.frame with 5,171 observations and 2 variables:

    +

    A data.frame with 4,969 observations and 2 variables:

    certe

    Commonly used code of a microorganism

    mo

    ID of the microorganism in the microorganisms data set

    diff --git a/docs/reference/microorganisms.html b/docs/reference/microorganisms.html index 07608340..18ab630b 100644 --- a/docs/reference/microorganisms.html +++ b/docs/reference/microorganisms.html @@ -80,7 +80,7 @@ AMR (for R) - 0.6.1.9052 + 0.6.1.9053 @@ -252,24 +252,7 @@

    Format

    -

    A data.frame with 67,903 observations and 16 variables:

    -
    mo

    ID of microorganism as used by this package

    -
    col_id

    Catalogue of Life ID

    -
    fullname

    Full name, like "Echerichia coli"

    -
    kingdom

    Taxonomic kingdom of the microorganism

    -
    phylum

    Taxonomic phylum of the microorganism

    -
    class

    Taxonomic class of the microorganism

    -
    order

    Taxonomic order of the microorganism

    -
    family

    Taxonomic family of the microorganism

    -
    genus

    Taxonomic genus of the microorganism

    -
    species

    Taxonomic species of the microorganism

    -
    subspecies

    Taxonomic subspecies of the microorganism

    -
    rank

    Taxonomic rank of the microorganism, like "species" or "genus"

    -
    ref

    Author(s) and year of concerning scientific publication

    -
    species_id

    ID of the species as used by the Catalogue of Life

    -
    source

    Either "CoL", "DSMZ" (see source) or "manually added"

    -
    prevalence

    Prevalence of the microorganism, see ?as.mo

    -
    +

    An object of class data.frame with 67903 rows and 16 columns.

    Source

    diff --git a/git_premaster.sh b/git_premaster.sh index 9e421fa6..ac9dd5d4 100755 --- a/git_premaster.sh +++ b/git_premaster.sh @@ -28,7 +28,7 @@ current_commit=`git describe --tags | sed 's/.*-\(.*\)-.*/\1/'` new_version="$current_tag.$((current_commit + 9000))" # results in 0.1.0.9040 sed -i -- "s/^Version: .*/Version: ${new_version}/" DESCRIPTION # update 1st line of NEWS.md -sed -i -- "1s/${current_tag}.*/${new_version}/" NEWS.md +sed -i -- "1s/.*/# AMR ${new_version}/" NEWS.md echo "First 3 lines of DESCRIPTION:" head -3 DESCRIPTION echo diff --git a/git_release.sh b/git_release.sh new file mode 100755 index 00000000..20679357 --- /dev/null +++ b/git_release.sh @@ -0,0 +1,32 @@ +####################################################################### +# To push new commits to the premaster branch, run: # +# bash git_premaster.sh "commit message" # +# # +# After successful CRAN checks, merge it to the master branch with: # +# bash git_merge.sh # +# # +# Initiate a new release with: # +# bash git_release.sh "new_version_number" # +# This will edit the DESCRIPTION file and the NEWS.md file. # +####################################################################### + +if [ -z "$1" ]; then + echo "FATAL - no version number" + exit 1 +fi + +echo "••••••••••••••••••••••••••••••••••••••••••••" +echo "• Updating package date and version number •" +echo "••••••••••••••••••••••••••••••••••••••••••••" +new_version=${1} +sed -i -- "s/^Version: .*/Version: ${new_version}/" DESCRIPTION +# update 1st line of NEWS.md +sed -i -- "1s/.*/# AMR ${new_version}/" NEWS.md +echo "First 3 lines of DESCRIPTION:" +head -3 DESCRIPTION +echo +echo "First line of NEWS.md:" +head -1 NEWS.md +echo +echo "Run devtools::release() or devtools::submit_cran(). Non-interactive mode (this script) will not work." + diff --git a/man/AMR.Rd b/man/AMR.Rd index 03869998..de905ff5 100644 --- a/man/AMR.Rd +++ b/man/AMR.Rd @@ -31,7 +31,7 @@ This package can be used for: 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 +[1] Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - \url{https://www.rug.nl} \url{https://www.umcg.nl} \cr [2] Certe Medical Diagnostics & Advice, Groningen, the Netherlands - \url{certe.nl} } diff --git a/man/catalogue_of_life.Rd b/man/catalogue_of_life.Rd index dff3053e..567a6989 100644 --- a/man/catalogue_of_life.Rd +++ b/man/catalogue_of_life.Rd @@ -28,7 +28,7 @@ Included are: The Catalogue of Life (\url{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: \url{https://gitlab.com/msberends/AMR/blob/master/reproduction_of_microorganisms.R}. +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/data-raw/reproduction_of_microorganisms.R}. } \section{Read more on our website!}{ diff --git a/man/microorganisms.Rd b/man/microorganisms.Rd index 2e6fa31a..01546260 100755 --- a/man/microorganisms.Rd +++ b/man/microorganisms.Rd @@ -4,25 +4,7 @@ \name{microorganisms} \alias{microorganisms} \title{Data set with ~65,000 microorganisms} -\format{A \code{\link{data.frame}} with 67,903 observations and 16 variables: -\describe{ - \item{\code{mo}}{ID of microorganism as used by this package} - \item{\code{col_id}}{Catalogue of Life ID} - \item{\code{fullname}}{Full name, like \code{"Echerichia coli"}} - \item{\code{kingdom}}{Taxonomic kingdom of the microorganism} - \item{\code{phylum}}{Taxonomic phylum of the microorganism} - \item{\code{class}}{Taxonomic class of the microorganism} - \item{\code{order}}{Taxonomic order of the microorganism} - \item{\code{family}}{Taxonomic family of the microorganism} - \item{\code{genus}}{Taxonomic genus of the microorganism} - \item{\code{species}}{Taxonomic species of the microorganism} - \item{\code{subspecies}}{Taxonomic subspecies of the microorganism} - \item{\code{rank}}{Taxonomic rank of the microorganism, like \code{"species"} or \code{"genus"}} - \item{\code{ref}}{Author(s) and year of concerning scientific publication} - \item{\code{species_id}}{ID of the species as used by the Catalogue of Life} - \item{\code{source}}{Either \code{"CoL"}, \code{"DSMZ"} (see source) or "manually added"} - \item{\code{prevalence}}{Prevalence of the microorganism, see \code{?as.mo}} -}} +\format{An object of class \code{data.frame} with 67903 rows and 16 columns.} \source{ Catalogue of Life: Annual Checklist (public online taxonomic database), \url{www.catalogueoflife.org} (check included annual version with \code{\link{catalogue_of_life_version}()}). diff --git a/man/microorganisms.codes.Rd b/man/microorganisms.codes.Rd index faffa253..53319cd0 100644 --- a/man/microorganisms.codes.Rd +++ b/man/microorganisms.codes.Rd @@ -4,7 +4,7 @@ \name{microorganisms.codes} \alias{microorganisms.codes} \title{Translation table for microorganism codes} -\format{A \code{\link{data.frame}} with 5,171 observations and 2 variables: +\format{A \code{\link{data.frame}} with 4,969 observations and 2 variables: \describe{ \item{\code{certe}}{Commonly used code of a microorganism} \item{\code{mo}}{ID of the microorganism in the \code{\link{microorganisms}} data set} diff --git a/pkgdown/extra.css b/pkgdown/extra.css index 7175fb98..634a7b0b 100644 --- a/pkgdown/extra.css +++ b/pkgdown/extra.css @@ -138,7 +138,7 @@ help { /* hide version label */ .version.label { - /* + /* display: none; */ } @@ -214,3 +214,7 @@ table a:not(.btn):hover, .table a:not(.btn):hover { #btn_collapseDisqus { white-space: normal; } + +#search-input { + max-width: 100px; +} diff --git a/pkgdown/extra.js b/pkgdown/extra.js index f0b6aada..9cf87b31 100644 --- a/pkgdown/extra.js +++ b/pkgdown/extra.js @@ -17,7 +17,7 @@ # 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. # +# Visit our website for more info: https://msberends.gitlab.io/AMR. # # ==================================================================== # */ diff --git a/tests/testthat/test-freq.R b/tests/testthat/test-freq.R index 296a6bfc..11ed4df5 100755 --- a/tests/testthat/test-freq.R +++ b/tests/testthat/test-freq.R @@ -66,7 +66,7 @@ test_that("frequency table works", { # rsi expect_output(print(freq(septic_patients$AMC))) # hms - expect_output(suppressWarnings(print(freq(hms::as.hms(sample(c(0:86399), 50)))))) + expect_output(print(freq(hms::as.hms(sample(c(0:86399), 50))))) # matrix expect_output(print(freq(as.matrix(septic_patients$age)))) expect_output(print(freq(as.matrix(septic_patients[, c("age", "gender")])))) @@ -74,10 +74,10 @@ test_that("frequency table works", { expect_output(print(freq(list(age = septic_patients$age)))) expect_output(print(freq(list(age = septic_patients$age, gender = septic_patients$gender)))) # difftime - expect_output(suppressWarnings(print( + expect_output(print( freq(difftime(Sys.time(), Sys.time() - runif(5, min = 0, max = 60 * 60 * 24), - units = "hours"))))) + units = "hours")))) expect_output(print(freq(septic_patients$age)[,1:3])) diff --git a/tests/testthat/test-mo.R b/tests/testthat/test-mo.R index 9594a43b..d96a60a8 100644 --- a/tests/testthat/test-mo.R +++ b/tests/testthat/test-mo.R @@ -247,11 +247,13 @@ test_that("as.mo works", { # summary expect_equal(length(summary(septic_patients$mo)), 6) - # other - expect_equal(as.character(as.mo(c("xxx", "con", "na", "nan"), debug = TRUE)), - rep(NA_character_, 4)) - - expect_equal(as.character(as.mo(c("other", "none", "unknown"))), + # WHONET codes and NA/NaN + expect_equal(as.character(as.mo(c("xxx", "na", "nan"), debug = TRUE)), + rep(NA_character_, 3)) + expect_equal(as.character(as.mo("con")), "UNKNOWN") + expect_equal(as.character(as.mo("xxx")), NA_character_) + expect_equal(as.character(as.mo(c("xxx", "con"))), c(NA_character_, "UNKNOWN")) + expect_equal(as.character(as.mo(c("other", "none", "unknown"))), rep("UNKNOWN", 3)) expect_null(mo_failures()) diff --git a/vignettes/AMR.Rmd b/vignettes/AMR.Rmd index 1ca2e47f..44cd5a31 100755 --- a/vignettes/AMR.Rmd +++ b/vignettes/AMR.Rmd @@ -42,7 +42,7 @@ knitr::kable(dplyr::tibble(date = Sys.Date(), ``` ## Needed R packages -As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the [tidyverse packages](https://www.tidyverse.org) [`dplyr`](https://dplyr.tidyverse.org/) and [`ggplot2`](https://ggplot2.tidyverse.org) by [Dr Hadley Wickham](https://www.linkedin.com/in/hadleywickham/). The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R. +As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the [tidyverse packages](https://www.tidyverse.org) [`dplyr`](https://dplyr.tidyverse.org/) and [`ggplot2`](https://ggplot2.tidyverse.org) by Dr Hadley Wickham. The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R. Our `AMR` package depends on these packages and even extends their use and functions. diff --git a/vignettes/resistance_predict.Rmd b/vignettes/resistance_predict.Rmd index dd2a7a84..7faada70 100755 --- a/vignettes/resistance_predict.Rmd +++ b/vignettes/resistance_predict.Rmd @@ -23,7 +23,7 @@ knitr::opts_chunk$set( ``` ## Needed R packages -As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the [tidyverse packages](https://www.tidyverse.org) [`dplyr`](https://dplyr.tidyverse.org/) and [`ggplot2`](https://ggplot2.tidyverse.org) by [Dr Hadley Wickham](https://www.linkedin.com/in/hadleywickham/). The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R. +As with many uses in R, we need some additional packages for AMR analysis. Our package works closely together with the [tidyverse packages](https://www.tidyverse.org) [`dplyr`](https://dplyr.tidyverse.org/) and [`ggplot2`](https://ggplot2.tidyverse.org) by Dr Hadley Wickham. The tidyverse tremendously improves the way we conduct data science - it allows for a very natural way of writing syntaxes and creating beautiful plots in R. Our `AMR` package depends on these packages and even extends their use and functions.