mirror of https://github.com/msberends/AMR.git
47 lines
2.4 KiB
R
47 lines
2.4 KiB
R
% Generated by roxygen2: do not edit by hand
|
|
% Please edit documentation in R/bug_drug_combinations.R
|
|
\name{bug_drug_combinations}
|
|
\alias{bug_drug_combinations}
|
|
\alias{format.bug_drug_combinations}
|
|
\title{Determine bug-drug combinations}
|
|
\source{
|
|
\strong{M39 Analysis and Presentation of Cumulative Antimicrobial Susceptibility Test Data, 4th Edition}, 2014, \emph{Clinical and Laboratory Standards Institute (CLSI)}. \url{https://clsi.org/standards/products/microbiology/documents/m39/}.
|
|
}
|
|
\usage{
|
|
bug_drug_combinations(x, col_mo = NULL, minimum = 30)
|
|
|
|
\method{format}{bug_drug_combinations}(x, combine_IR = FALSE,
|
|
add_ab_group = TRUE, ...)
|
|
}
|
|
\arguments{
|
|
\item{x}{data with antibiotic columns, like e.g. \code{AMX} and \code{AMC}}
|
|
|
|
\item{col_mo}{column name of the IDs of the microorganisms (see \code{\link{as.mo}}), defaults to the first column of class \code{mo}. Values will be coerced using \code{\link{as.mo}}.}
|
|
|
|
\item{minimum}{the minimum allowed number of available (tested) isolates. Any isolate count lower than \code{minimum} will return \code{NA} with a warning. The default number of \code{30} isolates is advised by the Clinical and Laboratory Standards Institute (CLSI) as best practice, see Source.}
|
|
|
|
\item{combine_IR}{logical to indicate whether values R and I should be summed}
|
|
|
|
\item{add_ab_group}{logical to indicate where the group of the antimicrobials must be included as a first column}
|
|
|
|
\item{...}{argumments passed on to \code{\link{mo_name}}}
|
|
}
|
|
\description{
|
|
Determine antimicrobial resistance (AMR) of all bug-drug combinations in your data set where at least 30 (default) isolates are available per species. Use \code{format} on the result to prettify it to a printable format, see Examples.
|
|
}
|
|
\details{
|
|
The function \code{format} calculates the resistance per bug-drug combination. Use \code{combine_IR = FALSE} (default) to test R vs. S+I and \code{combine_IR = TRUE} to test R+I vs. S.
|
|
}
|
|
\section{Read more on our website!}{
|
|
|
|
On our website \url{https://msberends.gitlab.io/AMR} you can find \href{https://msberends.gitlab.io/AMR/articles/AMR.html}{a tutorial} about how to conduct AMR analysis, the \href{https://msberends.gitlab.io/AMR/reference}{complete documentation of all functions} (which reads a lot easier than here in R) and \href{https://msberends.gitlab.io/AMR/articles/WHONET.html}{an example analysis using WHONET data}.
|
|
}
|
|
|
|
\examples{
|
|
\donttest{
|
|
x <- bug_drug_combinations(example_isolates)
|
|
x
|
|
format(x)
|
|
}
|
|
}
|