Learn R Programming

NMF (version 0.20.6)

.atrack: Annotation Tracks

Description

.atrack is an S4 generic method that converts an object into an annotation track object. It provides a general and flexible annotation framework that is used by aheatmap to annotates heatmap rows and columns.

is.atrack tests if an object is an annotationTrack object.

adata get/sets the annotation parameters on an object

amargin get/sets the annotation margin, i.e. along which dimension of the data the annotations are to be considered.

anames returns the reference margin names for annotation tracks, from their embedded annotation data object.

alength returns the reference length for annotation tracks, from their embedded annotation data object

atrack creates/concatenates annotationTrack objects

annotationTrack is constructor function for annotationTrack object

Usage

.atrack(object, ...)
is.atrack(x)
adata(x, value, ...)
amargin(x, value)
anames(x, default.margin)
alength(x, default.margin)
".atrack"(object, data = NULL, ...)
atrack(..., order = NULL, enforceNames = FALSE, .SPECIAL = NA, .DATA = NULL, .CACHE = NULL)
annotationTrack(x = list())

Arguments

object
an object from which is extracted annotation tracks
...
extra arguments to allow extensions and passed to the next method call. For atrack, arguments in ... are concatenated into a single annotationTrack object.
x
an R object
value
replacement value for the complete annotation data list
default.margin
margin to use if no margin data is stored in the x.
data
object used to extend the annotation track within a given data context. It is typically a matrix-like object, against which annotation specifications are matched using match_atrack.
order
an integer vector that indicates the order of the annotation tracks in the result list
enforceNames
logical that indicates if missing track names should be generated as X
.SPECIAL
an optional list of functions (with no arguments) that are called to generate special annotation tracks defined by codes of the form ':NAME'. e.g., the function link{consensusmap} defines special tracks ':basis' and ':consensus'.

If .SPECIAL=FALSE, then any special tracks is discarded and a warning is thrown.

.DATA
data used to match and extend annotation specifications. It is passed to argument data of the .atrack methods, which in turn use pass it to match_atrack.
.CACHE
an annotationTrack object with which the generated annotation track should be consistent. This argument is more for internal/advanced usage and should not be used by the end-user.

Value

atrack returns a list, decorated with class 'annotationTrack', where each element contains the description of an annotation track.

Methods

.atrack
signature(object = "ANY"): The default method converts character or integer vectors into factors. Numeric vectors, factors, a single NA or annotationTrack objects are returned unchanged (except from reordering by argument order). Data frames are not changed either, but class 'annotationTrack' is appended to their original class set.

Details

Methods for .atrack exist for common type of objects, which should provide enough options for new methods to define how annotation track are extracted from more complex objects, by coercing/filtering them into a supported type.