subsetTo,PharmacoSet-method {PharmacoGx} | R Documentation

## A function to subset a PharmacoSet to data containing only specified drugs, cells and genes

### Description

This is the prefered method of subsetting a PharmacoSet. This function allows abstraction of the data to the level of biologically relevant objects: drugs and cells. The function will automatically go through all of the combined data in the PharmacoSet and ensure only the requested drugs and cell lines are found in any of the slots. This allows quickly picking out all the experiments for a drug or cell of interest, as well removes the need to keep track of all the metadata conventions between different datasets.

### Usage

    ## S4 method for signature 'PharmacoSet'
    subsetTo(
      object,
      cells = NULL,
      drugs = NULL,
      molecular.data.cells = NULL,
      keep.controls = TRUE,
      ...
    )

### Arguments

`object` | A `PharmacoSet` to be subsetted
`cells` | A list or vector of cell names as used in the dataset to which the object will be subsetted. If left blank, then all cells will be left in the dataset.
`drugs` | A list or vector of drug names as used in the dataset to which the object will be subsetted. If left blank, then all drugs will be left in the dataset.
`molecular.data.cells` | A list or vector of cell names to keep in the molecular data
`keep.controls` | If the dataset has perturbation type experiments, should the controls be kept in the dataset? Defaults to true.
`...` | Other arguments passed by other function within the package

### Value

A PharmacoSet with only the selected drugs and cells

### Examples

    data(CCLEsmall)
    CCLEdrugs  <- drugNames(CCLEsmall)
    CCLEcells <- cellNames(CCLEsmall)
    pSet <- subsetTo(CCLEsmall, drugs = CCLEdrugs[1], cells = CCLEcells[1])
    pSet

[Package PharmacoGx version 2.4.0 Index]