CyData: CyData class and methods

Description Details Getter functions for group-level data Getter functions for cell-level data Subsetting Author(s) Examples


The CyData class is derived from the SingleCellExperiment class. It is intended to store the cell counts for each group of cells (rows) for each sample (columns). Groups are intended to be hyperspheres (see countCells) but could also be arbitrary clusters of cells. It also stores the median intensities for each group and the identity of cells in the groups, parallel to the rows.


CyData objects should not be created directly by users. The class has some strict validity conditions that are not easily satisfied by manual construction. Users should rely on functions like prepareCellData and countCells to create the objects. An overview of the CyData class and the available methods.

Getter functions for group-level data

In the following code chunks, x or object are CyData objects. mode is a string specifying the types of markers that should be returned; this defaults to only those markers that are used in prepareCellData, but can also return the unused markers or all of them.

Getter functions for cell-level data

In the following code chunks, x is a CyData object and mode is as previously described.


The subsetting and combining behaviour of CyData objects is mostly the same as that of SingleCellExperiment objects. The only difference is that subsetting or combining CyData objects by column is not advisable. Indeed, attempting to do so will result in a warning from the associated methods. This is because the columns are usually not independent in contexts involving clustering cells across multiple samples. If a sample is to be removed, it is more appropriate to do so in the function that generates the CyData object (usually prepareCellData).


Aaron Lun



cydar documentation built on April 17, 2021, 6:01 p.m.