group_split | R Documentation |
group_split()
works like base::split()
but
it uses the grouping structure from group_by()
and is therefore subject to the data mask
it does not name the elements of the list based on the grouping as this typically loses information and is confusing
group_split(.data, ..., .keep = TRUE)
group_keys(.data)
.data |
A |
... |
Grouping specification, forwarded to |
.keep |
|
Grouped data.frame
s:
The primary use case for group_split()
is with already groups data.frame
s, typically a result of group_by()
. In
this case, group_split()
only uses the first argument, the grouped data.frame
, and warns when ...
is used.
Because some of these groups may be empty, it is best paired with group_keys()
which identifies the representatives
of each grouping variable for the group.
Ungrouped data.frame
s:
When used on ungrouped data.frame
s, group_split()
forwards the ...
to group_by()
before the split, therefore
the ...
are subject to the data mask.
group_split()
returns a list of data.frame
s. Each data.frame
contains the rows of .data
with the associated
group and all the columns, including the grouping variables.
group_keys()
returns a data.frame
with one row per group, and one column per grouping variable
group_by()
# Grouped data.frames:
mtcars %>% group_by(cyl, am) %>% group_split()
mtcars %>% group_by(cyl, am) %>% group_split(.keep = FALSE)
mtcars %>% group_by(cyl, am) %>% group_keys()
# Ungrouped data.frames:
mtcars %>% group_split(am, cyl)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.