mergeSequenceTables: Merge two or more sample-by-sequence observation matrices.

Description Usage Arguments Value See Also Examples

View source: R/multiSample.R

Description

This function combines sequence tables together into one merged sequences table.

Usage

1
2
mergeSequenceTables(table1 = NULL, table2 = NULL, ..., tables = NULL,
  repeats = "error", orderBy = "abundance")

Arguments

table1

(Optional, default=NULL). Named integer matrix. Rownames correspond to samples and column names correspond to sequences. The output of makeSequenceTable.

table2

(Optional, default=NULL). Named integer matrix. Rownames correspond to samples and column names correspond to sequences. The output of makeSequenceTable.

...

(Optional). Additional sequence tables.

tables

(Optional, default=NULL). Either a list of sequence tables, or a list/vector of RDS filenames corresponding to sequence tables. If provided, table1, table2, and any additional arguments will be ignored.

repeats

(Optional). Default "error". Specifies how merging should proceed in the presence of repeated sample names. Valid values: "error", "sum". If "sum", then samples with the same name are summed together in the merged table.

orderBy

(Optional). character(1). Default "abundance". Specifies how the sequences (columns) of the returned table should be ordered (decreasing). Valid values: "abundance", "nsamples", NULL.

Value

Named integer matrix. A row for each sample, and a column for each unique sequence across all the samples. Note that the columns are named by the sequence which can make display unwieldy.

See Also

makeSequenceTable

Examples

1
2
3
4
5
6
7
8
## Not run: 
  mergetab <- mergeSequenceTables(seqtab1, seqtab2, seqtab3) # unnamed arguments are assumed to be individual sequence tables
  input_tables <- list(seqtab1, seqtab2, seqtab3)
  mergetab <- mergeSequenceTables(tables=input_tables) # list of sequence tables
  files <- c(file1, file2, file3)
  mergetab <- mergeSequenceTables(tables=files) # vector of filenames

## End(Not run)

dada2 documentation built on Nov. 1, 2018, 2:28 a.m.