unite {tidySingleCellExperiment} | R Documentation |
Unite multiple columns into one by pasting strings together
Description
Convenience function to paste together multiple columns into one.
Given either a regular expression or a vector of character positions,
separate()
turns a single character column into multiple columns.
Arguments
data |
A data frame.
|
col |
The name of the new column, as a string or symbol.
This argument is passed by expression and supports
quasiquotation (you can unquote strings
and symbols). The name is captured from the expression with
rlang::ensym() (note that this kind of interface where
symbols do not represent actual objects is now discouraged in the
tidyverse; we support it here for backward compatibility).
|
... |
<tidy-select > Columns to unite
|
na.rm |
If TRUE , missing values will be remove prior to uniting
each value.
|
remove |
If TRUE , remove input columns from output data frame.
|
sep |
Separator between columns.
If character, sep is interpreted as a regular expression. The default
value is a regular expression that matches any sequence of
non-alphanumeric values.
If numeric, sep is interpreted as character positions to split at. Positive
values start at 1 at the far-left of the string; negative value start at -1 at
the far-right of the string. The length of sep should be one less than
into .
|
extra |
If sep is a character vector, this controls what
happens when there are too many pieces. There are three valid options:
"warn" (the default): emit a warning and drop extra values.
"drop": drop any extra values without a warning.
"merge": only splits at most length(into) times
|
fill |
If sep is a character vector, this controls what
happens when there are not enough pieces. There are three valid options:
"warn" (the default): emit a warning and fill from the right
"right": fill with missing values on the right
"left": fill with missing values on the left
|
Value
A tidySingleCellExperiment objector a tibble depending on input
A tidySingleCellExperiment objector a tibble depending on input
See Also
separate()
, the complement.
unite()
, the complement, extract()
which uses regular
expression capturing groups.
Examples
pbmc_small %>%
unite("new_col", c(orig.ident, groups))
un <- pbmc_small %>%
unite("new_col", c(orig.ident, groups))
un %>% separate(col=new_col, into=c("orig.ident", "groups"))
[Package
tidySingleCellExperiment version 1.2.1
Index]