1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98
|
\name{makeTxDbFromEnsembl}
\alias{makeTxDbFromEnsembl}
\title{
Make a TxDb object from an Ensembl database
}
\description{
The \code{makeTxDbFromEnsembl} function creates a
\link[GenomicFeatures]{TxDb} object for a given organism by importing
the genomic locations of its transcripts, exons, CDS, and genes from an
Ensembl database.
Note that it uses the \pkg{RMariaDB} package internally so make sure
that this package is installed.
}
\usage{
makeTxDbFromEnsembl(organism="Homo sapiens",
release=NA,
circ_seqs=NULL,
server="ensembldb.ensembl.org",
username="anonymous", password=NULL, port=0L,
tx_attrib=NULL)
}
\arguments{
\item{organism}{
The \emph{scientific name} (i.e. genus and species, or genus and species
and subspecies) of the organism for which to import the data.
Case is not sensitive. Underscores can be used instead of white spaces
e.g. \code{"homo_sapiens"} is accepted.
}
\item{release}{
The Ensembl release to query e.g. 89. If set to \code{NA} (the default),
the current release is used.
}
\item{circ_seqs}{
A character vector to list out which chromosomes should be marked
as circular.
}
\item{server}{
The name of the MySQL server to query.
See \url{https://www.ensembl.org/info/data/mysql.html} for the list of
Ensembl public MySQL servers.
Make sure to use the server nearest to you. It can make a big difference!
}
\item{username}{
Login username for the MySQL server.
}
\item{password}{
Login password for the MySQL server.
}
\item{port}{
Port of the MySQL server.
}
\item{tx_attrib}{
If not \code{NULL}, only select transcripts with an attribute of
the given code, a string, like \code{"gencode_basic"}.
}
}
\value{
A \link[GenomicFeatures]{TxDb} object.
}
\note{
\code{makeTxDbFromEnsembl} tends to be faster and more reliable than
\code{\link{makeTxDbFromBiomart}}.
}
\author{H. Pagès}
\seealso{
\itemize{
\item \code{\link{makeTxDbFromUCSC}} and \code{\link{makeTxDbFromBiomart}}
for making a \link[GenomicFeatures]{TxDb} object from other online
resources.
\item \code{\link{makeTxDbFromGRanges}} and \code{\link{makeTxDbFromGFF}}
for making a \link[GenomicFeatures]{TxDb} object from a
\link[GenomicRanges]{GRanges} object, or from a GFF or GTF file.
\item \link[GenomicFeatures]{TxDb} objects implemented in the
\pkg{GenomicFeatures} package.
\item \code{\link{makeTxDb}} for the low-level function used
by the \code{makeTxDbFrom*} functions to make the
\link[GenomicFeatures]{TxDb} object returned to the user.
}
}
\examples{
txdb <- makeTxDbFromEnsembl("Saccharomyces cerevisiae",
server="useastdb.ensembl.org")
txdb
}
|