add mapping from informal to formal cell type tags to a SummarizedExperiment colData

bind_formal_tags(se, informal, tagmap, force = FALSE)

Arguments

se

SummarizedExperiment instance

informal

character(1) name of colData element with uncontrolled vocabulary

tagmap

data.frame with columns 'informal' and 'formal'

force

logical(1), defaults to FALSE; if TRUE, allows clobbering existing colData variable named "formal"

Value

SummarizedExperiment instance with a new colData column 'label.ont' giving the formal tags associated with each sample

Note

This function will fail if the value of `informal` is not among the colData variable names, or if "formal" is among the colData variable names.