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
|
\name{read.gff}
\alias{read.gff}
\title{Read GFF Files}
\description{
This function reads a file in general feature format version 3 (GFF3)
and returns a data frame.
}
\usage{
read.gff(file, na.strings = c(".", "?"), GFF3 = TRUE)
}
\arguments{
\item{file}{a file name specified by a character string.}
\item{na.strings}{the strings in the GFF file that will be converted
as NA's (missing values).}
\item{GFF3}{a logical value specifying whether if the file is
formatted according to version 3 of GFF.}
}
\details{
The returned data frame has its (column) names correctly set (see
References) and the categorical variables (seqid, source, type,
strand, and phase) set as factors.
This function should be more efficient than using \code{read.delim}.
GFF2 (aka GTF) files can also be read: use \code{GFF3 = FALSE} to have
the correct field names. Note that GFF2 files and GFF3 files have the
same structure, although some fields are slightly different (see
reference).
The file can be gz-compressed (see examples), but not zipped.
}
\value{NULL}
\author{Emmanuel Paradis}
\references{
\url{https://en.wikipedia.org/wiki/General_feature_format}
}
\examples{
\dontrun{
## requires to be connected on Internet
d <- "https://ftp.ensembl.org/pub/release-86/gff3/homo_sapiens/"
f <- "Homo_sapiens.GRCh38.86.chromosome.MT.gff3.gz"
download.file(paste0(d, f), "mt_gff3.gz")
## If the above command doesn't work, you may copy/paste the full URL in
## a Web browser instead.
gff.mito <- read.gff("mt_gff3.gz")
## the lengths of the sequence features:
gff.mito$end - (gff.mito$start - 1)
table(gff.mito$type)
## where the exons start:
gff.mito$start[gff.mito$type == "exon"]
}
}
\keyword{IO}
|
