Main Content

featureNames

Class: bioma.ExpressionSet
Package: bioma

Retrieve or set feature names in ExpressionSet object

Syntax

FeatNames = featureNames(ESObj)
FeatNames = featureNames(ESObj, Subset)
NewESObj = featureNames(ESObj, Subset, NewFeatNames)

Description

FeatNames = featureNames(ESObj) returns a cell array of character vectors specifying all feature names in an ExpressionSet object.

FeatNames = featureNames(ESObj, Subset) returns a cell array of character vectors specifying a subset the feature names in an ExpressionSet object.

NewESObj = featureNames(ESObj, Subset, NewFeatNames) replaces the feature names specified by Subset in ESObj, an ExpressionSet object, with NewFeatNames, and returns NewESObj, a new ExpressionSet object.

Input Arguments

ESObj

Object of the bioma.ExpressionSet class.

Subset

One of the following to specify a subset of the feature names in an ExpressionSet object:

  • Character vector or string specifying a feature name

  • Cell array of character vectors or string vector specifying feature names

  • Positive integer

  • Vector of positive integers

  • Logical vector

NewFeatNames

New feature names for specific feature names within an ExpressionSet object, specified by one of the following:

  • Numeric vector

  • Cell array of character vectors or string vector

  • Character vector or string, which featureNames uses as a prefix for the feature names, with feature numbers appended to the prefix

  • Logical true or false (default). If true, featureNames assigns unique feature names using the format Feature1, Feature2, etc.

The number of feature names in NewFeatNames must equal the number of features specified by Subset.

Output Arguments

FeatNames

Cell array of character vectors specifying all or some of the feature names in an ExpressionSet object. The feature names are the row names in the DataMatrix objects in the ExpressionSet object. The feature names are also the row names of the VarValues dataset array in the MetaData object in the ExpressionSet object.

NewESObj

Object of the bioma.ExpressionSet class, returned after replacing specific feature names.