.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
.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())
atrack
, arguments in
...
are concatenated into a single
annotationTrack
object.x
.match_atrack
.X
':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
of
the .atrack
methods, which in turn use pass it to
match_atrack
.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.atrack
returns a list, decorated with class
'annotationTrack'
, where each element contains the
description of an annotation track.
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. .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.