AMR/man/join.Rd

57 lines
2.3 KiB
Plaintext
Raw Normal View History

2018-02-21 11:52:31 +01:00
% Generated by roxygen2: do not edit by hand
2018-07-23 14:14:03 +02:00
% Please edit documentation in R/join_microorganisms.R
2018-02-21 11:52:31 +01:00
\name{join}
\alias{join}
\alias{inner_join_microorganisms}
2018-02-21 11:52:31 +01:00
\alias{inner_join}
\alias{left_join_microorganisms}
\alias{right_join_microorganisms}
\alias{full_join_microorganisms}
\alias{semi_join_microorganisms}
\alias{anti_join_microorganisms}
\title{Join a table with \code{microorganisms}}
2018-02-21 11:52:31 +01:00
\usage{
inner_join_microorganisms(x, by = "bactid", suffix = c("2", ""), ...)
2018-02-21 11:52:31 +01:00
left_join_microorganisms(x, by = "bactid", suffix = c("2", ""), ...)
2018-02-21 11:52:31 +01:00
right_join_microorganisms(x, by = "bactid", suffix = c("2", ""), ...)
2018-02-21 11:52:31 +01:00
full_join_microorganisms(x, by = "bactid", suffix = c("2", ""), ...)
2018-02-21 11:52:31 +01:00
semi_join_microorganisms(x, by = "bactid", ...)
2018-02-21 11:52:31 +01:00
anti_join_microorganisms(x, by = "bactid", ...)
2018-02-21 11:52:31 +01:00
}
\arguments{
\item{x}{existing table to join, also supports character vectors}
2018-02-21 11:52:31 +01:00
\item{by}{a variable to join by - could be a column name of \code{x} with values that exist in \code{microorganisms$bactid} (like \code{by = "bacteria_id"}), or another column in \code{\link{microorganisms}} (but then it should be named, like \code{by = c("my_genus_species" = "fullname")})}
2018-02-21 11:52:31 +01:00
\item{suffix}{if there are non-joined duplicate variables in \code{x} and \code{y}, these suffixes will be added to the output to disambiguate them. Should be a character vector of length 2.}
2018-02-27 20:01:02 +01:00
\item{...}{other parameters to pass on to \code{dplyr::\link[dplyr]{join}}.}
2018-02-21 11:52:31 +01:00
}
\description{
Join the dataset \code{\link{microorganisms}} easily to an existing table or character vector.
2018-02-21 11:52:31 +01:00
}
\details{
As opposed to the \code{\link[dplyr]{join}} functions of \code{dplyr}, characters vectors are supported and at default existing columns will get a suffix \code{"2"} and the newly joined columns will not get a suffix. See \code{\link[dplyr]{join}} for more information.
2018-02-21 11:52:31 +01:00
}
2018-02-22 20:48:48 +01:00
\examples{
left_join_microorganisms("STAAUR")
library(dplyr)
septic_patients \%>\% left_join_microorganisms()
2018-02-22 20:48:48 +01:00
df <- data.frame(date = seq(from = as.Date("2018-01-01"),
to = as.Date("2018-01-07"),
by = 1),
bacteria_id = c("STAAUR", "STAAUR", "STAAUR", "STAAUR",
"ESCCOL", "ESCCOL", "ESCCOL"),
stringsAsFactors = FALSE)
colnames(df)
df2 <- left_join_microorganisms(df, "bacteria_id")
2018-02-22 20:48:48 +01:00
colnames(df2)
}