Append data sets

DESCRIPTION:

Append two or more data sets, by rows.

This function requires the bigdata library section to be loaded.

USAGE:

bd.append(data, all.columns = T)

REQUIRED ARGUMENTS:

data
Input data set or list of data sets: bdFrame(s) or data.frame(s).

OPTIONAL ARGUMENTS:

all.columns
Determines whether unmatched columns are included in the output for each data set. If TRUE, include columns from input with keys that do not match other inputs. If FALSE, exclude unmatched columns.

VALUE:

A bdFrame or data.frame containing the rows from each input stored in data. If all inputs in data are data.frame objects, then the result is a data.frame; otherwise, the result is a bdFrame.

DETAILS:

This function simply appends two or more data sets.

The output includes all rows contained in all input data sets.

By default, the output includes all columns contained in all input data sets. To change this default, change all.columns to select which input columns to exclude from the output.

If you include unmatched columns, they contain NA values for the columns from inputs that do not match.

EXAMPLES:

## Append three data sets, including all unmatched columns.
## The first five rows contain X,Y,Z columns with NA.
## The second five rows contain NAs except for Fuel and X.
## The third five rows contain NAs except for Fuel and Y.
## The fourth five rows contain NAs except for Fuel, X and Z.
bd.append(data=list(fuel.frame[1:5,],
                              data.frame(X=1:5, Fuel=rnorm(5)),
                              data.frame(Y=1:5, Fuel=rnorm(5)),
                              data.frame(X=6:10, Z=1:5, Fuel=rnorm(5))))

## Append two data sets, excluding all unmatched columns.
## The result only has one column, Fuel.
bd.append(data=list(fuel.frame[1:5,],
                              data.frame(X=1:5, Fuel=rnorm(5)),
                              data.frame(Y=1:5, Fuel=rnorm(5)),
                              data.frame(X=6:10, Z=1:5, Fuel=rnorm(5))),
                   all=rep(F, 4))