dsTidyverseClient (version 1.0.3)

ds.bind_rows: Bind multiple data frames by row.

Description

DataSHIELD implementation of dplyr::bind_rows.

Usage

ds.bind_rows(to_combine = NULL, .id = NULL, newobj = NULL, datasources = NULL)

Value

No return value, called for its side effects. A data frame with the name specified by newobj and the same type as the first element of to_combine is created on the server.

Arguments

to_combine

Data frames to combine. Each argument can either be a data frame, a list that could be a data frame, or a list of data frames. Columns are matched by name, and any missing columns will be filled with NA.

.id

The name of an optional identifier column. Provide a string to create an output column that identifies each input. The column will use names if available, otherwise it will use positions.

newobj

Character specifying name for new server-side data frame.

datasources

datashield connections object.

Examples

if (FALSE) {
## First log in to a DataSHIELD session with mtcars dataset loaded.

ds.bind_rows(
  to_combine = list(mtcars, mtcars),
  newobj = "test",
  datasources = conns
)

## Refer to the package vignette for more examples.
}