From 504a042fbafeafb53d9990293845d009853494b8 Mon Sep 17 00:00:00 2001
From: "Matthijs S. Berends" <m.s.berends@umcg.nl>
Date: Tue, 12 Mar 2019 12:19:27 +0100
Subject: [PATCH] uncertainty levels, new WHONET codes

---
 DESCRIPTION                                   |   4 +-
 NEWS.md                                       |  28 +-
 R/data.R                                      |   2 +-
 R/like.R                                      |   2 +-
 R/mo.R                                        | 299 +++++++++++-------
 R/zzz.R                                       |  35 +-
 data/microorganisms.codes.rda                 | Bin 24009 -> 26668 bytes
 docs/LICENSE-text.html                        |   2 +-
 docs/articles/benchmarks.html                 |  76 ++---
 .../figure-html/unnamed-chunk-5-1.png         | Bin 28565 -> 28781 bytes
 docs/articles/index.html                      |   2 +-
 docs/authors.html                             |   2 +-
 docs/index.html                               |   2 +-
 docs/news/index.html                          | 164 +++++-----
 docs/reference/as.mo.html                     |  32 +-
 docs/reference/filter_ab_class.html           |   2 +-
 docs/reference/index.html                     |   2 +-
 docs/reference/like.html                      |   2 +-
 docs/reference/microorganisms.codes.html      |   4 +-
 man/as.mo.Rd                                  |  27 +-
 man/microorganisms.codes.Rd                   |   2 +-
 tests/testthat/test-mo.R                      |   5 +-
 22 files changed, 402 insertions(+), 292 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 7c259842..b7a7e584 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,6 +1,6 @@
 Package: AMR
