rbindNamedList {MIRA} | R Documentation

## Combine data.tables from a named list into one big data.table with extra column for name.

### Description

Combines data.tables from a list as data.table::rbindlist except an extra column is added which can mark which rows came from which original data.table. The name of this new column can be specified (newColName param) and the values are the names of the input list. This function was originally intended for a list where each data.table corresponds to a separate sample and the list names correspond to the names of the samples. Now all samples can be combined into one data.table but which sample the information came from can be kept.

### Usage

    rbindNamedList(namedList, newColName = "sampleName")

### Arguments

`namedList` | A list of data.tables. One sample per data.table/list item. Names of the list are the sample names.
`newColName` | The name of the column that will be added to the data.tables

### Value

mergedDT A single data.table that combines those in the input list (data.table::rbindlist) but also added a column (default, newColName="sampleName") to each one to keep track of which rows were from which sample

### Examples

    # NOTE: generally sample names should be added after running aggregateMethyl()
    # rather than before in order to save memory (since data.table has less rows
    # after aggregation)
    data(exampleBSseqObj)
    multiSampleList <- bsseqToDataTable(exampleBSseqObj)
    combinedDT <- rbindNamedList(multiSampleList)

[Package MIRA version 1.4.1 Index]