Learn R Programming

RnBeads (version 1.4.0)

rnb.load.annotation: rnb.load.annotation

Description

Loads a previously saved custom region annotation from a binary (RData) file.

Usage

rnb.load.annotation(fname, type)

Arguments

fname
One-element character vector giving the name of the file that contains the annotation data.
type
One-element character vector giving the name of the region annotation. If this annotation is already available, it will be overwritten for the current session.

Value

Invisibly, TRUE if the annotation was loaded successfully; an error message if the objects in the given file do not encode an annotation.

Details

If the region annotation cannot be loaded from the specified location, this function exits with an error message in the form "unable to load object from ...". This could happen, for example, when fname does not refer to a valid RData file, or the file cannot be accessed due to security restrictions.

If the file is loaded in the current session, but no annotation was added, the function returns invisibly one of the following short failure messages:

"invalid format"
The RData file does not store exactly the following three objects - assembly, regions, and mapping, or they are not of the expected type.

"unsupported assembly"
The specified assembly is unknown.

"invalid format of regions"
The specified region annotation table is invalid.

"invalid format of mappings"
The specified region mapping tables are invalid.

See Also

rnb.save.annotation for saving annotation to a binary file; rnb.set.annotation for loading an annotation from a BED file.