-Version: 0.5.0.9021
-Date: 2019-03-09
+Version: 0.5.0.9022
+Date: 2019-03-12
 Title: Antimicrobial Resistance Analysis
 Authors@R: c(
     person(
diff --git a/NEWS.md b/NEWS.md
index a8cedcf8..77b96a89 100755
--- a/NEWS.md
+++ b/NEWS.md
@@ -24,7 +24,7 @@ We've got a new website: [https://msberends.gitlab.io/AMR](https://msberends.git
 * Support for data from [WHONET](https://whonet.org/) and [EARS-Net](https://ecdc.europa.eu/en/about-us/partnerships-and-networks/disease-and-laboratory-networks/ears-net) (European Antimicrobial Resistance Surveillance Network):
   * Exported files from WHONET can be read and used in this package. For functions like `first_isolate()` and `eucast_rules()`, all parameters will be filled in automatically.
   * This package now knows all antibiotic abbrevations by EARS-Net (which are also being used by WHONET) - the `antibiotics` data set now contains a column `ears_net`.
-  * The function `as.mo()` now knows all WHONET species abbreviations too, because more than 1,600 microbial abbreviations were added to the `microorganisms.codes` data set.
+  * The function `as.mo()` now knows all WHONET species abbreviations too, because almost 2,000 microbial abbreviations were added to the `microorganisms.codes` data set.
 * New filters for antimicrobial classes. Use these functions to filter isolates on results in one of more antibiotics from a specific class:
   ```r
   filter_aminoglycosides()
@@ -100,8 +100,29 @@ We've got a new website: [https://msberends.gitlab.io/AMR](https://msberends.git
 * Functions `atc_ddd()` and `atc_groups()` have been renamed `atc_online_ddd()` and `atc_online_groups()`. The old functions are deprecated and will be removed in a future version.
 * Function `guess_mo()` is now deprecated in favour of `as.mo()` and will be removed in future versions
 * Function `guess_atc()` is now deprecated in favour of `as.atc()` and will be removed in future versions
-* Improvements for `as.mo()`:\
-  * Incoercible results will now be considered 'unknown', MO code `UNKNOWN`. Properties of these will be translated on foreign systems in all language already previously supported: German, Dutch, French, Italian, Spanish and Portuguese:
+* Improvements for `as.mo()`:
+  * Now handles incorrect spelling like `i` instead of `y` and `f` instead of `ph`:
+  ```r
+  # mo_fullname() uses as.mo() internally
+  
+  mo_fullname("Sthafilokockus aaureuz")
+  #> [1] "Staphylococcus aureus"
+  
+  mo_fullname("S. klossi")
+  #> [1] "Staphylococcus kloosii"
+  ```
+  * Uncertainty of the algorithm is now divided into four levels, 0 to 3, where the default `allow_uncertain = TRUE` is equal to uncertainty level 2. Run `?as.mo` for more info about these levels.
+  ```r
+  # equal:
+  as.mo(..., allow_uncertain = TRUE)
+  as.mo(..., allow_uncertain = 2)
+  
+  # also equal:
+  as.mo(..., allow_uncertain = FALSE)
+  as.mo(..., allow_uncertain = 0)
+  ```
+  Using `as.mo(..., allow_uncertain = 3)` could lead to very unreliable results.
+  * Incoercible results will now be considered 'unknown', MO code `UNKNOWN`. On foreign systems, properties of these will be translated to all languages already previously supported: German, Dutch, French, Italian, Spanish and Portuguese:
   ```r
   mo_genus("qwerty", language = "es")
   # Warning: 
@@ -164,6 +185,7 @@ We've got a new website: [https://msberends.gitlab.io/AMR](https://msberends.git
 * Automatic parameter filling for `mdro()`, `key_antibiotics()` and `eucast_rules()`
 * Updated examples for resistance prediction (`resistance_predict()` function)
 * Fix for `as.mic()` to support more values ending in (several) zeroes
+* if using different lengths of pattern and x in `%like%`, it will now return the call
 
 #### Other
 * Updated licence text to emphasise GPL 2.0 and that this is an R package.
diff --git a/R/data.R b/R/data.R
index 3bfacf79..ace145ef 100755
--- a/R/data.R
+++ b/R/data.R
@@ -188,7 +188,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 4,731 observations and 2 variables:
+#' @format A \code{\link{data.frame}} with 5,171 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/like.R b/R/like.R
index 7e3f4d08..f606c986 100755
--- a/R/like.R
+++ b/R/like.R
@@ -56,7 +56,7 @@ like <- function(x, pattern) {
   if (length(pattern) > 1) {
     if (length(x) != length(pattern)) {
       pattern <- pattern[1]
-      warning('only the first element of argument `pattern` used for `%like%`', call. = FALSE)
+      warning('only the first element of argument `pattern` used for `%like%`', call. = TRUE)
     } else {
       # x and pattern are of same length, so items with each other
       res <- vector(length = length(pattern))
diff --git a/R/mo.R b/R/mo.R
index 5cfc5b9b..953b6aac 100755
--- a/R/mo.R
+++ b/R/mo.R
@@ -21,7 +21,7 @@
 
 #' Transform to microorganism ID
 #'
-#' Use this function to determine a valid microorganism ID (\code{mo}). Determination is done using intelligent rules and the complete taxonomic kingdoms Archaea, Bacteria, Protozoa, Viruses and most microbial species from the kingdom Fungi (see Source), so the input can be almost anything: a full name (like \code{"Staphylococcus aureus"}), an abbreviated name (like \code{"S. aureus"}), an abbreviation known in the field (like \code{"MRSA"}), or just a genus. You could also \code{\link{select}} a genus and species column, zie Examples.
+#' Use this function to determine a valid microorganism ID (\code{mo}). Determination is done using intelligent rules and the complete taxonomic kingdoms Bacteria, Chromista, Protozoa, Archaea, Viruses, and most microbial species from the kingdom Fungi (see Source). The input can be almost anything: a full name (like \code{"Staphylococcus aureus"}), an abbreviated name (like \code{"S. aureus"}), an abbreviation known in the field (like \code{"MRSA"}), or just a genus. Please see Examples.
 #' @param x a character vector or a \code{data.frame} with one or two columns
 #' @param Becker a logical to indicate whether \emph{Staphylococci} should be categorised into Coagulase Negative \emph{Staphylococci} ("CoNS") and Coagulase Positive \emph{Staphylococci} ("CoPS") instead of their own species, according to Karsten Becker \emph{et al.} [1].
 #'
@@ -29,7 +29,7 @@
 #' @param Lancefield a logical to indicate whether beta-haemolytic \emph{Streptococci} should be categorised into Lancefield groups instead of their own species, according to Rebecca C. Lancefield [2]. These \emph{Streptococci} will be categorised in their first group, e.g. \emph{Streptococcus dysgalactiae} will be group C, although officially it was also categorised into groups G and L.
 #'
 #'   This excludes \emph{Enterococci} at default (who are in group D), use \code{Lancefield = "all"} to also categorise all \emph{Enterococci} as group D.
-#' @param allow_uncertain a logical to indicate whether the input should be checked for less possible results, see Details
+#' @param allow_uncertain a logical (\code{TRUE} or \code{FALSE}) or a value between 0 and 3 to indicate whether the input should be checked for less possible results, see Details
 #' @param reference_df a \code{data.frame} to use for extra reference when translating \code{x} to a valid \code{mo}. See \code{\link{set_mo_source}} and \code{\link{get_mo_source}} to automate the usage of your own codes (e.g. used in your analysis or organisation).
 #' @rdname as.mo
 #' @aliases mo
@@ -58,9 +58,9 @@
 #' \strong{Intelligent rules} \cr
 #' This function uses intelligent rules to help getting fast and logical results. It tries to find matches in this order:
 #' \itemize{
-#'   \item{Taxonomic kingdom: it first searches in Bacteria, then Fungi, then Protozoa}
-#'   \item{Human pathogenic prevalence: it first searches in more prevalent microorganisms, then less prevalent ones (see section \emph{Microbial prevalence of pathogens in humans})}
 #'   \item{Valid MO codes and full names: it first searches in already valid MO code and known genus/species combinations}
+#'   \item{Human pathogenic prevalence: it first searches in more prevalent microorganisms, then less prevalent ones (see \emph{Microbial prevalence of pathogens in humans} below)}
+#'   \item{Taxonomic kingdom: it first searches in Bacteria/Chromista, then Fungi, then Protozoa, then Viruses}
 #'   \item{Breakdown of input values: from here it starts to breakdown input values to find possible matches}
 #' }
 #'
@@ -73,15 +73,19 @@
 #' This means that looking up human pathogenic microorganisms takes less time than looking up human non-pathogenic microorganisms.
 #'
 #' \strong{Uncertain results} \cr
-#' When using \code{allow_uncertain = TRUE} (which is the default setting), it will use additional rules if all previous rules failed to get valid results. These are:
+#' The algorithm can additionally use three different levels of uncertainty to guess valid results. The default is \code{allow_uncertain = TRUE}, which is uqual to uncertainty level 2. Using \code{allow_uncertain = FALSE} will skip all of these additional rules:
 #' \itemize{
-#'   \item{It tries to look for previously accepted (but now invalid) taxonomic names}
-#'   \item{It strips off values between brackets and the brackets itself, and re-evaluates the input with all previous rules}
-#'   \item{It strips off words from the end one by one and re-evaluates the input with all previous rules}
-#'   \item{It strips off words from the start one by one and re-evaluates the input with all previous rules}
-#'   \item{It tries to look for some manual changes which are not (yet) published to the Catalogue of Life (like \emph{Propionibacterium} being \emph{Cutibacterium})}
+#'   \item{(uncertainty level 1): It tries to look for only matching genera}
+#'   \item{(uncertainty level 1): It tries to look for previously accepted (but now invalid) taxonomic names}
+#'   \item{(uncertainty level 1): It tries to look for some manual changes which are not (yet) published to the Catalogue of Life (like \emph{Propionibacterium} being \emph{Cutibacterium})}
+#'   \item{(uncertainty level 2): It strips off values between brackets and the brackets itself, and re-evaluates the input with all previous rules}
+#'   \item{(uncertainty level 2): It strips off words from the end one by one and re-evaluates the input with all previous rules}
+#'   \item{(uncertainty level 3): It strips off words from the start one by one and re-evaluates the input with all previous rules}
+#'   \item{(uncertainty level 3): It tries any part of the name}
 #' }
 #'
+#' You can also use e.g. \code{as.mo(..., allow_uncertain = 1)} to only allow up to level 1 uncertainty.
+#'
 #' Examples:
 #' \itemize{
 #'   \item{\code{"Streptococcus group B (known as S. agalactiae)"}. The text between brackets will be removed and a warning will be thrown that the result \emph{Streptococcus group B} (\code{B_STRPT_GRB}) needs review.}
@@ -96,7 +100,7 @@
 #' Use \code{mo_renamed()} to get a vector with all values that could be coerced based on an old, previously accepted taxonomic name.
 #'
 #' \strong{Microbial prevalence of pathogens in humans} \cr
-#' The intelligent rules takes into account microbial prevalence of pathogens in humans. It uses three groups and every (sub)species is in the group it matches first. These groups are:
+#' The intelligent rules takes into account microbial prevalence of pathogens in humans. It uses three groups and all (sub)species are in only one group. These groups are:
 #' \itemize{
 #'   \item{1 (most prevalent): class is Gammaproteobacteria \strong{or} genus is one of: \emph{Enterococcus}, \emph{Staphylococcus}, \emph{Streptococcus}.}
 #'   \item{2: phylum is one of: Proteobacteria, Firmicutes, Actinobacteria, Sarcomastigophora \strong{or} genus is one of: \emph{Aspergillus}, \emph{Bacteroides}, \emph{Candida}, \emph{Capnocytophaga}, \emph{Chryseobacterium}, \emph{Cryptococcus}, \emph{Elisabethkingia}, \emph{Flavobacterium}, \emph{Fusobacterium}, \emph{Giardia}, \emph{Leptotrichia}, \emph{Mycoplasma}, \emph{Prevotella}, \emph{Rhodotorula}, \emph{Treponema}, \emph{Trichophyton}, \emph{Ureaplasma}.}
@@ -130,6 +134,7 @@
 #' as.mo("S aureus")
 #' as.mo("Staphylococcus aureus")
 #' as.mo("Staphylococcus aureus (MRSA)")
+#' as.mo("Sthafilokkockus aaureuz") # handles incorrect spelling
 #' as.mo("MRSA") # Methicillin Resistant S. aureus
 #' as.mo("VISA") # Vancomycin Intermediate S. aureus
 #' as.mo("VRSA") # Vancomycin Resistant S. aureus
@@ -202,8 +207,8 @@ as.mo <- function(x, Becker = FALSE, Lancefield = FALSE, allow_uncertain = TRUE,
     )
 
   } else if (all(x %in% AMR::microorganisms$mo)
-      & isFALSE(Becker)
-      & isFALSE(Lancefield)) {
+             & isFALSE(Becker)
+             & isFALSE(Lancefield)) {
     y <- x
 
   } else if (all(tolower(x) %in% microorganismsDT$fullname_lower)
@@ -284,6 +289,15 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
                               fullname = character(0),
                               mo = character(0))
   failures <- character(0)
+  if (isTRUE(allow_uncertain)) {
+    # default to uncertainty level 2
+    allow_uncertain <- 2
+  } else {
+    allow_uncertain <- as.integer(allow_uncertain)
+    if (!allow_uncertain %in% c(0:3)) {
+      stop("`allow_uncertain` must be a number between 0 (none) and 3 (all), or TRUE (= 2) or FALSE (= 0).", call. = FALSE)
+    }
+  }
   x_input <- x
   # already strip leading and trailing spaces
   x <- trimws(x, which = "both")
@@ -387,6 +401,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
 
     # remove spp and species
     x <- trimws(gsub(" +(spp.?|ssp.?|sp.? |ss ?.?|subsp.?|subspecies|biovar |serovar |species)", " ", x_backup, ignore.case = TRUE), which = "both")
+    x_backup_without_spp <- x
     x_species <- paste(x, "species")
     # translate to English for supported languages of mo_property
     x <- gsub("(Gruppe|gruppe|groep|grupo|gruppo|groupe)", "group", x, ignore.case = TRUE)
@@ -400,12 +415,21 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
     x <- gsub("(alpha|beta|gamma) ha?emoly", "\\1-haemoly", x)
     # remove genus as first word
     x <- gsub("^Genus ", "", x)
+    # allow characters that resemble others
+    x <- gsub("[iy]+", "[iy]+", x, ignore.case = TRUE)
+    x <- gsub("[sz]+", "[sz]+", x, ignore.case = TRUE)
+    x <- gsub("(c|k|q|qu)+", "(c|k|q|qu)+", x, ignore.case = TRUE)
+    x <- gsub("(ph|f|v)+", "(ph|f|v)+", x, ignore.case = TRUE)
+    x <- gsub("(th|t)+", "(th|t)+", x, ignore.case = TRUE)
+    x <- gsub("a+", "a+", x, ignore.case = TRUE)
+    x <- gsub("e+", "e+", x, ignore.case = TRUE)
+    x <- gsub("o+", "o+", x, ignore.case = TRUE)
 
     # but spaces before and after should be omitted
     x <- trimws(x, which = "both")
     x_trimmed <- x
     x_trimmed_species <- paste(x_trimmed, "species")
-    x_trimmed_without_group <- gsub(" group$", "", x_trimmed, ignore.case = TRUE)
+    x_trimmed_without_group <- gsub(" gro.u.p$", "", x_trimmed, ignore.case = TRUE)
     # remove last part from "-" or "/"
     x_trimmed_without_group <- gsub("(.*)[-/].*", "\\1", x_trimmed_without_group)
     # replace space and dot by regex sign
@@ -423,6 +447,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
     # 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_backup_without_spp    "', x_backup_without_spp, '"\n'))
     # cat(paste0('x_trimmed               "', x_trimmed, '"\n'))
     # cat(paste0('x_trimmed_species       "', x_trimmed_species, '"\n'))
     # cat(paste0('x_trimmed_without_group "', x_trimmed_without_group, '"\n'))
@@ -440,12 +465,19 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
         next
       }
 
-      if (any(x_trimmed[i] %in% c(NA, "", "xxx", "con"))) {
+      found <- microorganismsDT[fullname_lower %in% tolower(c(x_backup[i], x_backup_without_spp[i])), ..property][[1]]
+      # most probable: is exact match in fullname
+      if (length(found) > 0) {
+        x[i] <- found[1L]
+        next
+      }
+
+      if (any(x_backup_without_spp[i] %in% c(NA, "", "xxx", "con"))) {
         x[i] <- NA_character_
         next
       }
 
-      if (tolower(x_trimmed[i]) %in% c("other", "none", "unknown")) {
+      if (tolower(x_backup_without_spp[i]) %in% c("other", "none", "unknown")) {
         # empty and nonsense values, ignore without warning
         x[i] <- microorganismsDT[mo == "UNKNOWN", ..property][[1]]
         next
@@ -472,7 +504,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
         next
       }
 
-      if (x_trimmed[i] %like% "virus") {
+      if (x_backup_without_spp[i] %like% "virus") {
         # there is no fullname like virus, so don't try to coerce it
         x[i] <- microorganismsDT[mo == "UNKNOWN", ..property][[1]]
         failures <- c(failures, x_backup[i])
@@ -481,100 +513,100 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
 
       # translate known trivial abbreviations to genus + species ----
       if (!is.na(x_trimmed[i])) {
-        if (toupper(x_trimmed[i]) %in% c('MRSA', 'MSSA', 'VISA', 'VRSA')) {
+        if (toupper(x_backup_without_spp[i]) %in% c('MRSA', 'MSSA', 'VISA', 'VRSA')) {
           x[i] <- microorganismsDT[mo == 'B_STPHY_AUR', ..property][[1]][1L]
           next
         }
-        if (toupper(x_trimmed[i]) %in% c('MRSE', 'MSSE')) {
+        if (toupper(x_backup_without_spp[i]) %in% c('MRSE', 'MSSE')) {
           x[i] <- microorganismsDT[mo == 'B_STPHY_EPI', ..property][[1]][1L]
           next
         }
-        if (toupper(x_trimmed[i]) == "VRE"
-            | x_trimmed[i] %like% '(enterococci|enterokok|enterococo)[a-z]*?$')  {
+        if (toupper(x_backup_without_spp[i]) == "VRE"
+            | x_backup_without_spp[i] %like% '(enterococci|enterokok|enterococo)[a-z]*?$')  {
           x[i] <- microorganismsDT[mo == 'B_ENTRC', ..property][[1]][1L]
           next
         }
-        if (toupper(x_trimmed[i]) %in% c("EHEC", "EPEC", "EIEC", "STEC", "ATEC")) {
+        if (toupper(x_backup_without_spp[i]) %in% c("EHEC", "EPEC", "EIEC", "STEC", "ATEC")) {
           x[i] <- microorganismsDT[mo == 'B_ESCHR_COL', ..property][[1]][1L]
           next
         }
-        if (toupper(x_trimmed[i]) == 'MRPA') {
+        if (toupper(x_backup_without_spp[i]) == 'MRPA') {
           # multi resistant P. aeruginosa
           x[i] <- microorganismsDT[mo == 'B_PSDMN_AER', ..property][[1]][1L]
           next
         }
-        if (toupper(x_trimmed[i]) == 'CRS'
-            | toupper(x_trimmed[i]) == 'CRSM') {
+        if (toupper(x_backup_without_spp[i]) == 'CRS'
+            | toupper(x_backup_without_spp[i]) == 'CRSM') {
           # co-trim resistant S. maltophilia
           x[i] <- microorganismsDT[mo == 'B_STNTR_MAL', ..property][[1]][1L]
           next
         }
-        if (toupper(x_trimmed[i]) %in% c('PISP', 'PRSP', 'VISP', 'VRSP')) {
+        if (toupper(x_backup_without_spp[i]) %in% c('PISP', 'PRSP', 'VISP', 'VRSP')) {
           # peni I, peni R, vanco I, vanco R: S. pneumoniae
           x[i] <- microorganismsDT[mo == 'B_STRPT_PNE', ..property][[1]][1L]
           next
         }
-        if (x_trimmed[i] %like% '^G[ABCDFGHK]S$') {
+        if (x_backup_without_spp[i] %like% '^G[ABCDFGHK]S$') {
           # Streptococci, like GBS = Group B Streptococci (B_STRPT_GRB)
-          x[i] <- microorganismsDT[mo == gsub("G([ABCDFGHK])S", "B_STRPT_GR\\1", x_trimmed[i], ignore.case = TRUE), ..property][[1]][1L]
+          x[i] <- microorganismsDT[mo == gsub("G([ABCDFGHK])S", "B_STRPT_GR\\1", x_backup_without_spp[i], ignore.case = TRUE), ..property][[1]][1L]
           next
         }
-        if (x_trimmed[i] %like% '(streptococ|streptokok).* [ABCDFGHK]$') {
+        if (x_backup_without_spp[i] %like% '(streptococ|streptokok).* [ABCDFGHK]$') {
           # Streptococci in different languages, like "estreptococos grupo B"
-          x[i] <- microorganismsDT[mo == gsub(".*(streptococ|streptokok|estreptococ).* ([ABCDFGHK])$", "B_STRPT_GR\\2", x_trimmed[i], ignore.case = TRUE), ..property][[1]][1L]
+          x[i] <- microorganismsDT[mo == gsub(".*(streptococ|streptokok|estreptococ).* ([ABCDFGHK])$", "B_STRPT_GR\\2", x_backup_without_spp[i], ignore.case = TRUE), ..property][[1]][1L]
           next
         }
-        if (x_trimmed[i] %like% 'group [ABCDFGHK] (streptococ|streptokok|estreptococ)') {
+        if (x_backup_without_spp[i] %like% 'group [ABCDFGHK] (streptococ|streptokok|estreptococ)') {
           # Streptococci in different languages, like "Group A Streptococci"
-          x[i] <- microorganismsDT[mo == gsub(".*group ([ABCDFGHK]) (streptococ|streptokok|estreptococ).*", "B_STRPT_GR\\1", x_trimmed[i], ignore.case = TRUE), ..property][[1]][1L]
+          x[i] <- microorganismsDT[mo == gsub(".*group ([ABCDFGHK]) (streptococ|streptokok|estreptococ).*", "B_STRPT_GR\\1", x_backup_without_spp[i], ignore.case = TRUE), ..property][[1]][1L]
           next
         }
         # CoNS/CoPS in different languages (support for German, Dutch, Spanish, Portuguese) ----
-        if (x[i] %like% '[ck]oagulas[ea] negatie?[vf]'
+        if (x_backup_without_spp[i] %like% '[ck]oagulas[ea] negatie?[vf]'
             | x_trimmed[i] %like% '[ck]oagulas[ea] negatie?[vf]'
-            | x[i] %like% '[ck]o?ns[^a-z]?$') {
+            | x_backup_without_spp[i] %like% '[ck]o?ns[^a-z]?$') {
           # coerce S. coagulase negative
           x[i] <- microorganismsDT[mo == 'B_STPHY_CNS', ..property][[1]][1L]
           next
         }
-        if (x[i] %like% '[ck]oagulas[ea] positie?[vf]'
+        if (x_backup_without_spp[i] %like% '[ck]oagulas[ea] positie?[vf]'
             | x_trimmed[i] %like% '[ck]oagulas[ea] positie?[vf]'
-            | x[i] %like% '[ck]o?ps[^a-z]?$') {
+            | x_backup_without_spp[i] %like% '[ck]o?ps[^a-z]?$') {
           # coerce S. coagulase positive
           x[i] <- microorganismsDT[mo == 'B_STPHY_CPS', ..property][[1]][1L]
           next
         }
-        if (x[i] %like% 'gram[ -]?neg.*'
+        if (x_backup_without_spp[i] %like% 'gram[ -]?neg.*'
             | x_trimmed[i] %like% 'gram[ -]?neg.*') {
-          # coerce S. coagulase positive
+          # coerce Gram negatives
           x[i] <- microorganismsDT[mo == 'B_GRAMN', ..property][[1]][1L]
           next
         }
-        if (x[i] %like% 'gram[ -]?pos.*'
+        if (x_backup_without_spp[i] %like% 'gram[ -]?pos.*'
             | x_trimmed[i] %like% 'gram[ -]?pos.*') {
-          # coerce S. coagulase positive
+          # coerce Gram positives
           x[i] <- microorganismsDT[mo == 'B_GRAMP', ..property][[1]][1L]
           next
         }
-        if (grepl("[sS]almonella [A-Z][a-z]+ ?.*", x_trimmed[i], ignore.case = FALSE)) {
-          if (x_trimmed[i] %like% "Salmonella group") {
+        if (grepl("[sS]almonella [A-Z][a-z]+ ?.*", x_backup_without_spp[i], ignore.case = FALSE)) {
+          if (x_backup_without_spp[i] %like% "Salmonella group") {
             # Salmonella Group A to Z, just return S. species for now
             x[i] <- microorganismsDT[mo == 'B_SLMNL', ..property][[1]][1L]
-            notes <- c(notes,
-                       magenta(paste0("Note: ",
-                                      italic("Salmonella"), " ", trimws(gsub("Salmonella", "", x_trimmed[i])),
-                                      " was considered ",
-                                      italic("Salmonella species"),
-                                      " (B_SLMNL)")))
+            options(mo_renamed = c(getOption("mo_renamed"),
+                                   magenta(paste0("Note: ",
+                                                  italic("Salmonella"), " ", trimws(gsub("Salmonella", "", x_backup_without_spp[i])),
+                                                  " was considered ",
+                                                  italic("Salmonella species"),
+                                                  " (B_SLMNL)"))))
           } else {
             # Salmonella with capital letter species like "Salmonella Goettingen" - they're all S. enterica
             x[i] <- microorganismsDT[mo == 'B_SLMNL_ENT', ..property][[1]][1L]
-            notes <- c(notes,
-                       magenta(paste0("Note: ",
-                                      italic("Salmonella"), " ", trimws(gsub("Salmonella", "", x_trimmed[i])),
-                                      " was considered a subspecies of ",
-                                      italic("Salmonella enterica"),
-                                      " (B_SLMNL_ENT)")))
+            options(mo_renamed = c(getOption("mo_renamed"),
+                                   magenta(paste0("Note: ",
+                                                  italic("Salmonella"), " ", trimws(gsub("Salmonella", "", x_backup_without_spp[i])),
+                                                  " was considered a subspecies of ",
+                                                  italic("Salmonella enterica"),
+                                                  " (B_SLMNL_ENT)"))))
           }
           next
         }
@@ -588,8 +620,8 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
           x[i] <- found[1L]
           next
         }
-        if (nchar(x_trimmed[i]) >= 6) {
-          found <- microorganismsDT[fullname_lower %like% paste0(x_withspaces_start_only[i], "[a-z]+ species"), ..property][[1]]
+        if (nchar(x_backup_without_spp[i]) >= 6) {
+          found <- microorganismsDT[fullname_lower %like% paste0("^", x_backup_without_spp[i], "[a-z]+"), ..property][[1]]
           if (length(found) > 0) {
             x[i] <- found[1L]
             next
@@ -621,7 +653,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
       }
 
       # allow no codes less than 4 characters long, was already checked for WHONET above
-      if (nchar(x_trimmed[i]) < 4) {
+      if (nchar(x_backup_without_spp[i]) < 4) {
         x[i] <- microorganismsDT[mo == "UNKNOWN", ..property][[1]]
         failures <- c(failures, x_backup[i])
         next
@@ -633,22 +665,23 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
                                        c.x_trimmed_without_group,
                                        d.x_withspaces_start_end,
                                        e.x_withspaces_start_only,
-                                       f.x_withspaces_end_only) {
+                                       f.x_withspaces_end_only,
+                                       g.x_backup_without_spp) {
 
-        found <- data_to_check[fullname_lower %in% tolower(c(a.x_backup, b.x_trimmed)), ..property][[1]]
-        # most probable: is exact match in fullname
+        # try probable: trimmed version of fullname ----
+        found <- data_to_check[fullname_lower %in% tolower(g.x_backup_without_spp), ..property][[1]]
         if (length(found) > 0) {
           return(found[1L])
         }
-
-        found <- data_to_check[fullname_lower == tolower(c.x_trimmed_without_group), ..property][[1]]
-        if (length(found) > 0) {
+        found <- data_to_check[fullname_lower %like% b.x_trimmed
+                               | fullname_lower %like% c.x_trimmed_without_group, ..property][[1]]
+        if (length(found) > 0 & nchar(g.x_backup_without_spp) >= 6) {
           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) {
+        if (length(found) > 0 & nchar(g.x_backup_without_spp) >= 6) {
           return(found[1L])
         }
 
@@ -658,7 +691,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
           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) {
+        if (length(found) > 0 & nchar(g.x_backup_without_spp) >= 6) {
           return(found[1L])
         }
 
@@ -671,12 +704,12 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
         # 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)
+        if (nchar(g.x_backup_without_spp) <= 6) {
+          x_length <- nchar(g.x_backup_without_spp)
           x_split <- paste0("^",
-                            b.x_trimmed %>% substr(1, x_length / 2),
+                            g.x_backup_without_spp %>% substr(1, x_length / 2),
                             '.* ',
-                            b.x_trimmed %>% substr((x_length / 2) + 1, x_length))
+                            g.x_backup_without_spp %>% substr((x_length / 2) + 1, x_length))
           found <- data_to_check[fullname %like% x_split, ..property][[1]]
           if (length(found) > 0) {
             return(found[1L])
@@ -701,7 +734,8 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
                                    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])
+                                   f.x_withspaces_end_only = x_withspaces_end_only[i],
+                                   g.x_backup_without_spp =  x_backup_without_spp[i])
       if (!empty_result(x[i])) {
         next
       }
@@ -712,7 +746,8 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
                                    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])
+                                   f.x_withspaces_end_only = x_withspaces_end_only[i],
+                                   g.x_backup_without_spp =  x_backup_without_spp[i])
       if (!empty_result(x[i])) {
         next
       }
@@ -723,7 +758,8 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
                                    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])
+                                   f.x_withspaces_end_only = x_withspaces_end_only[i],
+                                   g.x_backup_without_spp =  x_backup_without_spp[i])
       if (!empty_result(x[i])) {
         next
       }
@@ -752,31 +788,23 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
       }
 
       # check for uncertain results ----
-      if (allow_uncertain == TRUE) {
+      uncertain_fn <- function(a.x_backup,
+b.x_trimmed,
+ c.x_withspaces_start_end,
+d.x_withspaces_start_only,
+ f.x_withspaces_end_only,
+g.x_backup_without_spp) {
 
-        uncertain_fn <- function(a.x_backup, b.x_trimmed, c.x_withspaces_start_end, d.x_withspaces_start_only, f.x_withspaces_end_only) {
+        if (allow_uncertain == 0) {
+          # do not allow uncertainties
+          return(NA_character_)
+        }
 
-          # (1) look for genus only, part of name ----
-          if (nchar(b.x_trimmed) > 4 & !b.x_trimmed %like% " ") {
-            if (!grepl("^[A-Z][a-z]+", b.x_trimmed, ignore.case = FALSE)) {
-              # not when input is like Genustext, because then Neospora would lead to Actinokineospora
-              found <- microorganismsDT[fullname_lower %like% paste(b.x_trimmed, "species"), ..property][[1]]
-              if (length(found) > 0) {
-                x[i] <- found[1L]
-                uncertainties <<- rbind(uncertainties,
-                                        data.frame(uncertainty = 2,
-                                                   input = a.x_backup,
-                                                   fullname = microorganismsDT[mo == found[1L], fullname][[1]],
-                                                   mo = found[1L]))
-                return(x)
-              }
-            }
-          }
-
-          # (2) look again for old taxonomic names, now for G. species ----
+        if (allow_uncertain >= 1) {
+          # (1) look again for old taxonomic names, now for G. species ----
           found <- microorganisms.oldDT[fullname %like% c.x_withspaces_start_end
                                         | fullname %like% d.x_withspaces_start_only]
-          if (NROW(found) > 0 & nchar(b.x_trimmed) >= 6) {
+          if (NROW(found) > 0 & nchar(g.x_backup_without_spp) >= 6) {
             if (property == "ref") {
               # when property is "ref" (which is the case in mo_ref, mo_authors and mo_year), return the old value, so:
               # mo_ref("Chlamydia psittaci) = "Page, 1968" (with warning)
@@ -798,7 +826,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
             return(x)
           }
 
-          # (3) not yet implemented taxonomic changes in Catalogue of Life ----
+          # (2) not yet implemented taxonomic changes in Catalogue of Life ----
           found <- suppressMessages(suppressWarnings(exec_as.mo(TEMPORARY_TAXONOMY(b.x_trimmed), clear_options = FALSE, allow_uncertain = FALSE)))
           if (!empty_result(found)) {
             found_result <- found
@@ -810,12 +838,31 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
                                                mo = found_result[1L]))
             return(found[1L])
           }
+        }
+
+        if (allow_uncertain >= 2) {
+          # (3) look for genus only, part of name ----
+          if (nchar(g.x_backup_without_spp) > 4 & !b.x_trimmed %like% " ") {
+            if (!grepl("^[A-Z][a-z]+", b.x_trimmed, ignore.case = FALSE)) {
+              # not when input is like Genustext, because then Neospora would lead to Actinokineospora
+              found <- microorganismsDT[fullname_lower %like% paste(b.x_trimmed, "species"), ..property][[1]]
+              if (length(found) > 0) {
+                x[i] <- found[1L]
+                uncertainties <<- rbind(uncertainties,
+                                        data.frame(uncertainty = 2,
+                                                   input = a.x_backup,
+                                                   fullname = microorganismsDT[mo == found[1L], fullname][[1]],
+                                                   mo = found[1L]))
+                return(x)
+              }
+            }
+          }
 
           # (4) strip values between brackets ----
           a.x_backup_stripped <- gsub("( *[(].*[)] *)", " ", a.x_backup)
           a.x_backup_stripped <- trimws(gsub(" +", " ", a.x_backup_stripped))
           found <- suppressMessages(suppressWarnings(exec_as.mo(a.x_backup_stripped, clear_options = FALSE, allow_uncertain = FALSE)))
-          if (!empty_result(found) & nchar(b.x_trimmed) >= 6) {
+          if (!empty_result(found) & nchar(g.x_backup_without_spp) >= 6) {
             found_result <- found
             found <- microorganismsDT[mo == found, ..property][[1]]
             uncertainties <<- rbind(uncertainties,
@@ -828,26 +875,30 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
 
           # (5) try to strip off one element from end and check the remains ----
           x_strip <- a.x_backup %>% strsplit(" ") %>% unlist()
-          if (length(x_strip) > 1 & nchar(b.x_trimmed) >= 6) {
+          if (length(x_strip) > 1) {
             for (i in 1:(length(x_strip) - 1)) {
               x_strip_collapsed <- paste(x_strip[1:(length(x_strip) - i)], collapse = " ")
-              found <- suppressMessages(suppressWarnings(exec_as.mo(x_strip_collapsed, clear_options = FALSE, allow_uncertain = FALSE)))
-              if (!empty_result(found)) {
-                found_result <- found
-                found <- microorganismsDT[mo == found, ..property][[1]]
-                uncertainties <<- rbind(uncertainties,
-                                        data.frame(uncertainty = 2,
-                                                   input = a.x_backup,
-                                                   fullname = microorganismsDT[mo == found_result[1L], fullname][[1]],
-                                                   mo = found_result[1L]))
-                return(found[1L])
+              if (nchar(x_strip_collapsed) >= 4) {
+                found <- suppressMessages(suppressWarnings(exec_as.mo(x_strip_collapsed, clear_options = FALSE, allow_uncertain = FALSE)))
+                if (!empty_result(found)) {
+                  found_result <- found
+                  found <- microorganismsDT[mo == found, ..property][[1]]
+                  uncertainties <<- rbind(uncertainties,
+                                          data.frame(uncertainty = 2,
+                                                     input = a.x_backup,
+                                                     fullname = microorganismsDT[mo == found_result[1L], fullname][[1]],
+                                                     mo = found_result[1L]))
+                  return(found[1L])
+                }
               }
             }
           }
+        }
 
+        if (allow_uncertain >= 3) {
           # (6) try to strip off one element from start and check the remains ----
           x_strip <- a.x_backup %>% strsplit(" ") %>% unlist()
-          if (length(x_strip) > 1 & nchar(b.x_trimmed) >= 6) {
+          if (length(x_strip) > 1 & nchar(g.x_backup_without_spp) >= 6) {
             for (i in 2:(length(x_strip))) {
               x_strip_collapsed <- paste(x_strip[i:length(x_strip)], collapse = " ")
               found <- suppressMessages(suppressWarnings(exec_as.mo(x_strip_collapsed, clear_options = FALSE, allow_uncertain = FALSE)))
@@ -868,7 +919,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
           found <- microorganismsDT[fullname %like% f.x_withspaces_end_only]
           if (nrow(found) > 0) {
             found_result <- found[["mo"]]
-            if (!empty_result(found_result)) {
+            if (!empty_result(found_result) & nchar(g.x_backup_without_spp) >= 6) {
               found <- microorganismsDT[mo == found_result[1L], ..property][[1]]
               uncertainties <<- rbind(uncertainties,
                                       data.frame(uncertainty = 3,
@@ -878,16 +929,21 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
               return(found[1L])
             }
           }
-
-          # didn't found in uncertain results too
-          return(NA_character_)
         }
 
-        x[i] <- uncertain_fn(x_backup[i], x_trimmed[i], x_withspaces_start_end[i], x_withspaces_start_only[i], x_withspaces_end_only[i])
-        if (!empty_result(x[i])) {
-          next
-        }
+        # didn't found in uncertain results too
+        return(NA_character_)
       }
+      x[i] <- uncertain_fn(x_backup[i],
+                           x_trimmed[i],
+													 x_withspaces_start_end[i],
+                           x_withspaces_start_only[i],
+                           x_withspaces_end_only[i],
+                           x_backup_without_spp[i])
+      if (!empty_result(x[i])) {
+        next
+      }
+
 
       # not found ----
       x[i] <- microorganismsDT[mo == "UNKNOWN", ..property][[1]]
@@ -899,19 +955,19 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
   failures <- failures[!failures %in% c(NA, NULL, NaN)]
   if (length(failures) > 0 & clear_options == TRUE) {
     options(mo_failures = sort(unique(failures)))
-    plural <- c("value", "it", "is")
+    plural <- c("value", "it", "was")
     if (n_distinct(failures) > 1) {
-      plural <- c("values", "them", "are")
+      plural <- c("values", "them", "were")
     }
     total_failures <- length(x_input[x_input %in% failures & !x_input %in% c(NA, NULL, NaN)])
     total_n <- length(x_input[!x_input %in% c(NA, NULL, NaN)])
-    msg <- paste0("\n", nr2char(n_distinct(failures)), " unique ", plural[1],
+    msg <- paste0(nr2char(n_distinct(failures)), " unique ", plural[1],
                   " (^= ", percent(total_failures / total_n, round = 1, force_zero = TRUE),
                   ") could not be coerced and ", plural[3], " considered 'unknown'")
     if (n_distinct(failures) <= 10) {
       msg <- paste0(msg, ": ", paste('"', unique(failures), '"', sep = "", collapse = ', '))
     }
-    msg <- paste0(msg,  ". Use mo_failures() to review ", plural[2], ".")
+    msg <- paste0(msg,  ". Use mo_failures() to review ", plural[2], ". Edit the `allow_uncertain` parameter if needed (see ?as.mo).")
     warning(red(msg),
             call. = FALSE,
             immediate. = TRUE) # thus will always be shown, even if >= warnings
@@ -1026,7 +1082,7 @@ exec_as.mo <- function(x, Becker = FALSE, Lancefield = FALSE,
 }
 
 empty_result <- function(x) {
-  x %in% c(NA, "UNKNOWN")
+  all(x %in% c(NA, "UNKNOWN"))
 }
 
 TEMPORARY_TAXONOMY <- function(x) {
@@ -1124,6 +1180,9 @@ mo_uncertainties <- function() {
 #' @export
 #' @noRd
 print.mo_uncertainties <- function(x, ...) {
+  if (NROW(x) == 0) {
+    return(NULL)
+  }
   cat(paste0(bold(nrow(x), "unique result(s) guessed with uncertainty:"),
              "\n(1 = ", green("renamed"),
              ", 2 = ", yellow("uncertain"),
diff --git a/R/zzz.R b/R/zzz.R
index 78dccdcf..6d4a87df 100755
--- a/R/zzz.R
+++ b/R/zzz.R
@@ -25,28 +25,25 @@
   backports::import(pkgname)
 
   # register data
-  if (!all(c("microorganismsDT", "microorganisms.oldDT") %in% ls(envir = asNamespace("AMR")))) {
+  microorganisms.oldDT <- as.data.table(AMR::microorganisms.old)
+  microorganisms.oldDT$fullname_lower <- tolower(microorganisms.oldDT$fullname)
+  setkey(microorganisms.oldDT, col_id, fullname)
 
-    microorganisms.oldDT <- as.data.table(AMR::microorganisms.old)
-    microorganisms.oldDT$fullname_lower <- tolower(microorganisms.oldDT$fullname)
-    setkey(microorganisms.oldDT, col_id, fullname)
+  assign(x = "microorganisms",
+         value = make(),
+         envir = asNamespace("AMR"))
 
-    assign(x = "microorganisms",
-           value = make(),
-           envir = asNamespace("AMR"))
+  assign(x = "microorganismsDT",
+         value = make_DT(),
+         envir = asNamespace("AMR"))
 
-    assign(x = "microorganismsDT",
-           value = make_DT(),
-           envir = asNamespace("AMR"))
+  assign(x = "microorganisms.oldDT",
+         value = microorganisms.oldDT,
+         envir = asNamespace("AMR"))
 
-    assign(x = "microorganisms.oldDT",
-           value = microorganisms.oldDT,
-           envir = asNamespace("AMR"))
-
-    assign(x = "mo_codes_v0.5.0",
-           value = make_trans_tbl(),
-           envir = asNamespace("AMR"))
-  }
+  assign(x = "mo_codes_v0.5.0",
+         value = make_trans_tbl(),
+         envir = asNamespace("AMR"))
 }
 
 #' @importFrom dplyr mutate case_when
@@ -88,8 +85,8 @@ make_DT <- function() {
   microorganismsDT <- as.data.table(make())
   microorganismsDT$fullname_lower <- tolower(microorganismsDT$fullname)
   setkey(microorganismsDT,
-         kingdom,
          prevalence,
+         kingdom,
          fullname)
   microorganismsDT
 }
diff --git a/data/microorganisms.codes.rda b/data/microorganisms.codes.rda
index e5254a13174244e0b239c7ef7ba07372f196fd03..8b7b005eb92bbd2be744b5ec00ef1b359e81d187 100644
GIT binary patch
literal 26668
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
HCY(peZHw!9

literal 24009
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
A>i_@%

diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html
index f4aca6a7..5e593eff 100644
--- a/docs/LICENSE-text.html
+++ b/docs/LICENSE-text.html
@@ -78,7 +78,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/articles/benchmarks.html b/docs/articles/benchmarks.html
index 6848bcaa..9f9c9b39 100644
--- a/docs/articles/benchmarks.html
+++ b/docs/articles/benchmarks.html
@@ -40,7 +40,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
@@ -192,7 +192,7 @@
       <h1>Benchmarks</h1>
                         <h4 class="author">Matthijs S. Berends</h4>
             
-            <h4 class="date">09 March 2019</h4>
+            <h4 class="date">12 March 2019</h4>
       
       
       <div class="hidden name"><code>benchmarks.Rmd</code></div>
@@ -217,14 +217,14 @@
 <a class="sourceLine" id="cb2-8" title="8">                           <span class="dt">times =</span> <span class="dv">10</span>)</a>
 <a class="sourceLine" id="cb2-9" title="9"><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/print">print</a></span>(S.aureus, <span class="dt">unit =</span> <span class="st">"ms"</span>, <span class="dt">signif =</span> <span class="dv">3</span>)</a>
 <a class="sourceLine" id="cb2-10" title="10"><span class="co">#&gt; Unit: milliseconds</span></a>
-<a class="sourceLine" id="cb2-11" title="11"><span class="co">#&gt;                            expr   min    lq mean median    uq  max neval</span></a>
-<a class="sourceLine" id="cb2-12" title="12"><span class="co">#&gt;                    as.mo("sau") 16.60 16.60 25.2  16.80 18.00 58.3    10</span></a>
-<a class="sourceLine" id="cb2-13" title="13"><span class="co">#&gt;                   as.mo("stau") 31.60 31.80 44.8  32.40 72.20 76.7    10</span></a>
-<a class="sourceLine" id="cb2-14" title="14"><span class="co">#&gt;                 as.mo("staaur") 16.60 16.60 26.4  16.70 17.30 71.9    10</span></a>
-<a class="sourceLine" id="cb2-15" title="15"><span class="co">#&gt;                 as.mo("STAAUR") 16.50 16.60 16.6  16.60 16.70 16.8    10</span></a>
-<a class="sourceLine" id="cb2-16" title="16"><span class="co">#&gt;              as.mo("S. aureus") 24.50 24.60 29.0  24.70 25.00 66.6    10</span></a>
-<a class="sourceLine" id="cb2-17" title="17"><span class="co">#&gt;             as.mo("S.  aureus") 24.30 24.60 24.6  24.60 24.70 24.9    10</span></a>
-<a class="sourceLine" id="cb2-18" title="18"><span class="co">#&gt;  as.mo("Staphylococcus aureus")  7.45  7.47 11.9   7.53  7.97 50.0    10</span></a></code></pre></div>
+<a class="sourceLine" id="cb2-11" title="11"><span class="co">#&gt;                            expr   min   lq  mean median    uq   max neval</span></a>
+<a class="sourceLine" id="cb2-12" title="12"><span class="co">#&gt;                    as.mo("sau") 16.70 16.8 25.70  17.00 19.60  59.7    10</span></a>
+<a class="sourceLine" id="cb2-13" title="13"><span class="co">#&gt;                   as.mo("stau") 39.10 39.2 43.70  39.30 40.60  80.4    10</span></a>
+<a class="sourceLine" id="cb2-14" title="14"><span class="co">#&gt;                 as.mo("staaur") 16.70 16.8 24.60  17.00 18.20  58.9    10</span></a>
+<a class="sourceLine" id="cb2-15" title="15"><span class="co">#&gt;                 as.mo("STAAUR") 16.70 16.7 22.70  16.80 17.20  74.5    10</span></a>
+<a class="sourceLine" id="cb2-16" title="16"><span class="co">#&gt;              as.mo("S. aureus") 29.70 29.7 46.70  29.80 71.30 110.0    10</span></a>
+<a class="sourceLine" id="cb2-17" title="17"><span class="co">#&gt;             as.mo("S.  aureus") 29.60 29.7 36.10  29.70 33.10  83.7    10</span></a>
+<a class="sourceLine" id="cb2-18" title="18"><span class="co">#&gt;  as.mo("Staphylococcus aureus")  7.03  7.1  7.14   7.14  7.17   7.3    10</span></a></code></pre></div>
 <p>In the table above, all measurements are shown in milliseconds (thousands of seconds). A value of 5 milliseconds means it can determine 200 input values per second. It case of 100 milliseconds, this is only 10 input values per second. The second input is the only one that has to be looked up thoroughly. All the others are known codes (the first one is a WHONET code) or common laboratory codes, or common full organism names like the last one. Full organism names are always preferred.</p>
 <p>To achieve this speed, the <code>as.mo</code> 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 <em>Thermus islandicus</em> (<code>B_THERMS_ISL</code>), a bug probably never found before in humans:</p>
 <div class="sourceCode" id="cb3"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb3-1" title="1">T.islandicus &lt;-<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/microbenchmark/topics/microbenchmark">microbenchmark</a></span>(<span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"theisl"</span>),</a>
@@ -235,13 +235,13 @@
 <a class="sourceLine" id="cb3-6" title="6">                                 <span class="dt">times =</span> <span class="dv">10</span>)</a>
 <a class="sourceLine" id="cb3-7" title="7"><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/print">print</a></span>(T.islandicus, <span class="dt">unit =</span> <span class="st">"ms"</span>, <span class="dt">signif =</span> <span class="dv">3</span>)</a>
 <a class="sourceLine" id="cb3-8" title="8"><span class="co">#&gt; Unit: milliseconds</span></a>
-<a class="sourceLine" id="cb3-9" title="9"><span class="co">#&gt;                         expr   min    lq  mean median  uq max neval</span></a>
-<a class="sourceLine" id="cb3-10" title="10"><span class="co">#&gt;              as.mo("theisl") 262.0 263.0 284.0  284.0 304 308    10</span></a>
-<a class="sourceLine" id="cb3-11" title="11"><span class="co">#&gt;              as.mo("THEISL") 263.0 264.0 293.0  304.0 306 308    10</span></a>
-<a class="sourceLine" id="cb3-12" title="12"><span class="co">#&gt;       as.mo("T. islandicus") 142.0 142.0 151.0  143.0 147 187    10</span></a>
-<a class="sourceLine" id="cb3-13" title="13"><span class="co">#&gt;      as.mo("T.  islandicus") 142.0 142.0 169.0  184.0 185 194    10</span></a>
-<a class="sourceLine" id="cb3-14" title="14"><span class="co">#&gt;  as.mo("Thermus islandicus")  67.9  68.1  93.3   90.3 116 130    10</span></a></code></pre></div>
-<p>That takes 7.8 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. Full names (like <em>Thermus islandicus</em>) are almost fast - these are the most probable input from most data sets.</p>
+<a class="sourceLine" id="cb3-9" title="9"><span class="co">#&gt;                         expr   min    lq  mean median    uq max neval</span></a>
+<a class="sourceLine" id="cb3-10" title="10"><span class="co">#&gt;              as.mo("theisl") 417.0 419.0 450.0  460.0 464.0 474    10</span></a>
+<a class="sourceLine" id="cb3-11" title="11"><span class="co">#&gt;              as.mo("THEISL") 415.0 416.0 443.0  458.0 460.0 468    10</span></a>
+<a class="sourceLine" id="cb3-12" title="12"><span class="co">#&gt;       as.mo("T. islandicus") 281.0 281.0 299.0  285.0 325.0 352    10</span></a>
+<a class="sourceLine" id="cb3-13" title="13"><span class="co">#&gt;      as.mo("T.  islandicus") 292.0 298.0 341.0  336.0 340.0 495    10</span></a>
+<a class="sourceLine" id="cb3-14" title="14"><span class="co">#&gt;  as.mo("Thermus islandicus")  66.2  66.5  75.5   66.9  68.2 112    10</span></a></code></pre></div>
+<p>That takes 10.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. Full names (like <em>Thermus islandicus</em>) are almost fast - these are the most probable input from most data sets.</p>
 <p>In the figure below, we compare <em>Escherichia coli</em> (which is very common) with <em>Prevotella brevis</em> (which is moderately common) and with <em>Thermus islandicus</em> (which is very uncommon):</p>
 <div class="sourceCode" id="cb4"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb4-1" title="1"><span class="kw"><a href="https://www.rdocumentation.org/packages/graphics/topics/par">par</a></span>(<span class="dt">mar =</span> <span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(<span class="dv">5</span>, <span class="dv">16</span>, <span class="dv">4</span>, <span class="dv">2</span>)) <span class="co"># set more space for left margin text (16)</span></a>
 <a class="sourceLine" id="cb4-2" title="2"></a>
@@ -286,9 +286,9 @@
 <a class="sourceLine" id="cb5-23" title="23">                         <span class="dt">times =</span> <span class="dv">10</span>)</a>
 <a class="sourceLine" id="cb5-24" title="24"><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/print">print</a></span>(run_it, <span class="dt">unit =</span> <span class="st">"ms"</span>, <span class="dt">signif =</span> <span class="dv">3</span>)</a>
 <a class="sourceLine" id="cb5-25" title="25"><span class="co">#&gt; Unit: milliseconds</span></a>
-<a class="sourceLine" id="cb5-26" title="26"><span class="co">#&gt;            expr min  lq mean median  uq max neval</span></a>
-<a class="sourceLine" id="cb5-27" title="27"><span class="co">#&gt;  mo_fullname(x) 734 810  840    817 860 973    10</span></a></code></pre></div>
-<p>So transforming 500,000 values (!!) of 50 unique values only takes 0.82 seconds (817 ms). You only lose time on your unique input values.</p>
+<a class="sourceLine" id="cb5-26" title="26"><span class="co">#&gt;            expr min  lq mean median  uq  max neval</span></a>
+<a class="sourceLine" id="cb5-27" title="27"><span class="co">#&gt;  mo_fullname(x) 794 834  863    844 876 1050    10</span></a></code></pre></div>
+<p>So transforming 500,000 values (!!) of 50 unique values only takes 0.84 seconds (844 ms). You only lose time on your unique input values.</p>
 </div>
 <div id="precalculated-results" class="section level3">
 <h3 class="hasAnchor">
@@ -301,9 +301,9 @@
 <a class="sourceLine" id="cb6-5" title="5"><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/print">print</a></span>(run_it, <span class="dt">unit =</span> <span class="st">"ms"</span>, <span class="dt">signif =</span> <span class="dv">3</span>)</a>
 <a class="sourceLine" id="cb6-6" title="6"><span class="co">#&gt; Unit: milliseconds</span></a>
 <a class="sourceLine" id="cb6-7" title="7"><span class="co">#&gt;  expr    min     lq   mean median     uq    max neval</span></a>
-<a class="sourceLine" id="cb6-8" title="8"><span class="co">#&gt;     A 11.200 11.300 11.400 11.400 11.600 11.600    10</span></a>
-<a class="sourceLine" id="cb6-9" title="9"><span class="co">#&gt;     B 22.200 22.400 26.800 22.600 22.800 63.700    10</span></a>
-<a class="sourceLine" id="cb6-10" title="10"><span class="co">#&gt;     C  0.328  0.564  0.525  0.568  0.577  0.591    10</span></a></code></pre></div>
+<a class="sourceLine" id="cb6-8" title="8"><span class="co">#&gt;     A 10.900 11.100 11.200 11.200 11.300 11.400    10</span></a>
+<a class="sourceLine" id="cb6-9" title="9"><span class="co">#&gt;     B 27.300 27.900 28.300 28.000 28.100 31.500    10</span></a>
+<a class="sourceLine" id="cb6-10" title="10"><span class="co">#&gt;     C  0.319  0.326  0.472  0.563  0.568  0.579    10</span></a></code></pre></div>
 <p>So going from <code><a href="../reference/mo_property.html">mo_fullname("Staphylococcus aureus")</a></code> to <code>"Staphylococcus aureus"</code> takes 0.0006 seconds - it doesn’t even start calculating <em>if the result would be the same as the expected resulting value</em>. That goes for all helper functions:</p>
 <div class="sourceCode" id="cb7"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb7-1" title="1">run_it &lt;-<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/microbenchmark/topics/microbenchmark">microbenchmark</a></span>(<span class="dt">A =</span> <span class="kw"><a href="../reference/mo_property.html">mo_species</a></span>(<span class="st">"aureus"</span>),</a>
 <a class="sourceLine" id="cb7-2" title="2">                         <span class="dt">B =</span> <span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(<span class="st">"Staphylococcus"</span>),</a>
@@ -317,14 +317,14 @@
 <a class="sourceLine" id="cb7-10" title="10"><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/print">print</a></span>(run_it, <span class="dt">unit =</span> <span class="st">"ms"</span>, <span class="dt">signif =</span> <span class="dv">3</span>)</a>
 <a class="sourceLine" id="cb7-11" title="11"><span class="co">#&gt; Unit: milliseconds</span></a>
 <a class="sourceLine" id="cb7-12" title="12"><span class="co">#&gt;  expr   min    lq  mean median    uq   max neval</span></a>
-<a class="sourceLine" id="cb7-13" title="13"><span class="co">#&gt;     A 0.318 0.376 0.414  0.419 0.449 0.537    10</span></a>
-<a class="sourceLine" id="cb7-14" title="14"><span class="co">#&gt;     B 0.343 0.397 0.437  0.447 0.479 0.522    10</span></a>
-<a class="sourceLine" id="cb7-15" title="15"><span class="co">#&gt;     C 0.325 0.380 0.486  0.482 0.554 0.703    10</span></a>
-<a class="sourceLine" id="cb7-16" title="16"><span class="co">#&gt;     D 0.334 0.337 0.381  0.372 0.426 0.434    10</span></a>
-<a class="sourceLine" id="cb7-17" title="17"><span class="co">#&gt;     E 0.304 0.322 0.356  0.335 0.393 0.460    10</span></a>
-<a class="sourceLine" id="cb7-18" title="18"><span class="co">#&gt;     F 0.295 0.323 0.370  0.362 0.424 0.463    10</span></a>
-<a class="sourceLine" id="cb7-19" title="19"><span class="co">#&gt;     G 0.296 0.321 0.362  0.348 0.387 0.470    10</span></a>
-<a class="sourceLine" id="cb7-20" title="20"><span class="co">#&gt;     H 0.289 0.335 0.355  0.351 0.387 0.421    10</span></a></code></pre></div>
+<a class="sourceLine" id="cb7-13" title="13"><span class="co">#&gt;     A 0.308 0.332 0.396  0.393 0.457 0.498    10</span></a>
+<a class="sourceLine" id="cb7-14" title="14"><span class="co">#&gt;     B 0.349 0.376 0.419  0.444 0.462 0.467    10</span></a>
+<a class="sourceLine" id="cb7-15" title="15"><span class="co">#&gt;     C 0.351 0.398 0.529  0.555 0.628 0.702    10</span></a>
+<a class="sourceLine" id="cb7-16" title="16"><span class="co">#&gt;     D 0.302 0.330 0.378  0.381 0.424 0.465    10</span></a>
+<a class="sourceLine" id="cb7-17" title="17"><span class="co">#&gt;     E 0.282 0.329 0.371  0.374 0.384 0.539    10</span></a>
+<a class="sourceLine" id="cb7-18" title="18"><span class="co">#&gt;     F 0.281 0.354 0.364  0.366 0.402 0.444    10</span></a>
+<a class="sourceLine" id="cb7-19" title="19"><span class="co">#&gt;     G 0.275 0.309 0.347  0.351 0.380 0.420    10</span></a>
+<a class="sourceLine" id="cb7-20" title="20"><span class="co">#&gt;     H 0.279 0.306 0.356  0.363 0.404 0.411    10</span></a></code></pre></div>
 <p>Of course, when running <code><a href="../reference/mo_property.html">mo_phylum("Firmicutes")</a></code> the function has zero knowledge about the actual microorganism, namely <em>S. aureus</em>. But since the result would be <code>"Firmicutes"</code> 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.</p>
 </div>
 <div id="results-in-other-languages" class="section level3">
@@ -351,13 +351,13 @@
 <a class="sourceLine" id="cb8-18" title="18"><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/print">print</a></span>(run_it, <span class="dt">unit =</span> <span class="st">"ms"</span>, <span class="dt">signif =</span> <span class="dv">4</span>)</a>
 <a class="sourceLine" id="cb8-19" title="19"><span class="co">#&gt; Unit: milliseconds</span></a>
 <a class="sourceLine" id="cb8-20" title="20"><span class="co">#&gt;  expr   min    lq  mean median    uq   max neval</span></a>
-<a class="sourceLine" id="cb8-21" title="21"><span class="co">#&gt;    en 15.57 15.87 24.21  20.71 37.98 38.78    10</span></a>
-<a class="sourceLine" id="cb8-22" title="22"><span class="co">#&gt;    de 28.79 34.96 53.24  52.02 56.97 95.22    10</span></a>
-<a class="sourceLine" id="cb8-23" title="23"><span class="co">#&gt;    nl 28.31 29.29 47.74  40.57 58.94 97.03    10</span></a>
-<a class="sourceLine" id="cb8-24" title="24"><span class="co">#&gt;    es 28.97 30.43 42.78  34.70 51.47 72.11    10</span></a>
-<a class="sourceLine" id="cb8-25" title="25"><span class="co">#&gt;    it 27.71 29.15 38.88  31.19 35.10 76.86    10</span></a>
-<a class="sourceLine" id="cb8-26" title="26"><span class="co">#&gt;    fr 28.37 29.28 40.89  41.73 50.43 56.78    10</span></a>
-<a class="sourceLine" id="cb8-27" title="27"><span class="co">#&gt;    pt 27.82 29.03 42.49  29.84 50.14 94.96    10</span></a></code></pre></div>
+<a class="sourceLine" id="cb8-21" title="21"><span class="co">#&gt;    en 16.61 17.17 17.23  17.28 17.38 17.56    10</span></a>
+<a class="sourceLine" id="cb8-22" title="22"><span class="co">#&gt;    de 28.83 28.85 29.31  29.50 29.63 29.67    10</span></a>
+<a class="sourceLine" id="cb8-23" title="23"><span class="co">#&gt;    nl 29.08 29.44 33.71  29.65 29.72 71.15    10</span></a>
+<a class="sourceLine" id="cb8-24" title="24"><span class="co">#&gt;    es 28.86 29.52 38.07  29.70 30.60 72.14    10</span></a>
+<a class="sourceLine" id="cb8-25" title="25"><span class="co">#&gt;    it 28.71 29.48 34.04  29.63 31.28 71.09    10</span></a>
+<a class="sourceLine" id="cb8-26" title="26"><span class="co">#&gt;    fr 29.32 29.47 41.44  29.53 62.86 73.16    10</span></a>
+<a class="sourceLine" id="cb8-27" title="27"><span class="co">#&gt;    pt 29.05 29.43 33.93  29.62 30.93 71.00    10</span></a></code></pre></div>
 <p>Currently supported are German, Dutch, Spanish, Italian, French and Portuguese.</p>
 </div>
   </div>
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
index a6412a798cca5cac189aa7e58cb5fb38b1aaf306..22db0a14018333c66f04b9d57411c88afdd5f27e 100644
GIT binary patch
literal 28781
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

literal 28565
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
I%`)WQ0H)`uGynhq

diff --git a/docs/articles/index.html b/docs/articles/index.html
index d4d7734d..fefc0597 100644
--- a/docs/articles/index.html
+++ b/docs/articles/index.html
@@ -78,7 +78,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/authors.html b/docs/authors.html
index 6c9d4a73..0cae75ad 100644
--- a/docs/authors.html
+++ b/docs/authors.html
@@ -78,7 +78,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/index.html b/docs/index.html
index 9735202a..131bee7f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -42,7 +42,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/news/index.html b/docs/news/index.html
index 3c187f88..7bc98225 100644
--- a/docs/news/index.html
+++ b/docs/news/index.html
@@ -78,7 +78,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
@@ -267,7 +267,7 @@ This data is updated annually - check the included version with the new function
 <ul>
 <li>Exported files from WHONET can be read and used in this package. For functions like <code><a href="../reference/first_isolate.html">first_isolate()</a></code> and <code><a href="../reference/eucast_rules.html">eucast_rules()</a></code>, all parameters will be filled in automatically.</li>
 <li>This package now knows all antibiotic abbrevations by EARS-Net (which are also being used by WHONET) - the <code>antibiotics</code> data set now contains a column <code>ears_net</code>.</li>
-<li>The function <code><a href="../reference/as.mo.html">as.mo()</a></code> now knows all WHONET species abbreviations too, because more than 1,600 microbial abbreviations were added to the <code>microorganisms.codes</code> data set.</li>
+<li>The function <code><a href="../reference/as.mo.html">as.mo()</a></code> now knows all WHONET species abbreviations too, because almost 2,000 microbial abbreviations were added to the <code>microorganisms.codes</code> data set.</li>
 </ul>
 </li>
 <li>
@@ -347,14 +347,35 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 <li>Functions <code><a href="../reference/AMR-deprecated.html">atc_ddd()</a></code> and <code><a href="../reference/AMR-deprecated.html">atc_groups()</a></code> have been renamed <code><a href="../reference/atc_online.html">atc_online_ddd()</a></code> and <code><a href="../reference/atc_online.html">atc_online_groups()</a></code>. The old functions are deprecated and will be removed in a future version.</li>
 <li>Function <code><a href="../reference/AMR-deprecated.html">guess_mo()</a></code> is now deprecated in favour of <code><a href="../reference/as.mo.html">as.mo()</a></code> and will be removed in future versions</li>
 <li>Function <code><a href="../reference/AMR-deprecated.html">guess_atc()</a></code> is now deprecated in favour of <code><a href="../reference/as.atc.html">as.atc()</a></code> and will be removed in future versions</li>
-<li>Improvements for <code><a href="../reference/as.mo.html">as.mo()</a></code>:\
+<li>Improvements for <code><a href="../reference/as.mo.html">as.mo()</a></code>:
 <ul>
-<li>Incoercible results will now be considered ‘unknown’, MO code <code>UNKNOWN</code>. Properties of these will be translated on foreign systems in all language already previously supported: German, Dutch, French, Italian, Spanish and Portuguese:</li>
+<li>Now handles incorrect spelling like <code>i</code> instead of <code>y</code> and <code>f</code> instead of <code>ph</code>:</li>
 </ul>
-<div class="sourceCode" id="cb7"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb7-1" title="1"><span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(<span class="st">"qwerty"</span>, <span class="dt">language =</span> <span class="st">"es"</span>)</a>
-<a class="sourceLine" id="cb7-2" title="2"><span class="co"># Warning: </span></a>
-<a class="sourceLine" id="cb7-3" title="3"><span class="co"># one unique value (^= 100.0%) could not be coerced and is considered 'unknown': "qwerty". Use mo_failures() to review it.</span></a>
-<a class="sourceLine" id="cb7-4" title="4"><span class="co">#&gt; [1] "(género desconocido)"</span></a></code></pre></div>
+<div class="sourceCode" id="cb7"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb7-1" title="1"><span class="co"># mo_fullname() uses as.mo() internally</span></a>
+<a class="sourceLine" id="cb7-2" title="2"></a>
+<a class="sourceLine" id="cb7-3" title="3"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"Sthafilokockus aaureuz"</span>)</a>
+<a class="sourceLine" id="cb7-4" title="4"><span class="co">#&gt; [1] "Staphylococcus aureus"</span></a>
+<a class="sourceLine" id="cb7-5" title="5"></a>
+<a class="sourceLine" id="cb7-6" title="6"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"S. klossi"</span>)</a>
+<a class="sourceLine" id="cb7-7" title="7"><span class="co">#&gt; [1] "Staphylococcus kloosii"</span></a></code></pre></div>
+<ul>
+<li>Uncertainty of the algorithm is now divided into four levels, 0 to 3, where the default <code>allow_uncertain = TRUE</code> is equal to uncertainty level 2. Run <code><a href="../reference/as.mo.html">?as.mo</a></code> for more info about these levels.</li>
+</ul>
+<div class="sourceCode" id="cb8"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb8-1" title="1"><span class="co"># equal:</span></a>
+<a class="sourceLine" id="cb8-2" title="2"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(..., <span class="dt">allow_uncertain =</span> <span class="ot">TRUE</span>)</a>
+<a class="sourceLine" id="cb8-3" title="3"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(..., <span class="dt">allow_uncertain =</span> <span class="dv">2</span>)</a>
+<a class="sourceLine" id="cb8-4" title="4"></a>
+<a class="sourceLine" id="cb8-5" title="5"><span class="co"># also equal:</span></a>
+<a class="sourceLine" id="cb8-6" title="6"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(..., <span class="dt">allow_uncertain =</span> <span class="ot">FALSE</span>)</a>
+<a class="sourceLine" id="cb8-7" title="7"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(..., <span class="dt">allow_uncertain =</span> <span class="dv">0</span>)</a></code></pre></div>
+Using <code><a href="../reference/as.mo.html">as.mo(..., allow_uncertain = 3)</a></code> could lead to very unreliable results.
+<ul>
+<li>Incoercible results will now be considered ‘unknown’, MO code <code>UNKNOWN</code>. On foreign systems, properties of these will be translated to all languages already previously supported: German, Dutch, French, Italian, Spanish and Portuguese:</li>
+</ul>
+<div class="sourceCode" id="cb9"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb9-1" title="1"><span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(<span class="st">"qwerty"</span>, <span class="dt">language =</span> <span class="st">"es"</span>)</a>
+<a class="sourceLine" id="cb9-2" title="2"><span class="co"># Warning: </span></a>
+<a class="sourceLine" id="cb9-3" title="3"><span class="co"># one unique value (^= 100.0%) could not be coerced and is considered 'unknown': "qwerty". Use mo_failures() to review it.</span></a>
+<a class="sourceLine" id="cb9-4" title="4"><span class="co">#&gt; [1] "(género desconocido)"</span></a></code></pre></div>
 <ul>
 <li>Fix for vector containing only empty values</li>
 <li>Finds better results when input is in other languages</li>
@@ -400,19 +421,19 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 <ul>
 <li>
 <p>Support for tidyverse quasiquotation! Now you can create frequency tables of function outcomes:</p>
-<div class="sourceCode" id="cb8"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb8-1" title="1"><span class="co"># Determine genus of microorganisms (mo) in `septic_patients` data set:</span></a>
-<a class="sourceLine" id="cb8-2" title="2"><span class="co"># OLD WAY</span></a>
-<a class="sourceLine" id="cb8-3" title="3">septic_patients <span class="op">%&gt;%</span></a>
-<a class="sourceLine" id="cb8-4" title="4"><span class="st">  </span><span class="kw">mutate</span>(<span class="dt">genus =</span> <span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(mo)) <span class="op">%&gt;%</span></a>
-<a class="sourceLine" id="cb8-5" title="5"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(genus)</a>
-<a class="sourceLine" id="cb8-6" title="6"><span class="co"># NEW WAY</span></a>
-<a class="sourceLine" id="cb8-7" title="7">septic_patients <span class="op">%&gt;%</span><span class="st"> </span></a>
-<a class="sourceLine" id="cb8-8" title="8"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(<span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(mo))</a>
-<a class="sourceLine" id="cb8-9" title="9"></a>
-<a class="sourceLine" id="cb8-10" title="10"><span class="co"># Even supports grouping variables:</span></a>
-<a class="sourceLine" id="cb8-11" title="11">septic_patients <span class="op">%&gt;%</span></a>
-<a class="sourceLine" id="cb8-12" title="12"><span class="st">  </span><span class="kw">group_by</span>(gender) <span class="op">%&gt;%</span><span class="st"> </span></a>
-<a class="sourceLine" id="cb8-13" title="13"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(<span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(mo))</a></code></pre></div>
+<div class="sourceCode" id="cb10"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb10-1" title="1"><span class="co"># Determine genus of microorganisms (mo) in `septic_patients` data set:</span></a>
+<a class="sourceLine" id="cb10-2" title="2"><span class="co"># OLD WAY</span></a>
+<a class="sourceLine" id="cb10-3" title="3">septic_patients <span class="op">%&gt;%</span></a>
+<a class="sourceLine" id="cb10-4" title="4"><span class="st">  </span><span class="kw">mutate</span>(<span class="dt">genus =</span> <span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(mo)) <span class="op">%&gt;%</span></a>
+<a class="sourceLine" id="cb10-5" title="5"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(genus)</a>
+<a class="sourceLine" id="cb10-6" title="6"><span class="co"># NEW WAY</span></a>
+<a class="sourceLine" id="cb10-7" title="7">septic_patients <span class="op">%&gt;%</span><span class="st"> </span></a>
+<a class="sourceLine" id="cb10-8" title="8"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(<span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(mo))</a>
+<a class="sourceLine" id="cb10-9" title="9"></a>
+<a class="sourceLine" id="cb10-10" title="10"><span class="co"># Even supports grouping variables:</span></a>
+<a class="sourceLine" id="cb10-11" title="11">septic_patients <span class="op">%&gt;%</span></a>
+<a class="sourceLine" id="cb10-12" title="12"><span class="st">  </span><span class="kw">group_by</span>(gender) <span class="op">%&gt;%</span><span class="st"> </span></a>
+<a class="sourceLine" id="cb10-13" title="13"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(<span class="kw"><a href="../reference/mo_property.html">mo_genus</a></span>(mo))</a></code></pre></div>
 </li>
 <li>Header info is now available as a list, with the <code>header</code> function</li>
 <li>The parameter <code>header</code> is now set to <code>TRUE</code> at default, even for markdown</li>
@@ -432,6 +453,7 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 </li>
 <li>Updated examples for resistance prediction (<code><a href="../reference/resistance_predict.html">resistance_predict()</a></code> function)</li>
 <li>Fix for <code><a href="../reference/as.mic.html">as.mic()</a></code> to support more values ending in (several) zeroes</li>
+<li>if using different lengths of pattern and x in <code>%like%</code>, it will now return the call</li>
 </ul>
 </div>
 <div id="other" class="section level4">
@@ -486,10 +508,10 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 <li>Fewer than 3 characters as input for <code>as.mo</code> will return NA</li>
 <li>
 <p>Function <code>as.mo</code> (and all <code>mo_*</code> wrappers) now supports genus abbreviations with “species” attached</p>
-<div class="sourceCode" id="cb9"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb9-1" title="1"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"E. species"</span>)        <span class="co"># B_ESCHR</span></a>
-<a class="sourceLine" id="cb9-2" title="2"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"E. spp."</span>)     <span class="co"># "Escherichia species"</span></a>
-<a class="sourceLine" id="cb9-3" title="3"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"S. spp"</span>)            <span class="co"># B_STPHY</span></a>
-<a class="sourceLine" id="cb9-4" title="4"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"S. species"</span>)  <span class="co"># "Staphylococcus species"</span></a></code></pre></div>
+<div class="sourceCode" id="cb11"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb11-1" title="1"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"E. species"</span>)        <span class="co"># B_ESCHR</span></a>
+<a class="sourceLine" id="cb11-2" title="2"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"E. spp."</span>)     <span class="co"># "Escherichia species"</span></a>
+<a class="sourceLine" id="cb11-3" title="3"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"S. spp"</span>)            <span class="co"># B_STPHY</span></a>
+<a class="sourceLine" id="cb11-4" title="4"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"S. species"</span>)  <span class="co"># "Staphylococcus species"</span></a></code></pre></div>
 </li>
 <li>Added parameter <code>combine_IR</code> (TRUE/FALSE) to functions <code>portion_df</code> and <code>count_df</code>, to indicate that all values of I and R must be merged into one, so the output only consists of S vs. IR (susceptible vs. non-susceptible)</li>
 <li>Fix for <code>portion_*(..., as_percent = TRUE)</code> when minimal number of isolates would not be met</li>
@@ -502,15 +524,15 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 <ul>
 <li>
 <p>Support for grouping variables, test with:</p>
-<div class="sourceCode" id="cb10"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb10-1" title="1">septic_patients <span class="op">%&gt;%</span><span class="st"> </span></a>
-<a class="sourceLine" id="cb10-2" title="2"><span class="st">  </span><span class="kw">group_by</span>(hospital_id) <span class="op">%&gt;%</span><span class="st"> </span></a>
-<a class="sourceLine" id="cb10-3" title="3"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(gender)</a></code></pre></div>
+<div class="sourceCode" id="cb12"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb12-1" title="1">septic_patients <span class="op">%&gt;%</span><span class="st"> </span></a>
+<a class="sourceLine" id="cb12-2" title="2"><span class="st">  </span><span class="kw">group_by</span>(hospital_id) <span class="op">%&gt;%</span><span class="st"> </span></a>
+<a class="sourceLine" id="cb12-3" title="3"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(gender)</a></code></pre></div>
 </li>
 <li>
 <p>Support for (un)selecting columns:</p>
-<div class="sourceCode" id="cb11"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb11-1" title="1">septic_patients <span class="op">%&gt;%</span><span class="st"> </span></a>
-<a class="sourceLine" id="cb11-2" title="2"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(hospital_id) <span class="op">%&gt;%</span><span class="st"> </span></a>
-<a class="sourceLine" id="cb11-3" title="3"><span class="st">  </span><span class="kw">select</span>(<span class="op">-</span>count, <span class="op">-</span>cum_count) <span class="co"># only get item, percent, cum_percent</span></a></code></pre></div>
+<div class="sourceCode" id="cb13"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb13-1" title="1">septic_patients <span class="op">%&gt;%</span><span class="st"> </span></a>
+<a class="sourceLine" id="cb13-2" title="2"><span class="st">  </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(hospital_id) <span class="op">%&gt;%</span><span class="st"> </span></a>
+<a class="sourceLine" id="cb13-3" title="3"><span class="st">  </span><span class="kw">select</span>(<span class="op">-</span>count, <span class="op">-</span>cum_count) <span class="co"># only get item, percent, cum_percent</span></a></code></pre></div>
 </li>
 <li>Check for <code><a href="https://www.rdocumentation.org/packages/hms/topics/hms">hms::is.hms</a></code>
 </li>
@@ -590,18 +612,18 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 </li>
 </ul>
 <p>They also come with support for German, Dutch, French, Italian, Spanish and Portuguese:</p>
-<div class="sourceCode" id="cb12"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb12-1" title="1"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"E. coli"</span>)</a>
-<a class="sourceLine" id="cb12-2" title="2"><span class="co"># [1] "Gram negative"</span></a>
-<a class="sourceLine" id="cb12-3" title="3"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"E. coli"</span>, <span class="dt">language =</span> <span class="st">"de"</span>) <span class="co"># German</span></a>
-<a class="sourceLine" id="cb12-4" title="4"><span class="co"># [1] "Gramnegativ"</span></a>
-<a class="sourceLine" id="cb12-5" title="5"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"E. coli"</span>, <span class="dt">language =</span> <span class="st">"es"</span>) <span class="co"># Spanish</span></a>
-<a class="sourceLine" id="cb12-6" title="6"><span class="co"># [1] "Gram negativo"</span></a>
-<a class="sourceLine" id="cb12-7" title="7"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"S. group A"</span>, <span class="dt">language =</span> <span class="st">"pt"</span>) <span class="co"># Portuguese</span></a>
-<a class="sourceLine" id="cb12-8" title="8"><span class="co"># [1] "Streptococcus grupo A"</span></a></code></pre></div>
+<div class="sourceCode" id="cb14"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb14-1" title="1"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"E. coli"</span>)</a>
+<a class="sourceLine" id="cb14-2" title="2"><span class="co"># [1] "Gram negative"</span></a>
+<a class="sourceLine" id="cb14-3" title="3"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"E. coli"</span>, <span class="dt">language =</span> <span class="st">"de"</span>) <span class="co"># German</span></a>
+<a class="sourceLine" id="cb14-4" title="4"><span class="co"># [1] "Gramnegativ"</span></a>
+<a class="sourceLine" id="cb14-5" title="5"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"E. coli"</span>, <span class="dt">language =</span> <span class="st">"es"</span>) <span class="co"># Spanish</span></a>
+<a class="sourceLine" id="cb14-6" title="6"><span class="co"># [1] "Gram negativo"</span></a>
+<a class="sourceLine" id="cb14-7" title="7"><span class="kw"><a href="../reference/mo_property.html">mo_fullname</a></span>(<span class="st">"S. group A"</span>, <span class="dt">language =</span> <span class="st">"pt"</span>) <span class="co"># Portuguese</span></a>
+<a class="sourceLine" id="cb14-8" title="8"><span class="co"># [1] "Streptococcus grupo A"</span></a></code></pre></div>
 <p>Furthermore, former taxonomic names will give a note about the current taxonomic name:</p>
-<div class="sourceCode" id="cb13"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb13-1" title="1"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"Esc blattae"</span>)</a>
-<a class="sourceLine" id="cb13-2" title="2"><span class="co"># Note: 'Escherichia blattae' (Burgess et al., 1973) was renamed 'Shimwellia blattae' (Priest and Barker, 2010)</span></a>
-<a class="sourceLine" id="cb13-3" title="3"><span class="co"># [1] "Gram negative"</span></a></code></pre></div>
+<div class="sourceCode" id="cb15"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb15-1" title="1"><span class="kw"><a href="../reference/mo_property.html">mo_gramstain</a></span>(<span class="st">"Esc blattae"</span>)</a>
+<a class="sourceLine" id="cb15-2" title="2"><span class="co"># Note: 'Escherichia blattae' (Burgess et al., 1973) was renamed 'Shimwellia blattae' (Priest and Barker, 2010)</span></a>
+<a class="sourceLine" id="cb15-3" title="3"><span class="co"># [1] "Gram negative"</span></a></code></pre></div>
 </li>
 <li>Functions <code>count_R</code>, <code>count_IR</code>, <code>count_I</code>, <code>count_SI</code> and <code>count_S</code> to selectively count resistant or susceptible isolates
 <ul>
@@ -612,18 +634,18 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 </li>
 <li>
 <p>Functions <code>as.mo</code> and <code>is.mo</code> as replacements for <code>as.bactid</code> and <code>is.bactid</code> (since the <code>microoganisms</code> data set not only contains bacteria). These last two functions are deprecated and will be removed in a future release. The <code>as.mo</code> function determines microbial IDs using intelligent rules:</p>
-<div class="sourceCode" id="cb14"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb14-1" title="1"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"E. coli"</span>)</a>
-<a class="sourceLine" id="cb14-2" title="2"><span class="co"># [1] B_ESCHR_COL</span></a>
-<a class="sourceLine" id="cb14-3" title="3"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"MRSA"</span>)</a>
-<a class="sourceLine" id="cb14-4" title="4"><span class="co"># [1] B_STPHY_AUR</span></a>
-<a class="sourceLine" id="cb14-5" title="5"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"S group A"</span>)</a>
-<a class="sourceLine" id="cb14-6" title="6"><span class="co"># [1] B_STRPTC_GRA</span></a></code></pre></div>
+<div class="sourceCode" id="cb16"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb16-1" title="1"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"E. coli"</span>)</a>
+<a class="sourceLine" id="cb16-2" title="2"><span class="co"># [1] B_ESCHR_COL</span></a>
+<a class="sourceLine" id="cb16-3" title="3"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"MRSA"</span>)</a>
+<a class="sourceLine" id="cb16-4" title="4"><span class="co"># [1] B_STPHY_AUR</span></a>
+<a class="sourceLine" id="cb16-5" title="5"><span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(<span class="st">"S group A"</span>)</a>
+<a class="sourceLine" id="cb16-6" title="6"><span class="co"># [1] B_STRPTC_GRA</span></a></code></pre></div>
 <p>And with great speed too - on a quite regular Linux server from 2007 it takes us less than 0.02 seconds to transform 25,000 items:</p>
-<div class="sourceCode" id="cb15"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb15-1" title="1">thousands_of_E_colis &lt;-<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/rep">rep</a></span>(<span class="st">"E. coli"</span>, <span class="dv">25000</span>)</a>
-<a class="sourceLine" id="cb15-2" title="2">microbenchmark<span class="op">::</span><span class="kw"><a href="https://www.rdocumentation.org/packages/microbenchmark/topics/microbenchmark">microbenchmark</a></span>(<span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(thousands_of_E_colis), <span class="dt">unit =</span> <span class="st">"s"</span>)</a>
-<a class="sourceLine" id="cb15-3" title="3"><span class="co"># Unit: seconds</span></a>
-<a class="sourceLine" id="cb15-4" title="4"><span class="co">#         min       median         max  neval</span></a>
-<a class="sourceLine" id="cb15-5" title="5"><span class="co">#  0.01817717  0.01843957  0.03878077    100</span></a></code></pre></div>
+<div class="sourceCode" id="cb17"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb17-1" title="1">thousands_of_E_colis &lt;-<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/rep">rep</a></span>(<span class="st">"E. coli"</span>, <span class="dv">25000</span>)</a>
+<a class="sourceLine" id="cb17-2" title="2">microbenchmark<span class="op">::</span><span class="kw"><a href="https://www.rdocumentation.org/packages/microbenchmark/topics/microbenchmark">microbenchmark</a></span>(<span class="kw"><a href="../reference/as.mo.html">as.mo</a></span>(thousands_of_E_colis), <span class="dt">unit =</span> <span class="st">"s"</span>)</a>
+<a class="sourceLine" id="cb17-3" title="3"><span class="co"># Unit: seconds</span></a>
+<a class="sourceLine" id="cb17-4" title="4"><span class="co">#         min       median         max  neval</span></a>
+<a class="sourceLine" id="cb17-5" title="5"><span class="co">#  0.01817717  0.01843957  0.03878077    100</span></a></code></pre></div>
 </li>
 <li>Added parameter <code>reference_df</code> for <code>as.mo</code>, so users can supply their own microbial IDs, name or codes as a reference table</li>
 <li>Renamed all previous references to <code>bactid</code> to <code>mo</code>, like:
@@ -651,12 +673,12 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 <li>Added three antimicrobial agents to the <code>antibiotics</code> data set: Terbinafine (D01BA02), Rifaximin (A07AA11) and Isoconazole (D01AC05)</li>
 <li>
 <p>Added 163 trade names to the <code>antibiotics</code> data set, it now contains 298 different trade names in total, e.g.:</p>
-<div class="sourceCode" id="cb16"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb16-1" title="1"><span class="kw"><a href="../reference/AMR-deprecated.html">ab_official</a></span>(<span class="st">"Bactroban"</span>)</a>
-<a class="sourceLine" id="cb16-2" title="2"><span class="co"># [1] "Mupirocin"</span></a>
-<a class="sourceLine" id="cb16-3" title="3"><span class="kw"><a href="../reference/AMR-deprecated.html">ab_name</a></span>(<span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(<span class="st">"Bactroban"</span>, <span class="st">"Amoxil"</span>, <span class="st">"Zithromax"</span>, <span class="st">"Floxapen"</span>))</a>
-<a class="sourceLine" id="cb16-4" title="4"><span class="co"># [1] "Mupirocin" "Amoxicillin" "Azithromycin" "Flucloxacillin"</span></a>
-<a class="sourceLine" id="cb16-5" title="5"><span class="kw"><a href="../reference/AMR-deprecated.html">ab_atc</a></span>(<span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(<span class="st">"Bactroban"</span>, <span class="st">"Amoxil"</span>, <span class="st">"Zithromax"</span>, <span class="st">"Floxapen"</span>))</a>
-<a class="sourceLine" id="cb16-6" title="6"><span class="co"># [1] "R01AX06" "J01CA04" "J01FA10" "J01CF05"</span></a></code></pre></div>
+<div class="sourceCode" id="cb18"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb18-1" title="1"><span class="kw"><a href="../reference/AMR-deprecated.html">ab_official</a></span>(<span class="st">"Bactroban"</span>)</a>
+<a class="sourceLine" id="cb18-2" title="2"><span class="co"># [1] "Mupirocin"</span></a>
+<a class="sourceLine" id="cb18-3" title="3"><span class="kw"><a href="../reference/AMR-deprecated.html">ab_name</a></span>(<span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(<span class="st">"Bactroban"</span>, <span class="st">"Amoxil"</span>, <span class="st">"Zithromax"</span>, <span class="st">"Floxapen"</span>))</a>
+<a class="sourceLine" id="cb18-4" title="4"><span class="co"># [1] "Mupirocin" "Amoxicillin" "Azithromycin" "Flucloxacillin"</span></a>
+<a class="sourceLine" id="cb18-5" title="5"><span class="kw"><a href="../reference/AMR-deprecated.html">ab_atc</a></span>(<span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(<span class="st">"Bactroban"</span>, <span class="st">"Amoxil"</span>, <span class="st">"Zithromax"</span>, <span class="st">"Floxapen"</span>))</a>
+<a class="sourceLine" id="cb18-6" title="6"><span class="co"># [1] "R01AX06" "J01CA04" "J01FA10" "J01CF05"</span></a></code></pre></div>
 </li>
 <li>For <code>first_isolate</code>, rows will be ignored when there’s no species available</li>
 <li>Function <code>ratio</code> is now deprecated and will be removed in a future release, as it is not really the scope of this package</li>
@@ -667,13 +689,13 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 </li>
 <li>
 <p>Support for quasiquotation in the functions series <code>count_*</code> and <code>portions_*</code>, and <code>n_rsi</code>. This allows to check for more than 2 vectors or columns.</p>
-<div class="sourceCode" id="cb17"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb17-1" title="1">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw">select</span>(amox, cipr) <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/count.html">count_IR</a></span>()</a>
-<a class="sourceLine" id="cb17-2" title="2"><span class="co"># which is the same as:</span></a>
-<a class="sourceLine" id="cb17-3" title="3">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/count.html">count_IR</a></span>(amox, cipr)</a>
-<a class="sourceLine" id="cb17-4" title="4"></a>
-<a class="sourceLine" id="cb17-5" title="5">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/portion.html">portion_S</a></span>(amcl)</a>
-<a class="sourceLine" id="cb17-6" title="6">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/portion.html">portion_S</a></span>(amcl, gent)</a>
-<a class="sourceLine" id="cb17-7" title="7">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/portion.html">portion_S</a></span>(amcl, gent, pita)</a></code></pre></div>
+<div class="sourceCode" id="cb19"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb19-1" title="1">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw">select</span>(amox, cipr) <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/count.html">count_IR</a></span>()</a>
+<a class="sourceLine" id="cb19-2" title="2"><span class="co"># which is the same as:</span></a>
+<a class="sourceLine" id="cb19-3" title="3">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/count.html">count_IR</a></span>(amox, cipr)</a>
+<a class="sourceLine" id="cb19-4" title="4"></a>
+<a class="sourceLine" id="cb19-5" title="5">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/portion.html">portion_S</a></span>(amcl)</a>
+<a class="sourceLine" id="cb19-6" title="6">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/portion.html">portion_S</a></span>(amcl, gent)</a>
+<a class="sourceLine" id="cb19-7" title="7">septic_patients <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/portion.html">portion_S</a></span>(amcl, gent, pita)</a></code></pre></div>
 </li>
 <li>Edited <code>ggplot_rsi</code> and <code>geom_rsi</code> so they can cope with <code>count_df</code>. The new <code>fun</code> parameter has value <code>portion_df</code> at default, but can be set to <code>count_df</code>.</li>
 <li>Fix for <code>ggplot_rsi</code> when the <code>ggplot2</code> package was not loaded</li>
@@ -687,12 +709,12 @@ These functions use <code><a href="../reference/as.atc.html">as.atc()</a></code>
 </li>
 <li>
 <p>Support for types (classes) list and matrix for <code>freq</code></p>
-<div class="sourceCode" id="cb18"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb18-1" title="1">my_matrix =<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/with">with</a></span>(septic_patients, <span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/matrix">matrix</a></span>(<span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(age, gender), <span class="dt">ncol =</span> <span class="dv">2</span>))</a>
-<a class="sourceLine" id="cb18-2" title="2"><span class="kw"><a href="../reference/freq.html">freq</a></span>(my_matrix)</a></code></pre></div>
+<div class="sourceCode" id="cb20"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb20-1" title="1">my_matrix =<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/with">with</a></span>(septic_patients, <span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/matrix">matrix</a></span>(<span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/c">c</a></span>(age, gender), <span class="dt">ncol =</span> <span class="dv">2</span>))</a>
+<a class="sourceLine" id="cb20-2" title="2"><span class="kw"><a href="../reference/freq.html">freq</a></span>(my_matrix)</a></code></pre></div>
 <p>For lists, subsetting is possible:</p>
-<div class="sourceCode" id="cb19"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb19-1" title="1">my_list =<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/list">list</a></span>(<span class="dt">age =</span> septic_patients<span class="op">$</span>age, <span class="dt">gender =</span> septic_patients<span class="op">$</span>gender)</a>
-<a class="sourceLine" id="cb19-2" title="2">my_list <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(age)</a>
-<a class="sourceLine" id="cb19-3" title="3">my_list <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(gender)</a></code></pre></div>
+<div class="sourceCode" id="cb21"><pre class="sourceCode r"><code class="sourceCode r"><a class="sourceLine" id="cb21-1" title="1">my_list =<span class="st"> </span><span class="kw"><a href="https://www.rdocumentation.org/packages/base/topics/list">list</a></span>(<span class="dt">age =</span> septic_patients<span class="op">$</span>age, <span class="dt">gender =</span> septic_patients<span class="op">$</span>gender)</a>
+<a class="sourceLine" id="cb21-2" title="2">my_list <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(age)</a>
+<a class="sourceLine" id="cb21-3" title="3">my_list <span class="op">%&gt;%</span><span class="st"> </span><span class="kw"><a href="../reference/freq.html">freq</a></span>(gender)</a></code></pre></div>
 </li>
 </ul>
 </div>
diff --git a/docs/reference/as.mo.html b/docs/reference/as.mo.html
index 30856766..095fbfe4 100644
--- a/docs/reference/as.mo.html
+++ b/docs/reference/as.mo.html
@@ -47,7 +47,7 @@
   <script src="../extra.js"></script>
 <meta property="og:title" content="Transform to microorganism ID — as.mo" />
 
-<meta property="og:description" content="Use this function to determine a valid microorganism ID (mo). Determination is done using intelligent rules and the complete taxonomic kingdoms Archaea, Bacteria, Protozoa, Viruses and most microbial species from the kingdom Fungi (see Source), so the input can be almost anything: a full name (like &quot;Staphylococcus aureus&quot;), an abbreviated name (like &quot;S. aureus&quot;), an abbreviation known in the field (like &quot;MRSA&quot;), or just a genus. You could also select a genus and species column, zie Examples." />
+<meta property="og:description" content="Use this function to determine a valid microorganism ID (mo). Determination is done using intelligent rules and the complete taxonomic kingdoms Bacteria, Chromista, Protozoa, Archaea, Viruses, and most microbial species from the kingdom Fungi (see Source). The input can be almost anything: a full name (like &quot;Staphylococcus aureus&quot;), an abbreviated name (like &quot;S. aureus&quot;), an abbreviation known in the field (like &quot;MRSA&quot;), or just a genus. Please see Examples." />
 
 <meta property="og:image" content="https://msberends.gitlab.io/AMR/logo.png" />
 <meta name="twitter:card" content="summary" />
@@ -80,7 +80,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
@@ -237,7 +237,7 @@
 
     <div class="ref-description">
     
-    <p>Use this function to determine a valid microorganism ID (<code>mo</code>). Determination is done using intelligent rules and the complete taxonomic kingdoms Archaea, Bacteria, Protozoa, Viruses and most microbial species from the kingdom Fungi (see Source), so the input can be almost anything: a full name (like <code>"Staphylococcus aureus"</code>), an abbreviated name (like <code>"S. aureus"</code>), an abbreviation known in the field (like <code>"MRSA"</code>), or just a genus. You could also <code>select</code> a genus and species column, zie Examples.</p>
+    <p>Use this function to determine a valid microorganism ID (<code>mo</code>). Determination is done using intelligent rules and the complete taxonomic kingdoms Bacteria, Chromista, Protozoa, Archaea, Viruses, and most microbial species from the kingdom Fungi (see Source). The input can be almost anything: a full name (like <code>"Staphylococcus aureus"</code>), an abbreviated name (like <code>"S. aureus"</code>), an abbreviation known in the field (like <code>"MRSA"</code>), or just a genus. Please see Examples.</p>
     
     </div>
 
@@ -271,7 +271,7 @@
     </tr>
     <tr>
       <th>allow_uncertain</th>
-      <td><p>a logical to indicate whether the input should be checked for less possible results, see Details</p></td>
+      <td><p>a logical (<code>TRUE</code> or <code>FALSE</code>) or a value between 0 and 3 to indicate whether the input should be checked for less possible results, see Details</p></td>
     </tr>
     <tr>
       <th>reference_df</th>
@@ -303,9 +303,9 @@
 <p>Use the <code><a href='mo_property.html'>mo_property</a></code> functions to get properties based on the returned code, see Examples.</p>
 <p><strong>Intelligent rules</strong> <br />
 This function uses intelligent rules to help getting fast and logical results. It tries to find matches in this order:</p><ul>
-<li><p>Taxonomic kingdom: it first searches in Bacteria, then Fungi, then Protozoa</p></li>
-<li><p>Human pathogenic prevalence: it first searches in more prevalent microorganisms, then less prevalent ones (see section <em>Microbial prevalence of pathogens in humans</em>)</p></li>
 <li><p>Valid MO codes and full names: it first searches in already valid MO code and known genus/species combinations</p></li>
+<li><p>Human pathogenic prevalence: it first searches in more prevalent microorganisms, then less prevalent ones (see <em>Microbial prevalence of pathogens in humans</em> below)</p></li>
+<li><p>Taxonomic kingdom: it first searches in Bacteria/Chromista, then Fungi, then Protozoa, then Viruses</p></li>
 <li><p>Breakdown of input values: from here it starts to breakdown input values to find possible matches</p></li>
 </ul>
     <p>A couple of effects because of these rules:</p><ul>
@@ -314,14 +314,17 @@ This function uses intelligent rules to help getting fast and logical results. I
 <li><p>Something like <code>"stau"</code> or <code>"S aur"</code> will return the ID of <em>Staphylococcus aureus</em> and not <em>Staphylococcus auricularis</em></p></li>
 </ul><p>This means that looking up human pathogenic microorganisms takes less time than looking up human non-pathogenic microorganisms.</p>
 <p><strong>Uncertain results</strong> <br />
-When using <code>allow_uncertain = TRUE</code> (which is the default setting), it will use additional rules if all previous rules failed to get valid results. These are:</p><ul>
-<li><p>It tries to look for previously accepted (but now invalid) taxonomic names</p></li>
-<li><p>It strips off values between brackets and the brackets itself, and re-evaluates the input with all previous rules</p></li>
-<li><p>It strips off words from the end one by one and re-evaluates the input with all previous rules</p></li>
-<li><p>It strips off words from the start one by one and re-evaluates the input with all previous rules</p></li>
-<li><p>It tries to look for some manual changes which are not (yet) published to the Catalogue of Life (like <em>Propionibacterium</em> being <em>Cutibacterium</em>)</p></li>
+The algorithm can additionally use three different levels of uncertainty to guess valid results. The default is <code>allow_uncertain = TRUE</code>, which is uqual to uncertainty level 2. Using <code>allow_uncertain = FALSE</code> will skip all of these additional rules:</p><ul>
+<li><p>(uncertainty level 1): It tries to look for only matching genera</p></li>
+<li><p>(uncertainty level 1): It tries to look for previously accepted (but now invalid) taxonomic names</p></li>
+<li><p>(uncertainty level 1): It tries to look for some manual changes which are not (yet) published to the Catalogue of Life (like <em>Propionibacterium</em> being <em>Cutibacterium</em>)</p></li>
+<li><p>(uncertainty level 2): It strips off values between brackets and the brackets itself, and re-evaluates the input with all previous rules</p></li>
+<li><p>(uncertainty level 2): It strips off words from the end one by one and re-evaluates the input with all previous rules</p></li>
+<li><p>(uncertainty level 3): It strips off words from the start one by one and re-evaluates the input with all previous rules</p></li>
+<li><p>(uncertainty level 3): It tries any part of the name</p></li>
 </ul>
-    <p>Examples:</p><ul>
+    <p>You can also use e.g. <code>as.mo(..., allow_uncertain = 1)</code> to only allow up to level 1 uncertainty.</p>
+<p>Examples:</p><ul>
 <li><p><code>"Streptococcus group B (known as S. agalactiae)"</code>. The text between brackets will be removed and a warning will be thrown that the result <em>Streptococcus group B</em> (<code>B_STRPT_GRB</code>) needs review.</p></li>
 <li><p><code>"S. aureus - please mind: MRSA"</code>. The last word will be stripped, after which the function will try to find a match. If it does not, the second last word will be stripped, etc. Again, a warning will be thrown that the result <em>Staphylococcus aureus</em> (<code>B_STPHY_AUR</code>) needs review.</p></li>
 <li><p><code>"Fluoroquinolone-resistant Neisseria gonorrhoeae"</code>. The first word will be stripped, after which the function will try to find a match. A warning will be thrown that the result <em>Neisseria gonorrhoeae</em> (<code>B_NESSR_GON</code>) needs review.</p></li>
@@ -330,7 +333,7 @@ When using <code>allow_uncertain = TRUE</code> (which is the default setting), i
 <p>Use <code>mo_uncertainties()</code> to get a data.frame with all values that were coerced to a valid value, but with uncertainty.</p>
 <p>Use <code>mo_renamed()</code> to get a vector with all values that could be coerced based on an old, previously accepted taxonomic name.</p>
 <p><strong>Microbial prevalence of pathogens in humans</strong> <br />
-The intelligent rules takes into account microbial prevalence of pathogens in humans. It uses three groups and every (sub)species is in the group it matches first. These groups are:</p><ul>
+The intelligent rules takes into account microbial prevalence of pathogens in humans. It uses three groups and all (sub)species are in only one group. These groups are:</p><ul>
 <li><p>1 (most prevalent): class is Gammaproteobacteria <strong>or</strong> genus is one of: <em>Enterococcus</em>, <em>Staphylococcus</em>, <em>Streptococcus</em>.</p></li>
 <li><p>2: phylum is one of: Proteobacteria, Firmicutes, Actinobacteria, Sarcomastigophora <strong>or</strong> genus is one of: <em>Aspergillus</em>, <em>Bacteroides</em>, <em>Candida</em>, <em>Capnocytophaga</em>, <em>Chryseobacterium</em>, <em>Cryptococcus</em>, <em>Elisabethkingia</em>, <em>Flavobacterium</em>, <em>Fusobacterium</em>, <em>Giardia</em>, <em>Leptotrichia</em>, <em>Mycoplasma</em>, <em>Prevotella</em>, <em>Rhodotorula</em>, <em>Treponema</em>, <em>Trichophyton</em>, <em>Ureaplasma</em>.</p></li>
 <li><p>3 (least prevalent): all others.</p></li>
@@ -374,6 +377,7 @@ The <code><a href='mo_property.html'>mo_property</a></code> functions (like <cod
 <span class='fu'>as.mo</span>(<span class='st'>"S aureus"</span>)
 <span class='fu'>as.mo</span>(<span class='st'>"Staphylococcus aureus"</span>)
 <span class='fu'>as.mo</span>(<span class='st'>"Staphylococcus aureus (MRSA)"</span>)
+<span class='fu'>as.mo</span>(<span class='st'>"Sthafilokkockus aaureuz"</span>) <span class='co'># handles incorrect spelling</span>
 <span class='fu'>as.mo</span>(<span class='st'>"MRSA"</span>) <span class='co'># Methicillin Resistant S. aureus</span>
 <span class='fu'>as.mo</span>(<span class='st'>"VISA"</span>) <span class='co'># Vancomycin Intermediate S. aureus</span>
 <span class='fu'>as.mo</span>(<span class='st'>"VRSA"</span>) <span class='co'># Vancomycin Resistant S. aureus</span>
diff --git a/docs/reference/filter_ab_class.html b/docs/reference/filter_ab_class.html
index 82e0c76d..e6387dad 100644
--- a/docs/reference/filter_ab_class.html
+++ b/docs/reference/filter_ab_class.html
@@ -80,7 +80,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/reference/index.html b/docs/reference/index.html
index 2ed17949..a99f2ee1 100644
--- a/docs/reference/index.html
+++ b/docs/reference/index.html
@@ -78,7 +78,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/reference/like.html b/docs/reference/like.html
index 1b0b35c4..18edf3f9 100644
--- a/docs/reference/like.html
+++ b/docs/reference/like.html
@@ -80,7 +80,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
diff --git a/docs/reference/microorganisms.codes.html b/docs/reference/microorganisms.codes.html
index 104b3c0c..0b071283 100644
--- a/docs/reference/microorganisms.codes.html
+++ b/docs/reference/microorganisms.codes.html
@@ -80,7 +80,7 @@
       </button>
       <span class="navbar-brand">
         <a class="navbar-link" href="../index.html">AMR (for R)</a>
-        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9021</span>
+        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0.9022</span>
       </span>
     </div>
 
@@ -245,7 +245,7 @@
         
     <h2 class="hasAnchor" id="format"><a class="anchor" href="#format"></a>Format</h2>
 
-    <p>A <code><a href='https://www.rdocumentation.org/packages/base/topics/data.frame'>data.frame</a></code> with 4,731 observations and 2 variables:</p><dl class='dl-horizontal'>
+    <p>A <code><a href='https://www.rdocumentation.org/packages/base/topics/data.frame'>data.frame</a></code> with 5,171 observations and 2 variables:</p><dl class='dl-horizontal'>
   <dt><code>certe</code></dt><dd><p>Commonly used code of a microorganism</p></dd>
   <dt><code>mo</code></dt><dd><p>ID of the microorganism in the <code><a href='microorganisms.html'>microorganisms</a></code> data set</p></dd>
 </dl>
diff --git a/man/as.mo.Rd b/man/as.mo.Rd
index a621d410..c6f9167a 100644
--- a/man/as.mo.Rd
+++ b/man/as.mo.Rd
@@ -31,7 +31,7 @@ mo_renamed()
 
   This excludes \emph{Enterococci} at default (who are in group D), use \code{Lancefield = "all"} to also categorise all \emph{Enterococci} as group D.}
 
-\item{allow_uncertain}{a logical to indicate whether the input should be checked for less possible results, see Details}
+\item{allow_uncertain}{a logical (\code{TRUE} or \code{FALSE}) or a value between 0 and 3 to indicate whether the input should be checked for less possible results, see Details}
 
 \item{reference_df}{a \code{data.frame} to use for extra reference when translating \code{x} to a valid \code{mo}. See \code{\link{set_mo_source}} and \code{\link{get_mo_source}} to automate the usage of your own codes (e.g. used in your analysis or organisation).}
 }
@@ -39,7 +39,7 @@ mo_renamed()
 Character (vector) with class \code{"mo"}. Unknown values will return \code{NA}.
 }
 \description{
-Use this function to determine a valid microorganism ID (\code{mo}). Determination is done using intelligent rules and the complete taxonomic kingdoms Archaea, Bacteria, Protozoa, Viruses and most microbial species from the kingdom Fungi (see Source), so the input can be almost anything: a full name (like \code{"Staphylococcus aureus"}), an abbreviated name (like \code{"S. aureus"}), an abbreviation known in the field (like \code{"MRSA"}), or just a genus. You could also \code{\link{select}} a genus and species column, zie Examples.
+Use this function to determine a valid microorganism ID (\code{mo}). Determination is done using intelligent rules and the complete taxonomic kingdoms Bacteria, Chromista, Protozoa, Archaea, Viruses, and most microbial species from the kingdom Fungi (see Source). The input can be almost anything: a full name (like \code{"Staphylococcus aureus"}), an abbreviated name (like \code{"S. aureus"}), an abbreviation known in the field (like \code{"MRSA"}), or just a genus. Please see Examples.
 }
 \details{
 A microbial ID from this package (class: \code{mo}) typically looks like these examples:\cr
@@ -65,9 +65,9 @@ Use the \code{\link{mo_property}} functions to get properties based on the retur
 \strong{Intelligent rules} \cr
 This function uses intelligent rules to help getting fast and logical results. It tries to find matches in this order:
 \itemize{
-  \item{Taxonomic kingdom: it first searches in Bacteria, then Fungi, then Protozoa}
-  \item{Human pathogenic prevalence: it first searches in more prevalent microorganisms, then less prevalent ones (see section \emph{Microbial prevalence of pathogens in humans})}
   \item{Valid MO codes and full names: it first searches in already valid MO code and known genus/species combinations}
+  \item{Human pathogenic prevalence: it first searches in more prevalent microorganisms, then less prevalent ones (see \emph{Microbial prevalence of pathogens in humans} below)}
+  \item{Taxonomic kingdom: it first searches in Bacteria/Chromista, then Fungi, then Protozoa, then Viruses}
   \item{Breakdown of input values: from here it starts to breakdown input values to find possible matches}
 }
 
@@ -80,15 +80,19 @@ A couple of effects because of these rules:
 This means that looking up human pathogenic microorganisms takes less time than looking up human non-pathogenic microorganisms.
 
 \strong{Uncertain results} \cr
-When using \code{allow_uncertain = TRUE} (which is the default setting), it will use additional rules if all previous rules failed to get valid results. These are:
+The algorithm can additionally use three different levels of uncertainty to guess valid results. The default is \code{allow_uncertain = TRUE}, which is uqual to uncertainty level 2. Using \code{allow_uncertain = FALSE} will skip all of these additional rules:
 \itemize{
-  \item{It tries to look for previously accepted (but now invalid) taxonomic names}
-  \item{It strips off values between brackets and the brackets itself, and re-evaluates the input with all previous rules}
-  \item{It strips off words from the end one by one and re-evaluates the input with all previous rules}
-  \item{It strips off words from the start one by one and re-evaluates the input with all previous rules}
-  \item{It tries to look for some manual changes which are not (yet) published to the Catalogue of Life (like \emph{Propionibacterium} being \emph{Cutibacterium})}
+  \item{(uncertainty level 1): It tries to look for only matching genera}
+  \item{(uncertainty level 1): It tries to look for previously accepted (but now invalid) taxonomic names}
+  \item{(uncertainty level 1): It tries to look for some manual changes which are not (yet) published to the Catalogue of Life (like \emph{Propionibacterium} being \emph{Cutibacterium})}
+  \item{(uncertainty level 2): It strips off values between brackets and the brackets itself, and re-evaluates the input with all previous rules}
+  \item{(uncertainty level 2): It strips off words from the end one by one and re-evaluates the input with all previous rules}
+  \item{(uncertainty level 3): It strips off words from the start one by one and re-evaluates the input with all previous rules}
+  \item{(uncertainty level 3): It tries any part of the name}
 }
 
+You can also use e.g. \code{as.mo(..., allow_uncertain = 1)} to only allow up to level 1 uncertainty.
+
 Examples:
 \itemize{
   \item{\code{"Streptococcus group B (known as S. agalactiae)"}. The text between brackets will be removed and a warning will be thrown that the result \emph{Streptococcus group B} (\code{B_STRPT_GRB}) needs review.}
@@ -103,7 +107,7 @@ Use \code{mo_uncertainties()} to get a data.frame with all values that were coer
 Use \code{mo_renamed()} to get a vector with all values that could be coerced based on an old, previously accepted taxonomic name.
 
 \strong{Microbial prevalence of pathogens in humans} \cr
-The intelligent rules takes into account microbial prevalence of pathogens in humans. It uses three groups and every (sub)species is in the group it matches first. These groups are:
+The intelligent rules takes into account microbial prevalence of pathogens in humans. It uses three groups and all (sub)species are in only one group. These groups are:
 \itemize{
   \item{1 (most prevalent): class is Gammaproteobacteria \strong{or} genus is one of: \emph{Enterococcus}, \emph{Staphylococcus}, \emph{Streptococcus}.}
   \item{2: phylum is one of: Proteobacteria, Firmicutes, Actinobacteria, Sarcomastigophora \strong{or} genus is one of: \emph{Aspergillus}, \emph{Bacteroides}, \emph{Candida}, \emph{Capnocytophaga}, \emph{Chryseobacterium}, \emph{Cryptococcus}, \emph{Elisabethkingia}, \emph{Flavobacterium}, \emph{Fusobacterium}, \emph{Giardia}, \emph{Leptotrichia}, \emph{Mycoplasma}, \emph{Prevotella}, \emph{Rhodotorula}, \emph{Treponema}, \emph{Trichophyton}, \emph{Ureaplasma}.}
@@ -146,6 +150,7 @@ as.mo("S. aureus")
 as.mo("S aureus")
 as.mo("Staphylococcus aureus")
 as.mo("Staphylococcus aureus (MRSA)")
+as.mo("Sthafilokkockus aaureuz") # handles incorrect spelling
 as.mo("MRSA") # Methicillin Resistant S. aureus
 as.mo("VISA") # Vancomycin Intermediate S. aureus
 as.mo("VRSA") # Vancomycin Resistant S. aureus
diff --git a/man/microorganisms.codes.Rd b/man/microorganisms.codes.Rd
index 2bb9fe22..46252cac 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 4,731 observations and 2 variables:
+\format{A \code{\link{data.frame}} with 5,171 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/tests/testthat/test-mo.R b/tests/testthat/test-mo.R
index 79aeb460..c4b535c3 100644
--- a/tests/testthat/test-mo.R
+++ b/tests/testthat/test-mo.R
@@ -80,10 +80,11 @@ test_that("as.mo works", {
               "staaur",
               "S. aureus",
               "S aureus",
+              "Sthafilokkockus aureeuzz",
               "Staphylococcus aureus",
               "MRSA",
               "VISA"))),
-    rep("B_STPHY_AUR", 8))
+    rep("B_STPHY_AUR", 9))
   expect_identical(
     as.character(
       as.mo(c('EHEC', 'EPEC', 'EIEC', 'STEC', 'ATEC'))),
@@ -229,7 +230,7 @@ test_that("as.mo works", {
     c("Microbacterium paraoxidans",
       "Streptococcus suis (bovis gr)",
       "Raoultella (here some text) terrigena")))),
-    c("B_MCRBC", "B_STRPT_SUI", "B_RLTLL_TER"))
+    c("B_MCRBC_PAR", "B_STRPT_SUI", "B_RLTLL_TER"))
   print(mo_uncertainties())
 
   # Salmonella (City) are all actually Salmonella enterica spp (City)