ds.group_by: Group by one or more variables

View source: R/ds.group_by.R

ds.group_byR Documentation

Group by one or more variables

Description

DataSHIELD implentation of dplyr::group_by.

Usage

ds.group_by(
  df.name = NULL,
  tidy_expr,
  .add = FALSE,
  .drop = TRUE,
  newobj = NULL,
  datasources = NULL
)

Arguments

df.name

Character specifying a serverside data frame or tibble.

tidy_expr

List of variables or computations to group by.

.add

When FALSE, the default, group_by() will override existing groups. To add to the existing groups, use .add = TRUE.

.drop

Drop groups formed by factor levels that don't appear in the data? The default is TRUE except when .data has been previously grouped with .drop = FALSE.

newobj

Character specifying name for new server-side data frame.

datasources

DataSHIELD connections object.

Value

No return value, called for its side effects. A grouped data frame with class grouped_df newobj is created on the server, unless the combination of tidy_expr and .add yields a empty set of grouping columns, in which case a tibble will be created on the server.

Examples

## Not run: 
ds.group_by(
  df.name = "mtcars",
  expr = list(mpg, cyl),
  newobj = "grouped_df"
)

## End(Not run)

dsTidyverseClient documentation built on April 12, 2025, 1:55 a.m.