GenomeDescription-class {GenomeInfoDb} | R Documentation |
GenomeDescription objects
Description
A GenomeDescription object holds the meta information describing a given genome.
Constructor
Even though a constructor function is provided (GenomeDescription()
),
it is rarely needed
GenomeDescription objects are typically obtained by coercing a
BSgenome object to GenomeDescription. This has the
effect of stripping the sequences from the object and retaining only
the meta information that describes the genome. See the Examples section
below for an example.
Accessor methods
In the code snippets below, object
or x
is a
GenomeDescription object.
-
organism(object)
: Return the scientific name of the organism of the genome e.g."Homo sapiens"
,"Mus musculus"
,"Caenorhabditis elegans"
, etc... -
commonName(object)
: Return the common name of the organism of the genome e.g."Human"
,"Mouse"
,"Worm"
, etc... -
providerVersion(x)
: Return the name of the genome. This is typically the name of an NCBI assembly (e.g.GRCh38.p13
,WBcel235
,TAIR10.1
,ARS-UCD1.2
, etc...) or UCSC genome (e.g.hg38
,bosTau9
,galGal6
,ce11
, etc...). -
provider(x)
: Return the provider of this genome e.g."UCSC"
,"BDGP"
,"FlyBase"
, etc... -
releaseDate(x)
: Return the release date of this genome e.g."Mar. 2006"
. -
releaseName(x)
: IMPORTANT NOTE: After being deprecated in Bioconductor 3.12, thereleaseName()
methods for GenomeDescription and BSgenome objects are defunct in Bioconductor 3.15!If
x
is a GenomeDescription object,releaseName(x)
returns the release name of this genome, which is usually made of the name of the organization who assembled it plus its Build version. For example, UCSC uses"hg18"
for the version of the Human genome corresponding to the Build 36.1 from NCBI hence the release name for this genome is"NCBI Build 36.1"
.If
x
is a BSgenome object,releaseName(x)
returnsNA_character_
. -
bsgenomeName(x)
: Uses the meta information stored in GenomeDescription objectx
to construct the name of the corresponding BSgenome data package (see theavailable.genomes
function in the BSgenome package for details about the naming scheme used for those packages). Note that there is no guarantee that a package with that name actually exists. seqinfo(x)
-
Gets information about the genome sequences. This information is returned in a Seqinfo object. Each part of the information can be retrieved separately with
seqnames(x)
,seqlengths(x)
, andisCircular(x)
, respectively, as described below. seqnames(x)
-
Gets the names of the genome sequences.
seqnames(x)
is equivalent toseqnames(seqinfo(x))
. seqlengths(x)
-
Gets the lengths of the genome sequences.
seqlengths(x)
is equivalent toseqlengths(seqinfo(x))
. isCircular(x)
-
Returns the circularity flags of the genome sequences.
isCircular(x)
is equivalent toisCircular(seqinfo(x))
.
Author(s)
H. Pagès
See Also
The
available.genomes
function and the BSgenome class in the BSgenome package.The Seqinfo class.
Examples
library(BSgenome.Celegans.UCSC.ce2)
BSgenome.Celegans.UCSC.ce2
as(BSgenome.Celegans.UCSC.ce2, "GenomeDescription")