ds.filter: Keep rows that match a condition

In dsTidyverseClient: 'DataSHIELD' 'Tidyverse' Clientside Package

Keep rows that match a condition

Description

DataSHIELD implentation of dplyr::filter.

Usage

ds.filter(
  df.name = NULL,
  tidy_expr = NULL,
  .by = NULL,
  .preserve = FALSE,
  newobj = NULL,
  datasources = NULL
)

Arguments

df.name	Character specifying a serverside data frame or tibble.
tidy_expr	List of expressions that return a logical value, and are defined in terms of the variables in df.name.
.by	Optionally, a selection of columns to group by for just this operation, functioning as an alternative to dplyr::group_by
.preserve	Relevant when the .data input is grouped. If .preserve = FALSE (the default), the grouping structure is recalculated based on the resulting data, otherwise the grouping is kept as is.
newobj	Character specifying name for new server-side data frame.
datasources	DataSHIELD connections object.

Value

No return value, called for its side effects. An object (typically a data frame or tibble) with the name specified by newobj is created on the server.

Examples

## Not run: 
ds.filter(
  df.name = "mtcars",
  tidy_expr = list(cyl == 4 & mpg > 20),
  newobj = "filtered",
  datasources = conns
)

## End(Not run)

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